NovaCore.Agents
2.1.9
dotnet add package NovaCore.Agents --version 2.1.9
NuGet\Install-Package NovaCore.Agents -Version 2.1.9
<PackageReference Include="NovaCore.Agents" Version="2.1.9" />
<PackageVersion Include="NovaCore.Agents" Version="2.1.9" />
<PackageReference Include="NovaCore.Agents" />
paket add NovaCore.Agents --version 2.1.9
#r "nuget: NovaCore.Agents, 2.1.9"
#:package NovaCore.Agents@2.1.9
#addin nuget:?package=NovaCore.Agents&version=2.1.9
#tool nuget:?package=NovaCore.Agents&version=2.1.9
NovaCore.Agents
A composable .NET 10 agent runtime. Streaming event pipeline, dialect × transport provider composition, typed tools, 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
using NovaCore.Agents;
var agent = Agent.Build()
.UseProvider(Anthropic.Direct(apiKey, AnthropicModels.ClaudeSonnet46))
.Build();
var result = await agent.RunToCompletionAsync("What's 2+2?");
Console.WriteLine(result.FinalText);
Docs
Each doc covers one vertical. Read only the one you need.
Start here
- Getting started — install, hello agent, streaming, first session
- API reference — all public types, grouped by package
Core
- Providers — Anthropic, OpenAI, Google, OpenAI-compatible, Llama
- Tools — custom tools,
ToolResponse,[SequentialOnly],IToolSource - Dependency injection —
AddNovaAgents,IAgentFactory, lifetimes - System prompts — base, append, contributors, tool-source prompts
State + context
- Sessions & persistence —
ISessionStore, EF Core setup - Memory —
IMemory+ remember/recall - Summarisation — cumulative conversation summaries
- History pruning — tool-result + multimodal filtering
Flow control
- Loop policies — ReAct, stuck detection,
CompleteTaskTool - Budget —
RunBudget,BudgetBreached - Structured output —
RunToCompletionAsync<T>
Integrations
- Observability — event stream, middleware, OpenTelemetry — how your host hooks in
- Browser use — CDP-backed web automation
- OpenAI computer use — pixel-driven Chromium via OpenAI's Responses
computertool - MCP — Model Context Protocol
- Testing —
FakeProvider,ScriptedProvider
Upgrading
- Migration v1 → v2 — package + API map
- v2 redesign — architecture rationale (historical)
Status
Alpha. v1 (NovaCore.AgentKit.*) has been removed. Stable cut follows an internal validation pass.
License
Proprietary. Copyright (c) 2025 NovaCore. All rights reserved — see LICENSE. Contact NovaCore for licensing inquiries.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.7)
NuGet packages (9)
Showing the top 5 NuGet packages that depend on NovaCore.Agents:
| Package | Downloads |
|---|---|
|
NovaCore.Agents.BrowserUse
CDP-based browser automation tools for NovaCore.Agents. Parallel DOM+AX+snapshot fetch, enhanced DOM merge, LLM-friendly serialization with stable indices, 12 browser tools, managed or host-supplied browser sessions. |
|
|
NovaCore.Agents.Providers.OpenAI
OpenAI provider for NovaCore.Agents. Ships the OpenAI dialect (chat completions wire format) plus two transports: OpenAI-compatible (api.openai.com + any bearer-auth gateway — Groq, xAI, Fireworks, OpenRouter, Azure Foundry) and Azure OpenAI Service (deployment-based URL + api-key header). |
|
|
NovaCore.Agents.Observability.OpenTelemetry
OpenTelemetry instrumentation for NovaCore.Agents. A pipeline middleware emits an ActivitySource span per turn + per LLM call + per tool execution, and records Meter counters/histograms for tokens, cost, duration, and invocation counts. Host registers the ActivitySource and Meter names with its own OTel SDK. |
|
|
NovaCore.Agents.Providers.Google
Google Gemini provider for NovaCore.Agents. Ships the Gemini dialect (contents/parts + functionCall/functionResponse) with two transports: Direct (api-key auth against generativelanguage.googleapis.com) and Vertex (access-token auth; host supplies the token via a callback, keeping OAuth out of Core). |
|
|
NovaCore.Agents.Persistence.EntityFramework
EF Core persistence adapters for NovaCore.Agents. Supports library-owned tables via ConfigureNovaAgents() and host-owned tenant/encrypted entities via IAgentPersistenceContext projections. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.1.9 | 191 | 5/25/2026 |
| 2.1.8 | 174 | 5/25/2026 |
| 2.1.7 | 189 | 5/22/2026 |
| 2.1.6 | 196 | 5/16/2026 |
| 2.1.5 | 186 | 5/16/2026 |
| 2.1.4 | 180 | 5/16/2026 |
| 2.1.3 | 193 | 5/14/2026 |
| 2.1.2 | 189 | 5/13/2026 |
| 2.1.1 | 198 | 5/4/2026 |
| 2.1.0 | 203 | 5/3/2026 |
| 2.0.4 | 184 | 5/1/2026 |
| 2.0.3 | 189 | 4/29/2026 |
| 2.0.2 | 168 | 4/28/2026 |
| 2.0.1 | 158 | 4/27/2026 |
| 2.0.0 | 182 | 4/25/2026 |
| 1.0.4 | 155 | 4/24/2026 |
| 1.0.3 | 168 | 4/23/2026 |
| 1.0.2 | 152 | 4/22/2026 |
| 1.0.1 | 154 | 4/22/2026 |
| 1.0.0 | 181 | 4/18/2026 |