PRAXO-CORE C# Core¶

C# 12 / .NET 8 implementation of the PRAXO-CORE agent contract.

SPEC_VERSION: 0.2.0
Core version: 0.1.1
License: MIT
Dependencies: none beyond the .NET base class library

Scope¶

The Core implements all eleven vector groups: toolcall, jsonschema, plugin, checkpoint, event, memory, policy, stream, context, middleware, and agent loop. It also includes a synchronous OpenAiCompatibleModel and a streaming variant. The public API is idiomatic C#; wire shapes keep the Go casing (image_url, runId, plugin_id).

Build and test¶

dotnet build language/csharp/Praxo.Core/Praxo.Core.csproj
dotnet run --project language/csharp/Praxo.Conformance
dotnet run --project language/csharp/Praxo.Tests
dotnet run --project language/csharp/Praxo.Conformance -- --check-api
dotnet run --project language/csharp/samples/VbSample

Local toolchain used by the repository maintainers lives at D:\dev\dotnet. On CI, use the standard actions/setup-dotnet job.

Quickstart¶

using Praxo.Core;

var model = new StaticModel("hello");
var agent = new Agent(new AgentOptions(model));
var result = agent.Run(new Session("demo"), "hello");
Console.WriteLine(result.Output);

Tools are registered on AgentOptions.Tools:

var registry = new ToolRegistry();
registry.Register(new FuncTool("echo", "Echo arguments", args => args.DeepClone()));

var agent = new Agent(new AgentOptions(model)
{
    Tools = registry,
    MaxSteps = 8,
});

Layout¶

Praxo.Core/ library.
Praxo.Conformance/ vector runner and API snapshot tool.
Praxo.Tests/ dependency-free core tests.
samples/VbSample/ VB.NET consumer sample.
api-snapshot.txt checked-in public API snapshot.

Release¶

Tag shape: csharp/v0.1.1. The tag targets SPEC_VERSION 0.2.0.