NovaCore.Agents 3.0.0

NovaCore.Agents

A composable .NET 10 agent runtime. Every invocation — one-shot, chat, ReAct, structured, sub-agent, or HITL resume — is one node in a durable execution tree, run through a single IAgentRuntime.Execute. Streaming event pipeline, dialect × transport provider composition, typed capabilities, budget enforcement, cumulative summarisation, browser automation, MCP, EF persistence, OpenTelemetry.

Install

dotnet add package NovaCore.Agents
dotnet add package NovaCore.Agents.Providers.Anthropic

Hello, agent

Everything is wired through IServiceCollection: register the runtime, map a model role to a provider, register a named agent (you get a typed AgentRef), then Execute it.

using Microsoft.Extensions.DependencyInjection;
using NovaCore.Agents;
using NovaCore.Agents.Providers.Anthropic;

var services = new ServiceCollection();
services.AddAgentRuntime();
services.AddModelProfiles(p => p.Add("default", Anthropic.Direct(apiKey, AnthropicModels.ClaudeSonnet46)));
var greeter = services.AddAgent<string, string>("greeter", a => a
    .Model("default")
    .Prompt("You are concise."));
var sp = services.BuildServiceProvider();

var outcome = await sp.GetRequiredService<IAgentRuntime>()
    .Execute(greeter, AgentRequest<string>.Start("What's 2+2?")).Completion;

if (outcome is ExecutionOutcome<string>.Completed done)
    Console.WriteLine(done.Value);

Docs

Each doc covers one vertical. Read only the one you need.

Start here

• Getting started — install, hello agent, streaming, the model in five points
• Agents & execution — AgentDefinition, AgentRef, IAgentRuntime.Execute, ExecutionOutcome<T>
• API reference — all public types, grouped by package
• Host integration — DI wiring, typed context, resource ownership

Core

• Providers — Anthropic, OpenAI, Google, OpenAI-compatible, Llama
• Capabilities — the one model-callable unit, CapabilityResult, SequentialOnly, SuspendsForHost
• Dependency injection — runtime, model profiles, AddAgent registration
• System prompts — static prompt, live context (AddContext), capability prompts

State + context

• Sessions & persistence — StateBinding, IConversationStore, EF Core setup
• Memory — IMemory + remember/recall
• Summarisation — cumulative conversation summaries
• History pruning — tool-result + multimodal filtering

Flow control

• Loop policies — LoopPolicy, ReAct, stuck detection, completion capability
• Budget — RunBudget, BudgetBreached
• Structured output — typed TOutput via OutputContract<T>
• Resilience & fallback — retries, provider fallback chains

Integrations

• Observability — the Events stream + OpenTelemetry — how your host hooks in
• Browser use — CDP-backed web automation
• OpenAI computer use — pixel-driven Chromium via OpenAI's Responses computer tool
• MCP — Model Context Protocol
• Testing — FakeProvider, ScriptedProvider

Upgrading

• Migration 2.6 → v3 — the v3 surface rewrite: what replaces builders/catalog/runner/ISessionStore
• Migration 2.x → 2.6 — what moved into the library and what hosts remove

Status

Current package line: 3.0.0.

License

Proprietary. Copyright (c) 2025 NovaCore. All rights reserved — see LICENSE. Contact NovaCore for licensing inquiries.