ANcpLua.Agents

Lean toolkit for Microsoft Agent Framework 1.13.x.

The repo is intentionally small: runtime governance primitives, MAF-native OpenTelemetry helpers, service defaults, workflow helpers, and test infrastructure. Provider-specific facades, MCP wrappers, Qyl Durable experiments, and demo product hosts were removed instead of kept alive as compatibility shims.

Compatible with: Microsoft.Agents.AI 1.13.x Tested against: Microsoft.Agents.AI 1.13.0 Upstream harvest: MAF 1.13 repositions OpenTelemetry below FunctionInvokingChatClient (#6667), so tool-calling agents emit execute_tool spans parented under invoke_agent; checkpoints survive package upgrades (TypeId ignores assembly version, #6636/#6670) and fan-in state persists correctly (#6491/#6574). Sequential orchestration gains chainOnlyAgentResponses (#6554), surfaced here through BuildQylSequential/AsQylSequentialAgent.

Packages

Package	Contents
ANcpLua.Agents	Core runtime helpers and governance primitives
ANcpLua.Agents.Instrumentation	Mandatory wrapped agent factory plus MAF-native OpenTelemetry registration helpers
ANcpLua.Agents.Hosting.ServiceDefaults	Health endpoints plus MAF ActivitySource registration helpers
ANcpLua.Agents.Workflows	Workflow facades and execution helpers
ANcpLua.Agents.Workflows.Declarative	Stable declarative workflow helpers
ANcpLua.Agents.Testing	Fake agents, fake chat clients, diagnostics, conformance fixtures
ANcpLua.Agents.Testing.Workflows	Workflow fixtures and workflow harnesses

Instrumentation

builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => tracing.AddAgentFrameworkSources())
    .WithMetrics(metrics => metrics.AddAgentFrameworkMeters());

var agent = QylAgentFactory.Create(
    chatClient,
    options => options
        .WithName("support-agent")
        .WithInstructions("Help the user."),
    services: serviceProvider);

QylAgentFactory is the ChatClientAgent construction boundary: it creates the inner agent with the supplied DI provider and always returns MAF-native OpenTelemetryAgent around the complete optional middleware pipeline. The wrapper emits invoke_agent / execute_tool spans on Experimental.Microsoft.Agents.AI; sensitive data is pinned off. It does not emit raw prompts, message content, tool arguments, tool results, API keys, or exception messages. UseAgentTelemetry remains available for non-ChatClientAgent backends that already exist as AIAgent instances.

Siblings: ANcpLua.Roslyn.Utilities · ANcpLua.NET.Sdk · ANcpLua.Analyzers