# Tracon.Abstractions

> 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-abstractions/
> Summary: Public types shipped by Tracon.Abstractions, generated from the compiled assembly and its XML documentation.

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

| Type | Kind | Purpose |
|---|---|---|
| [`AgentDefinition`](/api/tracon.agentdefinition/) | Class | 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 tells the two apart. |
| [`AgentDefinitionOrigin`](/api/tracon.agentdefinitionorigin/) | Enum | Tells where an agent definition came from. |
| [`AgentDescriptor`](/api/tracon.agentdescriptor/) | Class | 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. |
| [`AgentParameter`](/api/tracon.agentparameter/) | Class | A single named placeholder an AgentDefinition's instructions can reference as {{name}}. |
| [`AgentParameterKind`](/api/tracon.agentparameterkind/) | Enum | The data kind of an AgentParameter. |
| [`AgentResponseFormat`](/api/tracon.agentresponseformat/) | Class | The definition of a structured output. |
| [`AgentResponseFormatKind`](/api/tracon.agentresponseformatkind/) | Enum | The requested format of an agent response. |
| [`AgentRunBudget`](/api/tracon.agentrunbudget/) | Class | A run budget shared across an entire call tree. |
| [`AgentRunDocument`](/api/tracon.agentrundocument/) | Class | A piece of reference text attached to a single run, kept apart from the model's instructions. |
| [`AgentSkillDefinition`](/api/tracon.agentskilldefinition/) | Class | A markdown-based skill definition that can be loaded into an agent at run time. |
| [`AgentSkillResourceDefinition`](/api/tracon.agentskillresourcedefinition/) | Class | A readable resource carried with an AgentSkillDefinition. |
| [`AgentSkillScriptDefinition`](/api/tracon.agentskillscriptdefinition/) | Class | A server-executable script stored together with an AgentSkillDefinition. |
| [`AgentSourceDiagnostic`](/api/tracon.agentsourcediagnostic/) | Class | Describes one agent source registered in the catalog. |
| [`AgentSourcePriority`](/api/tracon.agentsourcepriority/) | Class | The priority values Tracon's own built-in agent sources use. |
| [`AmbientRunAttributionScope`](/api/tracon.ambientrunattributionscope/) | Class | 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/) | Class | The ambient passing mechanism for running an operation executed in the background (outside an HTTP request) as a specific tenant. |
| [`ApiKeyCreationResult`](/api/tracon.apikeycreationresult/) | Class | The result of a key creation operation. |
| [`ApiKeyDraft`](/api/tracon.apikeydraft/) | Class | A draft for creating an API key. |
| [`ApiKeyGenerator`](/api/tracon.apikeygenerator/) | Class | A helper that produces a raw API key value and its hash. |
| [`ApiKeyRecord`](/api/tracon.apikeyrecord/) | Class | An API key's database-stored view, which CARRIES no raw VALUE. |
| [`ApiKeyScope`](/api/tracon.apikeyscope/) | Enum | An authority scope an API key may open. |
| [`ApprovalStatus`](/api/tracon.approvalstatus/) | Enum | The status of a pending approval request. |
| [`ArchiveRow`](/api/tracon.archiverow/) | Class | The JSON representation of a single row to write to the archive. |
| [`AttachmentContent`](/api/tracon.attachmentcontent/) | Class | The content of a new attachment to be saved into the store. |
| [`AttachmentDescriptor`](/api/tracon.attachmentdescriptor/) | Class | The metadata of an uploaded attachment. |
| [`AttachmentQuery`](/api/tracon.attachmentquery/) | Class | The filter used to list attachments. |
| [`AuditChainQuery`](/api/tracon.auditchainquery/) | Class | The criteria that scope a hash chain verification. |
| [`AuditChainStatus`](/api/tracon.auditchainstatus/) | Enum | The result of walking a tenant's audit trail hash chain. |
| [`AuditChainVerification`](/api/tracon.auditchainverification/) | Class | The result of verifying one tenant's audit trail hash chain. |
| [`AuditEntry`](/api/tracon.auditentry/) | Class | A row in the audit trail that records who changed which entity and when. |
| [`AuditQuery`](/api/tracon.auditquery/) | Class | The criteria that filter an audit trail query. |
| [`CallableAgentReference`](/api/tracon.callableagentreference/) | Class | One agent another agent may call, and the version of it that runs. |
| [`CanaryPolicy`](/api/tracon.canarypolicy/) | Class | Defines automatic rollback and gradual traffic-increase rules for an experiment canary variant. |
| [`CompactionSettings`](/api/tracon.compactionsettings/) | Class | Determines how an agent compacts its conversation history. |
| [`CompactionStrategyKind`](/api/tracon.compactionstrategykind/) | Enum | The kind of context compaction strategy that can be bound to an agent definition. |
| [`ConfigurationDiagnostic`](/api/tracon.configurationdiagnostic/) | Class | Reports whether a configuration key resolves. It does not carry the value. |
| [`ContentGuardAction`](/api/tracon.contentguardaction/) | Enum | The decision a guard can make. |
| [`ContentGuardContext`](/api/tracon.contentguardcontext/) | Class | The context of an IContentGuard call. |
| [`ContentGuardDirection`](/api/tracon.contentguarddirection/) | Enum | The direction of a content guard check. |
| [`ContentGuardResult`](/api/tracon.contentguardresult/) | Class | The result of an IContentGuard check. |
| [`ContentGuardSource`](/api/tracon.contentguardsource/) | Enum | Where the text handed to an IContentGuard came from. |
| [`ConversationBranch`](/api/tracon.conversationbranch/) | Struct | A conversation branch's store-level result. |
| [`ConversationMemorySearch`](/api/tracon.conversationmemorysearch/) | Enum | When an agent searches its conversation memory (EnableConversationMemory). |
| [`DataSubjectExport`](/api/tracon.datasubjectexport/) | Class | A data subject's exported content. |
| [`DataSubjectScope`](/api/tracon.datasubjectscope/) | Class | The sessions, runs, and conversations that belong to one data subject. |
| [`EvalCase`](/api/tracon.evalcase/) | Class | A single test case inside an EvalSuite. |
| [`EvalCaseAddResult`](/api/tracon.evalcaseaddresult/) | Class | The result of IEvalStore.AddCaseAsync. |
| [`EvalCaseDiff`](/api/tracon.evalcasediff/) | Class | One case's outcome on both sides of an EvalRunDiff. |
| [`EvalCaseDiffKind`](/api/tracon.evalcasediffkind/) | Enum | The bucket an aligned case falls into within an EvalRunDiff. |
| [`EvalCaseDraft`](/api/tracon.evalcasedraft/) | Class | Carrier for adding a single EvalCase. |
| [`EvalCaseResult`](/api/tracon.evalcaseresult/) | Class | The result of a single EvalCase within an EvalRun. |
| [`EvalCaseSource`](/api/tracon.evalcasesource/) | Enum | The reason an EvalCase was promoted from a production run. |
| [`EvalExpectedToolCall`](/api/tracon.evalexpectedtoolcall/) | Class | A tool call an EvalCase expects the agent to make. |
| [`EvalRun`](/api/tracon.evalrun/) | Class | A single execution record and summary of an EvalSuite. |
| [`EvalRunCompletion`](/api/tracon.evalruncompletion/) | Class | The information needed to finalize a run. |
| [`EvalRunDiff`](/api/tracon.evalrundiff/) | Class | The case-by-case difference between two completed EvalRun records of the same suite. |
| [`EvalRunDiffBuilder`](/api/tracon.evalrundiffbuilder/) | Class | Aligns two eval runs' per-case results into an EvalRunDiff. |
| [`EvalRunDiffQuery`](/api/tracon.evalrundiffquery/) | Class | Which two eval runs to compare, and which page of the result to read. |
| [`EvalRunDiffUnavailableException`](/api/tracon.evalrundiffunavailableexception/) | Class | Thrown by IEvalStore.DiffRunsAsync when two eval runs exist but cannot be compared. |
| [`EvalRunDiffUnavailableReason`](/api/tracon.evalrundiffunavailablereason/) | Enum | Why two eval runs cannot be compared. |
| [`EvalRunQuery`](/api/tracon.evalrunquery/) | Class | A query for filtering the run list. |
| [`EvalRunStatus`](/api/tracon.evalrunstatus/) | Enum | The status of an eval run. |
| [`EvalSuite`](/api/tracon.evalsuite/) | Class | An evaluation (eval) suite defined for an agent: carries which agent is measured, with which checks. |
| [`Experiment`](/api/tracon.experiment/) | Class | Represents an A/B experiment that splits traffic between two or more definition versions of the same agent. |
| [`ExperimentResultsQuery`](/api/tracon.experimentresultsquery/) | Class | Defines a query for experiment results. |
| [`ExperimentStatus`](/api/tracon.experimentstatus/) | Enum | Defines the lifecycle status of an A/B experiment. |
| [`ExperimentVariant`](/api/tracon.experimentvariant/) | Class | Defines one experiment variant: its definition version and traffic weight. |
| [`ExperimentVariantResult`](/api/tracon.experimentvariantresult/) | Class | Summarizes run results for an experiment variant (calculated in the store). |
| [`ExtensionPointDiagnostic`](/api/tracon.extensionpointdiagnostic/) | Class | One host-bound extension point and whether the host replaced its built-in default. |
| [`GeneratedApiKey`](/api/tracon.generatedapikey/) | Class | The generated raw API key value and its derived forms. |
| [`HarnessSettings`](/api/tracon.harnesssettings/) | Class | Settings for the harness capabilities. It mirrors a safe subset of the HarnessAgentOptions structure of Microsoft Agent Framework. |
| [`HostedToolContext`](/api/tracon.hostedtoolcontext/) | Class | What the factory of a hosted tool (AddHostedTool) learns about the agent it builds the tool for. |
| [`HostedToolKind`](/api/tracon.hostedtoolkind/) | Enum | The kinds of tool a model provider runs on its own side, which a host registers in code with AddHostedTool. |
| [`HostedToolKinds`](/api/tracon.hostedtoolkinds/) | Enum | The HostedToolKind values a provider's API surface can run, as a set. |
| [`IAgentCatalog`](/api/tracon.iagentcatalog/) | Interface | 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/) | Interface | 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. |
| [`IAgentDefinitionStore`](/api/tracon.iagentdefinitionstore/) | Interface | 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. |
| [`IAgentSkillStore`](/api/tracon.iagentskillstore/) | Interface | The store for a tenant's run-time skill definitions. |
| [`IAgentSource`](/api/tracon.iagentsource/) | Interface | 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/) | Interface | The store for per-tenant API keys. |
| [`IArchiveSink`](/api/tracon.iarchivesink/) | Interface | The cold-storage extension point rows are written to before deletion. |
| [`IAttachmentStorage`](/api/tracon.iattachmentstorage/) | Interface | The extension point that stores attachment content in an external store (S3, Blob). |
| [`IAttachmentStore`](/api/tracon.iattachmentstore/) | Interface | The contract for attachment metadata and for the default (database) content storage. |
| [`IAuditLog`](/api/tracon.iauditlog/) | Interface | The audit trail log. |
| [`IContentGuard`](/api/tracon.icontentguard/) | Interface | The extension point that inspects content going to and coming from the model. |
| [`IContentProtector`](/api/tracon.icontentprotector/) | Interface | Extension point for at-rest encryption of stored content. |
| [`IConversationBranchStore`](/api/tracon.iconversationbranchstore/) | Interface | The store that branches a conversation by copying it. |
| [`IDataSubjectResolver`](/api/tracon.idatasubjectresolver/) | Interface | 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/) | Interface | The data plane that counts, exports, and erases one data subject's content across the schema. |
| [`IdempotencyRequest`](/api/tracon.idempotencyrequest/) | Class | An idempotency reservation request. |
| [`IdempotencyReservation`](/api/tracon.idempotencyreservation/) | Class | The result of an IIdempotencyStore.ReserveAsync call. |
| [`IdempotencyResponse`](/api/tracon.idempotencyresponse/) | Class | The stored HTTP response. |
| [`IdempotencyState`](/api/tracon.idempotencystate/) | Enum | The four possible states of an idempotency key. |
| [`IEvalStore`](/api/tracon.ievalstore/) | Interface | The store for evaluation (eval) suites, cases, and runs. |
| [`IExperimentStore`](/api/tracon.iexperimentstore/) | Interface | Defines the store for A/B experiments. |
| [`IHostedToolSupport`](/api/tracon.ihostedtoolsupport/) | Interface | An optional interface of an IModelProvider that states which HostedToolKind values its API surface runs. |
| [`IIdempotencyStore`](/api/tracon.iidempotencystore/) | Interface | The store for idempotency records. |
| [`IInboundTriggerStore`](/api/tracon.iinboundtriggerstore/) | Interface | The store for inbound trigger definitions. |
| [`IJobDispatcher`](/api/tracon.ijobdispatcher/) | Interface | Queues a job for a registered IJobHandler. |
| [`IJobHandler`](/api/tracon.ijobhandler/) | Interface | The extension point that provides job execution logic for one handler key. |
| [`IJobScheduleStore`](/api/tracon.ijobschedulestore/) | Interface | The store for schedule definitions. |
| [`IJobStore`](/api/tracon.ijobstore/) | Interface | The store for queued jobs and their items. |
| [`ILiveVoiceProvider`](/api/tracon.ilivevoiceprovider/) | Interface | Creates and supervises a provider-hosted live voice session. |
| [`ILiveVoiceSideband`](/api/tracon.ilivevoicesideband/) | Interface | The server-side control connection of a live voice session. |
| [`IMcpServerStore`](/api/tracon.imcpserverstore/) | Interface | The store for registered MCP servers. |
| [`IMigrationApplier`](/api/tracon.imigrationapplier/) | Interface | Applies the pending migrations of the active SQL persistence provider. |
| [`IModelProvider`](/api/tracon.imodelprovider/) | Interface | A model provider. Each provider is implemented in its own package (for example, Tracon.OpenAI) and registered with DI. |
| [`IModelProviderConfigurationDiagnostics`](/api/tracon.imodelproviderconfigurationdiagnostics/) | Interface | Defines optional configuration diagnostics for a model provider. |
| [`IModelProviderHealthCheck`](/api/tracon.imodelproviderhealthcheck/) | Interface | The optional health-check contract for a model provider. |
| [`IModelProviderRegistry`](/api/tracon.imodelproviderregistry/) | Interface | The registry that keeps registered model providers by name. |
| [`InboundTrigger`](/api/tracon.inboundtrigger/) | Class | An inbound trigger definition: an external event that starts a queued run. |
| [`InboundTriggerPayloadMode`](/api/tracon.inboundtriggerpayloadmode/) | Enum | How an inbound trigger's request body becomes the agent/workflow message. |
| [`InboundTriggerTargetKind`](/api/tracon.inboundtriggertargetkind/) | Enum | What kind of target an inbound trigger fires. |
| [`IPendingApprovalStore`](/api/tracon.ipendingapprovalstore/) | Interface | The store for pending approval requests. |
| [`IProductionProfileCheck`](/api/tracon.iproductionprofilecheck/) | Interface | Answers one production decision while the host starts, for RequireProductionProfile. |
| [`IProviderRetryClassifier`](/api/tracon.iproviderretryclassifier/) | Interface | Decides whether a model-provider failure is retryable on the next fallback link. |
| [`IQuotaStore`](/api/tracon.iquotastore/) | Interface | The store for quota rules and consumption counters. |
| [`IResponseSchemaSupport`](/api/tracon.iresponseschemasupport/) | Interface | An optional interface of an IModelProvider that states which response schema its client sends to the model for a binding. |
| [`IRetentionPolicyStore`](/api/tracon.iretentionpolicystore/) | Interface | The control-plane store for retention policies and run history. |
| [`IRetentionStore`](/api/tracon.iretentionstore/) | Interface | The data plane that counts, batch-deletes, and reads-for-archive over the actual retention data. |
| [`IRunAttributionContext`](/api/tracon.irunattributioncontext/) | Interface | Resolves who a run belongs to and what work it was made for. |
| [`IRunAuthorizationHandler`](/api/tracon.irunauthorizationhandler/) | Interface | Decides whether a caller may start a run or read/write a session. |
| [`IRunCancellationRegistry`](/api/tracon.iruncancellationregistry/) | Interface | The in-memory registry of runs in progress on this instance; binds an incoming cancellation request to the running run's Threading.CancellationTokenSource. |
| [`IRunErrorClassifier`](/api/tracon.irunerrorclassifier/) | Interface | Converts a raw run error into a class and a clustering fingerprint. |
| [`IRunEventSink`](/api/tracon.iruneventsink/) | Interface | Receives run events as they are written, in addition to IRunStore. |
| [`IRunInputStore`](/api/tracon.iruninputstore/) | Interface | Stores a run's input messages. The source of replay. |
| [`IRunJudge`](/api/tracon.irunjudge/) | Interface | The extension point that scores a completed production run. |
| [`IRunPricingResolver`](/api/tracon.irunpricingresolver/) | Interface | Computes the cost from a model+usage pair. Pricing order: the model catalog, then the Tracon:Pricing configuration. |
| [`IRunScoreStore`](/api/tracon.irunscorestore/) | Interface | The store for run and message scores (RunScore). |
| [`IRunStore`](/api/tracon.irunstore/) | Interface | Store for run records and the event stream. |
| [`ISamplingSupport`](/api/tracon.isamplingsupport/) | Interface | An optional interface of an IModelProvider that states which SamplingFields its API surface sends to the model. |
| [`ISessionStore`](/api/tracon.isessionstore/) | Interface | The store for serialized agent sessions. |
| [`ISingletonLeaseStore`](/api/tracon.isingletonleasestore/) | Interface | The lease store that keeps a named job running on a single instance across the cluster. |
| [`ISkillScriptExecutor`](/api/tracon.iskillscriptexecutor/) | Interface | 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. |
| [`ISkillScriptGrantStore`](/api/tracon.iskillscriptgrantstore/) | Interface | The store for skill script execution grants. |
| [`ISpeechDialogueSynthesizer`](/api/tracon.ispeechdialoguesynthesizer/) | Interface | 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/) | Interface | Returns a speech provider by name, after the calling tenant's provider checks. |
| [`ISpeechSynthesizer`](/api/tracon.ispeechsynthesizer/) | Interface | A provider that generates speech from text. |
| [`ISpeechTranscriber`](/api/tracon.ispeechtranscriber/) | Interface | A provider that transcribes speech to text. |
| [`ISqlPersistenceDiagnostics`](/api/tracon.isqlpersistencediagnostics/) | Interface | Defines optional diagnostics for the active SQL persistence provider. |
| [`IStructuredResponseValidator`](/api/tracon.istructuredresponsevalidator/) | Interface | Validates a run's response against the agent's requested AgentResponseFormat before the run closes. |
| [`ITenantContext`](/api/tracon.itenantcontext/) | Interface | Resolves the current request's tenant. In a single-tenant setup, returns a fixed value and requires no additional configuration. |
| [`ITenantCredentialModelProvider`](/api/tracon.itenantcredentialmodelprovider/) | Interface | A model provider that can build clients from resolved per-tenant credentials. |
| [`ITenantEgressPolicyStore`](/api/tracon.itenantegresspolicystore/) | Interface | The store for per-tenant provider egress policies. |
| [`ITenantProviderBindingStore`](/api/tracon.itenantproviderbindingstore/) | Interface | The store for per-tenant model provider bindings (BYOK). |
| [`ITenantStore`](/api/tracon.itenantstore/) | Interface | The store for tenant registrations. |
| [`IToolApprovalPresenter`](/api/tracon.itoolapprovalpresenter/) | Interface | Resolves a human-readable presentation for a tool call that is about to publish an approval request — turning, for example, { "orderId": "ORD-1001" } into. |
| [`IToolApprovalRuleStore`](/api/tracon.itoolapprovalrulestore/) | Interface | The store for persistent approval rules. |
| [`IToolArgumentsValidator`](/api/tracon.itoolargumentsvalidator/) | Interface | Validates a tool call's arguments before the call runs. |
| [`IToolAuthorizationHandler`](/api/tracon.itoolauthorizationhandler/) | Interface | Decides whether a tenant/user may call a specific tool. |
| [`IToolRegistry`](/api/tracon.itoolregistry/) | Interface | The registry of tools registered in code. |
| [`ITraceStore`](/api/tracon.itracestore/) | Interface | The store for persisted spans. |
| [`IVectorSearchStore`](/api/tracon.ivectorsearchstore/) | Interface | The embedding-based semantic search store. |
| [`IVersionedAgentSource`](/api/tracon.iversionedagentsource/) | Interface | An IAgentSource that can resolve a specific definition version. Only sources that keep a version history implement it. A source without version history need not. |
| [`IVoiceHealthCheck`](/api/tracon.ivoicehealthcheck/) | Interface | Checks the voice provider's reachability. |
| [`IVoicePricingReader`](/api/tracon.ivoicepricingreader/) | Interface | Reads the configured voice model's pricing. |
| [`IVoiceSessionStore`](/api/tracon.ivoicesessionstore/) | Interface | Stores the summary record of real-time voice connections. |
| [`IWebhookStore`](/api/tracon.iwebhookstore/) | Interface | The store for webhook subscriptions and delivery history. |
| [`IWorkflowCheckpointStore`](/api/tracon.iworkflowcheckpointstore/) | Interface | The store for workflow checkpoints. |
| [`IWorkflowDefinitionStore`](/api/tracon.iworkflowdefinitionstore/) | Interface | 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. |
| [`IWorkflowRequestStore`](/api/tracon.iworkflowrequeststore/) | Interface | 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/) | Interface | 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. |
| [`IWorkflowRunner`](/api/tracon.iworkflowrunner/) | Interface | Reads the workflow catalog and runs workflows. |
| [`JobCompletion`](/api/tracon.jobcompletion/) | Class | The information needed to finalize a job. |
| [`JobContext`](/api/tracon.jobcontext/) | Class | The context available during an IJobHandler execution. |
| [`JobErrorCodes`](/api/tracon.joberrorcodes/) | Class | The stable codes a job's JobRecord.ErrorMessage carries when the failure comes from the queue itself rather than from a handler. |
| [`JobHandlerKeys`](/api/tracon.jobhandlerkeys/) | Class | The built-in job handler keys, plus validation for the keys a consumer registers. |
| [`JobItemRecord`](/api/tracon.jobitemrecord/) | Class | A single input of a batch job and that input's processing result. |
| [`JobItemResult`](/api/tracon.jobitemresult/) | Class | The result of a processed job item. Reported with IJobStore.ReportItemAsync. |
| [`JobItemStatus`](/api/tracon.jobitemstatus/) | Enum | The status of a batch job item. |
| [`JobLanes`](/api/tracon.joblanes/) | Class | Well-known values and validation for job lane identifiers. |
| [`JobLeaseRequest`](/api/tracon.jobleaserequest/) | Class | What a worker asks of IJobStore.LeaseAsync: who it is, how long the lease lasts, which lanes it serves and, optionally, a per-tenant ceiling. |
| [`JobQuery`](/api/tracon.jobquery/) | Class | A filter for querying the job list. |
| [`JobQueueDepth`](/api/tracon.jobqueuedepth/) | Class | The number of open jobs in one lane/status pair. |
| [`JobRecord`](/api/tracon.jobrecord/) | Class | The summary of a queued job. The header of its items (JobItemRecord). |
| [`JobRequest`](/api/tracon.jobrequest/) | Class | The description of one job to queue through IJobDispatcher. |
| [`JobRetryException`](/api/tracon.jobretryexception/) | Class | The exception an IJobHandler throws to signal that it wants the job retried after a specific delay. |
| [`JobSchedule`](/api/tracon.jobschedule/) | Class | The schedule record defining when and how a job runs. |
| [`JobStatus`](/api/tracon.jobstatus/) | Enum | The status of a queued job. |
| [`JobTenantCap`](/api/tracon.jobtenantcap/) | Class | 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/) | Class | One named score produced by an IRunJudge. |
| [`LateToolCompletion`](/api/tracon.latetoolcompletion/) | Class | The settled outcome of a tool call whose timeout had already been reported. |
| [`LiveVoiceAppend`](/api/tracon.livevoiceappend/) | Class | Text sent into a live conversation's context. |
| [`LiveVoiceAppendChannel`](/api/tracon.livevoiceappendchannel/) | Enum | The channel a live append is written to. |
| [`LiveVoiceAttachRequest`](/api/tracon.livevoiceattachrequest/) | Class | The request that attaches the server-side control connection to a live voice session. |
| [`LiveVoiceCreateRequest`](/api/tracon.livevoicecreaterequest/) | Class | The request that creates a live voice session. |
| [`LiveVoiceDelegationMode`](/api/tracon.livevoicedelegationmode/) | Enum | How a live model hands heavier work back. |
| [`LiveVoiceEvent`](/api/tracon.livevoiceevent/) | Class | One event observed on a live voice session's sideband. |
| [`LiveVoiceEventKind`](/api/tracon.livevoiceeventkind/) | Enum | What a live voice sideband event says. |
| [`LiveVoiceSessionHandle`](/api/tracon.livevoicesessionhandle/) | Class | The result of creating a live voice session. |
| [`LiveVoiceSessionOptions`](/api/tracon.livevoicesessionoptions/) | Class | The settings of one live voice session. |
| [`LoopCriterion`](/api/tracon.loopcriterion/) | Class | One declarative stop criterion of the harness loop (see LoopSettings). |
| [`LoopOutcome`](/api/tracon.loopoutcome/) | Enum | What a harness loop does when it ends without every criterion satisfied: return the last response, or fail the run. |
| [`LoopSettings`](/api/tracon.loopsettings/) | Class | Turns the harness loop on: the agent is re-invoked until a stop criterion says the work is finished. |
| [`McpOAuthAuthorizationMode`](/api/tracon.mcpoauthauthorizationmode/) | Enum | The MCP OAuth authorization flow. |
| [`McpServerDefinition`](/api/tracon.mcpserverdefinition/) | Class | A registered remote MCP server. Its tools are discovered at connection time and listed alongside the tools registered in code. |
| [`McpTransportMode`](/api/tracon.mcptransportmode/) | Enum | The way a connection to an MCP server is made. |
| [`MemorySettings`](/api/tracon.memorysettings/) | Class | Determines the memory providers bound to an agent. |
| [`ModelBinding`](/api/tracon.modelbinding/) | Class | 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/) | Class | A model's capabilities and limits. |
| [`ModelFallback`](/api/tracon.modelfallback/) | Class | One link of a ModelBinding.Fallbacks chain. |
| [`ModelOutputLimit`](/api/tracon.modeloutputlimit/) | Class | The output token limit a provider's chat client sends when ModelBinding.MaxOutputTokens is empty. |
| [`ModelProviderCredential`](/api/tracon.modelprovidercredential/) | Class | 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/) | Class | A provider's definition as shown in the UI. |
| [`ModelProviderHealth`](/api/tracon.modelproviderhealth/) | Class | A model provider's status at the last check. |
| [`ModelProviderHealthStatus`](/api/tracon.modelproviderhealthstatus/) | Enum | A provider's checked reachability status. |
| [`ModelProviderSettings`](/api/tracon.modelprovidersettings/) | Class | Helpers that read and validate a provider settings dictionary: the ModelBinding.ProviderSettings of a model binding, and the ProviderSettings of a speech request. |
| [`NonTokenUsageRecord`](/api/tracon.nontokenusagerecord/) | Class | One non-token item a workflow function node reported: the persistent record behind GET /api/runs/{runId}/usage. |
| [`PendingApproval`](/api/tracon.pendingapproval/) | Class | The pending tool approval request of a run that executes from the queue. |
| [`PricingDiagnostic`](/api/tracon.pricingdiagnostic/) | Class | Whether the catalog can actually put a price on a run. |
| [`PricingSource`](/api/tracon.pricingsource/) | Enum | Reports where a run's cost pricing came from. |
| [`ProductionProfileResult`](/api/tracon.productionprofileresult/) | Class | The answer one production profile check gives. |
| [`ProductionProfileState`](/api/tracon.productionprofilestate/) | Enum | What a production profile check found. |
| [`ProtectedColumn`](/api/tracon.protectedcolumn/) | Enum | A database column IContentProtector can be applied to. |
| [`ProviderDiagnostic`](/api/tracon.providerdiagnostic/) | Class | Summarizes diagnostics for a model provider. |
| [`ProviderRetryDecision`](/api/tracon.providerretrydecision/) | Enum | Whether a provider failure should move to the next fallback link. |
| [`QuotaConsumption`](/api/tracon.quotaconsumption/) | Class | The consumption of a completed run to add to the quota counters. |
| [`QuotaDefinition`](/api/tracon.quotadefinition/) | Class | A quota rule defined for a tenant or an agent. |
| [`QuotaMetric`](/api/tracon.quotametric/) | Enum | The metric a quota is exceeded by. |
| [`QuotaPeriod`](/api/tracon.quotaperiod/) | Enum | The interval at which a quota's counter resets. |
| [`QuotaUsageQuery`](/api/tracon.quotausagequery/) | Class | A filter for querying quota usage. |
| [`QuotaUsageRecord`](/api/tracon.quotausagerecord/) | Class | A scope's consumption in the current period. |
| [`ReplayToolMode`](/api/tracon.replaytoolmode/) | Enum | How tools are handled during replay. |
| [`ResponseCacheSettings`](/api/tracon.responsecachesettings/) | Class | Response caching settings for a ModelBinding. |
| [`ResponseSchemaShape`](/api/tracon.responseschemashape/) | Class | 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/) | Class | An age- and volume-based retention rule for a target. |
| [`RetentionRun`](/api/tracon.retentionrun/) | Class | The history record of a cleanup run. |
| [`RetentionTargets`](/api/tracon.retentiontargets/) | Class | The fixed table list a retention policy may target. |
| [`RunAccess`](/api/tracon.runaccess/) | Enum | The kind of access a RunAuthorizationRequest asks about. |
| [`RunAgentStatistics`](/api/tracon.runagentstatistics/) | Class | An agent's run summary. |
| [`RunAuthorizationRequest`](/api/tracon.runauthorizationrequest/) | Class | Describes one run awaiting an authorization decision. |
| [`RunAuthorizationResult`](/api/tracon.runauthorizationresult/) | Class | The outcome of an authorization decision. |
| [`RunCompletion`](/api/tracon.runcompletion/) | Class | Everything needed to close a run. |
| [`RunCost`](/api/tracon.runcost/) | Class | 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/) | Class | Error information for a failed run. |
| [`RunErrorClass`](/api/tracon.runerrorclass/) | Enum | A run error's class. |
| [`RunErrorClassification`](/api/tracon.runerrorclassification/) | Class | The result of an IRunErrorClassifier classification. |
| [`RunErrorCluster`](/api/tracon.runerrorcluster/) | Class | The summary of runs sharing the same fingerprint. |
| [`RunErrorStatistics`](/api/tracon.runerrorstatistics/) | Class | An error class's summary. |
| [`RunEvent`](/api/tracon.runevent/) | Class | A single event produced during a run. Events are append-only: they are never updated, only added. |
| [`RunEventCustomTypes`](/api/tracon.runeventcustomtypes/) | Class | Validation for the CustomType string that qualifies a RunEventType.Custom event. |
| [`RunEventType`](/api/tracon.runeventtype/) | Enum | Event types produced during a run. The user interface maps these directly onto visual elements, so the values must stay stable. |
| [`RunInputRecord`](/api/tracon.runinputrecord/) | Class | A run's stored input. |
| [`RunJudgeContext`](/api/tracon.runjudgecontext/) | Class | The limited context supplied to a judge. |
| [`RunJudgment`](/api/tracon.runjudgment/) | Class | The judge's verdict: the named scores it produced. |
| [`RunKind`](/api/tracon.runkind/) | Enum | Reports what a runs row records. |
| [`RunLabels`](/api/tracon.runlabels/) | Class | The limits a run's attribution must obey, and the single place they are enforced. |
| [`RunLabelStatistics`](/api/tracon.runlabelstatistics/) | Class | A label's run summary; one entry per distinct key/value pair. |
| [`RunModelStatistics`](/api/tracon.runmodelstatistics/) | Class | A model's run summary. The input to cost computation. |
| [`RunNonTokenCost`](/api/tracon.runnontokencost/) | Class | 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/) | Class | Query used to filter the run list. |
| [`RunReconciliationOptions`](/api/tracon.runreconciliationoptions/) | Class | Orphaned-run reconciliation settings. |
| [`RunRecord`](/api/tracon.runrecord/) | Class | Summary of a run. It acts as the header of the event stream. |
| [`RunRecordingDiagnostic`](/api/tracon.runrecordingdiagnostic/) | Class | What a run actually records, as configured. |
| [`RunReplayRequest`](/api/tracon.runreplayrequest/) | Class | A replay request. |
| [`RunScore`](/api/tracon.runscore/) | Class | A human (or judge) score for a run or for a single message within a run. |
| [`RunScoreAggregate`](/api/tracon.runscoreaggregate/) | Class | One aggregated group: every score sharing a breakdown key AND a RunScoreKind. |
| [`RunScoreBucket`](/api/tracon.runscorebucket/) | Enum | A closed, low-cardinality set of time buckets for a score trend series. |
| [`RunScoreBucketAggregate`](/api/tracon.runscorebucketaggregate/) | Class | One time bucket of the trend series (RunScoreSummary.Series). |
| [`RunScoreBucketing`](/api/tracon.runscorebucketing/) | Class | Shared pure logic for score trend bucket truncation (RunScoreBucket). |
| [`RunScoreKind`](/api/tracon.runscorekind/) | Enum | The shape of the value a RunScore carries. |
| [`RunScoreQuery`](/api/tracon.runscorequery/) | Class | The filter for a score summary query (IRunScoreStore.SummarizeAsync). |
| [`RunScoreRules`](/api/tracon.runscorerules/) | Class | The shared rules a RunScore must satisfy before it is stored. |
| [`RunScoreSummary`](/api/tracon.runscoresummary/) | Class | The result of IRunScoreStore.SummarizeAsync. |
| [`RunScoreTarget`](/api/tracon.runscoretarget/) | Enum | Which target a score belongs to — the filter RunScoreQuery.Target narrows to. |
| [`RunSpend`](/api/tracon.runspend/) | Class | The one place a run's token cost and its reported (non-token) amount are added. |
| [`RunStartInfo`](/api/tracon.runstartinfo/) | Class | Everything needed to open a new run. |
| [`RunStatistics`](/api/tracon.runstatistics/) | Class | A summary of the runs in a time range. |
| [`RunStatisticsQuery`](/api/tracon.runstatisticsquery/) | Class | The filter for a run statistics query. |
| [`RunStatus`](/api/tracon.runstatus/) | Enum | Status of a run. |
| [`RunTimeSeriesBucketing`](/api/tracon.runtimeseriesbucketing/) | Class | The shared pure logic for time-series bucket computation. Both InMemoryRunStore and PostgresRunStore use this type, so the bucket limit and rounding rules never. |
| [`RunTimeSeriesQuery`](/api/tracon.runtimeseriesquery/) | Class | Filter for a time-series query. |
| [`RunTrace`](/api/tracon.runtrace/) | Class | A run's span tree. The waterfall view is built on top of this. |
| [`RunTreeCost`](/api/tracon.runtreecost/) | Class | Total cost of a run tree (the root plus every child run). |
| [`RunUsage`](/api/tracon.runusage/) | Class | Token usage of a run. |
| [`RunUserStatistics`](/api/tracon.runuserstatistics/) | Class | A user's run summary. |
| [`RunVersionStatistics`](/api/tracon.runversionstatistics/) | Class | A definition version's run summary. |
| [`SamplingFields`](/api/tracon.samplingfields/) | Enum | The request fields of ModelBinding whose support depends on the provider's API surface. |
| [`SessionAccess`](/api/tracon.sessionaccess/) | Enum | The kind of access a SessionAuthorizationRequest asks about. |
| [`SessionAuthorizationRequest`](/api/tracon.sessionauthorizationrequest/) | Class | Describes one session access awaiting an authorization decision. |
| [`SessionQuery`](/api/tracon.sessionquery/) | Class | A filter for querying the session list. |
| [`SessionRecord`](/api/tracon.sessionrecord/) | Class | A stored session. |
| [`SingletonExecutionOptions`](/api/tracon.singletonexecutionoptions/) | Class | The settings of single-executor election. |
| [`SkillScriptExecutionRequest`](/api/tracon.skillscriptexecutionrequest/) | Class | One skill script that passed every execution gate, as handed to an ISkillScriptExecutor. |
| [`SkillScriptExecutionResult`](/api/tracon.skillscriptexecutionresult/) | Class | What one skill script run did, as an ISkillScriptExecutor reports it. |
| [`SkillScriptGrant`](/api/tracon.skillscriptgrant/) | Class | The record carrying permission to execute a skill script. |
| [`SkillScriptOrigin`](/api/tracon.skillscriptorigin/) | Enum | Where the content of a skill script came from. |
| [`SkillSettings`](/api/tracon.skillsettings/) | Class | Settings for how an agent uses the skills it names in AgentDefinition.SkillNames. |
| [`SpeechAlignment`](/api/tracon.speechalignment/) | Class | One character's position in the generated audio. |
| [`SpeechAudio`](/api/tracon.speechaudio/) | Class | Generated audio. |
| [`SpeechDialogueAudio`](/api/tracon.speechdialogueaudio/) | Class | The audio of a dialogue and the time range of each turn. |
| [`SpeechDialogueCapabilities`](/api/tracon.speechdialoguecapabilities/) | Class | The limits of one dialogue request, as the provider states them. |
| [`SpeechDialogueRequest`](/api/tracon.speechdialoguerequest/) | Class | A request to voice a dialogue. |
| [`SpeechDialogueSegment`](/api/tracon.speechdialoguesegment/) | Class | The time range one turn takes in a dialogue's audio. |
| [`SpeechDialogueTurn`](/api/tracon.speechdialogueturn/) | Class | One turn of a dialogue: a text and the voice that speaks it. |
| [`SpeechProviderDescriptor`](/api/tracon.speechproviderdescriptor/) | Class | A registered speech provider, as the speech provider list reports it. |
| [`SpeechProviderKind`](/api/tracon.speechproviderkind/) | Enum | The kind of a registered speech provider. |
| [`SpeechRequest`](/api/tracon.speechrequest/) | Class | A text-to-speech generation request. |
| [`SpeechTranscript`](/api/tracon.speechtranscript/) | Class | The result of speech-to-text conversion. |
| [`SpeechTranscriptionOptions`](/api/tracon.speechtranscriptionoptions/) | Class | Speech-to-text conversion settings. |
| [`SpeechUsageSource`](/api/tracon.speechusagesource/) | Enum | The source of a speech measurement. |
| [`SqlPersistenceDiagnosticsSnapshot`](/api/tracon.sqlpersistencediagnosticssnapshot/) | Class | Represents the current connection and migration status of an SQL persistence provider. |
| [`StructuredResponseValidationContext`](/api/tracon.structuredresponsevalidationcontext/) | Class | The response an IStructuredResponseValidator checks. |
| [`StructuredResponseValidationResult`](/api/tracon.structuredresponsevalidationresult/) | Class | The outcome of a structured response validation check. |
| [`SubAgentCallMode`](/api/tracon.subagentcallmode/) | Enum | How an agent calls the agents it may call (CallableAgents). |
| [`SubAgentSettings`](/api/tracon.subagentsettings/) | Class | Determines how an agent calls the agents it may call, and how long it waits for them. |
| [`TenantDescriptor`](/api/tracon.tenantdescriptor/) | Class | A registered tenant. |
| [`TenantEgressPolicy`](/api/tracon.tenantegresspolicy/) | Class | The set of providers a tenant's data is allowed to reach (egress policy). |
| [`TenantProviderBinding`](/api/tracon.tenantproviderbinding/) | Class | Binds a tenant to a provider's credential, by name only. |
| [`TimeSeriesBucket`](/api/tracon.timeseriesbucket/) | Enum | The bucket width for a time-series query. |
| [`TimeSeriesPoint`](/api/tracon.timeseriespoint/) | Class | A summary of the runs in a time bucket. The result unit of /api/stats/timeseries; empty buckets are also returned (with zero events). |
| [`ToolApprovalContext`](/api/tracon.toolapprovalcontext/) | Class | The tool call a code-defined approval policy judges. Read-only. |
| [`ToolApprovalPolicyDecision`](/api/tracon.toolapprovalpolicydecision/) | Enum | The outcome of a code-defined approval policy (ToolApprovalContext). |
| [`ToolApprovalPresentation`](/api/tracon.toolapprovalpresentation/) | Class | A human-readable projection of one tool-approval request, produced by a consumer's IToolApprovalPresenter. |
| [`ToolApprovalRule`](/api/tracon.toolapprovalrule/) | Class | A persistent approval rule for a tool call the user said "do not ask again" for. |
| [`ToolArgumentCondition`](/api/tracon.toolargumentcondition/) | Class | One comparison against a tool call argument: path · operator · value. |
| [`ToolArgumentOperator`](/api/tracon.toolargumentoperator/) | Enum | A comparison operator for a ToolArgumentCondition. |
| [`ToolArgumentsValidationResult`](/api/tracon.toolargumentsvalidationresult/) | Class | The outcome of a tool arguments validation check. |
| [`ToolAuthorizationRequest`](/api/tracon.toolauthorizationrequest/) | Class | Describes one tool call awaiting an authorization decision. |
| [`ToolAuthorizationResult`](/api/tracon.toolauthorizationresult/) | Class | The outcome of an authorization decision. |
| [`ToolCallUsage`](/api/tracon.toolcallusage/) | Class | A non-token measurement and its cost: one tool call's, or one item a workflow function node reported. |
| [`ToolDescriptor`](/api/tracon.tooldescriptor/) | Class | 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. |
| [`ToolEffect`](/api/tracon.tooleffect/) | Enum | Classifies the blast radius of a tool call. |
| [`ToolInvocationRecord`](/api/tracon.toolinvocationrecord/) | Class | The summary of a single completed tool call. |
| [`ToolLoopSettings`](/api/tracon.toolloopsettings/) | Class | Tool-call loop settings for a ModelBinding. |
| [`ToolRegistrationOptions`](/api/tracon.toolregistrationoptions/) | Class | Configures metadata for a tool registration. |
| [`ToolUsage`](/api/tracon.toolusage/) | Class | A tool's usage summary. Shown by the UI's Tools screen. |
| [`ToolUsageQuery`](/api/tracon.toolusagequery/) | Class | The filter for a tool usage summary. |
| [`ToolUsageUnits`](/api/tracon.toolusageunits/) | Class | The known unit names for ToolCallUsage.Unit. |
| [`TraceSpan`](/api/tracon.tracespan/) | Class | A single persisted OpenTelemetry span. |
| [`TraceSpanBatch`](/api/tracon.tracespanbatch/) | Class | A span set belonging to a single trace. |
| [`TraceSpanKind`](/api/tracon.tracespankind/) | Enum | A span's OpenTelemetry kind. Values are stored in the database as smallint; the numbers are stable. |
| [`TraceSpanStatus`](/api/tracon.tracespanstatus/) | Enum | A span's result status. smallint in the database. |
| [`TraconAgentSourceException`](/api/tracon.traconagentsourceexception/) | Class | Represents a normalized failure from an IAgentSource. |
| [`TraconChildRunTimeoutException`](/api/tracon.traconchildruntimeoutexception/) | Class | Thrown when an agent step of a workflow does not answer within the sub-agent wait limit. |
| [`TraconCompilationException`](/api/tracon.traconcompilationexception/) | Class | Thrown when an agent definition cannot be turned into a runnable agent. |
| [`TraconContentBlockedException`](/api/tracon.traconcontentblockedexception/) | Class | Thrown when an IContentGuard blocks content. |
| [`TraconContentFilteredException`](/api/tracon.traconcontentfilteredexception/) | Class | Thrown when a model provider cuts the response short with its safety or content filter. |
| [`TraconDiagnosticsReport`](/api/tracon.tracondiagnosticsreport/) | Class | Reports the self-diagnostics of the installation. |
| [`TraconEgressOptions`](/api/tracon.traconegressoptions/) | Class | Shared rules for the target address of outbound network requests. |
| [`TraconErrorTypes`](/api/tracon.traconerrortypes/) | Class | 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/) | Class | Base class for every error Tracon raises. |
| [`TraconExternalCallException`](/api/tracon.traconexternalcallexception/) | Class | 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/) | Class | Finish reasons Tracon reads beyond the ones AI.ChatFinishReason defines. |
| [`TraconGeneratedToolArguments`](/api/tracon.tracongeneratedtoolarguments/) | Class | The helper methods called by tool wrappers produced by the source generator while converting JSON arguments to CLR types. |
| [`TraconId`](/api/tracon.traconid/) | Class | UUID version 7 generator for Tracon identifiers (RFC 9562). |
| [`TraconInboundTriggerOptions`](/api/tracon.traconinboundtriggeroptions/) | Class | Options that constrain inbound triggers. |
| [`TraconLoopUnsatisfiedException`](/api/tracon.traconloopunsatisfiedexception/) | Class | Thrown when a harness loop reaches its iteration ceiling while a criterion still asks for another iteration, and its LoopSettings.OnExhausted is LoopOutcome.FailRun. |
| [`TraconMcpSecurityOptions`](/api/tracon.traconmcpsecurityoptions/) | Class | The security boundary applied to stored MCP server definitions. |
| [`TraconModelConcurrencyOptions`](/api/tracon.traconmodelconcurrencyoptions/) | Class | Defines the outgoing concurrency limit applied per model provider. |
| [`TraconOutputTruncatedException`](/api/tracon.traconoutputtruncatedexception/) | Class | Thrown when the model stops at its output token limit before a structured (JSON) response is complete. |
| [`TraconPreflightOptions`](/api/tracon.traconpreflightoptions/) | Class | Defines options for the pre-flight context-window check. |
| [`TraconProductionRisk`](/api/tracon.traconproductionrisk/) | Enum | One production decision the profile gate refuses to leave unanswered. |
| [`TraconProviderUnavailableException`](/api/tracon.traconproviderunavailableexception/) | Class | Thrown when the circuit breaker has temporarily taken a model provider out of service. |
| [`TraconRunBudgetExceededException`](/api/tracon.traconrunbudgetexceededexception/) | Class | 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. |
| [`TraconRunOptions`](/api/tracon.traconrunoptions/) | Class | Run options that let the caller determine a run's identifier, its place in the tree, and its budget. |
| [`TraconSchedulingOptions`](/api/tracon.traconschedulingoptions/) | Class | Batch and scheduled run settings. |
| [`TraconSessionConflictException`](/api/tracon.traconsessionconflictexception/) | Class | Thrown for the losing request when two concurrent first requests arrive for the same new session id. |
| [`TraconSessionOwnerRequiredException`](/api/tracon.traconsessionownerrequiredexception/) | Class | 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/) | Class | Turns per-user session ownership on, a second boundary drawn UNDER the tenant. |
| [`TraconStructuredResponseException`](/api/tracon.traconstructuredresponseexception/) | Class | Thrown when a run's response fails structured output validation. |
| [`TraconTenantProviderOptions`](/api/tracon.tracontenantprovideroptions/) | Class | Options that constrain per-tenant model provider bindings (BYOK). |
| [`TraconTenantProviderRefusedException`](/api/tracon.tracontenantproviderrefusedexception/) | Class | Thrown when a tenant's provider rules refuse a call before it leaves the process. |
| [`TraconTenantQuotaExceededException`](/api/tracon.tracontenantquotaexceededexception/) | Class | 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. |
| [`TraconToolAttribute`](/api/tracon.tracontoolattribute/) | Class | Marks a method as a tool. AddToolsFrom registers only methods carrying this attribute. |
| [`TraconToolRegistration`](/api/tracon.tracontoolregistration/) | Class | A single tool registered with dependency injection. Tracon builds the tool registry from these registrations. |
| [`TraconToolTimeoutException`](/api/tracon.tracontooltimeoutexception/) | Class | Thrown when a tool call does not settle within its configured timeout. |
| [`TraconWorkflowFunctionTimeoutException`](/api/tracon.traconworkflowfunctiontimeoutexception/) | Class | Thrown when a function node of a workflow does not return within its timeout. |
| [`VectorChunk`](/api/tracon.vectorchunk/) | Class | A single chunk to write. |
| [`VectorSearchHit`](/api/tracon.vectorsearchhit/) | Class | A single search result. |
| [`VectorSearchRequest`](/api/tracon.vectorsearchrequest/) | Class | A semantic search request. |
| [`VoiceAttributeNames`](/api/tracon.voiceattributenames/) | Class | Names for well-known VoiceDescriptor.Attributes keys. Not exhaustive: a provider may report other safe scalar labels under their own key. |
| [`VoiceDescriptor`](/api/tracon.voicedescriptor/) | Class | The definition of an available voice. |
| [`VoiceHealth`](/api/tracon.voicehealth/) | Class | The voice provider's reachability status. |
| [`VoiceSessionCost`](/api/tracon.voicesessioncost/) | Class | What one voice conversation cost. |
| [`VoiceSessionEndReason`](/api/tracon.voicesessionendreason/) | Enum | The reason a voice connection closed. |
| [`VoiceSessionQuery`](/api/tracon.voicesessionquery/) | Class | The filter for listing voice session records. |
| [`VoiceSessionRecord`](/api/tracon.voicesessionrecord/) | Class | The summary record of a real-time voice connection. |
| [`WebhookDelivery`](/api/tracon.webhookdelivery/) | Class | A single delivery record. |
| [`WebhookDeliveryQuery`](/api/tracon.webhookdeliveryquery/) | Class | A filter for querying delivery history. |
| [`WebhookDeliveryResult`](/api/tracon.webhookdeliveryresult/) | Class | The result of a delivery attempt. |
| [`WebhookDeliveryStatus`](/api/tracon.webhookdeliverystatus/) | Enum | The status of a webhook delivery attempt. |
| [`WebhookEvents`](/api/tracon.webhookevents/) | Class | The event types Tracon can publish. |
| [`WebhookSubscription`](/api/tracon.webhooksubscription/) | Class | An external system's event subscription. |
| [`WorkflowCheckpointRecord`](/api/tracon.workflowcheckpointrecord/) | Class | Represents a single checkpoint of a workflow run. |
| [`WorkflowDefinition`](/api/tracon.workflowdefinition/) | Class | Represents the full definition of a workflow, whether defined through the UI or in code. |
| [`WorkflowDescriptor`](/api/tracon.workflowdescriptor/) | Class | Represents a summary view of a workflow listed in the catalog. |
| [`WorkflowEdgeKind`](/api/tracon.workflowedgekind/) | Enum | Represents the kind of an edge. |
| [`WorkflowGraph`](/api/tracon.workflowgraph/) | Class | Represents a workflow's compiled graph: nodes, edges, and external request ports. |
| [`WorkflowGraphEdge`](/api/tracon.workflowgraphedge/) | Class | Represents the connection between two nodes. |
| [`WorkflowGraphNode`](/api/tracon.workflowgraphnode/) | Class | Represents a node in the graph. |
| [`WorkflowKind`](/api/tracon.workflowkind/) | Enum | Represents the built-in workflow patterns that can be defined through the UI. |
| [`WorkflowNodeKind`](/api/tracon.workflownodekind/) | Enum | Represents the role of a graph node. |
| [`WorkflowNodeReference`](/api/tracon.workflownodereference/) | Class | Points to a single node entering a workflow's graph: an agent from the catalog, or a function registered in code. |
| [`WorkflowPendingRequest`](/api/tracon.workflowpendingrequest/) | Class | Represents human input awaited by a workflow run. |
| [`WorkflowRequestForm`](/api/tracon.workflowrequestform/) | Enum | Defines how the UI presents a pending request. |
| [`WorkflowRequestQuery`](/api/tracon.workflowrequestquery/) | Class | The filter and the page of a listing of a tenant's open human requests. |
| [`WorkflowRequestRecord`](/api/tracon.workflowrequestrecord/) | Class | One request a workflow run waits on, as the inbox stores it. |
| [`WorkflowRequestState`](/api/tracon.workflowrequeststate/) | Enum | Which of the open human requests of a tenant a listing returns. |
| [`WorkflowRequestStatus`](/api/tracon.workflowrequeststatus/) | Enum | Whether a run still waits on a request. |
| [`WorkflowRespondRequest`](/api/tracon.workflowrespondrequest/) | Class | Represents a response to a pending request. |
| [`WorkflowResponseClaim`](/api/tracon.workflowresponseclaim/) | Class | The outcome of recording an answer that may claim a request. |
| [`WorkflowResponseMode`](/api/tracon.workflowresponsemode/) | Enum | How a workflow treats more than one answer to the same pending human request. |
| [`WorkflowResponseRecord`](/api/tracon.workflowresponserecord/) | Class | One answer to a workflow's pending human request. |
| [`WorkflowResponseStatus`](/api/tracon.workflowresponsestatus/) | Enum | The state of a recorded answer. |
| [`WorkflowResumeRequest`](/api/tracon.workflowresumerequest/) | Class | The information needed to resume a workflow from a checkpoint. |
| [`WorkflowRunRequest`](/api/tracon.workflowrunrequest/) | Class | The information needed to run a workflow. |
| [`WorkspaceSettings`](/api/tracon.workspacesettings/) | Class | 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. |