# Tracon

> 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/tracon/
> Summary: Tracon: Public types in the Tracon namespace.

## Namespaces

 [Tracon.Testing](/api/tracon.testing/)

## Classes

 [AgentDecoratorPipeline](/api/tracon.agentdecoratorpipeline/)

Applies every registered [IAgentDecorator](/api/tracon.iagentdecorator/) to an agent, in the
same order [Tracon.CompositeAgentCatalog](/api/tracon/) uses.

 [AgentDefinition](/api/tracon.agentdefinition/)

The full definition of an agent. The same type is used whether the agent is
declared in code or stored in the database; [AgentDefinition.Origin](/api/tracon.agentdefinition/#Tracon_AgentDefinition_Origin) tells the two apart.

 [AgentDefinitionCompiler](/api/tracon.agentdefinitioncompiler/)

Chat agent, child agent (sub-agent), and harness agent production.

 [AgentDefinitionRequest](/api/tracon.agentdefinitionrequest/)

Request to create or update an agent definition.

 [AgentDescriptor](/api/tracon.agentdescriptor/)

A summary view of an agent listed in the catalog. It carries everything the user
interface needs to draw the agent list, without having to build the agent. A source
must not mutate a descriptor or its nested collections after returning it.

 [AgentExtensionContext](/api/tracon.agentextensioncontext/)

The agent an [IAgentExtension](/api/tracon.iagentextension/) is configuring: the definition, the
tenant, the one options object the compiler is about to build the agent from, and
the wrappers and chat client rings the extension adds.

 [AgentParameter](/api/tracon.agentparameter/)

A single named placeholder an [AgentDefinition](/api/tracon.agentdefinition/)'s instructions can
reference as `{{name}}`.

 [AgentParameterValidationError](/api/tracon.agentparametervalidationerror/)

A single parameter value violation.

 [AgentParameterValidationResult](/api/tracon.agentparametervalidationresult/)

The outcome of [AgentParameterValidator.ValidateValues](/api/tracon.agentparametervalidator/#Tracon_AgentParameterValidator_ValidateValues_System_Collections_Generic_IReadOnlyList_Tracon_AgentParameter__System_Collections_Generic_IReadOnlyDictionary_System_String_System_String__System_Nullable_System_Int32__).

 [AgentParameterValidator](/api/tracon.agentparametervalidator/)

Validates an [AgentDefinition](/api/tracon.agentdefinition/)'s parameter schema, and validates
a run's supplied values against it.

 [AgentResponseFormat](/api/tracon.agentresponseformat/)

The definition of a structured output.

 [AgentRunBudget](/api/tracon.agentrunbudget/)

A run budget shared across an entire call tree.

 [AgentRunDocument](/api/tracon.agentrundocument/)

A piece of reference text attached to a single run, kept apart from the
model's instructions.

 [AgentRunRequest](/api/tracon.agentrunrequest/)

Request for a trial run made from the UI.

 [AgentRunScope](/api/tracon.agentrunscope/)

Represents the view of a running run that is exposed to the helper
components in the run path.

 [AgentSessionManager](/api/tracon.agentsessionmanager/)

Manages the lifecycle of named sessions: loads, restores, and saves them
through [ISessionStore](/api/tracon.isessionstore/).

 [AgentSkillDefinition](/api/tracon.agentskilldefinition/)

A markdown-based skill definition that can be loaded into an agent at run time.

 [AgentSkillResourceDefinition](/api/tracon.agentskillresourcedefinition/)

A readable resource carried with an [AgentSkillDefinition](/api/tracon.agentskilldefinition/).

 [AgentSkillScriptDefinition](/api/tracon.agentskillscriptdefinition/)

A server-executable script stored together with an [AgentSkillDefinition](/api/tracon.agentskilldefinition/).

 [AgentSourceDiagnostic](/api/tracon.agentsourcediagnostic/)

Describes one agent source registered in the catalog.

 [AgentSourcePriority](/api/tracon.agentsourcepriority/)

The priority values Tracon's own built-in agent sources use.

 [AmbientRunAttributionScope](/api/tracon.ambientrunattributionscope/)

The ambient pass-through for attributing a run that does not run inside an
HTTP request to a user and a set of labels.

 [AmbientTenantScope](/api/tracon.ambienttenantscope/)

The ambient passing mechanism for running an operation executed in the
background (outside an HTTP request) as a specific tenant.

 [AnthropicProviderExtensions](/api/tracon.anthropicproviderextensions/)

Extensions that add the Anthropic (Claude) provider to the Tracon chain.

 [AnthropicProviderNames](/api/tracon.anthropicprovidernames/)

The provider name registered by `UseAnthropic` and the
[ModelBinding.ProviderSettings](/api/tracon.modelbinding/#Tracon_ModelBinding_ProviderSettings) keys.

 [AnthropicProviderOptions](/api/tracon.anthropicprovideroptions/)

Tracon's Anthropic (Claude) provider settings.

 [ApiKeyCreationResult](/api/tracon.apikeycreationresult/)

The result of a key creation operation.

 [ApiKeyDraft](/api/tracon.apikeydraft/)

A draft for creating an API key.

 [ApiKeyGenerator](/api/tracon.apikeygenerator/)

A helper that produces a raw API key value and its hash.

 [ApiKeyRecord](/api/tracon.apikeyrecord/)

An API key's database-stored view, which CARRIES no raw VALUE.

 [ArchiveRow](/api/tracon.archiverow/)

The JSON representation of a single row to write to the archive.

 [AttachmentContent](/api/tracon.attachmentcontent/)

The content of a new attachment to be saved into the store.

 [AttachmentDescriptor](/api/tracon.attachmentdescriptor/)

The metadata of an uploaded attachment.

 [AttachmentQuery](/api/tracon.attachmentquery/)

The filter used to list attachments.

 [AuditChainQuery](/api/tracon.auditchainquery/)

The criteria that scope a hash chain verification.

 [AuditChainVerification](/api/tracon.auditchainverification/)

The result of verifying one tenant's audit trail hash chain.

 [AuditEntry](/api/tracon.auditentry/)

A row in the audit trail that records who changed which entity and when.

 [AuditQuery](/api/tracon.auditquery/)

The criteria that filter an audit trail query.

 [AzureOpenAIImageBuilderExtensions](/api/tracon.azureopenaiimagebuilderextensions/)

Adds Azure OpenAI image generation to the Tracon chain.

 [AzureOpenAIProviderExtensions](/api/tracon.azureopenaiproviderextensions/)

Extensions that add the Azure OpenAI provider to the Tracon chain.

 [AzureOpenAIProviderNames](/api/tracon.azureopenaiprovidernames/)

The provider name registered by the `UseAzureOpenAI` call, and the
[ModelBinding.ProviderSettings](/api/tracon.modelbinding/#Tracon_ModelBinding_ProviderSettings) keys.

 [AzureOpenAIProviderOptions](/api/tracon.azureopenaiprovideroptions/)

Tracon's Azure OpenAI provider options.

 [CallableAgentReference](/api/tracon.callableagentreference/)

One agent another agent may call, and the version of it that runs.

 [CanaryOptions](/api/tracon.canaryoptions/)

Options for the canary evaluation background service.

 [CanaryPolicy](/api/tracon.canarypolicy/)

Defines automatic rollback and gradual traffic-increase rules for an experiment canary variant.

 [ChildAgentInvoker](/api/tracon.childagentinvoker/)

Wraps a sub-agent an agent may call; enforces depth, budget, and tenant
limits and links the sub-run into the tree.

 [ClientToolResult](/api/tracon.clienttoolresult/)

The result of a single client-side tool call, sent back so the run can
continue.

 [CompactionSettings](/api/tracon.compactionsettings/)

Determines how an agent compacts its conversation history.

 [CompiledAgentCache](/api/tracon.compiledagentcache/)

Caches compiled agents keyed by
`(tenant, name, definition fingerprint, dependency fingerprint, culture)`,
holding one entry per `(tenant, name, definition fingerprint, culture)`.

 [ConfigurationDiagnostic](/api/tracon.configurationdiagnostic/)

Reports whether a configuration key resolves. It does not carry the value.

 [ContentGuardContext](/api/tracon.contentguardcontext/)

The context of an [IContentGuard](/api/tracon.icontentguard/) call.

 [ContentGuardResult](/api/tracon.contentguardresult/)

The result of an [IContentGuard](/api/tracon.icontentguard/) check.

 [DataSubjectExport](/api/tracon.datasubjectexport/)

A data subject's exported content.

 [DataSubjectScope](/api/tracon.datasubjectscope/)

The sessions, runs, and conversations that belong to one data subject.

 [DefaultRunAttributionContext](/api/tracon.defaultrunattributioncontext/)

The built-in [IRunAttributionContext](/api/tracon.irunattributioncontext/). It reports whatever
[AmbientRunAttributionScope](/api/tracon.ambientrunattributionscope/) carries, and nothing otherwise.

 [DefaultRunErrorClassifier](/api/tracon.defaultrunerrorclassifier/)

Tracon's built-in error classifier.

 [ElevenLabsProviderNames](/api/tracon.elevenlabsprovidernames/)

The provider name the built-in ElevenLabs client reports, and the
`ProviderSettings` keys it accepts on [SpeechRequest](/api/tracon.speechrequest/) and
[SpeechDialogueRequest](/api/tracon.speechdialoguerequest/).

 [EvalCase](/api/tracon.evalcase/)

A single test case inside an [EvalSuite](/api/tracon.evalsuite/).

 [EvalCaseAddResult](/api/tracon.evalcaseaddresult/)

The result of [IEvalStore.AddCaseAsync](/api/tracon.ievalstore/#Tracon_IEvalStore_AddCaseAsync_System_Guid_Tracon_EvalCaseDraft_System_Threading_CancellationToken_).

 [EvalCaseDiff](/api/tracon.evalcasediff/)

One case's outcome on both sides of an [EvalRunDiff](/api/tracon.evalrundiff/).

 [EvalCaseDraft](/api/tracon.evalcasedraft/)

Carrier for adding a single [EvalCase](/api/tracon.evalcase/).

 [EvalCaseResult](/api/tracon.evalcaseresult/)

The result of a single [EvalCase](/api/tracon.evalcase/) within an [EvalRun](/api/tracon.evalrun/).

 [EvalExpectedToolCall](/api/tracon.evalexpectedtoolcall/)

A tool call an [EvalCase](/api/tracon.evalcase/) expects the agent to make.

 [EvalRun](/api/tracon.evalrun/)

A single execution record and summary of an [EvalSuite](/api/tracon.evalsuite/).

 [EvalRunCompletion](/api/tracon.evalruncompletion/)

The information needed to finalize a run.

 [EvalRunDiff](/api/tracon.evalrundiff/)

The case-by-case difference between two completed [EvalRun](/api/tracon.evalrun/)
records of the same suite.

 [EvalRunDiffBuilder](/api/tracon.evalrundiffbuilder/)

Aligns two eval runs' per-case results into an [EvalRunDiff](/api/tracon.evalrundiff/).

 [EvalRunDiffQuery](/api/tracon.evalrundiffquery/)

Which two eval runs to compare, and which page of the result to read.

 [EvalRunDiffUnavailableException](/api/tracon.evalrundiffunavailableexception/)

Thrown by [IEvalStore.DiffRunsAsync](/api/tracon.ievalstore/#Tracon_IEvalStore_DiffRunsAsync_Tracon_EvalRunDiffQuery_System_Threading_CancellationToken_) when two eval runs exist
but cannot be compared.

 [EvalRunQuery](/api/tracon.evalrunquery/)

A query for filtering the run list.

 [EvalSuite](/api/tracon.evalsuite/)

An evaluation (eval) suite defined for an agent: carries which agent is
measured, with which checks.

 [Experiment](/api/tracon.experiment/)

Represents an A/B experiment that splits traffic between two or more definition versions of the same agent.

 [ExperimentResultsQuery](/api/tracon.experimentresultsquery/)

Defines a query for experiment results.

 [ExperimentVariant](/api/tracon.experimentvariant/)

Defines one experiment variant: its definition version and traffic weight.

 [ExperimentVariantResult](/api/tracon.experimentvariantresult/)

Summarizes run results for an experiment variant (calculated in the store).

 [ExtensionPointDiagnostic](/api/tracon.extensionpointdiagnostic/)

One host-bound extension point and whether the host replaced its built-in default.

 [FixedTenantContext](/api/tracon.fixedtenantcontext/)

An immutable tenant context that always returns the same tenant.

 [GeneratedApiKey](/api/tracon.generatedapikey/)

The generated raw API key value and its derived forms.

 [GoogleImageBuilderExtensions](/api/tracon.googleimagebuilderextensions/)

Adds Google image generation to the Tracon chain.

 [GoogleProviderExtensions](/api/tracon.googleproviderextensions/)

Extensions that add the Google Gemini provider to the Tracon chain.

 [GoogleProviderNames](/api/tracon.googleprovidernames/)

Provider name registered by the `UseGoogle` call, and the
[ModelBinding.ProviderSettings](/api/tracon.modelbinding/#Tracon_ModelBinding_ProviderSettings) keys.

 [GoogleProviderOptions](/api/tracon.googleprovideroptions/)

Tracon's Google Gemini provider settings.

 [GoogleSpeechBuilderExtensions](/api/tracon.googlespeechbuilderextensions/)

Adds Google Gemini speech to the Tracon chain.

 [GoogleSpeechOptions](/api/tracon.googlespeechoptions/)

Settings of [GoogleSpeechBuilderExtensions.UseGoogleSpeech](/api/tracon.googlespeechbuilderextensions/#Tracon_GoogleSpeechBuilderExtensions_UseGoogleSpeech_Tracon_ITraconBuilder_System_Action_Tracon_GoogleSpeechOptions__).

 [HarnessSettings](/api/tracon.harnesssettings/)

Settings for the harness capabilities. It mirrors a safe subset of the
`HarnessAgentOptions` structure of Microsoft Agent Framework.

 [HostedToolContext](/api/tracon.hostedtoolcontext/)

What the factory of a hosted tool (`AddHostedTool`) learns about the agent it builds the
tool for.

 [HostedToolPriceOverride](/api/tracon.hostedtoolpriceoverride/)

Defines the configured price of one hosted tool kind at one provider.

 [HttpTenantContext](/api/tracon.httptenantcontext/)

Resolves the tenant from the current HTTP request.

 [IdempotencyRequest](/api/tracon.idempotencyrequest/)

An idempotency reservation request.

 [IdempotencyReservation](/api/tracon.idempotencyreservation/)

The result of an [IIdempotencyStore.ReserveAsync](/api/tracon.iidempotencystore/#Tracon_IIdempotencyStore_ReserveAsync_Tracon_IdempotencyRequest_System_Threading_CancellationToken_) call.

 [IdempotencyResponse](/api/tracon.idempotencyresponse/)

The stored HTTP response.

 [ImagePriceOverride](/api/tracon.imagepriceoverride/)

Defines the configured price for one image-generation model.

 [InboundTrigger](/api/tracon.inboundtrigger/)

An inbound trigger definition: an external event that starts a queued run.

 [JobCompletion](/api/tracon.jobcompletion/)

The information needed to finalize a job.

 [JobContext](/api/tracon.jobcontext/)

The context available during an [IJobHandler](/api/tracon.ijobhandler/) execution.

 [JobErrorCodes](/api/tracon.joberrorcodes/)

The stable codes a job's [JobRecord.ErrorMessage](/api/tracon.jobrecord/#Tracon_JobRecord_ErrorMessage) carries when
the failure comes from the queue itself rather than from a handler.

 [JobHandlerKeys](/api/tracon.jobhandlerkeys/)

The built-in job handler keys, plus validation for the keys a consumer
registers.

 [JobItemRecord](/api/tracon.jobitemrecord/)

A single input of a batch job and that input's processing result.

 [JobItemResult](/api/tracon.jobitemresult/)

The result of a processed job item. Reported with [IJobStore.ReportItemAsync](/api/tracon.ijobstore/#Tracon_IJobStore_ReportItemAsync_Tracon_JobItemResult_System_Threading_CancellationToken_).

 [JobLanes](/api/tracon.joblanes/)

Well-known values and validation for job `lane` identifiers.

 [JobLeaseRequest](/api/tracon.jobleaserequest/)

What a worker asks of [IJobStore.LeaseAsync](/api/tracon.ijobstore/#Tracon_IJobStore_LeaseAsync_Tracon_JobLeaseRequest_System_Threading_CancellationToken_): who it is, how long the lease
lasts, which lanes it serves and, optionally, a per-tenant ceiling.

 [JobQuery](/api/tracon.jobquery/)

A filter for querying the job list.

 [JobQueueDepth](/api/tracon.jobqueuedepth/)

The number of open jobs in one lane/status pair.

 [JobRecord](/api/tracon.jobrecord/)

The summary of a queued job. The header of its items ([JobItemRecord](/api/tracon.jobitemrecord/)).

 [JobRequest](/api/tracon.jobrequest/)

The description of one job to queue through [IJobDispatcher](/api/tracon.ijobdispatcher/).

 [JobRetryException](/api/tracon.jobretryexception/)

The exception an [IJobHandler](/api/tracon.ijobhandler/) throws to signal that it wants
the job retried after a specific delay.

 [JobSchedule](/api/tracon.jobschedule/)

The schedule record defining when and how a job runs.

 [JobTenantCap](/api/tracon.jobtenantcap/)

A ceiling on how many jobs of a set of handler keys one tenant may hold leased at the
same time.

 [JudgeScore](/api/tracon.judgescore/)

One named score produced by an [IRunJudge](/api/tracon.irunjudge/).

 [LateToolCompletion](/api/tracon.latetoolcompletion/)

The settled outcome of a tool call whose timeout had already been reported.

 [LiveVoiceAppend](/api/tracon.livevoiceappend/)

Text sent into a live conversation's context.

 [LiveVoiceAttachRequest](/api/tracon.livevoiceattachrequest/)

The request that attaches the server-side control connection to a live voice session.

 [LiveVoiceBuilderExtensions](/api/tracon.livevoicebuilderextensions/)

Extensions that enable the provider-hosted live voice layer.

 [LiveVoiceCreateRequest](/api/tracon.livevoicecreaterequest/)

The request that creates a live voice session.

 [LiveVoiceEvent](/api/tracon.livevoiceevent/)

One event observed on a live voice session's sideband.

 [LiveVoiceSessionHandle](/api/tracon.livevoicesessionhandle/)

The result of creating a live voice session.

 [LiveVoiceSessionOptions](/api/tracon.livevoicesessionoptions/)

The settings of one live voice session.

 [LoopCriterion](/api/tracon.loopcriterion/)

One declarative stop criterion of the harness loop (see `LoopSettings`).

 [LoopSettings](/api/tracon.loopsettings/)

Turns the harness loop on: the agent is re-invoked until a stop criterion
says the work is finished.

 [McpServerDefinition](/api/tracon.mcpserverdefinition/)

A registered remote MCP server. Its tools are discovered at connection time and
listed alongside the tools registered in code.

 [McpServerRequest](/api/tracon.mcpserverrequest/)

Request to create/update an MCP server.

 [MemorySettings](/api/tracon.memorysettings/)

Determines the memory providers bound to an agent.

 [ModelBinding](/api/tracon.modelbinding/)

Determines the provider and the model an agent runs with. It carries
*no* credentials; the API key is resolved from configuration.

 [ModelDescriptor](/api/tracon.modeldescriptor/)

A model's capabilities and limits.

 [ModelFallback](/api/tracon.modelfallback/)

One link of a [ModelBinding.Fallbacks](/api/tracon.modelbinding/#Tracon_ModelBinding_Fallbacks) chain.

 [ModelOutputLimit](/api/tracon.modeloutputlimit/)

The output token limit a provider's chat client sends when
[ModelBinding.MaxOutputTokens](/api/tracon.modelbinding/#Tracon_ModelBinding_MaxOutputTokens) is empty.

 [ModelPriceOverride](/api/tracon.modelpriceoverride/)

Defines a configured price override for one model.

 [ModelProviderCredential](/api/tracon.modelprovidercredential/)

A resolved, in-memory credential used to call a provider (a model, live voice or
speech provider) on behalf of a specific tenant.

 [ModelProviderDescriptor](/api/tracon.modelproviderdescriptor/)

A provider's definition as shown in the UI.

 [ModelProviderHealth](/api/tracon.modelproviderhealth/)

A model provider's status at the last check.

 [ModelProviderRegistry](/api/tracon.modelproviderregistry/)

Registry that holds the registered [IModelProvider](/api/tracon.imodelprovider/)
implementations by name, and the single place that assembles the model-call pipeline.

 [ModelProviderSettings](/api/tracon.modelprovidersettings/)

Helpers that read and validate a provider settings dictionary: the
[ModelBinding.ProviderSettings](/api/tracon.modelbinding/#Tracon_ModelBinding_ProviderSettings) of a model binding, and the
`ProviderSettings` of a speech request.

 [ModelRunJudgeOptions](/api/tracon.modelrunjudgeoptions/)

Options for the built-in model-based judge ([Tracon.ModelRunJudge](/api/tracon/)).

 [NonTokenUsageRecord](/api/tracon.nontokenusagerecord/)

One non-token item a workflow function node reported: the persistent record behind
`GET /api/runs/{runId}/usage`.

 [OnlineEvaluationOptions](/api/tracon.onlineevaluationoptions/)

Online evaluation settings.

 [OpenAICompatibleProviderExtensions](/api/tracon.openaicompatibleproviderextensions/)

Extensions that add named providers with an OpenAI compatible chat API to the
Tracon chain (OpenRouter, Groq, vLLM, Ollama, LM Studio, ...).

 [OpenAICompatibleProviderOptions](/api/tracon.openaicompatibleprovideroptions/)

Constants for the configuration path of the providers that
`UseOpenAICompatible` registers.

 [OpenAIImageBuilderExtensions](/api/tracon.openaiimagebuilderextensions/)

Adds OpenAI image generation to the Tracon chain.

 [OpenAILiveOptions](/api/tracon.openailiveoptions/)

Options of the OpenAI live voice provider.

 [OpenAILiveProviderExtensions](/api/tracon.openailiveproviderextensions/)

Extensions that add OpenAI's live voice provider to the Tracon chain.

 [OpenAIProviderExtensions](/api/tracon.openaiproviderextensions/)

Extensions that add the OpenAI provider to the Tracon chain.

 [OpenAIProviderNames](/api/tracon.openaiprovidernames/)

The provider names that the `UseOpenAI` call registers, and the
[ModelBinding.ProviderSettings](/api/tracon.modelbinding/#Tracon_ModelBinding_ProviderSettings) keys.

 [OpenAIProviderOptions](/api/tracon.openaiprovideroptions/)

The OpenAI provider options of Tracon.

 [OpenAISpeechBuilderExtensions](/api/tracon.openaispeechbuilderextensions/)

Adds OpenAI speech to the Tracon chain.

 [OpenAISpeechOptions](/api/tracon.openaispeechoptions/)

Settings of [OpenAISpeechBuilderExtensions.UseOpenAISpeech](/api/tracon.openaispeechbuilderextensions/#Tracon_OpenAISpeechBuilderExtensions_UseOpenAISpeech_Tracon_ITraconBuilder_System_Action_Tracon_OpenAISpeechOptions__).

 [PatternContentGuardOptions](/api/tracon.patterncontentguardoptions/)

Settings for the built-in pattern-based guard.

 [PendingApproval](/api/tracon.pendingapproval/)

The pending tool approval request of a run that executes from the queue.

 [PricingDiagnostic](/api/tracon.pricingdiagnostic/)

Whether the catalog can actually put a price on a run.

 [ProductionProfileResult](/api/tracon.productionprofileresult/)

The answer one production profile check gives.

 [ProviderDiagnostic](/api/tracon.providerdiagnostic/)

Summarizes diagnostics for a model provider.

 [QuotaConsumption](/api/tracon.quotaconsumption/)

The consumption of a completed run to add to the quota counters.

 [QuotaDefinition](/api/tracon.quotadefinition/)

A quota rule defined for a tenant or an agent.

 [QuotaUsageQuery](/api/tracon.quotausagequery/)

A filter for querying quota usage.

 [QuotaUsageRecord](/api/tracon.quotausagerecord/)

A scope's consumption in the current period.

 [ResponseCacheSettings](/api/tracon.responsecachesettings/)

Response caching settings for a [ModelBinding](/api/tracon.modelbinding/).

 [ResponseSchemaShape](/api/tracon.responseschemashape/)

The response schema as a provider's client sends it to the model, and what differs from the
schema the author wrote.

 [RetentionPolicy](/api/tracon.retentionpolicy/)

An age- and volume-based retention rule for a target.

 [RetentionRun](/api/tracon.retentionrun/)

The history record of a cleanup run.

 [RetentionTargetOptions](/api/tracon.retentiontargetoptions/)

Defines a configuration-based retention default for one target.

 [RetentionTargets](/api/tracon.retentiontargets/)

The fixed table list a retention policy may target.

 [RunAgentStatistics](/api/tracon.runagentstatistics/)

An agent's run summary.

 [RunAuthorizationRequest](/api/tracon.runauthorizationrequest/)

Describes one run awaiting an authorization decision.

 [RunAuthorizationResult](/api/tracon.runauthorizationresult/)

The outcome of an authorization decision.

 [RunCompletion](/api/tracon.runcompletion/)

Everything needed to close a run.

 [RunCost](/api/tracon.runcost/)

Cost of a run. It is computed and written once when the run ends (a price
snapshot) — a later change to the price list does not change past values.

 [RunError](/api/tracon.runerror/)

Error information for a failed run.

 [RunErrorClassification](/api/tracon.runerrorclassification/)

The result of an [IRunErrorClassifier](/api/tracon.irunerrorclassifier/) classification.

 [RunErrorCluster](/api/tracon.runerrorcluster/)

The summary of runs sharing the same fingerprint.

 [RunErrorFingerprint](/api/tracon.runerrorfingerprint/)

Produces the clustering digest Tracon's built-in classifier uses.

 [RunErrorStatistics](/api/tracon.runerrorstatistics/)

An error class's summary.

 [RunEvent](/api/tracon.runevent/)

A single event produced during a run. Events are *append-only*: they are
never updated, only added.

 [RunEventCustomTypes](/api/tracon.runeventcustomtypes/)

Validation for the `CustomType` string that qualifies a
[RunEventType.Custom](/api/tracon.runeventtype/) event.

 [RunEventWriter](/api/tracon.runeventwriter/)

Writes the events of a single run into [IRunStore](/api/tracon.irunstore/) and
produces the sequence number.

 [RunInputRecord](/api/tracon.runinputrecord/)

A run's stored input.

 [RunJudgeContext](/api/tracon.runjudgecontext/)

The limited context supplied to a judge.

 [RunJudgment](/api/tracon.runjudgment/)

The judge's verdict: the named scores it produced.

 [RunLabelStatistics](/api/tracon.runlabelstatistics/)

A label's run summary; one entry per distinct key/value pair.

 [RunLabels](/api/tracon.runlabels/)

The limits a run's attribution must obey, and the single place they are enforced.

 [RunModelStatistics](/api/tracon.runmodelstatistics/)

A model's run summary. The input to cost computation.

 [RunNonTokenCost](/api/tracon.runnontokencost/)

What a run spent that is not tokens: the amounts its workflow function nodes and
its tools reported, added up in one currency.

 [RunQuery](/api/tracon.runquery/)

Query used to filter the run list.

 [RunReconciliationOptions](/api/tracon.runreconciliationoptions/)

Orphaned-run reconciliation settings.

 [RunRecord](/api/tracon.runrecord/)

Summary of a run. It acts as the header of the event stream.

 [RunRecordingAgent](/api/tracon.runrecordingagent/)

Run completion: usage/cost merging, error mapping, and the terminal store
write. [RunRecordingAgent.CompleteAsync](/api/tracon.runrecordingagent/) fans out to the root-only notifications
in `RunRecordingAgent.Notifications.cs`, but owns the outcome itself.

 [RunRecordingDiagnostic](/api/tracon.runrecordingdiagnostic/)

What a run actually records, as configured.

 [RunReplayRequest](/api/tracon.runreplayrequest/)

A replay request.

 [RunScore](/api/tracon.runscore/)

A human (or judge) score for a run or for a single message within a run.

 [RunScoreAggregate](/api/tracon.runscoreaggregate/)

One aggregated group: every score sharing a breakdown key AND a
[RunScoreKind](/api/tracon.runscorekind/).

 [RunScoreBucketAggregate](/api/tracon.runscorebucketaggregate/)

One time bucket of the trend series ([RunScoreSummary.Series](/api/tracon.runscoresummary/#Tracon_RunScoreSummary_Series)).

 [RunScoreBucketing](/api/tracon.runscorebucketing/)

Shared pure logic for score trend bucket truncation ([RunScoreBucket](/api/tracon.runscorebucket/)).

 [RunScoreQuery](/api/tracon.runscorequery/)

The filter for a score summary query ([IRunScoreStore.SummarizeAsync](/api/tracon.irunscorestore/#Tracon_IRunScoreStore_SummarizeAsync_Tracon_RunScoreQuery_System_Threading_CancellationToken_)).

 [RunScoreRules](/api/tracon.runscorerules/)

The shared rules a [RunScore](/api/tracon.runscore/) must satisfy before it is stored.

 [RunScoreSummary](/api/tracon.runscoresummary/)

The result of [IRunScoreStore.SummarizeAsync](/api/tracon.irunscorestore/#Tracon_IRunScoreStore_SummarizeAsync_Tracon_RunScoreQuery_System_Threading_CancellationToken_).

 [RunSpend](/api/tracon.runspend/)

The one place a run's token cost and its reported (non-token) amount are added.

 [RunStartInfo](/api/tracon.runstartinfo/)

Everything needed to open a new run.

 [RunStatistics](/api/tracon.runstatistics/)

A summary of the runs in a time range.

 [RunStatisticsQuery](/api/tracon.runstatisticsquery/)

The filter for a run statistics query.

 [RunTimeSeriesBucketing](/api/tracon.runtimeseriesbucketing/)

The shared pure logic for time-series bucket computation. Both
`InMemoryRunStore` and `PostgresRunStore` use this type, so the
bucket limit and rounding rules never diverge between the two stores.

 [RunTimeSeriesQuery](/api/tracon.runtimeseriesquery/)

Filter for a time-series query.

 [RunTrace](/api/tracon.runtrace/)

A run's span tree. The waterfall view is built on top of this.

 [RunTreeCost](/api/tracon.runtreecost/)

Total cost of a run tree (the root plus every child run).

 [RunUsage](/api/tracon.runusage/)

Token usage of a run.

 [RunUserStatistics](/api/tracon.runuserstatistics/)

A user's run summary.

 [RunVersionStatistics](/api/tracon.runversionstatistics/)

A definition version's run summary.

 [SearchKnowledgeRequest](/api/tracon.searchknowledgerequest/)

A semantic search request.

 [SessionAuthorizationRequest](/api/tracon.sessionauthorizationrequest/)

Describes one session access awaiting an authorization decision.

 [SessionQuery](/api/tracon.sessionquery/)

A filter for querying the session list.

 [SessionRecord](/api/tracon.sessionrecord/)

A stored session.

 [SingleTenantContext](/api/tracon.singletenantcontext/)

The default tenant context for single-tenant deployments. It always returns
[TraconOptions.DefaultTenantId](/api/tracon.traconoptions/#Tracon_TraconOptions_DefaultTenantId).

 [SingletonExecutionOptions](/api/tracon.singletonexecutionoptions/)

The settings of single-executor election.

 [SkillScriptExecutionRequest](/api/tracon.skillscriptexecutionrequest/)

One skill script that passed every execution gate, as handed to an
[ISkillScriptExecutor](/api/tracon.iskillscriptexecutor/).

 [SkillScriptExecutionResult](/api/tracon.skillscriptexecutionresult/)

What one skill script run did, as an [ISkillScriptExecutor](/api/tracon.iskillscriptexecutor/) reports it.

 [SkillScriptGrant](/api/tracon.skillscriptgrant/)

The record carrying permission to execute a skill script.

 [SkillSettings](/api/tracon.skillsettings/)

Settings for how an agent uses the skills it names in `AgentDefinition.SkillNames`.

 [SpeechAlignment](/api/tracon.speechalignment/)

One character's position in the generated audio.

 [SpeechAudio](/api/tracon.speechaudio/)

Generated audio.

 [SpeechDialogueAudio](/api/tracon.speechdialogueaudio/)

The audio of a dialogue and the time range of each turn.

 [SpeechDialogueCapabilities](/api/tracon.speechdialoguecapabilities/)

The limits of one dialogue request, as the provider states them.

 [SpeechDialogueRequest](/api/tracon.speechdialoguerequest/)

A request to voice a dialogue.

 [SpeechDialogueSegment](/api/tracon.speechdialoguesegment/)

The time range one turn takes in a dialogue's audio.

 [SpeechDialogueTurn](/api/tracon.speechdialogueturn/)

One turn of a dialogue: a text and the voice that speaks it.

 [SpeechProviderDescriptor](/api/tracon.speechproviderdescriptor/)

A registered speech provider, as the speech provider list reports it.

 [SpeechRequest](/api/tracon.speechrequest/)

A text-to-speech generation request.

 [SpeechToTextClientBinding](/api/tracon.speechtotextclientbinding/)

Binds a `Microsoft.Extensions.AI` speech-to-text client in the container to a named
Tracon speech transcriber.

 [SpeechTranscript](/api/tracon.speechtranscript/)

The result of speech-to-text conversion.

 [SpeechTranscriptionOptions](/api/tracon.speechtranscriptionoptions/)

Speech-to-text conversion settings.

 [SqlPersistenceDiagnosticsSnapshot](/api/tracon.sqlpersistencediagnosticssnapshot/)

Represents the current connection and migration status of an SQL persistence provider.

 [StructuredResponseValidationContext](/api/tracon.structuredresponsevalidationcontext/)

The response an [IStructuredResponseValidator](/api/tracon.istructuredresponsevalidator/) checks.

 [StructuredResponseValidationResult](/api/tracon.structuredresponsevalidationresult/)

The outcome of a structured response validation check.

 [SubAgentSettings](/api/tracon.subagentsettings/)

Determines how an agent calls the agents it may call, and how long it waits for them.

 [TraconDiagnostics.Tags](/api/tracon.tracondiagnostics.tags/)

Defines span and metric tag names. Changing them breaks dashboards.

 [TenantDescriptor](/api/tracon.tenantdescriptor/)

A registered tenant.

 [TenantEgressPolicy](/api/tracon.tenantegresspolicy/)

The set of providers a tenant's data is allowed to reach (egress policy).

 [TenantProviderBinding](/api/tracon.tenantproviderbinding/)

Binds a tenant to a provider's credential, by **name** only.

 [TextToSpeechClientBinding](/api/tracon.texttospeechclientbinding/)

Binds a `Microsoft.Extensions.AI` text-to-speech client in the container to a named
Tracon speech synthesizer.

 [TimeSeriesPoint](/api/tracon.timeseriespoint/)

A summary of the runs in a time bucket. The result unit of
`/api/stats/timeseries`; empty buckets are also returned (with zero events).

 [TimeoutAIFunction](/api/tracon.timeoutaifunction/)

Wraps an `AI.AIFunction` so a call that does not settle within a
fixed duration ends in [TraconToolTimeoutException](/api/tracon.tracontooltimeoutexception/) instead
of running unbounded.

 [ToolApprovalContext](/api/tracon.toolapprovalcontext/)

The tool call a code-defined approval policy judges. Read-only.

 [ToolApprovalDecision](/api/tracon.toolapprovaldecision/)

Tool approval decision sent from the UI.

 [ToolApprovalPresentation](/api/tracon.toolapprovalpresentation/)

A human-readable projection of one tool-approval request, produced by a consumer's
[IToolApprovalPresenter](/api/tracon.itoolapprovalpresenter/).

 [ToolApprovalRule](/api/tracon.toolapprovalrule/)

A persistent approval rule for a tool call the user said "do not ask again" for.

 [ToolArgumentCondition](/api/tracon.toolargumentcondition/)

One comparison against a tool call argument: *path · operator · value*.

 [ToolArgumentsValidationResult](/api/tracon.toolargumentsvalidationresult/)

The outcome of a tool arguments validation check.

 [ToolAuthorizationRequest](/api/tracon.toolauthorizationrequest/)

Describes one tool call awaiting an authorization decision.

 [ToolAuthorizationResult](/api/tracon.toolauthorizationresult/)

The outcome of an authorization decision.

 [ToolCallUsage](/api/tracon.toolcallusage/)

A non-token measurement and its cost: one tool call's, or one item a
workflow function node reported.

 [ToolDescriptor](/api/tracon.tooldescriptor/)

The UI-facing definition of a tool registered in code. The agent editor
shows a selection from this list; it does not accept free-text input.

 [ToolInputResponse](/api/tracon.toolinputresponse/)

The answer to one request for user input that suspended a tool call (MCP elicitation).

 [ToolInvocationRecord](/api/tracon.toolinvocationrecord/)

The summary of a single completed tool call.

 [ToolLoopSettings](/api/tracon.toolloopsettings/)

Tool-call loop settings for a [ModelBinding](/api/tracon.modelbinding/).

 [ToolRegistrationOptions](/api/tracon.toolregistrationoptions/)

Configures metadata for a tool registration.

 [ToolUsage](/api/tracon.toolusage/)

A tool's usage summary. Shown by the UI's Tools screen.

 [ToolUsageQuery](/api/tracon.toolusagequery/)

The filter for a tool usage summary.

 [ToolUsageUnits](/api/tracon.toolusageunits/)

The known unit names for [ToolCallUsage.Unit](/api/tracon.toolcallusage/#Tracon_ToolCallUsage_Unit).

 [TraceSpan](/api/tracon.tracespan/)

A single persisted OpenTelemetry span.

 [TraceSpanBatch](/api/tracon.tracespanbatch/)

A span set belonging to a single trace.

 [TraconA2ABuilderExtensions](/api/tracon.tracona2abuilderextensions/)

Extensions that register the services needed to publish Tracon agents
over A2A.

 [TraconA2AExtensions](/api/tracon.tracona2aextensions/)

Extensions that connect the HTTP endpoint that publishes Tracon agents
over A2A.

 [TraconA2AOptions](/api/tracon.tracona2aoptions/)

Settings for publishing Tracon agents over A2A.

 [TraconAgentGraphOptions](/api/tracon.traconagentgraphoptions/)

Defines limits that apply when an agent calls another agent.

 [TraconAgentSourceException](/api/tracon.traconagentsourceexception/)

Represents a normalized failure from an [IAgentSource](/api/tracon.iagentsource/).

 [TraconApprovalOptions](/api/tracon.traconapprovaloptions/)

Options for asynchronous approvals.

 [TraconAsyncRunOptions](/api/tracon.traconasyncrunoptions/)

Defines queued, durable run options.

 [TraconAttachmentOptions](/api/tracon.traconattachmentoptions/)

Defines attachment upload limits for size and media-type allow lists.

 [TraconAuditOptions](/api/tracon.traconauditoptions/)

Defines options for audit-trail actor resolution.

 [TraconBuilderConversationMemoryExtensions](/api/tracon.traconbuilderconversationmemoryextensions/)

Setup of conversation memory.

 [TraconBuilderExtensions](/api/tracon.traconbuilderextensions/)

The registration methods of the Tracon configuration chain that
`AddTracon` returns.

 [TraconChildRunTimeoutException](/api/tracon.traconchildruntimeoutexception/)

Thrown when an agent step of a workflow does not answer within the
sub-agent wait limit.

 [TraconCircuitBreakerOptions](/api/tracon.traconcircuitbreakeroptions/)

Defines circuit-breaker options that temporarily stop requests after a model
provider returns consecutive failures.

 [TraconClientToolExtensions](/api/tracon.traconclienttoolextensions/)

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 on the caller instead of on the server.

 [TraconCompilationException](/api/tracon.traconcompilationexception/)

Thrown when an agent definition cannot be turned into a runnable agent.

 [TraconContentBlockedException](/api/tracon.traconcontentblockedexception/)

Thrown when an [IContentGuard](/api/tracon.icontentguard/) blocks content.

 [TraconContentFilteredException](/api/tracon.traconcontentfilteredexception/)

Thrown when a model provider cuts the response short with its safety or
content filter.

 [TraconContentGuardBuilderExtensions](/api/tracon.traconcontentguardbuilderextensions/)

Chain extensions that turn on content inspection.

 [TraconContentGuardOptions](/api/tracon.traconcontentguardoptions/)

Settings for the content inspection pipeline.

 [TraconContentProtectionExtensions](/api/tracon.traconcontentprotectionextensions/)

Chain extensions that turn on at-rest content protection.

 [TraconContentProtectionOptions](/api/tracon.traconcontentprotectionoptions/)

Settings for at-rest content protection.

 [TraconConversationMemoryOptions](/api/tracon.traconconversationmemoryoptions/)

Setup for conversation memory ([MemorySettings.EnableConversationMemory](/api/tracon.memorysettings/#Tracon_MemorySettings_EnableConversationMemory)), set with
`UseConversationMemory`.

 [TraconDiagnostics](/api/tracon.tracondiagnostics/)

Defines Tracon telemetry source and measurement names.

 [TraconDiagnosticsCollector](/api/tracon.tracondiagnosticscollector/)

Collects the installation's self-diagnostic summary report.

 [TraconDiagnosticsReport](/api/tracon.tracondiagnosticsreport/)

Reports the self-diagnostics of the installation.

 [TraconDrainOptions](/api/tracon.tracondrainoptions/)

Graceful-shutdown draining settings.

 [TraconEgressOptions](/api/tracon.traconegressoptions/)

Shared rules for the target address of outbound network requests.

 [TraconEndpointOptions](/api/tracon.traconendpointoptions/)

Access and behavior settings for the endpoints connected via `MapTracon`.

 [TraconEndpointRouteBuilderExtensions](/api/tracon.traconendpointroutebuilderextensions/)

Extensions that connect Tracon's HTTP surface to the application.

 [TraconErrorTypes](/api/tracon.traconerrortypes/)

Every machine-readable error code Tracon writes: the type of a failed run, the code of a job the
queue failed, and the `error.type` of an OpenAI-compatible error body.

 [TraconException](/api/tracon.traconexception/)

Base class for every error Tracon raises.

 [TraconExternalCallException](/api/tracon.traconexternalcallexception/)

Thrown when an external caller (over MCP or A2A) asked to invoke an agent from
the catalog and the call was refused because it crosses a boundary.

 [TraconFinishReasons](/api/tracon.traconfinishreasons/)

Finish reasons Tracon reads beyond the ones `AI.ChatFinishReason` defines.

 [TraconGeneratedToolArguments](/api/tracon.tracongeneratedtoolarguments/)

The helper methods called by tool wrappers produced by the source
generator while converting JSON arguments to CLR types.

 [TraconHealthCheckExtensions](/api/tracon.traconhealthcheckextensions/)

Extensions that connect Tracon to the standard.NET health check system.

 [TraconHealthOptions](/api/tracon.traconhealthoptions/)

Defines model-provider health-check options.

 [TraconId](/api/tracon.traconid/)

UUID version 7 generator for Tracon identifiers (RFC 9562).

 [TraconIdempotencyOptions](/api/tracon.traconidempotencyoptions/)

Options for `Idempotency-Key` support.

 [TraconImageOptions](/api/tracon.traconimageoptions/)

Settings for the image-generation tool.

 [TraconInboundTriggerOptions](/api/tracon.traconinboundtriggeroptions/)

Options that constrain inbound triggers.

 [TraconKnowledgeOptions](/api/tracon.traconknowledgeoptions/)

Options for the knowledge base (semantic search).

 [TraconLoopUnsatisfiedException](/api/tracon.traconloopunsatisfiedexception/)

Thrown when a harness loop reaches its iteration ceiling while a criterion still
asks for another iteration, and its [LoopSettings.OnExhausted](/api/tracon.loopsettings/#Tracon_LoopSettings_OnExhausted) is
[LoopOutcome.FailRun](/api/tracon.loopoutcome/).

 [TraconMcpBuilderExtensions](/api/tracon.traconmcpbuilderextensions/)

Extensions that register tool discovery from remote MCP servers.

 [TraconMcpOptions](/api/tracon.traconmcpoptions/)

Options for connecting to remote MCP servers.

 [TraconMcpSecurityOptions](/api/tracon.traconmcpsecurityoptions/)

The security boundary applied to stored MCP server definitions.

 [TraconMcpServerBuilderExtensions](/api/tracon.traconmcpserverbuilderextensions/)

Extensions that register the services needed to publish Tracon agents
as MCP tools.

 [TraconMcpServerExtensions](/api/tracon.traconmcpserverextensions/)

Extensions that connect the HTTP endpoint that publishes Tracon agents
as MCP tools.

 [TraconMcpServerOptions](/api/tracon.traconmcpserveroptions/)

Settings for publishing Tracon agents as MCP tools.

 [TraconModelConcurrencyOptions](/api/tracon.traconmodelconcurrencyoptions/)

Defines the outgoing concurrency limit applied per model provider.

 [TraconObservabilityOptions](/api/tracon.traconobservabilityoptions/)

Defines telemetry collection and persistence options.

 [TraconOnlineEvaluationBuilderExtensions](/api/tracon.tracononlineevaluationbuilderextensions/)

Chain extensions that turn on the built-in model-based judge.

 [TraconOptions](/api/tracon.traconoptions/)

Defines Tracon run-time options.

 [TraconOutputTruncatedException](/api/tracon.traconoutputtruncatedexception/)

Thrown when the model stops at its output token limit before a structured
(JSON) response is complete.

 [TraconPolicies](/api/tracon.traconpolicies/)

Role-based authorization policy names that Tracon defines.

 [TraconPostgreSqlBuilderExtensions](/api/tracon.traconpostgresqlbuilderextensions/)

Extensions that add PostgreSQL persistence to the Tracon chain.

 [TraconPostgreSqlOptions](/api/tracon.traconpostgresqloptions/)

Settings for Tracon's PostgreSQL persistence layer.

 [TraconPreflightOptions](/api/tracon.traconpreflightoptions/)

Defines options for the pre-flight context-window check.

 [TraconPricingOptions](/api/tracon.traconpricingoptions/)

Defines a run-cost price source. It is a secondary source for a model that
has no price in the [ModelDescriptor](/api/tracon.modeldescriptor/) catalog.

 [TraconProductionProfileOptions](/api/tracon.traconproductionprofileoptions/)

The risks a deployment has deliberately decided to carry, for
`RequireProductionProfile`.

 [TraconProviderUnavailableException](/api/tracon.traconproviderunavailableexception/)

Thrown when the circuit breaker has temporarily taken a model provider out of
service.

 [TraconQuotaOptions](/api/tracon.traconquotaoptions/)

Defines options for the quota subsystem.

 [TraconRateLimitOptions](/api/tracon.traconratelimitoptions/)

Rate-limit settings applied to Tracon endpoints.

 [TraconRetentionOptions](/api/tracon.traconretentionoptions/)

Defines data retention and archival options.

 [TraconRunBudgetExceededException](/api/tracon.traconrunbudgetexceededexception/)

Thrown when a run tree's budget runs out: its token or cost budget between two
model turns, or a workflow step or function node that the budget refuses to start.

 [TraconRunContext](/api/tracon.traconruncontext/)

Carries the identity, tree position, and budget of the running run to the
helper components inside the run path.

 [TraconRunContinuationOptions](/api/tracon.traconruncontinuationoptions/)

Interrupted-run continuation settings.

 [TraconRunOptions](/api/tracon.traconrunoptions/)

Run options that let the caller determine a run's identifier, its place
in the tree, and its budget.

 [TraconRunRecordingOptions](/api/tracon.traconrunrecordingoptions/)

Defines how much detail run recording retains.

 [TraconSchedulingOptions](/api/tracon.traconschedulingoptions/)

Batch and scheduled run settings.

 [TraconServiceCollectionExtensions](/api/tracon.traconservicecollectionextensions/)

Extensions that register Tracon with dependency injection.

 [TraconSessionConflictException](/api/tracon.traconsessionconflictexception/)

Thrown for the losing request when two concurrent first requests arrive for the
same new session id.

 [TraconSessionOwnerRequiredException](/api/tracon.traconsessionownerrequiredexception/)

Thrown when session ownership is on, a session write needs an owner, and no
authenticated identity could be resolved to be that owner.

 [TraconSessionOwnershipOptions](/api/tracon.traconsessionownershipoptions/)

Turns per-user session ownership on, a second boundary drawn UNDER the
tenant.

 [TraconSkillOptions](/api/tracon.traconskilloptions/)

Defines limits for skill content and agent attachment.

 [TraconSkillScriptBuilderExtensions](/api/tracon.traconskillscriptbuilderextensions/)

Configuration extensions that enable skill script execution.

 [TraconSkillScriptOptions](/api/tracon.traconskillscriptoptions/)

Defines options that control server-side skill script execution.

 [TraconSqlServerBuilderExtensions](/api/tracon.traconsqlserverbuilderextensions/)

Extensions that add SQL Server persistence to the Tracon chain.

 [TraconSqlServerOptions](/api/tracon.traconsqlserveroptions/)

Settings for Tracon's SQL Server persistence layer.

 [TraconSqliteBuilderExtensions](/api/tracon.traconsqlitebuilderextensions/)

Extensions that add SQLite persistence to the Tracon chain.

 [TraconSqliteOptions](/api/tracon.traconsqliteoptions/)

Settings for Tracon's SQLite persistence layer.

 [TraconStructuredResponseException](/api/tracon.traconstructuredresponseexception/)

Thrown when a run's response fails structured output validation.

 [TraconStructuredResponseOptions](/api/tracon.traconstructuredresponseoptions/)

Structured response validation settings.

 [TraconTenancyBuilderExtensions](/api/tracon.tracontenancybuilderextensions/)

Extensions that connect multi-tenancy to the HTTP request.

 [TraconTenancyOptions](/api/tracon.tracontenancyoptions/)

Settings that determine how the tenant is resolved from the request.

 [TraconTenantProviderOptions](/api/tracon.tracontenantprovideroptions/)

Options that constrain per-tenant model provider bindings (BYOK).

 [TraconTenantProviderRefusedException](/api/tracon.tracontenantproviderrefusedexception/)

Thrown when a tenant's provider rules refuse a call before it leaves the process.

 [TraconTenantQuotaExceededException](/api/tracon.tracontenantquotaexceededexception/)

Thrown when a tenant's quota period is spent and a run tree that is already running is
refused new work: a workflow function node or an agent step that has not started.

 [TraconToolApprovalPolicyExtensions](/api/tracon.tracontoolapprovalpolicyextensions/)

Chain extension that registers a code-defined approval policy for a tool.

 [TraconToolAttribute](/api/tracon.tracontoolattribute/)

Marks a method as a tool. `AddToolsFrom<T>` registers only
methods carrying this attribute.

 [TraconToolOptions](/api/tracon.tracontooloptions/)

Defines tool execution options.

 [TraconToolRegistration](/api/tracon.tracontoolregistration/)

A single tool registered with dependency injection. Tracon builds the
tool registry from these registrations.

 [TraconToolTimeoutException](/api/tracon.tracontooltimeoutexception/)

Thrown when a tool call does not settle within its configured timeout.

 [TraconToolUsage](/api/tracon.tracontoolusage/)

Lets a tool report non-token usage from its own body.

 [TraconUiBuilderExtensions](/api/tracon.traconuibuilderextensions/)

Provides extensions that register the embedded management UI.

 [TraconValidationOptions](/api/tracon.traconvalidationoptions/)

Defines options for the `POST /api/agents/validate` endpoint.

 [TraconWebhookOptions](/api/tracon.traconwebhookoptions/)

Event publishing (webhook) settings.

 [TraconWorkflowContextExtensions](/api/tracon.traconworkflowcontextextensions/)

What a function node reads from, and reports to, its workflow run: the run's parameter
values and the non-token usage it spent.

 [TraconWorkflowFunctionExtensions](/api/tracon.traconworkflowfunctionextensions/)

Extensions that register a code function as a workflow node.

 [TraconWorkflowFunctionTimeoutException](/api/tracon.traconworkflowfunctiontimeoutexception/)

Thrown when a function node of a workflow does not return within its timeout.

 [TraconWorkflowOptions](/api/tracon.traconworkflowoptions/)

Settings that control workflow execution.

 [TraconWorkflowsBuilderExtensions](/api/tracon.traconworkflowsbuilderextensions/)

Extensions that register workflow execution.

 [TraconWorkspaceOptions](/api/tracon.traconworkspaceoptions/)

Limits of the session workspace ([WorkspaceSettings](/api/tracon.workspacesettings/)).

 [UploadDocumentChunk](/api/tracon.uploaddocumentchunk/)

A single ready-made chunk in an upload request.

 [UploadDocumentRequest](/api/tracon.uploaddocumentrequest/)

Request to upload a document.

 [VectorChunk](/api/tracon.vectorchunk/)

A single chunk to write.

 [VectorSearchHit](/api/tracon.vectorsearchhit/)

A single search result.

 [VectorSearchRequest](/api/tracon.vectorsearchrequest/)

A semantic search request.

 [VoiceAttributeNames](/api/tracon.voiceattributenames/)

Names for well-known [VoiceDescriptor.Attributes](/api/tracon.voicedescriptor/#Tracon_VoiceDescriptor_Attributes) keys. Not
exhaustive: a provider may report other safe scalar labels under their own key.

 [VoiceBuilderExtensions](/api/tracon.voicebuilderextensions/)

Adds the voice tools to the Tracon chain.

 [VoiceConversationBuilderExtensions](/api/tracon.voiceconversationbuilderextensions/)

Extensions that enable the real-time voice conversation layer.

 [VoiceConversationOptions](/api/tracon.voiceconversationoptions/)

Options of the real-time voice conversation layer.

 [VoiceDescriptor](/api/tracon.voicedescriptor/)

The definition of an available voice.

 [VoiceHealth](/api/tracon.voicehealth/)

The voice provider's reachability status.

 [VoiceLiveOptions](/api/tracon.voiceliveoptions/)

Options of the provider-hosted live voice layer.

 [VoiceOptions](/api/tracon.voiceoptions/)

Settings for the voice tools.

 [VoicePriceOverride](/api/tracon.voicepriceoverride/)

Defines the configured price for one voice model.

 [VoiceSessionCost](/api/tracon.voicesessioncost/)

What one voice conversation cost.

 [VoiceSessionQuery](/api/tracon.voicesessionquery/)

The filter for listing voice session records.

 [VoiceSessionRecord](/api/tracon.voicesessionrecord/)

The summary record of a real-time voice connection.

 [WebhookDelivery](/api/tracon.webhookdelivery/)

A single delivery record.

 [WebhookDeliveryQuery](/api/tracon.webhookdeliveryquery/)

A filter for querying delivery history.

 [WebhookDeliveryResult](/api/tracon.webhookdeliveryresult/)

The result of a delivery attempt.

 [WebhookEvents](/api/tracon.webhookevents/)

The event types Tracon can publish.

 [WebhookSigner](/api/tracon.webhooksigner/)

Produces and verifies the HMAC-SHA256 signature of webhook requests.

 [WebhookSubscription](/api/tracon.webhooksubscription/)

An external system's event subscription.

 [WorkflowAgentBinding](/api/tracon.workflowagentbinding/)

Binds catalog agents to a workflow graph defined in code.

 [WorkflowAgentStepOptions](/api/tracon.workflowagentstepoptions/)

The settings of one agent step in a workflow graph built in code, passed to
[WorkflowAgentBinding.GetWorkflowAgentStep](/api/tracon.workflowagentbinding/).

 [WorkflowCheckpointRecord](/api/tracon.workflowcheckpointrecord/)

Represents a single checkpoint of a workflow run.

 [WorkflowDefinition](/api/tracon.workflowdefinition/)

Represents the full definition of a workflow, whether defined through the
UI or in code.

 [WorkflowDescriptor](/api/tracon.workflowdescriptor/)

Represents a summary view of a workflow listed in the catalog.

 [WorkflowFunctionBinding](/api/tracon.workflowfunctionbinding/)

Binds functions registered with `AddWorkflowFunction` to a workflow graph defined in code.

 [WorkflowFunctionOptions](/api/tracon.workflowfunctionoptions/)

The optional settings of a workflow function registered with
`AddWorkflowFunction`: its description, retry policy, timeout, how many calls may run at
once and whether it starts when the call tree's budget is spent.

 [WorkflowFunctionStepOptions](/api/tracon.workflowfunctionstepoptions/)

The settings of one function node in a workflow graph built in code, passed to
[WorkflowFunctionBinding.GetWorkflowFunction](/api/tracon.workflowfunctionbinding/).

 [WorkflowGraph](/api/tracon.workflowgraph/)

Represents a workflow's compiled graph: nodes, edges, and external
request ports.

 [WorkflowGraphEdge](/api/tracon.workflowgraphedge/)

Represents the connection between two nodes.

 [WorkflowGraphNode](/api/tracon.workflowgraphnode/)

Represents a node in the graph.

 [WorkflowNodeReference](/api/tracon.workflownodereference/)

Points to a single node entering a workflow's graph: an agent from the
catalog, or a function registered in code.

 [WorkflowNodeRetryPolicy](/api/tracon.workflownoderetrypolicy/)

Retries a single workflow function node on a transient provider error
instead of failing the whole run.

 [WorkflowPendingRequest](/api/tracon.workflowpendingrequest/)

Represents human input awaited by a workflow run.

 [WorkflowRegistrationOptions](/api/tracon.workflowregistrationoptions/)

The settings of a workflow defined in code, passed to
[TraconWorkflowsBuilderExtensions.AddWorkflow](/api/tracon.traconworkflowsbuilderextensions/).

 [WorkflowRequestQuery](/api/tracon.workflowrequestquery/)

The filter and the page of a listing of a tenant's open human requests.

 [WorkflowRequestRecord](/api/tracon.workflowrequestrecord/)

One request a workflow run waits on, as the inbox stores it.

 [WorkflowRespondRequest](/api/tracon.workflowrespondrequest/)

Represents a response to a pending request.

 [WorkflowResponseClaim](/api/tracon.workflowresponseclaim/)

The outcome of recording an answer that may claim a request.

 [WorkflowResponseRecord](/api/tracon.workflowresponserecord/)

One answer to a workflow's pending human request.

 [WorkflowResumeRequest](/api/tracon.workflowresumerequest/)

The information needed to resume a workflow from a checkpoint.

 [WorkflowRunRequest](/api/tracon.workflowrunrequest/)

The information needed to run a workflow.

 [WorkspaceSettings](/api/tracon.workspacesettings/)

Settings for the session workspace of an agent: a file area that belongs to one
conversation, where the agent lists, reads, searches, writes, edits and deletes files.

## Structs

 [CallableAgentInfo](/api/tracon.callableagentinfo/)

The summary of a callable sub-agent, reported to the model.

 [ConversationBranch](/api/tracon.conversationbranch/)

A conversation branch's store-level result.

 [ResolvedCallableAgents](/api/tracon.resolvedcallableagents/)

The resolved set of sub-agents a definition may call, and its cache fingerprint.

 [RunEventDraft](/api/tracon.runeventdraft/)

Represents the information an event carries before its sequence number and
timestamp are assigned.

## Interfaces

 [IAgentCatalog](/api/tracon.iagentcatalog/)

The catalog that joins every agent source into a single view. The user interface
and the HTTP layer reach agents only through this interface.

 [IAgentDecorator](/api/tracon.iagentdecorator/)

A decorator applied to every agent resolved from the catalog. Tracon adds run
recording through this mechanism; a consumer can register its own decorator the
same way.

 [IAgentDefinitionStore](/api/tracon.iagentdefinitionstore/)

The store for agent definitions kept in the database. Versioning and rollback
support are required: every save produces a new version, and old versions are
not deleted.

 [IAgentExtension](/api/tracon.iagentextension/)

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](/api/tracon.iagentextension/#Tracon_IAgentExtension_Name) in [AgentDefinition.ExtensionNames](/api/tracon.agentdefinition/#Tracon_AgentDefinition_ExtensionNames).

 [IAgentSkillStore](/api/tracon.iagentskillstore/)

The store for a tenant's run-time skill definitions.

 [IAgentSource](/api/tracon.iagentsource/)

A source the catalog collects agents from. Tracon joins sources declared in
code, stored in the database, and registered by the application.

 [IApiKeyStore](/api/tracon.iapikeystore/)

The store for per-tenant API keys.

 [IArchiveSink](/api/tracon.iarchivesink/)

The cold-storage extension point rows are written to before deletion.

 [IAttachmentStorage](/api/tracon.iattachmentstorage/)

The extension point that stores attachment content in an external store (S3, Blob).

 [IAttachmentStore](/api/tracon.iattachmentstore/)

The contract for attachment metadata and for the default (database) content storage.

 [IAuditLog](/api/tracon.iauditlog/)

The audit trail log.

 [IContentGuard](/api/tracon.icontentguard/)

The extension point that inspects content going to and coming from the model.

 [IContentProtector](/api/tracon.icontentprotector/)

Extension point for at-rest encryption of stored content.

 [IConversationBranchStore](/api/tracon.iconversationbranchstore/)

The store that branches a conversation by copying it.

 [IDataSubjectResolver](/api/tracon.idatasubjectresolver/)

Maps a data subject (an end user, in the consumer's own identity system) to
the sessions, runs, and conversations that belong to them.

 [IDataSubjectStore](/api/tracon.idatasubjectstore/)

The data plane that counts, exports, and erases one data subject's content
across the schema.

 [IEvalEvaluatorFactory](/api/tracon.ievalevaluatorfactory/)

The extension point that builds the `AI.IAgentEvaluator` an eval
suite is graded with.

 [IEvalStore](/api/tracon.ievalstore/)

The store for evaluation (eval) suites, cases, and runs.

 [IExperimentStore](/api/tracon.iexperimentstore/)

Defines the store for A/B experiments.

 [IHostedToolSupport](/api/tracon.ihostedtoolsupport/)

An optional interface of an [IModelProvider](/api/tracon.imodelprovider/) that states which
[HostedToolKind](/api/tracon.hostedtoolkind/) values its API surface runs.

 [IIdempotencyStore](/api/tracon.iidempotencystore/)

The store for idempotency records.

 [IInboundTriggerStore](/api/tracon.iinboundtriggerstore/)

The store for inbound trigger definitions.

 [IJobDispatcher](/api/tracon.ijobdispatcher/)

Queues a job for a registered [IJobHandler](/api/tracon.ijobhandler/).

 [IJobHandler](/api/tracon.ijobhandler/)

The extension point that provides job execution logic for one handler key.

 [IJobScheduleStore](/api/tracon.ijobschedulestore/)

The store for schedule definitions.

 [IJobStore](/api/tracon.ijobstore/)

The store for queued jobs and their items.

 [ILiveVoiceProvider](/api/tracon.ilivevoiceprovider/)

Creates and supervises a provider-hosted live voice session.

 [ILiveVoiceSideband](/api/tracon.ilivevoicesideband/)

The server-side control connection of a live voice session.

 [IMcpServerStore](/api/tracon.imcpserverstore/)

The store for registered MCP servers.

 [IMigrationApplier](/api/tracon.imigrationapplier/)

Applies the pending migrations of the active SQL persistence provider.

 [IModelProvider](/api/tracon.imodelprovider/)

A model provider. Each provider is implemented in its own package (for
example, `Tracon.OpenAI`) and registered with DI.

 [IModelProviderConfigurationDiagnostics](/api/tracon.imodelproviderconfigurationdiagnostics/)

Defines optional configuration diagnostics for a model provider.

 [IModelProviderHealthCheck](/api/tracon.imodelproviderhealthcheck/)

The optional health-check contract for a model provider.

 [IModelProviderRegistry](/api/tracon.imodelproviderregistry/)

The registry that keeps registered model providers by name.

 [IPendingApprovalStore](/api/tracon.ipendingapprovalstore/)

The store for pending approval requests.

 [IProductionProfileCheck](/api/tracon.iproductionprofilecheck/)

Answers one production decision while the host starts, for
`RequireProductionProfile`.

 [IProviderRetryClassifier](/api/tracon.iproviderretryclassifier/)

Decides whether a model-provider failure is retryable on the next fallback link.

 [IQuotaStore](/api/tracon.iquotastore/)

The store for quota rules and consumption counters.

 [IResponseSchemaSupport](/api/tracon.iresponseschemasupport/)

An optional interface of an [IModelProvider](/api/tracon.imodelprovider/) that states which response schema its
client sends to the model for a binding.

 [IRetentionPolicyStore](/api/tracon.iretentionpolicystore/)

The control-plane store for retention policies and run history.

 [IRetentionStore](/api/tracon.iretentionstore/)

The data plane that counts, batch-deletes, and reads-for-archive over the
actual retention data.

 [IRunAttributionContext](/api/tracon.irunattributioncontext/)

Resolves who a run belongs to and what work it was made for.

 [IRunAuthorizationHandler](/api/tracon.irunauthorizationhandler/)

Decides whether a caller may start a run or read/write a session.

 [IRunCancellationRegistry](/api/tracon.iruncancellationregistry/)

The in-memory registry of runs in progress on this instance; binds an
incoming cancellation request to the running run's
[CancellationTokenSource](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtokensource).

 [IRunErrorClassifier](/api/tracon.irunerrorclassifier/)

Converts a raw run error into a class and a clustering fingerprint.

 [IRunEventSink](/api/tracon.iruneventsink/)

Receives run events as they are written, in addition to [IRunStore](/api/tracon.irunstore/).

 [IRunInputStore](/api/tracon.iruninputstore/)

Stores a run's input messages. The source of replay.

 [IRunJudge](/api/tracon.irunjudge/)

The extension point that scores a completed production run.

 [IRunPricingResolver](/api/tracon.irunpricingresolver/)

Computes the cost from a model+usage pair. Pricing order: the model
catalog, then the `Tracon:Pricing` configuration.

 [IRunScoreStore](/api/tracon.irunscorestore/)

The store for run and message scores ([RunScore](/api/tracon.runscore/)).

 [IRunStore](/api/tracon.irunstore/)

Store for run records and the event stream.

 [ISamplingSupport](/api/tracon.isamplingsupport/)

An optional interface of an [IModelProvider](/api/tracon.imodelprovider/) that states which
[SamplingFields](/api/tracon.samplingfields/) its API surface sends to the model.

 [ISessionStore](/api/tracon.isessionstore/)

The store for serialized agent sessions.

 [ISingletonLeaseStore](/api/tracon.isingletonleasestore/)

The lease store that keeps a named job running on a single instance across the
cluster.

 [ISkillScriptExecutor](/api/tracon.iskillscriptexecutor/)

Starts a skill script that already passed every execution gate, and reports
what it did. Register your own implementation to run scripts somewhere other
than the Tracon host: a container, a micro-VM, or a remote runner service.

 [ISkillScriptGrantStore](/api/tracon.iskillscriptgrantstore/)

The store for skill script execution grants.

 [ISpeechDialogueSynthesizer](/api/tracon.ispeechdialoguesynthesizer/)

A speech provider that voices a dialogue: an ordered list of turns, each spoken by its
own voice, in one request and one audio result.

 [ISpeechProviderResolver](/api/tracon.ispeechproviderresolver/)

Returns a speech provider by name, after the calling tenant's provider checks.

 [ISpeechSynthesizer](/api/tracon.ispeechsynthesizer/)

A provider that generates speech from text.

 [ISpeechTranscriber](/api/tracon.ispeechtranscriber/)

A provider that transcribes speech to text.

 [ISqlPersistenceDiagnostics](/api/tracon.isqlpersistencediagnostics/)

Defines optional diagnostics for the active SQL persistence provider.

 [IStructuredResponseValidator](/api/tracon.istructuredresponsevalidator/)

Validates a run's response against the agent's requested
[AgentResponseFormat](/api/tracon.agentresponseformat/) before the run closes.

 [ITenantContext](/api/tracon.itenantcontext/)

Resolves the current request's tenant. In a single-tenant setup, returns a
fixed value and requires no additional configuration.

 [ITenantCredentialModelProvider](/api/tracon.itenantcredentialmodelprovider/)

A model provider that can build clients from resolved per-tenant credentials.

 [ITenantEgressPolicyStore](/api/tracon.itenantegresspolicystore/)

The store for per-tenant provider egress policies.

 [ITenantProviderBindingStore](/api/tracon.itenantproviderbindingstore/)

The store for per-tenant model provider bindings (BYOK).

 [ITenantStore](/api/tracon.itenantstore/)

The store for tenant registrations.

 [IToolApprovalPresenter](/api/tracon.itoolapprovalpresenter/)

Resolves a human-readable presentation for a tool call that is about to publish an
approval request — turning, for example, `{ "orderId": "ORD-1001" }` into
"Cancel order for Priya Shah".

 [IToolApprovalRuleStore](/api/tracon.itoolapprovalrulestore/)

The store for persistent approval rules.

 [IToolArgumentsValidator](/api/tracon.itoolargumentsvalidator/)

Validates a tool call's arguments before the call runs.

 [IToolAuthorizationHandler](/api/tracon.itoolauthorizationhandler/)

Decides whether a tenant/user may call a specific tool.

 [IToolRegistry](/api/tracon.itoolregistry/)

The registry of tools registered in code.

 [ITraceStore](/api/tracon.itracestore/)

The store for persisted spans.

 [ITraconBuilder](/api/tracon.itraconbuilder/)

The fluent chain that configures Tracon. Returned from the
`AddTracon` call.

 [IVectorSearchStore](/api/tracon.ivectorsearchstore/)

The embedding-based semantic search store.

 [IVersionedAgentSource](/api/tracon.iversionedagentsource/)

An [IAgentSource](/api/tracon.iagentsource/) that can resolve a specific definition version. Only
sources that keep a version history implement it. A source without version history
need not implement this interface.

 [IVoiceHealthCheck](/api/tracon.ivoicehealthcheck/)

Checks the voice provider's reachability.

 [IVoicePricingReader](/api/tracon.ivoicepricingreader/)

Reads the configured voice model's pricing.

 [IVoiceSessionStore](/api/tracon.ivoicesessionstore/)

Stores the summary record of real-time voice connections.

 [IWebhookStore](/api/tracon.iwebhookstore/)

The store for webhook subscriptions and delivery history.

 [IWorkflowCheckpointStore](/api/tracon.iworkflowcheckpointstore/)

The store for workflow checkpoints.

 [IWorkflowDefinitionStore](/api/tracon.iworkflowdefinitionstore/)

The store for workflow definitions stored in the database. Every save produces a
new version, old versions are not deleted, and a rollback writes an old version's
content back as a new one.

 [IWorkflowRequestStore](/api/tracon.iworkflowrequeststore/)

The inbox of a tenant's open workflow requests: one row per request a run is waiting on,
with the time the request expires and whether somebody answered it.

 [IWorkflowResponseStore](/api/tracon.iworkflowresponsestore/)

Where the answers to a workflow's pending human requests are recorded: which run
answered which request of which run, who answered, and whether the single answer a
[WorkflowResponseMode.SingleAnswer](/api/tracon.workflowresponsemode/) workflow allows is already taken.

 [IWorkflowRunner](/api/tracon.iworkflowrunner/)

Reads the workflow catalog and runs workflows.

## Enums

 [AgentDefinitionOrigin](/api/tracon.agentdefinitionorigin/)

Tells where an agent definition came from.

 [AgentParameterKind](/api/tracon.agentparameterkind/)

The data kind of an [AgentParameter](/api/tracon.agentparameter/).

 [AgentResponseFormatKind](/api/tracon.agentresponseformatkind/)

The requested format of an agent response.

 [ApiKeyScope](/api/tracon.apikeyscope/)

An authority scope an API key may open.

 [ApprovalStatus](/api/tracon.approvalstatus/)

The status of a pending approval request.

 [AuditChainStatus](/api/tracon.auditchainstatus/)

The result of walking a tenant's audit trail hash chain.

 [ChatClientSlot](/api/tracon.chatclientslot/)

Where a chat client ring that an agent extension adds sits in the agent's model pipeline.

 [CompactionStrategyKind](/api/tracon.compactionstrategykind/)

The kind of context compaction strategy that can be bound to an agent definition.

 [ContentGuardAction](/api/tracon.contentguardaction/)

The decision a guard can make.

 [ContentGuardDirection](/api/tracon.contentguarddirection/)

The direction of a content guard check.

 [ContentGuardSource](/api/tracon.contentguardsource/)

Where the text handed to an [IContentGuard](/api/tracon.icontentguard/) came from.

 [ConversationMemorySearch](/api/tracon.conversationmemorysearch/)

When an agent searches its conversation memory (`EnableConversationMemory`).

 [EvalCaseDiffKind](/api/tracon.evalcasediffkind/)

The bucket an aligned case falls into within an [EvalRunDiff](/api/tracon.evalrundiff/).

 [EvalCaseSource](/api/tracon.evalcasesource/)

The reason an [EvalCase](/api/tracon.evalcase/) was promoted from a production run.

 [EvalRunDiffUnavailableReason](/api/tracon.evalrundiffunavailablereason/)

Why two eval runs cannot be compared.

 [EvalRunStatus](/api/tracon.evalrunstatus/)

The status of an eval run.

 [ExperimentStatus](/api/tracon.experimentstatus/)

Defines the lifecycle status of an A/B experiment.

 [GoogleDialogueSpeakerMode](/api/tracon.googledialoguespeakermode/)

How a Gemini dialogue request names its speakers.

 [HostedToolKind](/api/tracon.hostedtoolkind/)

The kinds of tool a model provider runs on its own side, which a host registers in code
with `AddHostedTool`.

 [HostedToolKinds](/api/tracon.hostedtoolkinds/)

The [HostedToolKind](/api/tracon.hostedtoolkind/) values a provider's API surface can run, as a set.

 [IdempotencyState](/api/tracon.idempotencystate/)

The four possible states of an idempotency key.

 [InboundTriggerPayloadMode](/api/tracon.inboundtriggerpayloadmode/)

How an inbound trigger's request body becomes the agent/workflow message.

 [InboundTriggerTargetKind](/api/tracon.inboundtriggertargetkind/)

What kind of target an inbound trigger fires.

 [JobItemStatus](/api/tracon.jobitemstatus/)

The status of a batch job item.

 [JobStatus](/api/tracon.jobstatus/)

The status of a queued job.

 [LiveVoiceAppendChannel](/api/tracon.livevoiceappendchannel/)

The channel a live append is written to.

 [LiveVoiceDelegationMode](/api/tracon.livevoicedelegationmode/)

How a live model hands heavier work back.

 [LiveVoiceEventKind](/api/tracon.livevoiceeventkind/)

What a live voice sideband event says.

 [LoopOutcome](/api/tracon.loopoutcome/)

What a harness loop does when it ends without every criterion satisfied: return
the last response, or fail the run.

 [McpOAuthAuthorizationMode](/api/tracon.mcpoauthauthorizationmode/)

The MCP OAuth authorization flow.

 [McpTransportMode](/api/tracon.mcptransportmode/)

The way a connection to an MCP server is made.

 [ModelProviderHealthStatus](/api/tracon.modelproviderhealthstatus/)

A provider's checked reachability status.

 [PiiPatterns](/api/tracon.piipatterns/)

The built-in pattern families for [Tracon.PatternContentGuard](/api/tracon/).

 [PricingSource](/api/tracon.pricingsource/)

Reports where a run's cost pricing came from.

 [ProductionProfileState](/api/tracon.productionprofilestate/)

What a production profile check found.

 [ProtectedColumn](/api/tracon.protectedcolumn/)

A database column [IContentProtector](/api/tracon.icontentprotector/) can be applied to.

 [ProviderRetryDecision](/api/tracon.providerretrydecision/)

Whether a provider failure should move to the next fallback link.

 [QuotaMetric](/api/tracon.quotametric/)

The metric a quota is exceeded by.

 [QuotaPeriod](/api/tracon.quotaperiod/)

The interval at which a quota's counter resets.

 [RateLimitPartitionKind](/api/tracon.ratelimitpartitionkind/)

Which key the rate limit is partitioned by.

 [ReplayToolMode](/api/tracon.replaytoolmode/)

How tools are handled during replay.

 [RunAccess](/api/tracon.runaccess/)

The kind of access a [RunAuthorizationRequest](/api/tracon.runauthorizationrequest/) asks about.

 [RunErrorClass](/api/tracon.runerrorclass/)

A run error's class.

 [RunEventType](/api/tracon.runeventtype/)

Event types produced during a run. The user interface maps these directly onto
visual elements, so the values must stay stable.

 [RunKind](/api/tracon.runkind/)

Reports what a `runs` row records.

 [RunScoreBucket](/api/tracon.runscorebucket/)

A closed, low-cardinality set of time buckets for a score trend series.

 [RunScoreKind](/api/tracon.runscorekind/)

The shape of the value a [RunScore](/api/tracon.runscore/) carries.

 [RunScoreTarget](/api/tracon.runscoretarget/)

Which target a score belongs to — the filter [RunScoreQuery.Target](/api/tracon.runscorequery/#Tracon_RunScoreQuery_Target) narrows to.

 [RunStatus](/api/tracon.runstatus/)

Status of a run.

 [SamplingFields](/api/tracon.samplingfields/)

The request fields of [ModelBinding](/api/tracon.modelbinding/) whose support depends on the
provider's API surface.

 [SessionAccess](/api/tracon.sessionaccess/)

The kind of access a [SessionAuthorizationRequest](/api/tracon.sessionauthorizationrequest/) asks about.

 [SkillScriptOrigin](/api/tracon.skillscriptorigin/)

Where the content of a skill script came from.

 [SpeechProviderKind](/api/tracon.speechproviderkind/)

The kind of a registered speech provider.

 [SpeechUsageSource](/api/tracon.speechusagesource/)

The source of a speech measurement.

 [SubAgentCallMode](/api/tracon.subagentcallmode/)

How an agent calls the agents it may call (`CallableAgents`).

 [TimeSeriesBucket](/api/tracon.timeseriesbucket/)

The bucket width for a time-series query.

 [ToolApprovalPolicyDecision](/api/tracon.toolapprovalpolicydecision/)

The outcome of a code-defined approval policy ([ToolApprovalContext](/api/tracon.toolapprovalcontext/)).

 [ToolArgumentOperator](/api/tracon.toolargumentoperator/)

A comparison operator for a [ToolArgumentCondition](/api/tracon.toolargumentcondition/).

 [ToolEffect](/api/tracon.tooleffect/)

Classifies the blast radius of a tool call.

 [ToolInputAction](/api/tracon.toolinputaction/)

What the user did with a request for input that suspended a tool call.

 [TraceSpanKind](/api/tracon.tracespankind/)

A span's OpenTelemetry kind. Values are stored in the database as
`smallint`; the numbers are stable.

 [TraceSpanStatus](/api/tracon.tracespanstatus/)

A span's result status. `smallint` in the database.

 [TraconProductionRisk](/api/tracon.traconproductionrisk/)

One production decision the profile gate refuses to leave unanswered.

 [VoiceSessionEndReason](/api/tracon.voicesessionendreason/)

The reason a voice connection closed.

 [WebhookDeliveryStatus](/api/tracon.webhookdeliverystatus/)

The status of a webhook delivery attempt.

 [WorkflowEdgeKind](/api/tracon.workflowedgekind/)

Represents the kind of an edge.

 [WorkflowKind](/api/tracon.workflowkind/)

Represents the built-in workflow patterns that can be defined through the
UI.

 [WorkflowNodeKind](/api/tracon.workflownodekind/)

Represents the role of a graph node.

 [WorkflowRequestForm](/api/tracon.workflowrequestform/)

Defines how the UI presents a pending request.

 [WorkflowRequestState](/api/tracon.workflowrequeststate/)

Which of the open human requests of a tenant a listing returns.

 [WorkflowRequestStatus](/api/tracon.workflowrequeststatus/)

Whether a run still waits on a request.

 [WorkflowResponseMode](/api/tracon.workflowresponsemode/)

How a workflow treats more than one answer to the same pending human request.

 [WorkflowResponseStatus](/api/tracon.workflowresponsestatus/)

The state of a recorded answer.
