Ananke.Orchestration 0.8.3

Ananke.Orchestration

Workflow orchestration engine for .NET — typed workflows, agent jobs, streaming chat loops, tool execution, checkpointing, and orchestration-level tracing.

Install

dotnet add package Ananke.Orchestration

Add an LLM provider:

dotnet add package Ananke.Orchestration.OpenAI    # or Ananke.Orchestration.Anthropic

Quick start

var workflow = new Workflow<ResearchState>("research-pipeline")
    .Job("plan",       planJob)
    .Job("search_web", searchWebJob)
    .Job("search_db",  searchDbJob)
    .Job("synthesize", synthesizeJob)
    .Then("plan", Workflow.Fork("search_web", "search_db"))
    .Join(["search_web", "search_db"], "synthesize", Merge)
    .Then("synthesize", Workflow.End);

var result = await workflow.RunAsync(new ResearchState { Query = "distributed systems" });

The same workflow surface supports:

• delegate jobs and custom IJob<TState> implementations
• direct, routed, looped, fork/join, and sub-workflow transitions
• checkpoint/resume for human-in-the-loop scenarios
• event streaming through IWorkflowRunner.StreamAsync(...)
• agent jobs backed by IAgentModel and IStreamingAgentModel

DI registration

using Ananke.Orchestration.Extensions;

services.AddWorkflowOrchestration(o => o
    .UseCheckpointing()
    .StoreCompletions(false)
    .WithCheckpointTtl(TimeSpan.FromDays(14)));

Features

• Typed workflow builder — Workflow<TState> with Job, Then, Chain, Loop, Fork, Join, and SubFlow
• Routing primitives — Workflow.Decide(...), Workflow.DecideAsync(...), and Workflow.DecideWithAgent(...)
• Agent jobs — AgentJob<TState,TResponse> for structured output and TextAgentJob<TState> for plain-text generations
• Streaming chat workflow — StreamingChatWorkflow builder for agent → tools → agent loops with delta callbacks
• Checkpointing and resume — ICheckpointStore, interrupts, and IWorkflowRunner.ResumeAsync(...)
• Workflow event streaming — IWorkflowRunner.StreamAsync(...) for progress, fork/join, and terminal events
• Tool execution — ToolKit, ToolDefinition, ToolBuilder, memory-backed tool gating, and execution strategies
• Smart tool routing — CompositeSmartToolRouter and routing stages surfaced through SmartToolRouterMiddleware
• Model middleware — logging, guardrails, caching, resilience, and tool-window narrowing at the IAgentModel layer
• Pattern builders — AgenticPattern.ReviewCritique<TState>() and AgenticPattern.IterativeRefinement<TState>()
• Tracing and budgets — IWorkflowTracer, workflow trace context, and token-usage capture for model calls

Key surfaces

Package boundaries

Ananke.Orchestration depends on Ananke.Orchestration.Knowledge, but the knowledge package remains independently consumable. This package also includes bridge types that expose knowledge stores and catalogs as agent-callable tools.

For compatibility, several agent and knowledge types are type-forwarded so existing consumers that referenced them through Ananke.Orchestration continue to resolve after package extraction.

Related packages

Documentation

Full docs, demos, and architecture: github.com/sevensamurai/Ananke

License

Apache 2.0