# Tracon.Core

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/api/package-tracon-core/
> Summary: Public types shipped by Tracon.Core, generated from the compiled assembly and its XML documentation.

88 public types. Select a type for signatures, defaults, remarks,
exceptions, and links to related contracts.

| Type | Kind | Purpose |
|---|---|---|
| [`AgentDecoratorPipeline`](/api/tracon.agentdecoratorpipeline/) | Class | Applies every registered IAgentDecorator to an agent, in the same order Tracon.CompositeAgentCatalog uses. |
| [`AgentDefinitionCompiler`](/api/tracon.agentdefinitioncompiler/) | Class | Chat agent, child agent (sub-agent), and harness agent production. |
| [`AgentExtensionContext`](/api/tracon.agentextensioncontext/) | Class | The agent an IAgentExtension is configuring: the definition, the tenant, the one options object the compiler is about to build the agent from, and the wrappers. |
| [`AgentParameterValidationError`](/api/tracon.agentparametervalidationerror/) | Class | A single parameter value violation. |
| [`AgentParameterValidationResult`](/api/tracon.agentparametervalidationresult/) | Class | The outcome of AgentParameterValidator.ValidateValues. |
| [`AgentParameterValidator`](/api/tracon.agentparametervalidator/) | Class | Validates an AgentDefinition's parameter schema, and validates a run's supplied values against it. |
| [`AgentRunScope`](/api/tracon.agentrunscope/) | Class | Represents the view of a running run that is exposed to the helper components in the run path. |
| [`AgentSessionManager`](/api/tracon.agentsessionmanager/) | Class | Manages the lifecycle of named sessions: loads, restores, and saves them through ISessionStore. |
| [`CallableAgentInfo`](/api/tracon.callableagentinfo/) | Struct | The summary of a callable sub-agent, reported to the model. |
| [`CanaryOptions`](/api/tracon.canaryoptions/) | Class | Options for the canary evaluation background service. |
| [`ChatClientSlot`](/api/tracon.chatclientslot/) | Enum | Where a chat client ring that an agent extension adds sits in the agent's model pipeline. |
| [`ChildAgentInvoker`](/api/tracon.childagentinvoker/) | Class | Wraps a sub-agent an agent may call; enforces depth, budget, and tenant limits and links the sub-run into the tree. |
| [`CompiledAgentCache`](/api/tracon.compiledagentcache/) | Class | Caches compiled agents keyed by (tenant, name, definition fingerprint, dependency fingerprint, culture), holding one entry per (tenant, name, definition. |
| [`DefaultRunAttributionContext`](/api/tracon.defaultrunattributioncontext/) | Class | The built-in IRunAttributionContext. It reports whatever AmbientRunAttributionScope carries, and nothing otherwise. |
| [`DefaultRunErrorClassifier`](/api/tracon.defaultrunerrorclassifier/) | Class | Tracon's built-in error classifier. |
| [`FixedTenantContext`](/api/tracon.fixedtenantcontext/) | Class | An immutable tenant context that always returns the same tenant. |
| [`HostedToolPriceOverride`](/api/tracon.hostedtoolpriceoverride/) | Class | Defines the configured price of one hosted tool kind at one provider. |
| [`IAgentExtension`](/api/tracon.iagentextension/) | Interface | A named piece of code that reaches the Microsoft Agent Framework options the compiler builds for an agent. A definition selects it by IAgentExtension.Name in. |
| [`IEvalEvaluatorFactory`](/api/tracon.ievalevaluatorfactory/) | Interface | The extension point that builds the AI.IAgentEvaluator an eval suite is graded with. |
| [`ImagePriceOverride`](/api/tracon.imagepriceoverride/) | Class | Defines the configured price for one image-generation model. |
| [`ITraconBuilder`](/api/tracon.itraconbuilder/) | Interface | The fluent chain that configures Tracon. Returned from the AddTracon call. |
| [`LiveVoiceBuilderExtensions`](/api/tracon.livevoicebuilderextensions/) | Class | Extensions that enable the provider-hosted live voice layer. |
| [`ModelPriceOverride`](/api/tracon.modelpriceoverride/) | Class | Defines a configured price override for one model. |
| [`ModelProviderRegistry`](/api/tracon.modelproviderregistry/) | Class | Registry that holds the registered IModelProvider implementations by name, and the single place that assembles the model-call pipeline. |
| [`ModelRunJudgeOptions`](/api/tracon.modelrunjudgeoptions/) | Class | Options for the built-in model-based judge (Tracon.ModelRunJudge). |
| [`OnlineEvaluationOptions`](/api/tracon.onlineevaluationoptions/) | Class | Online evaluation settings. |
| [`PatternContentGuardOptions`](/api/tracon.patterncontentguardoptions/) | Class | Settings for the built-in pattern-based guard. |
| [`PiiPatterns`](/api/tracon.piipatterns/) | Enum | The built-in pattern families for Tracon.PatternContentGuard. |
| [`RateLimitPartitionKind`](/api/tracon.ratelimitpartitionkind/) | Enum | Which key the rate limit is partitioned by. |
| [`ResolvedCallableAgents`](/api/tracon.resolvedcallableagents/) | Struct | The resolved set of sub-agents a definition may call, and its cache fingerprint. |
| [`RetentionTargetOptions`](/api/tracon.retentiontargetoptions/) | Class | Defines a configuration-based retention default for one target. |
| [`RunErrorFingerprint`](/api/tracon.runerrorfingerprint/) | Class | Produces the clustering digest Tracon's built-in classifier uses. |
| [`RunEventDraft`](/api/tracon.runeventdraft/) | Struct | Represents the information an event carries before its sequence number and timestamp are assigned. |
| [`RunEventWriter`](/api/tracon.runeventwriter/) | Class | Writes the events of a single run into IRunStore and produces the sequence number. |
| [`RunRecordingAgent`](/api/tracon.runrecordingagent/) | Class | Run completion: usage/cost merging, error mapping, and the terminal store write. RunRecordingAgent.CompleteAsync fans out to the root-only notifications in. |
| [`SingleTenantContext`](/api/tracon.singletenantcontext/) | Class | The default tenant context for single-tenant deployments. It always returns TraconOptions.DefaultTenantId. |
| [`SpeechToTextClientBinding`](/api/tracon.speechtotextclientbinding/) | Class | Binds a Microsoft.Extensions.AI speech-to-text client in the container to a named Tracon speech transcriber. |
| [`TextToSpeechClientBinding`](/api/tracon.texttospeechclientbinding/) | Class | Binds a Microsoft.Extensions.AI text-to-speech client in the container to a named Tracon speech synthesizer. |
| [`TimeoutAIFunction`](/api/tracon.timeoutaifunction/) | Class | Wraps an AI.AIFunction so a call that does not settle within a fixed duration ends in TraconToolTimeoutException instead of running unbounded. |
| [`TraconAgentGraphOptions`](/api/tracon.traconagentgraphoptions/) | Class | Defines limits that apply when an agent calls another agent. |
| [`TraconApprovalOptions`](/api/tracon.traconapprovaloptions/) | Class | Options for asynchronous approvals. |
| [`TraconAsyncRunOptions`](/api/tracon.traconasyncrunoptions/) | Class | Defines queued, durable run options. |
| [`TraconAttachmentOptions`](/api/tracon.traconattachmentoptions/) | Class | Defines attachment upload limits for size and media-type allow lists. |
| [`TraconAuditOptions`](/api/tracon.traconauditoptions/) | Class | Defines options for audit-trail actor resolution. |
| [`TraconBuilderConversationMemoryExtensions`](/api/tracon.traconbuilderconversationmemoryextensions/) | Class | Setup of conversation memory. |
| [`TraconBuilderExtensions`](/api/tracon.traconbuilderextensions/) | Class | The registration methods of the Tracon configuration chain that AddTracon returns. |
| [`TraconCircuitBreakerOptions`](/api/tracon.traconcircuitbreakeroptions/) | Class | Defines circuit-breaker options that temporarily stop requests after a model provider returns consecutive failures. |
| [`TraconClientToolExtensions`](/api/tracon.traconclienttoolextensions/) | Class | Registers a client-side tool: its declaration (name, description, JSON schema) lives in code, like every other tool (the code-only tools rule), but its body runs. |
| [`TraconContentGuardBuilderExtensions`](/api/tracon.traconcontentguardbuilderextensions/) | Class | Chain extensions that turn on content inspection. |
| [`TraconContentGuardOptions`](/api/tracon.traconcontentguardoptions/) | Class | Settings for the content inspection pipeline. |
| [`TraconContentProtectionExtensions`](/api/tracon.traconcontentprotectionextensions/) | Class | Chain extensions that turn on at-rest content protection. |
| [`TraconContentProtectionOptions`](/api/tracon.traconcontentprotectionoptions/) | Class | Settings for at-rest content protection. |
| [`TraconConversationMemoryOptions`](/api/tracon.traconconversationmemoryoptions/) | Class | Setup for conversation memory (MemorySettings.EnableConversationMemory), set with UseConversationMemory. |
| [`TraconDiagnostics`](/api/tracon.tracondiagnostics/) | Class | Defines Tracon telemetry source and measurement names. |
| [`TraconDiagnostics.Tags`](/api/tracon.tracondiagnostics.tags/) | Class | Defines span and metric tag names. Changing them breaks dashboards. |
| [`TraconDiagnosticsCollector`](/api/tracon.tracondiagnosticscollector/) | Class | Collects the installation's self-diagnostic summary report. |
| [`TraconDrainOptions`](/api/tracon.tracondrainoptions/) | Class | Graceful-shutdown draining settings. |
| [`TraconHealthOptions`](/api/tracon.traconhealthoptions/) | Class | Defines model-provider health-check options. |
| [`TraconIdempotencyOptions`](/api/tracon.traconidempotencyoptions/) | Class | Options for Idempotency-Key support. |
| [`TraconImageOptions`](/api/tracon.traconimageoptions/) | Class | Settings for the image-generation tool. |
| [`TraconKnowledgeOptions`](/api/tracon.traconknowledgeoptions/) | Class | Options for the knowledge base (semantic search). |
| [`TraconObservabilityOptions`](/api/tracon.traconobservabilityoptions/) | Class | Defines telemetry collection and persistence options. |
| [`TraconOnlineEvaluationBuilderExtensions`](/api/tracon.tracononlineevaluationbuilderextensions/) | Class | Chain extensions that turn on the built-in model-based judge. |
| [`TraconOptions`](/api/tracon.traconoptions/) | Class | Defines Tracon run-time options. |
| [`TraconPricingOptions`](/api/tracon.traconpricingoptions/) | Class | Defines a run-cost price source. It is a secondary source for a model that has no price in the ModelDescriptor catalog. |
| [`TraconProductionProfileOptions`](/api/tracon.traconproductionprofileoptions/) | Class | The risks a deployment has deliberately decided to carry, for RequireProductionProfile. |
| [`TraconQuotaOptions`](/api/tracon.traconquotaoptions/) | Class | Defines options for the quota subsystem. |
| [`TraconRateLimitOptions`](/api/tracon.traconratelimitoptions/) | Class | Rate-limit settings applied to Tracon endpoints. |
| [`TraconRetentionOptions`](/api/tracon.traconretentionoptions/) | Class | Defines data retention and archival options. |
| [`TraconRunContext`](/api/tracon.traconruncontext/) | Class | Carries the identity, tree position, and budget of the running run to the helper components inside the run path. |
| [`TraconRunContinuationOptions`](/api/tracon.traconruncontinuationoptions/) | Class | Interrupted-run continuation settings. |
| [`TraconRunRecordingOptions`](/api/tracon.traconrunrecordingoptions/) | Class | Defines how much detail run recording retains. |
| [`TraconServiceCollectionExtensions`](/api/tracon.traconservicecollectionextensions/) | Class | Extensions that register Tracon with dependency injection. |
| [`TraconSkillOptions`](/api/tracon.traconskilloptions/) | Class | Defines limits for skill content and agent attachment. |
| [`TraconSkillScriptBuilderExtensions`](/api/tracon.traconskillscriptbuilderextensions/) | Class | Configuration extensions that enable skill script execution. |
| [`TraconSkillScriptOptions`](/api/tracon.traconskillscriptoptions/) | Class | Defines options that control server-side skill script execution. |
| [`TraconStructuredResponseOptions`](/api/tracon.traconstructuredresponseoptions/) | Class | Structured response validation settings. |
| [`TraconToolApprovalPolicyExtensions`](/api/tracon.tracontoolapprovalpolicyextensions/) | Class | Chain extension that registers a code-defined approval policy for a tool. |
| [`TraconToolOptions`](/api/tracon.tracontooloptions/) | Class | Defines tool execution options. |
| [`TraconToolUsage`](/api/tracon.tracontoolusage/) | Class | Lets a tool report non-token usage from its own body. |
| [`TraconValidationOptions`](/api/tracon.traconvalidationoptions/) | Class | Defines options for the POST /api/agents/validate endpoint. |
| [`TraconWebhookOptions`](/api/tracon.traconwebhookoptions/) | Class | Event publishing (webhook) settings. |
| [`TraconWorkspaceOptions`](/api/tracon.traconworkspaceoptions/) | Class | Limits of the session workspace (WorkspaceSettings). |
| [`VoiceConversationBuilderExtensions`](/api/tracon.voiceconversationbuilderextensions/) | Class | Extensions that enable the real-time voice conversation layer. |
| [`VoiceConversationOptions`](/api/tracon.voiceconversationoptions/) | Class | Options of the real-time voice conversation layer. |
| [`VoiceLiveOptions`](/api/tracon.voiceliveoptions/) | Class | Options of the provider-hosted live voice layer. |
| [`VoicePriceOverride`](/api/tracon.voicepriceoverride/) | Class | Defines the configured price for one voice model. |
| [`WebhookSigner`](/api/tracon.webhooksigner/) | Class | Produces and verifies the HMAC-SHA256 signature of webhook requests. |