Tracon.Abstractions

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

Type	Kind	Purpose
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	Enum	Tells where an agent definition came from.
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	Class	A single named placeholder an AgentDefinition’s instructions can reference as {{name}}.
AgentParameterKind	Enum	The data kind of an AgentParameter.
AgentResponseFormat	Class	The definition of a structured output.
AgentResponseFormatKind	Enum	The requested format of an agent response.
AgentRunBudget	Class	A run budget shared across an entire call tree.
AgentRunDocument	Class	A piece of reference text attached to a single run, kept apart from the model’s instructions.
AgentSkillDefinition	Class	A markdown-based skill definition that can be loaded into an agent at run time.
AgentSkillResourceDefinition	Class	A readable resource carried with an AgentSkillDefinition.
AgentSkillScriptDefinition	Class	A server-executable script stored together with an AgentSkillDefinition.
AgentSourceDiagnostic	Class	Describes one agent source registered in the catalog.
AgentSourcePriority	Class	The priority values Tracon’s own built-in agent sources use.
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	Class	The ambient passing mechanism for running an operation executed in the background (outside an HTTP request) as a specific tenant.
ApiKeyCreationResult	Class	The result of a key creation operation.
ApiKeyDraft	Class	A draft for creating an API key.
ApiKeyGenerator	Class	A helper that produces a raw API key value and its hash.
ApiKeyRecord	Class	An API key’s database-stored view, which CARRIES no raw VALUE.
ApiKeyScope	Enum	An authority scope an API key may open.
ApprovalStatus	Enum	The status of a pending approval request.
ArchiveRow	Class	The JSON representation of a single row to write to the archive.
AttachmentContent	Class	The content of a new attachment to be saved into the store.
AttachmentDescriptor	Class	The metadata of an uploaded attachment.
AttachmentQuery	Class	The filter used to list attachments.
AuditChainQuery	Class	The criteria that scope a hash chain verification.
AuditChainStatus	Enum	The result of walking a tenant’s audit trail hash chain.
AuditChainVerification	Class	The result of verifying one tenant’s audit trail hash chain.
AuditEntry	Class	A row in the audit trail that records who changed which entity and when.
AuditQuery	Class	The criteria that filter an audit trail query.
CallableAgentReference	Class	One agent another agent may call, and the version of it that runs.
CanaryPolicy	Class	Defines automatic rollback and gradual traffic-increase rules for an experiment canary variant.
CompactionSettings	Class	Determines how an agent compacts its conversation history.
CompactionStrategyKind	Enum	The kind of context compaction strategy that can be bound to an agent definition.
ConfigurationDiagnostic	Class	Reports whether a configuration key resolves. It does not carry the value.
ContentGuardAction	Enum	The decision a guard can make.
ContentGuardContext	Class	The context of an IContentGuard call.
ContentGuardDirection	Enum	The direction of a content guard check.
ContentGuardResult	Class	The result of an IContentGuard check.
ContentGuardSource	Enum	Where the text handed to an IContentGuard came from.
ConversationBranch	Struct	A conversation branch’s store-level result.
ConversationMemorySearch	Enum	When an agent searches its conversation memory (EnableConversationMemory).
DataSubjectExport	Class	A data subject’s exported content.
DataSubjectScope	Class	The sessions, runs, and conversations that belong to one data subject.
EvalCase	Class	A single test case inside an EvalSuite.
EvalCaseAddResult	Class	The result of IEvalStore.AddCaseAsync.
EvalCaseDiff	Class	One case’s outcome on both sides of an EvalRunDiff.
EvalCaseDiffKind	Enum	The bucket an aligned case falls into within an EvalRunDiff.
EvalCaseDraft	Class	Carrier for adding a single EvalCase.
EvalCaseResult	Class	The result of a single EvalCase within an EvalRun.
EvalCaseSource	Enum	The reason an EvalCase was promoted from a production run.
EvalExpectedToolCall	Class	A tool call an EvalCase expects the agent to make.
EvalRun	Class	A single execution record and summary of an EvalSuite.
EvalRunCompletion	Class	The information needed to finalize a run.
EvalRunDiff	Class	The case-by-case difference between two completed EvalRun records of the same suite.
EvalRunDiffBuilder	Class	Aligns two eval runs’ per-case results into an EvalRunDiff.
EvalRunDiffQuery	Class	Which two eval runs to compare, and which page of the result to read.
EvalRunDiffUnavailableException	Class	Thrown by IEvalStore.DiffRunsAsync when two eval runs exist but cannot be compared.
EvalRunDiffUnavailableReason	Enum	Why two eval runs cannot be compared.
EvalRunQuery	Class	A query for filtering the run list.
EvalRunStatus	Enum	The status of an eval run.
EvalSuite	Class	An evaluation (eval) suite defined for an agent: carries which agent is measured, with which checks.
Experiment	Class	Represents an A/B experiment that splits traffic between two or more definition versions of the same agent.
ExperimentResultsQuery	Class	Defines a query for experiment results.
ExperimentStatus	Enum	Defines the lifecycle status of an A/B experiment.
ExperimentVariant	Class	Defines one experiment variant: its definition version and traffic weight.
ExperimentVariantResult	Class	Summarizes run results for an experiment variant (calculated in the store).
ExtensionPointDiagnostic	Class	One host-bound extension point and whether the host replaced its built-in default.
GeneratedApiKey	Class	The generated raw API key value and its derived forms.
HarnessSettings	Class	Settings for the harness capabilities. It mirrors a safe subset of the HarnessAgentOptions structure of Microsoft Agent Framework.
HostedToolContext	Class	What the factory of a hosted tool (AddHostedTool) learns about the agent it builds the tool for.
HostedToolKind	Enum	The kinds of tool a model provider runs on its own side, which a host registers in code with AddHostedTool.
HostedToolKinds	Enum	The HostedToolKind values a provider’s API surface can run, as a set.
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	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	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	Interface	The store for a tenant’s run-time skill definitions.
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	Interface	The store for per-tenant API keys.
IArchiveSink	Interface	The cold-storage extension point rows are written to before deletion.
IAttachmentStorage	Interface	The extension point that stores attachment content in an external store (S3, Blob).
IAttachmentStore	Interface	The contract for attachment metadata and for the default (database) content storage.
IAuditLog	Interface	The audit trail log.
IContentGuard	Interface	The extension point that inspects content going to and coming from the model.
IContentProtector	Interface	Extension point for at-rest encryption of stored content.
IConversationBranchStore	Interface	The store that branches a conversation by copying it.
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	Interface	The data plane that counts, exports, and erases one data subject’s content across the schema.
IdempotencyRequest	Class	An idempotency reservation request.
IdempotencyReservation	Class	The result of an IIdempotencyStore.ReserveAsync call.
IdempotencyResponse	Class	The stored HTTP response.
IdempotencyState	Enum	The four possible states of an idempotency key.
IEvalStore	Interface	The store for evaluation (eval) suites, cases, and runs.
IExperimentStore	Interface	Defines the store for A/B experiments.
IHostedToolSupport	Interface	An optional interface of an IModelProvider that states which HostedToolKind values its API surface runs.
IIdempotencyStore	Interface	The store for idempotency records.
IInboundTriggerStore	Interface	The store for inbound trigger definitions.
IJobDispatcher	Interface	Queues a job for a registered IJobHandler.
IJobHandler	Interface	The extension point that provides job execution logic for one handler key.
IJobScheduleStore	Interface	The store for schedule definitions.
IJobStore	Interface	The store for queued jobs and their items.
ILiveVoiceProvider	Interface	Creates and supervises a provider-hosted live voice session.
ILiveVoiceSideband	Interface	The server-side control connection of a live voice session.
IMcpServerStore	Interface	The store for registered MCP servers.
IMigrationApplier	Interface	Applies the pending migrations of the active SQL persistence provider.
IModelProvider	Interface	A model provider. Each provider is implemented in its own package (for example, Tracon.OpenAI) and registered with DI.
IModelProviderConfigurationDiagnostics	Interface	Defines optional configuration diagnostics for a model provider.
IModelProviderHealthCheck	Interface	The optional health-check contract for a model provider.
IModelProviderRegistry	Interface	The registry that keeps registered model providers by name.
InboundTrigger	Class	An inbound trigger definition: an external event that starts a queued run.
InboundTriggerPayloadMode	Enum	How an inbound trigger’s request body becomes the agent/workflow message.
InboundTriggerTargetKind	Enum	What kind of target an inbound trigger fires.
IPendingApprovalStore	Interface	The store for pending approval requests.
IProductionProfileCheck	Interface	Answers one production decision while the host starts, for RequireProductionProfile.
IProviderRetryClassifier	Interface	Decides whether a model-provider failure is retryable on the next fallback link.
IQuotaStore	Interface	The store for quota rules and consumption counters.
IResponseSchemaSupport	Interface	An optional interface of an IModelProvider that states which response schema its client sends to the model for a binding.
IRetentionPolicyStore	Interface	The control-plane store for retention policies and run history.
IRetentionStore	Interface	The data plane that counts, batch-deletes, and reads-for-archive over the actual retention data.
IRunAttributionContext	Interface	Resolves who a run belongs to and what work it was made for.
IRunAuthorizationHandler	Interface	Decides whether a caller may start a run or read/write a session.
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	Interface	Converts a raw run error into a class and a clustering fingerprint.
IRunEventSink	Interface	Receives run events as they are written, in addition to IRunStore.
IRunInputStore	Interface	Stores a run’s input messages. The source of replay.
IRunJudge	Interface	The extension point that scores a completed production run.
IRunPricingResolver	Interface	Computes the cost from a model+usage pair. Pricing order: the model catalog, then the Tracon:Pricing configuration.
IRunScoreStore	Interface	The store for run and message scores (RunScore).
IRunStore	Interface	Store for run records and the event stream.
ISamplingSupport	Interface	An optional interface of an IModelProvider that states which SamplingFields its API surface sends to the model.
ISessionStore	Interface	The store for serialized agent sessions.
ISingletonLeaseStore	Interface	The lease store that keeps a named job running on a single instance across the cluster.
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	Interface	The store for skill script execution grants.
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	Interface	Returns a speech provider by name, after the calling tenant’s provider checks.
ISpeechSynthesizer	Interface	A provider that generates speech from text.
ISpeechTranscriber	Interface	A provider that transcribes speech to text.
ISqlPersistenceDiagnostics	Interface	Defines optional diagnostics for the active SQL persistence provider.
IStructuredResponseValidator	Interface	Validates a run’s response against the agent’s requested AgentResponseFormat before the run closes.
ITenantContext	Interface	Resolves the current request’s tenant. In a single-tenant setup, returns a fixed value and requires no additional configuration.
ITenantCredentialModelProvider	Interface	A model provider that can build clients from resolved per-tenant credentials.
ITenantEgressPolicyStore	Interface	The store for per-tenant provider egress policies.
ITenantProviderBindingStore	Interface	The store for per-tenant model provider bindings (BYOK).
ITenantStore	Interface	The store for tenant registrations.
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	Interface	The store for persistent approval rules.
IToolArgumentsValidator	Interface	Validates a tool call’s arguments before the call runs.
IToolAuthorizationHandler	Interface	Decides whether a tenant/user may call a specific tool.
IToolRegistry	Interface	The registry of tools registered in code.
ITraceStore	Interface	The store for persisted spans.
IVectorSearchStore	Interface	The embedding-based semantic search store.
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	Interface	Checks the voice provider’s reachability.
IVoicePricingReader	Interface	Reads the configured voice model’s pricing.
IVoiceSessionStore	Interface	Stores the summary record of real-time voice connections.
IWebhookStore	Interface	The store for webhook subscriptions and delivery history.
IWorkflowCheckpointStore	Interface	The store for workflow checkpoints.
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	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	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	Interface	Reads the workflow catalog and runs workflows.
JobCompletion	Class	The information needed to finalize a job.
JobContext	Class	The context available during an IJobHandler execution.
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	Class	The built-in job handler keys, plus validation for the keys a consumer registers.
JobItemRecord	Class	A single input of a batch job and that input’s processing result.
JobItemResult	Class	The result of a processed job item. Reported with IJobStore.ReportItemAsync.
JobItemStatus	Enum	The status of a batch job item.
JobLanes	Class	Well-known values and validation for job lane identifiers.
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	Class	A filter for querying the job list.
JobQueueDepth	Class	The number of open jobs in one lane/status pair.
JobRecord	Class	The summary of a queued job. The header of its items (JobItemRecord).
JobRequest	Class	The description of one job to queue through IJobDispatcher.
JobRetryException	Class	The exception an IJobHandler throws to signal that it wants the job retried after a specific delay.
JobSchedule	Class	The schedule record defining when and how a job runs.
JobStatus	Enum	The status of a queued job.
JobTenantCap	Class	A ceiling on how many jobs of a set of handler keys one tenant may hold leased at the same time.
JudgeScore	Class	One named score produced by an IRunJudge.
LateToolCompletion	Class	The settled outcome of a tool call whose timeout had already been reported.
LiveVoiceAppend	Class	Text sent into a live conversation’s context.
LiveVoiceAppendChannel	Enum	The channel a live append is written to.
LiveVoiceAttachRequest	Class	The request that attaches the server-side control connection to a live voice session.
LiveVoiceCreateRequest	Class	The request that creates a live voice session.
LiveVoiceDelegationMode	Enum	How a live model hands heavier work back.
LiveVoiceEvent	Class	One event observed on a live voice session’s sideband.
LiveVoiceEventKind	Enum	What a live voice sideband event says.
LiveVoiceSessionHandle	Class	The result of creating a live voice session.
LiveVoiceSessionOptions	Class	The settings of one live voice session.
LoopCriterion	Class	One declarative stop criterion of the harness loop (see LoopSettings).
LoopOutcome	Enum	What a harness loop does when it ends without every criterion satisfied: return the last response, or fail the run.
LoopSettings	Class	Turns the harness loop on: the agent is re-invoked until a stop criterion says the work is finished.
McpOAuthAuthorizationMode	Enum	The MCP OAuth authorization flow.
McpServerDefinition	Class	A registered remote MCP server. Its tools are discovered at connection time and listed alongside the tools registered in code.
McpTransportMode	Enum	The way a connection to an MCP server is made.
MemorySettings	Class	Determines the memory providers bound to an agent.
ModelBinding	Class	Determines the provider and the model an agent runs with. It carries no credentials; the API key is resolved from configuration.
ModelDescriptor	Class	A model’s capabilities and limits.
ModelFallback	Class	One link of a ModelBinding.Fallbacks chain.
ModelOutputLimit	Class	The output token limit a provider’s chat client sends when ModelBinding.MaxOutputTokens is empty.
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	Class	A provider’s definition as shown in the UI.
ModelProviderHealth	Class	A model provider’s status at the last check.
ModelProviderHealthStatus	Enum	A provider’s checked reachability status.
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	Class	One non-token item a workflow function node reported: the persistent record behind GET /api/runs/{runId}/usage.
PendingApproval	Class	The pending tool approval request of a run that executes from the queue.
PricingDiagnostic	Class	Whether the catalog can actually put a price on a run.
PricingSource	Enum	Reports where a run’s cost pricing came from.
ProductionProfileResult	Class	The answer one production profile check gives.
ProductionProfileState	Enum	What a production profile check found.
ProtectedColumn	Enum	A database column IContentProtector can be applied to.
ProviderDiagnostic	Class	Summarizes diagnostics for a model provider.
ProviderRetryDecision	Enum	Whether a provider failure should move to the next fallback link.
QuotaConsumption	Class	The consumption of a completed run to add to the quota counters.
QuotaDefinition	Class	A quota rule defined for a tenant or an agent.
QuotaMetric	Enum	The metric a quota is exceeded by.
QuotaPeriod	Enum	The interval at which a quota’s counter resets.
QuotaUsageQuery	Class	A filter for querying quota usage.
QuotaUsageRecord	Class	A scope’s consumption in the current period.
ReplayToolMode	Enum	How tools are handled during replay.
ResponseCacheSettings	Class	Response caching settings for a ModelBinding.
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	Class	An age- and volume-based retention rule for a target.
RetentionRun	Class	The history record of a cleanup run.
RetentionTargets	Class	The fixed table list a retention policy may target.
RunAccess	Enum	The kind of access a RunAuthorizationRequest asks about.
RunAgentStatistics	Class	An agent’s run summary.
RunAuthorizationRequest	Class	Describes one run awaiting an authorization decision.
RunAuthorizationResult	Class	The outcome of an authorization decision.
RunCompletion	Class	Everything needed to close a run.
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	Class	Error information for a failed run.
RunErrorClass	Enum	A run error’s class.
RunErrorClassification	Class	The result of an IRunErrorClassifier classification.
RunErrorCluster	Class	The summary of runs sharing the same fingerprint.
RunErrorStatistics	Class	An error class’s summary.
RunEvent	Class	A single event produced during a run. Events are append-only: they are never updated, only added.
RunEventCustomTypes	Class	Validation for the CustomType string that qualifies a RunEventType.Custom event.
RunEventType	Enum	Event types produced during a run. The user interface maps these directly onto visual elements, so the values must stay stable.
RunInputRecord	Class	A run’s stored input.
RunJudgeContext	Class	The limited context supplied to a judge.
RunJudgment	Class	The judge’s verdict: the named scores it produced.
RunKind	Enum	Reports what a runs row records.
RunLabels	Class	The limits a run’s attribution must obey, and the single place they are enforced.
RunLabelStatistics	Class	A label’s run summary; one entry per distinct key/value pair.
RunModelStatistics	Class	A model’s run summary. The input to cost computation.
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	Class	Query used to filter the run list.
RunReconciliationOptions	Class	Orphaned-run reconciliation settings.
RunRecord	Class	Summary of a run. It acts as the header of the event stream.
RunRecordingDiagnostic	Class	What a run actually records, as configured.
RunReplayRequest	Class	A replay request.
RunScore	Class	A human (or judge) score for a run or for a single message within a run.
RunScoreAggregate	Class	One aggregated group: every score sharing a breakdown key AND a RunScoreKind.
RunScoreBucket	Enum	A closed, low-cardinality set of time buckets for a score trend series.
RunScoreBucketAggregate	Class	One time bucket of the trend series (RunScoreSummary.Series).
RunScoreBucketing	Class	Shared pure logic for score trend bucket truncation (RunScoreBucket).
RunScoreKind	Enum	The shape of the value a RunScore carries.
RunScoreQuery	Class	The filter for a score summary query (IRunScoreStore.SummarizeAsync).
RunScoreRules	Class	The shared rules a RunScore must satisfy before it is stored.
RunScoreSummary	Class	The result of IRunScoreStore.SummarizeAsync.
RunScoreTarget	Enum	Which target a score belongs to — the filter RunScoreQuery.Target narrows to.
RunSpend	Class	The one place a run’s token cost and its reported (non-token) amount are added.
RunStartInfo	Class	Everything needed to open a new run.
RunStatistics	Class	A summary of the runs in a time range.
RunStatisticsQuery	Class	The filter for a run statistics query.
RunStatus	Enum	Status of a run.
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	Class	Filter for a time-series query.
RunTrace	Class	A run’s span tree. The waterfall view is built on top of this.
RunTreeCost	Class	Total cost of a run tree (the root plus every child run).
RunUsage	Class	Token usage of a run.
RunUserStatistics	Class	A user’s run summary.
RunVersionStatistics	Class	A definition version’s run summary.
SamplingFields	Enum	The request fields of ModelBinding whose support depends on the provider’s API surface.
SessionAccess	Enum	The kind of access a SessionAuthorizationRequest asks about.
SessionAuthorizationRequest	Class	Describes one session access awaiting an authorization decision.
SessionQuery	Class	A filter for querying the session list.
SessionRecord	Class	A stored session.
SingletonExecutionOptions	Class	The settings of single-executor election.
SkillScriptExecutionRequest	Class	One skill script that passed every execution gate, as handed to an ISkillScriptExecutor.
SkillScriptExecutionResult	Class	What one skill script run did, as an ISkillScriptExecutor reports it.
SkillScriptGrant	Class	The record carrying permission to execute a skill script.
SkillScriptOrigin	Enum	Where the content of a skill script came from.
SkillSettings	Class	Settings for how an agent uses the skills it names in AgentDefinition.SkillNames.
SpeechAlignment	Class	One character’s position in the generated audio.
SpeechAudio	Class	Generated audio.
SpeechDialogueAudio	Class	The audio of a dialogue and the time range of each turn.
SpeechDialogueCapabilities	Class	The limits of one dialogue request, as the provider states them.
SpeechDialogueRequest	Class	A request to voice a dialogue.
SpeechDialogueSegment	Class	The time range one turn takes in a dialogue’s audio.
SpeechDialogueTurn	Class	One turn of a dialogue: a text and the voice that speaks it.
SpeechProviderDescriptor	Class	A registered speech provider, as the speech provider list reports it.
SpeechProviderKind	Enum	The kind of a registered speech provider.
SpeechRequest	Class	A text-to-speech generation request.
SpeechTranscript	Class	The result of speech-to-text conversion.
SpeechTranscriptionOptions	Class	Speech-to-text conversion settings.
SpeechUsageSource	Enum	The source of a speech measurement.
SqlPersistenceDiagnosticsSnapshot	Class	Represents the current connection and migration status of an SQL persistence provider.
StructuredResponseValidationContext	Class	The response an IStructuredResponseValidator checks.
StructuredResponseValidationResult	Class	The outcome of a structured response validation check.
SubAgentCallMode	Enum	How an agent calls the agents it may call (CallableAgents).
SubAgentSettings	Class	Determines how an agent calls the agents it may call, and how long it waits for them.
TenantDescriptor	Class	A registered tenant.
TenantEgressPolicy	Class	The set of providers a tenant’s data is allowed to reach (egress policy).
TenantProviderBinding	Class	Binds a tenant to a provider’s credential, by name only.
TimeSeriesBucket	Enum	The bucket width for a time-series query.
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	Class	The tool call a code-defined approval policy judges. Read-only.
ToolApprovalPolicyDecision	Enum	The outcome of a code-defined approval policy (ToolApprovalContext).
ToolApprovalPresentation	Class	A human-readable projection of one tool-approval request, produced by a consumer’s IToolApprovalPresenter.
ToolApprovalRule	Class	A persistent approval rule for a tool call the user said “do not ask again” for.
ToolArgumentCondition	Class	One comparison against a tool call argument: path · operator · value.
ToolArgumentOperator	Enum	A comparison operator for a ToolArgumentCondition.
ToolArgumentsValidationResult	Class	The outcome of a tool arguments validation check.
ToolAuthorizationRequest	Class	Describes one tool call awaiting an authorization decision.
ToolAuthorizationResult	Class	The outcome of an authorization decision.
ToolCallUsage	Class	A non-token measurement and its cost: one tool call’s, or one item a workflow function node reported.
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	Enum	Classifies the blast radius of a tool call.
ToolInvocationRecord	Class	The summary of a single completed tool call.
ToolLoopSettings	Class	Tool-call loop settings for a ModelBinding.
ToolRegistrationOptions	Class	Configures metadata for a tool registration.
ToolUsage	Class	A tool’s usage summary. Shown by the UI’s Tools screen.
ToolUsageQuery	Class	The filter for a tool usage summary.
ToolUsageUnits	Class	The known unit names for ToolCallUsage.Unit.
TraceSpan	Class	A single persisted OpenTelemetry span.
TraceSpanBatch	Class	A span set belonging to a single trace.
TraceSpanKind	Enum	A span’s OpenTelemetry kind. Values are stored in the database as smallint; the numbers are stable.
TraceSpanStatus	Enum	A span’s result status. smallint in the database.
TraconAgentSourceException	Class	Represents a normalized failure from an IAgentSource.
TraconChildRunTimeoutException	Class	Thrown when an agent step of a workflow does not answer within the sub-agent wait limit.
TraconCompilationException	Class	Thrown when an agent definition cannot be turned into a runnable agent.
TraconContentBlockedException	Class	Thrown when an IContentGuard blocks content.
TraconContentFilteredException	Class	Thrown when a model provider cuts the response short with its safety or content filter.
TraconDiagnosticsReport	Class	Reports the self-diagnostics of the installation.
TraconEgressOptions	Class	Shared rules for the target address of outbound network requests.
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	Class	Base class for every error Tracon raises.
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	Class	Finish reasons Tracon reads beyond the ones AI.ChatFinishReason defines.
TraconGeneratedToolArguments	Class	The helper methods called by tool wrappers produced by the source generator while converting JSON arguments to CLR types.
TraconId	Class	UUID version 7 generator for Tracon identifiers (RFC 9562).
TraconInboundTriggerOptions	Class	Options that constrain inbound triggers.
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	Class	The security boundary applied to stored MCP server definitions.
TraconModelConcurrencyOptions	Class	Defines the outgoing concurrency limit applied per model provider.
TraconOutputTruncatedException	Class	Thrown when the model stops at its output token limit before a structured (JSON) response is complete.
TraconPreflightOptions	Class	Defines options for the pre-flight context-window check.
TraconProductionRisk	Enum	One production decision the profile gate refuses to leave unanswered.
TraconProviderUnavailableException	Class	Thrown when the circuit breaker has temporarily taken a model provider out of service.
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	Class	Run options that let the caller determine a run’s identifier, its place in the tree, and its budget.
TraconSchedulingOptions	Class	Batch and scheduled run settings.
TraconSessionConflictException	Class	Thrown for the losing request when two concurrent first requests arrive for the same new session id.
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	Class	Turns per-user session ownership on, a second boundary drawn UNDER the tenant.
TraconStructuredResponseException	Class	Thrown when a run’s response fails structured output validation.
TraconTenantProviderOptions	Class	Options that constrain per-tenant model provider bindings (BYOK).
TraconTenantProviderRefusedException	Class	Thrown when a tenant’s provider rules refuse a call before it leaves the process.
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	Class	Marks a method as a tool. AddToolsFrom registers only methods carrying this attribute.
TraconToolRegistration	Class	A single tool registered with dependency injection. Tracon builds the tool registry from these registrations.
TraconToolTimeoutException	Class	Thrown when a tool call does not settle within its configured timeout.
TraconWorkflowFunctionTimeoutException	Class	Thrown when a function node of a workflow does not return within its timeout.
VectorChunk	Class	A single chunk to write.
VectorSearchHit	Class	A single search result.
VectorSearchRequest	Class	A semantic search request.
VoiceAttributeNames	Class	Names for well-known VoiceDescriptor.Attributes keys. Not exhaustive: a provider may report other safe scalar labels under their own key.
VoiceDescriptor	Class	The definition of an available voice.
VoiceHealth	Class	The voice provider’s reachability status.
VoiceSessionCost	Class	What one voice conversation cost.
VoiceSessionEndReason	Enum	The reason a voice connection closed.
VoiceSessionQuery	Class	The filter for listing voice session records.
VoiceSessionRecord	Class	The summary record of a real-time voice connection.
WebhookDelivery	Class	A single delivery record.
WebhookDeliveryQuery	Class	A filter for querying delivery history.
WebhookDeliveryResult	Class	The result of a delivery attempt.
WebhookDeliveryStatus	Enum	The status of a webhook delivery attempt.
WebhookEvents	Class	The event types Tracon can publish.
WebhookSubscription	Class	An external system’s event subscription.
WorkflowCheckpointRecord	Class	Represents a single checkpoint of a workflow run.
WorkflowDefinition	Class	Represents the full definition of a workflow, whether defined through the UI or in code.
WorkflowDescriptor	Class	Represents a summary view of a workflow listed in the catalog.
WorkflowEdgeKind	Enum	Represents the kind of an edge.
WorkflowGraph	Class	Represents a workflow’s compiled graph: nodes, edges, and external request ports.
WorkflowGraphEdge	Class	Represents the connection between two nodes.
WorkflowGraphNode	Class	Represents a node in the graph.
WorkflowKind	Enum	Represents the built-in workflow patterns that can be defined through the UI.
WorkflowNodeKind	Enum	Represents the role of a graph node.
WorkflowNodeReference	Class	Points to a single node entering a workflow’s graph: an agent from the catalog, or a function registered in code.
WorkflowPendingRequest	Class	Represents human input awaited by a workflow run.
WorkflowRequestForm	Enum	Defines how the UI presents a pending request.
WorkflowRequestQuery	Class	The filter and the page of a listing of a tenant’s open human requests.
WorkflowRequestRecord	Class	One request a workflow run waits on, as the inbox stores it.
WorkflowRequestState	Enum	Which of the open human requests of a tenant a listing returns.
WorkflowRequestStatus	Enum	Whether a run still waits on a request.
WorkflowRespondRequest	Class	Represents a response to a pending request.
WorkflowResponseClaim	Class	The outcome of recording an answer that may claim a request.
WorkflowResponseMode	Enum	How a workflow treats more than one answer to the same pending human request.
WorkflowResponseRecord	Class	One answer to a workflow’s pending human request.
WorkflowResponseStatus	Enum	The state of a recorded answer.
WorkflowResumeRequest	Class	The information needed to resume a workflow from a checkpoint.
WorkflowRunRequest	Class	The information needed to run a workflow.
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.