Nexus.Testing 0.1.2

Nexus — Multi-Agent Orchestration Engine

Nexus is an enterprise-grade .NET 10 framework for building, orchestrating, and managing multi-agent AI systems. It provides a composable architecture for agent execution, tool integration, memory management, guardrails, protocol support (MCP, A2A, AG-UI), and workflow orchestration.

📖 Full Documentation — Architecture guides, API reference, and examples.

Architecture

┌──────────────────────────────────────────────────────────┐
│                    Nexus.Hosting.AspNetCore               │
│              (AG-UI SSE, A2A JSON-RPC, Health)           │
├──────────────────────────────────────────────────────────┤
│  Nexus.Protocols.Mcp  │  Nexus.Protocols.A2A  │  AG-UI  │
├────────────────────────┴───────────────────────┴─────────┤
│                   Nexus.Workflows.Dsl                    │
│                  (JSON/YAML Pipelines)                   │
├──────────────────────────────────────────────────────────┤
│  Nexus.Orchestration  │  Nexus.Orchestration.Checkpoint  │
│   (Graph, Sequence,   │     (Snapshot Serialization,     │
│    Parallel, Hier.)   │      In-Memory Store)            │
├───────────────────────┴──────────────────────────────────┤
│  Guardrails  │  Memory  │  Messaging  │  Telemetry  │Auth│
│  (PII, Inj.) │ (Conv,   │ (PubSub,   │(OTel Traces│OAuth│
│              │  Working) │  DLQ)      │ & Metrics) │    │
├──────────────────────────────────────────────────────────┤
│                      Nexus.Core                          │
│    Agents · Tools · Pipeline · Events · Contracts · DI   │
└──────────────────────────────────────────────────────────┘

Packages

Quick Start

using Microsoft.Extensions.AI;
using Microsoft.Extensions.DependencyInjection;
using Nexus.Core.Agents;
using Nexus.Core.Configuration;
using Nexus.Core.Tools;
using Nexus.Memory;
using Nexus.Orchestration;

var services = new ServiceCollection();

services.AddNexus(nexus =>
{
    nexus.UseChatClient(_ => myLlmClient);       // Plug in any IChatClient
    nexus.AddOrchestration(o => o.UseDefaults());
    nexus.AddMemory(m => m.UseInMemory());
});

var sp = services.BuildServiceProvider();

// Register tools
var tools = sp.GetRequiredService<IToolRegistry>();
tools.Register(new LambdaTool("get_time", "Current UTC time",
    (_, _, _) => Task.FromResult(ToolResult.Success(DateTime.UtcNow.ToString("O")))));

// Spawn an agent and execute
var pool = sp.GetRequiredService<IAgentPool>();
var agent = await pool.SpawnAsync(new AgentDefinition
{
    Name = "Assistant",
    SystemPrompt = "You are a helpful assistant.",
});

var orchestrator = sp.GetRequiredService<IOrchestrator>();
var result = await orchestrator.ExecuteSequenceAsync([
    new AgentTask { Id = TaskId.New(), Description = "Hello!", AssignedAgent = agent.Id }
]);

Console.WriteLine(result.TaskResults.Values.First().Text);

Multi-Agent Graph

var graph = orchestrator.CreateGraph();
var research = graph.AddTask(new AgentTask
{
    Id = TaskId.New(),
    Description = "Research AI trends",
    AssignedAgent = researcher.Id,
});
var write = graph.AddTask(new AgentTask
{
    Id = TaskId.New(),
    Description = "Write blog post",
    AssignedAgent = writer.Id,
});

graph.AddDependency(research, write);

await foreach (var evt in orchestrator.ExecuteGraphStreamingAsync(graph))
{
    // Handle NodeStarted, AgentEventInGraph, NodeCompleted, etc.
}

Guardrails

using Nexus.Guardrails;
using Nexus.Guardrails.BuiltIn;

var pipeline = new DefaultGuardrailPipeline([
    new PromptInjectionDetector(),
    new PiiRedactor(GuardrailPhase.Output),
    new SecretsDetector(),
    new InputLengthLimiter { MaxTokens = 5000 },
]);

var result = await pipeline.EvaluateInputAsync(userInput);
if (!result.IsAllowed)
    Console.WriteLine($"Blocked: {result.Reason}");

Workflow DSL

{
    "id": "content-pipeline",
    "name": "Content Pipeline",
    "nodes": [
        { "id": "research", "name": "Researcher", "description": "Research topic",
          "agent": { "tools": ["web_search"], "budget": { "maxCostUsd": 1.0 } } },
        { "id": "write", "name": "Writer", "description": "Write content" }
    ],
    "edges": [
        { "from": "research", "to": "write" }
    ]
}

var loader = sp.GetRequiredService<IWorkflowLoader>();
var workflow = loader.LoadFromString(json, "json");
var validation = sp.GetRequiredService<IWorkflowValidator>().Validate(workflow);

Documentation

Full documentation is in the docs/ directory:

• Getting Started — Installation · Quick Start · CLI
• Architecture — Overview · Core Engine
• Guides — Orchestration · Memory · Guardrails · Messaging · Checkpointing · Workflows DSL · Protocols · Telemetry · Auth · Testing · Middleware
• API Reference — Core · Orchestration · Memory · Guardrails · Messaging · Workflows DSL · Protocols · Testing

Building & Testing

dotnet build Nexus.sln
dotnet test Nexus.sln

Project Structure

src/
  Nexus.Core/                       Core abstractions & DI
  Nexus.Orchestration/              Agent pool, orchestrator, task graphs
  Nexus.Orchestration.Checkpointing/ Snapshot serialization & storage
  Nexus.Memory/                     Conversation & working memory
  Nexus.Messaging/                  Message bus & shared state
  Nexus.Guardrails/                 Input/output guardrails
  Nexus.Telemetry/                  OpenTelemetry integration
  Nexus.Auth.OAuth2/                Authentication & token management
  Nexus.Protocols.Mcp/              MCP tool adapter
  Nexus.Protocols.A2A/              A2A protocol client
  Nexus.Protocols.AgUi/             AG-UI event bridge
  Nexus.Workflows.Dsl/              JSON/YAML workflow loader
  Nexus.Hosting.AspNetCore/         ASP.NET Core hosting
  Nexus.Testing/                    Test utilities & mocks
tests/
  Nexus.Core.Tests/                 35 unit tests
  Nexus.Orchestration.Tests/        14 unit tests
  Nexus.Memory.Tests/               12 unit tests
  Nexus.Messaging.Tests/            11 unit tests
  Nexus.Guardrails.Tests/           16 unit tests
  Nexus.Workflows.Dsl.Tests/        20 unit tests
  Nexus.Integration.Tests/          9 integration tests + 15 unit tests
examples/
  Nexus.Examples.Minimal/           Single agent with tools & guardrails
  Nexus.Examples.MultiAgent/        Graph orchestration, checkpointing, workflows

License

MIT