Tracon.Core

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

Type	Kind	Purpose
AgentCallGraph	Class	Validates an agent call graph at save time.
AgentCallGraphProblem	Struct	The machine-readable result of a call graph validation.
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.
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.
AgentSessionIdentity	Class	Stamps an AI.AgentSession with, and reads back, its Tracon session identity.
AgentSessionManager	Class	Manages the lifecycle of named sessions: loads, restores, and saves them through ISessionStore.
AgentSkillCatalog	Class	Combines code and run-time skill sources with a precedence rule.
AttachmentTypeGuard	Class	Validates an attachment candidate against size and media-type allow lists.
AttachmentUriReference	Class	Converts an attachment to a AI.UriContent reference and resolves that reference back.
AttachmentValidationResult	Struct	The result of validating an attachment.
AuditActorContext	Class	An ambient context that carries the user of the current call.
AuditChainHasher	Class	Computes the hash chain link for an audit trail entry. The single place the canonical form is defined; both the write path and the verify path call it, so the.
AuditChainWalker	Class	Walks an ordered list of audit entries and reports the chain status. Shared by Tracon.InMemoryAuditLog and the SQL providers so the two verify algorithms can.
AuditPayload	Class	Builds a small JSON object for the audit trail.
AuditRecorder	Class	A helper that supplies the common write path for all code that writes audit entries, including store decorators and endpoint-layer exceptions.
AuditSecretFilter	Class	Redacts potential secrets from before and after payloads before they are written to the audit trail.
AuthorizingAIFunction	Class	Wraps an AI.AIFunction with an IToolAuthorizationHandler check that runs before every call.
CallableAgentInfo	Struct	The summary of a callable sub-agent, reported to the model.
CallableAgentResolver	Class	Resolves, from the catalog, the other agents an agent may call.
CanaryEvaluator	Class	Pure decision logic that evaluates a CanaryPolicy against the current results of the canary and control arms.
CanaryOptions	Class	Options for the canary evaluation background service.
ChildAgentInvoker	Class	Wraps a sub-agent an agent may call; enforces depth, budget, and tenant limits and links the sub-run into the tree.
ChildRunApproval	Class	Determines whether a response carries a tool call pending approval.
CodeAgentRegistration	Class	A code-defined agent registration. Use one of two forms: declarative CodeAgentRegistration.Definition or CodeAgentRegistration.Factory, which gives full control.
CompiledAgentCache	Class	Caches compiled agents keyed by (tenant, name, version, skill fingerprint, culture).
ConfigurationKeyGuard	Class	Verifies that a configuration key name a stored record points at sits under an allowed prefix.
ContentGuardPipeline	Class	Pipeline that runs the registered IContentGuard implementations in sequence and records their decisions.
CronExpression	Class	A hand-written parser for the standard five-field cron subset (minute hour day-of-month month day-of-week).
DefaultProviderRetryClassifier	Class	Tracon’s built-in provider retry classifier — the same closed-set rules Tracon.FallbackRetryClassifier has always applied.
DefaultRunAttributionContext	Class	The built-in IRunAttributionContext. It reports whatever AmbientRunAttributionScope carries, and nothing otherwise.
DefaultRunErrorClassifier	Class	Tracon’s built-in error classifier.
DocumentAttachmentSummary	Struct	A document attachment’s identifying information, without its content.
DocumentChannelMessageBuilder	Class	Builds the AI.ChatMessage a document is carried in and lets the recording path tell such a message apart from ordinary instructions text.
EgressAddressPolicy	Struct	The address rules one outbound surface applies to its targets.
EgressAddressValidator	Class	The single place that decides whether an outbound target address is safe.
EgressAddressVerdict	Struct	The result of validating an outbound target address.
EgressSocketGuard	Class	Validates the address a socket is about to connect to, and opens the socket only to an allowed address.
FixedTenantContext	Class	An immutable tenant context that always returns the same tenant.
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.
InboundTriggerDispatchResult	Class	The result of InboundTriggerDispatcher.EnqueueAsync.
InboundTriggerOutcome	Enum	The outcome of validating an inbound trigger request.
InboundTriggerRateLimiter	Class	Applies a fixed-window rate limit per inbound trigger.
InboundTriggerSecretResolver	Class	Resolves an InboundTrigger’s signing secret by reading its configured configuration key.
InboundTriggerValidatedRequest	Class	A request that passed every check and is ready to be queued.
InboundTriggerValidationResult	Class	The result of InboundTriggerDispatcher.ValidateAsync.
InMemoryWorkflowCheckpointStore	Class	Stores workflow checkpoints in process memory.
InstructionCultureResolver	Class	Resolves the instructions text a run should use from an AgentDefinition’s culture dictionary.
InstructionParameterBinder	Class	Substitutes {{name}} placeholders in an instructions text with concrete values.
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.
ModelProviderCircuitBreaker	Class	Circuit breaker that temporarily cuts off requests when a model provider fails consecutively. Holds state per provider name.
ModelProviderHealthCache	Class	Caches the health-check results of the registered model providers.
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).
OnlineEvalSummaryService	Class	Maintains a sliding-window summary of online evaluation scores and publishes WebhookEvents.RunScoreLow when its threshold is crossed.
OnlineEvaluationOptions	Class	Online evaluation settings.
OnlineEvaluationSummary	Class	Summarizes the online evaluation window (GET /api/evaluation/online).
PatternContentGuardOptions	Class	Settings for the built-in pattern-based guard.
PiiPatterns	Enum	The built-in pattern families for Tracon.PatternContentGuard.
ProviderConcurrencyLimiter	Class	Limits concurrent outgoing calls per model provider.
ProviderCredentialClientCache<TFactory\>	Class	Builds and caches a provider-specific client factory keyed by a resolved ModelProviderCredential (BYOK).
QuotaEnforcer	Class	Enforces quota rules and records the consumption of completed runs.
QuotaPeriodCalculator	Class	Calculates which quota period an instant falls into, and when that period resets.
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.
ResolvedRetentionPolicy	Class	Represents a resolved, applicable retention rule for a target.
RetentionExecutor	Class	Provides shared logic for preview and actual cleanup runs. Tracon.RetentionJobHandler and the RetentionEndpoints “run now” and “preview” endpoints use it.
RetentionPolicyResolver	Class	Combines the database policy with the configuration default for a target.
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.
RunPromotionOutcome	Class	Represents the RunToCasePromoter.PromoteAsync outcome and its case, when present.
RunPromotionStatus	Enum	Defines the outcome of RunToCasePromoter.PromoteAsync.
RunRecordingAgent	Class	Run completion: usage/cost merging, error mapping, and the terminal store write. RunRecordingAgent.CompleteAsync fans out to the root-only notifications in.
RunReplayOutcome	Enum	Represents the outcome of a replay preparation.
RunReplayPreparation	Class	Represents a prepared replay plan.
RunSampler	Class	Decides whether to sample a completed run for online evaluation and, when sampled, queues a JobHandlerKeys.OnlineEval job.
RunSampleRequest	Class	Represents the run summary required for a sampling decision.
RunTraceCollector	Class	Listens to Tracon spans, buffers them per run, and writes them to ITraceStore when the run completes, based on the sampling decision.
SandboxedSkillScriptRunner	Class	Tracon’s single script execution path, which runs skill scripts in an isolated operating-system process.
SessionBranchOutcome	Class	The result of a branching attempt.
SessionBranchStatus	Enum	The outcome of a branching attempt.
SingleTenantContext	Class	The default tenant context for single-tenant deployments. It always returns TraconOptions.DefaultTenantId.
SkillScriptExecutionResult	Class	The result of one skill script execution.
SkillScriptNaming	Class	Validates the file name a stored script is written under.
SkillScriptSupport	Class	The compile-path handle for skill script execution: sets up MAF’s file-based skill source and produces the execution delegate for stored scripts.
StateGenerationCount	Class	The number of stored rows carrying one schema generation, and whether this build can read them.
StatePreflight	Class	Answers “can this build still read the state already in the database” WITHOUT writing anything and without starting the application.
StatePreflightReport	Class	What a read-only state preflight found: how many rows carry each stored schema generation, and how a small sample of them behaved when this build tried to read them.
StateSampleFailure	Class	One sampled row the running build could not read.
TenantChatClientCacheKey	Class	Builds the cache key for an AI.IChatClient produced for a tenant credential (BYOK).
TenantProviderCredentialResolver	Class	Resolves a tenant’s TenantProviderBinding into a ModelProviderCredential by reading the bound configuration key’s value.
TextChunker	Class	Splits text into fixed-length chunks with overlap.
TextTrimming	Class	Trims text to a UTF-8 byte limit.
TimeoutAIFunction	Class	Wraps an AI.AIFunction so a call that does not settle within a fixed duration ends in TraconToolTimeoutException instead of running unbounded.
ToolApprovalPolicyRegistration	Class	A code-defined approval policy registered through ITraconBuilder.AddToolApprovalPolicy(…).
ToolApprovalPolicyRegistry	Class	Holds the code-defined approval policies registered at startup, keyed by tool name.
ToolApprovalPresenterRunner	Class	Calls the registered IToolApprovalPresenter for every pending approval request and turns its fail-open contract into an actual guarantee.
ToolApprovalRuleEvaluator	Class	Applies persistent approval rules to a tool call.
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.
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.
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.
TraconEvalCheckRegistration	Class	A custom check registration added through ITraconBuilder.AddEvalCheck(…).
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).
TraconLoopEvaluatorRegistration	Class	A code-defined loop stop criterion registered through ITraconBuilder.AddLoopEvaluator(…).
TraconMetrics	Class	Metrics emitted by Tracon. Consumers collect them with AddMeter(TraconDiagnostics.MeterName).
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.
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.
TruncatingAIFunction	Class	Wraps an AI.AIFunction so a result over a byte limit is trimmed and handed to the model inside an envelope that states how many bytes were dropped, instead of.
ValidatingAIFunction	Class	Wraps an AI.AIFunction with an IToolArgumentsValidator check that runs before every call.
VoiceAudioFormats	Class	The audio formats that the client can send.
VoiceConnectionLease	Class	Represents a reserved voice connection slot.
VoiceConnectionLimiter	Class	Limits concurrent voice connections per tenant.
VoiceConversationBuilderExtensions	Class	Extensions that enable the real-time voice conversation layer.
VoiceConversationOptions	Class	Options of the real-time voice conversation layer.
VoiceConversationProtocol	Class	The frame names and the audio formats of the conversation WebSocket.
VoiceConversationRequest	Class	The immutable facts of a conversation connection.
VoiceLiveOptions	Class	Options of the provider-hosted live voice layer.
VoicePriceOverride	Class	Defines the configured price for one voice model.
WebhookHttpClient	Class	Provides the Http.HttpClient used for webhook delivery, with built-in SSRF protection.
WebhookSigner	Class	Produces and verifies the HMAC-SHA256 signature of webhook requests.
WebhookUrlValidator	Class	Validates webhook target addresses against SSRF.
WebhookUrlVerdict	Struct	The result reporting whether a webhook target is safe.
WorkflowDefinitionValidator	Class	Validates the structural validity of a workflow definition.