Tracon.Core

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

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