ControlAgentNet.Core 0.1.0

ControlAgentNet.Core

Core contracts and neutral models for ControlAgentNet - the foundation every package builds upon.

Purpose

ControlAgentNet.Core defines the shared abstractions that all other packages depend on. This enables:

• Modularity - Any package can reference Core without pulling in extra dependencies
• Extensibility - Third parties can build new implementations
• Consistency - All packages share the same types and interfaces

What's in Core

Interfaces

Models

Descriptors

Why These Types?

Design Principle: Core Stays Lean

Core contains only types that need to be shared across packages:

┌─────────────────────────────────────────┐
│            ControlAgentNet.Core            │
│  (interfaces, models, descriptors)     │
└─────────────────────────────────────────┘
         ▲          ▲          ▲
         │          │          │
    Policies    Runtime     Guards
    (stores)    (orch)    (enforce)

Core knows nothing about:

• Database connections
• HTTP clients
• Specific AI providers
• Channel implementations

This keeps Core lightweight and focused on contracts.

Extending Core

Third parties can create new implementations:

// Create a custom engine
public sealed class MyCustomEngine : IAgentEngine
{
    public Task<AgentEngineResult> RunAsync(AgentContext context, CancellationToken ct)
    {
        // Custom AI logic
        return Task.FromResult(AgentEngineResult.FromText("Hello from my custom engine"));
    }

    public IAsyncEnumerable<string> StreamAsync(AgentContext context, CancellationToken ct)
    {
        // Streaming support
    }
}

// Register it
builder.Services.AddSingleton<IAgentEngine, MyCustomEngine>();

RunAsync returns AgentEngineResult so engines can surface response text plus optional metadata such as model id, finish reason, and token usage.

Versioning

Core follows semantic versioning. Once v1.0.0 is released:

• Breaking changes = major version bump
• New features = minor version bump
• Bug fixes = patch version bump

Dependencies

Zero external dependencies. Core is pure .NET:

<PropertyGroup>
  <TargetFramework>net10.0</TargetFramework>
  <ImplicitUsings>enable</ImplicitUsings>
  <Nullable>enable</Nullable>
</PropertyGroup>

This ensures Core can be referenced by any package without version conflicts.

Related Packages

• ControlAgentNet.Agents - Main facade
• ControlAgentNet.Runtime - Implementation