NovaCore.Agents 3.2.0

NovaCore.Agents

A composable .NET 10 agent runtime. Hold an agent from a factory and run it — one-shot, chat, ReAct, structured, or HITL resume. Beneath the factory, every invocation (including sub-agents) 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

An IAgentFactory mints holdable agents. Create one from a provider, get an IAgent, and run it — no DI required:

using NovaCore.Agents;
using NovaCore.Agents.Providers.Anthropic;

using var factory = AgentFactory.Create("greeter",
    Anthropic.Direct(apiKey, AnthropicModels.ClaudeSonnet46),
    defaults: new AgentSpec { Instructions = "You are concise." });

var agent   = factory.Create();
var outcome = await agent.RunAsync("What's 2+2?");

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

In an app, register the factory once and inject it — map a model role to a provider, register a named factory, resolve it keyed by name (or plain for a single factory):

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

services.AddModelProfiles(p => p.Add("default", Anthropic.Direct(apiKey, AnthropicModels.ClaudeSonnet46)));
services.AddAgentFactory("greeter", f => f
    .Model("default")
    .Instructions("You are concise."));

// elsewhere:
public sealed class Greeter([FromKeyedServices("greeter")] IAgentFactory factory)
{
    public Task<ExecutionOutcome<string>> Greet(string who) => factory.Create().RunAsync(who);
}

The factory runs on the engine's one execution method, IAgentRuntime.Execute, which also powers sub-agents — reach for it directly only for sub-agent trees and advanced composition.

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 — the factory, the holdable agent, AgentSpec, the engine, ExecutionOutcome<T>
• API reference — all public types, grouped by package
• Host integration — principals, credentials, per-tenant key selection

Core

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

State + context

• Sessions & persistence — sessions, durable stores, resume, IConversationStore, EF Core
• 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 — budgets, the ledger, BudgetBreached
• Structured output — typed T via RunStructuredAsync<T> / 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

Status

Current package line: 3.1.0.

License

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