Skip to main content

Crate stateknot_core

Crate stateknot_core 

Source
Expand description

Provider-independent domain types shared across StateKnot runtime boundaries.

This crate is intentionally independent of model providers, wire protocols, databases, HTTP servers, and async executors. Implemented contracts are introduced only with strict validation, schemas, and versioned wire fixtures from RFC-0001. Agent admission values freeze authenticated authority, deterministic finite budgets, executable graph identity, and a database-clock commit without depending on any storage implementation.

Structs§

AgentAdmission
Fully committed Agent admission using the authoritative database clock.
AgentAdmissionAuthority
Authenticated principal and policy decision that authorized one new run.
AgentAdmissionBudgetLayer
One immutable, attributable budget-policy layer used at admission.
AgentAdmissionIntent
Caller-controlled, integrity-bound input to database-time admission.
AgentArtifacts
Canonical bounded final artifact references returned by one agent invocation.
AgentDescriptor
Immutable, registry-resolved definition of one typed agent version.
AgentExecutionConfig
Finite, deterministic controls for the prebuilt model/tool agent loop.
AgentInstructions
Ordered, non-empty trusted instructions pinned into one agent definition.
AgentRequest
Schema-bound input and request-local budget constraints for one agent run.
AgentResult
Successful, schema-bound terminal result of one agent invocation.
AgentResultProvenance
Trusted execution identity attached to one successful agent result.
AgentSubmissionKey
Opaque caller key for durable Agent-submission idempotency.
AgentTools
Canonically ordered, registry-resolved tools exposed by one agent.
ArtifactDescription
A bounded human-readable artifact description.
ArtifactId
A tenant-scoped artifact identifier.
ArtifactIdentity
The tenant-qualified identity of an artifact.
ArtifactName
A bounded logical artifact name that is never a filesystem path.
ArtifactParents
A canonical bounded set of direct artifact parents.
ArtifactPresentation
Human-facing artifact metadata, separate from storage coordinates.
ArtifactProvenance
Append-only creator and causation attribution for an artifact.
ArtifactRef
A complete durable reference to immutable artifact bytes.
ArtifactRepresentation
Integrity and interpretation metadata for immutable artifact bytes.
AttemptId
A tenant-scoped node or dependency attempt identifier.
AuthorizationReceiptId
A tenant-scoped durable authorization receipt identifier.
BarrierResultHeads
Canonically ordered, duplicate-free result heads consumed by one barrier.
BoundedJson
An immutable JSON value materialized under validated resource limits.
BudgetLimits
Optional limits supplied by one configuration or request layer.
BudgetRemaining
Remaining finite capacity after evaluating one usage snapshot.
BudgetUsage
Monotonic run usage with explicit provider-observability gaps.
BudgetUsageBuilder
Builder for a validated BudgetUsage snapshot or delta.
ByteCount
A count of input, output, event, checkpoint, or artifact bytes.
CancellationSignal
Cloneable, runtime-neutral handle to cooperative cancellation state.
CanonicalJson
Immutable RFC 8785 JSON Canonicalization Scheme bytes.
CapabilityDescription
Bounded trusted-registry description text for a capability.
CapabilityIdentity
An owner-qualified, version-pinned capability identity.
CapabilityLifecycle
Validated lifecycle metadata for one pinned capability version.
CapabilityMetadata
Common discovery metadata shared by specialized capability descriptors.
CapabilityName
A stable, case-sensitive capability name.
CapabilityReference
A version-pinned reference to a registered capability.
CapabilityTitle
A bounded single-line display title for a capability.
Checkpoint
One committed, self-validating graph checkpoint.
CheckpointBarrier
Integrity-bound semantic input to one successor checkpoint transaction.
CheckpointHead
Compact exact identity of a previously validated committed checkpoint.
CheckpointId
A tenant-scoped immutable checkpoint identifier.
CheckpointLineageVerifier
Streaming verifier for a checkpoint lineage read from newest to oldest.
CheckpointState
Immutable, schema-pinned JSON graph state with a verified checksum.
CheckpointWrite
Stable checkpoint write intent before the anchoring journal event commits.
ChildAgentReference
Exact Agent definition pin, including instructions, tools, model and limits.
ChildRunAdmissionIntent
A bounded, immutable child admission candidate and its stable retry digest.
ChildRunBudgetAccount
Bounded, integrity-bound accounting state for one parent admission.
ChildRunBudgetEntry
A lifetime child slot record. Settled entries are retained for retry identity.
ChildRunBudgetSettlement
Exact, fully priced terminal contribution of one immediate child subtree.
ChildRunDeclaration
One node-owned, named delegation slot with pinned Agent and graph contracts.
ChildRunJoinBinding
Immutable complete, priced terminal evidence in the request’s declared order. Each position corresponds to the same-position ownership key. A store must revalidate the actual owned admission and exact terminal journal for every position; a matching checksum is not authentication or proof of execution.
ChildRunJoinHead
Compact Join evidence consumed by a parent pending result. The parent event is not a child terminal event: cross-Run journal sequences are never compared.
ChildRunJoinRequest
One sealed, nonempty set of owned children for one logical parent activation. The store must prove ownership and require the complete admitted set before registering it. Construction alone grants no authority and performs no I/O.
ChildRunKey
Integrity-bound logical ownership key for one isolated child Run.
ChildRunSlot
A stable, case-sensitive child slot declared by an executable definition.
ChildRunTopologyLimits
Finite topology limits pinned by a parent graph, never unlimited defaults.
CompiledGraph
Canonical, schema-pinned declarative graph compiled before admission.
ContentMetadata
Security and source metadata carried by each content value.
CostLimits
A bounded set of monetary ceilings keyed by currency.
CumulativeBudgetReservation
An immutable ceiling reserved for cumulative work, not observed usage.
CurrencyCode
A structurally valid ISO 4217 alphabetic currency code.
DeliveryFence
Fencing token authorizing one fixed physical delivery attempt.
DeliveryId
A tenant-scoped durable outbox delivery identifier.
DestinationId
A tenant-scoped durable outbox destination identifier.
Digest
A canonical integrity digest.
DurableTimer
Immutable timer committed with its registration journal fact.
DurableTimerHead
Compact immutable timer anchor carried by a firing intent.
DurableTimerRecord
Complete durable timer history: one registration and at most one firing.
DurationMillis
A non-negative duration represented as signed 64-bit milliseconds.
EventId
A tenant-scoped durable event identifier.
ExecutionCount
A count of graph steps, model attempts, tool calls, branches, delegations, or retries.
ExtensionKey
A stable namespace identity for one extension value.
ExtensionLimits
Validated limits that may only narrow StateKnot’s hard extension ceiling.
Extensions
A sorted, unique, resource-bounded extension map.
Failure
One protocol-neutral failure occurrence.
FailureCode
A stable, machine-readable failure code owned by an application or adapter.
FailureDetails
Schema-bound, resource-limited structured information safe to expose.
FailureId
A tenant-scoped failure occurrence identifier.
FailureMessage
A bounded message explicitly approved for public error surfaces.
FailureOrigin
A stable component or dependency namespace that originated a failure.
FencingEpoch
Positive, monotonically increasing database fencing epoch for one run.
GraphBarrierPlan
Complete deterministic plan ready for an existing atomic barrier API.
GraphChildRunPolicy
Closed version-one delegation profile embedded in the parent graph digest.
GraphComposition
A canonical ordinary graph plus its deterministic executor source map.
GraphExecutionLimits
Hard execution ceilings embedded in one graph definition.
GraphNamespace
Slash-separated namespace of one node inside a root or nested graph.
GraphNode
Declarative control surface for one stable graph node.
GraphNodeSource
Original executable role for one generated node identity.
GraphReducerInput
One immutable update presented to a reducer in canonical node order.
GraphReducerReference
Exact executable reducer revision required by a compiled graph.
GraphReference
Exact graph definition and state schema required to resume a checkpoint.
GraphRoute
One declared conditional branch and its non-empty successor set.
GraphRoutes
Canonically ordered, duplicate-free route collection for one node.
GraphSubgraphCall
One static call-site replacement in a parent graph.
Instruction
A versioned, owner-attributed, integrity-bound trusted instruction.
InstructionIdentity
Stable identity of an application-owned instruction record.
InstructionName
A stable, case-sensitive instruction name.
InstructionProvenance
Application-owned provenance for a trusted instruction.
InterruptId
A tenant-scoped interrupt identifier.
InterruptRecord
Complete durable interrupt history: one request and at most one resolution.
InterruptRequest
Immutable interrupt request committed with its registration journal fact.
InterruptRequestHead
Compact immutable interrupt anchor carried by a resolution.
InterruptRequestIntent
Pre-commit request to register one externally resolvable interrupt.
InterruptResolution
Immutable authorized resolution committed with its journal fact.
InterruptResolutionIntent
Pre-commit authenticated resolution of one exact interrupt request.
InterruptResolver
Authenticated identity and granted authorization scopes of one resolver.
InvocationId
A tenant-scoped external invocation identifier.
IssuerId
An exact, case-sensitive OIDC/OAuth issuer identifier.
JournalAppend
Atomic append request combining an idempotent intent and exact head check.
JournalChainVerifier
Streaming verifier for a complete journal or a suffix after a trusted head.
JournalEvent
One committed, self-validating record in a run’s append-only journal.
JournalEventIntent
Stable idempotent request to append one semantic event.
JournalEventKind
Stable lower-kebab-case semantic name of a durable event payload.
JournalHead
Exact committed journal head used for optimistic append comparison.
JournalPayload
Schema-bound durable event payload whose checksum uses RFC 8785 bytes.
JournalSequence
Positive, contiguous event position within one tenant-scoped run journal.
JsonContent
Structured content materialized under bounded JSON limits.
JsonLimits
Validated resource limits applied while JSON is materialized.
JsonStats
Safe aggregate statistics for a materialized BoundedJson value.
KnownCosts
Known accumulated monetary charges keyed by currency.
LanguageTag
A stable, case-normalized RFC 5646 language tag.
MediaType
A concrete, canonical media type for stored artifact bytes.
Message
A durable, provenance-bound conversation message.
MessageId
A tenant-scoped durable message identifier.
MessageParts
A bounded, ordered, non-empty list of content parts.
MessageProvenance
Durable causation and producer attribution for a message.
ModelCapabilities
Immutable capabilities of one exact model, adapter, and endpoint binding.
ModelCapabilityMismatch
Deterministic, non-empty set of every unmet model requirement.
ModelContext
Ephemeral, capability-limited context for exactly one model attempt.
ModelDescriptor
Immutable, protocol-neutral description of one executable model binding.
ModelError
Public-safe typed failure returned by a model adapter.
ModelErrorProvenance
Correlation evidence attached to a failed model attempt.
ModelEvent
Provider-neutral semantic event emitted by one model attempt.
ModelEventAccumulator
Fail-closed state machine that assembles one verified streaming response.
ModelInvocation
One immutable, journal-anchored revision of a logical model invocation.
ModelInvocationHead
Compact exact identity of a validated model invocation revision.
ModelInvocationHistoryVerifier
Streaming validator for one complete ascending model invocation history.
ModelInvocationIntent
Immutable preparation intent for one logical model invocation.
ModelInvocationRevision
Monotonic zero-based revision of one logical model invocation.
ModelModalities
Sorted, duplicate-free model modality set.
ModelProviderModelId
An opaque model identifier reported by the selected provider binding.
ModelProviderReplay
Exact bounded provider response fragment required for stateless continuation.
ModelProviderReplayFormat
Versioned adapter-owned syntax for one exact provider replay fragment.
ModelProviderRequestId
An opaque request correlation identifier reported or recognized by a model provider.
ModelProviderResponseId
An opaque response identifier reported by a model provider.
ModelProviderToolCallId
An opaque provider correlation identifier for one proposed tool call.
ModelRequest
Immutable, fully normalized request passed to a model adapter.
ModelRequestBuilder
Fluent, fail-closed builder for ModelRequest.
ModelRequestLimits
Finite, provider-neutral ceilings for one model request.
ModelRequirements
Provider-neutral requirements derived from one concrete model request.
ModelResponse
Immutable, fully normalized result of one model attempt.
ModelResponseProvenance
Stable and provider-reported identity for one model attempt response.
ModelStreamChunk
One exact, non-empty provider-normalized stream fragment.
ModelStructuredOutputCapabilities
Structured final-output support for one model binding.
ModelTokenLimits
Explicitly known token ceilings for one model-and-endpoint binding.
ModelToolCallProposal
A complete, unapproved tool-call proposal emitted by a model.
ModelToolCapabilities
Model support for tool definitions, selection, and emitted calls.
ModelToolChoices
Sorted, duplicate-free set of tool-selection controls.
ModelToolFailure
Public-safe durable failure snapshot supplied back to a model.
ModelToolRequirements
Minimum tool support needed by one model request.
ModelTranscript
Bounded ordered prior model/tool turns for one stateless request.
ModelTranscriptTurn
One completed model tool-call turn and its complete durable outcomes.
ModelUsage
Normalized token accounting for exactly one model attempt.
Money
A non-negative known monetary cost in integer micro-units.
NodeActivation
Exact graph-node activation that owns a logical tool invocation.
NodeAttempt
Fully restored physical node attempt, executing or terminal.
NodeAttemptCompletion
Immutable terminal record for one already-started physical node attempt.
NodeAttemptHistoryVerifier
Streaming validator for one logical activation’s physical attempts.
NodeAttemptStart
Immutable proof that one physical node execution was durably admitted.
NodeAttemptStartHead
Exact compact identity of one durable node-attempt start.
NodeId
Stable, case-sensitive identity of one compiled graph node.
NodeInvocationBindings
Canonically ordered, duplicate-free, bounded external invocation bindings.
NodeStateUpdate
Schema-pinned bounded update emitted by one successful node activation.
NodeTerminalOutput
Schema-pinned bounded output emitted by a terminal graph node.
NodeWaits
Non-empty, bounded, identity-unique uncommitted wait batch.
OutboxAttempt
Fully restored physical delivery attempt, active or terminal.
OutboxAttemptCompletion
Immutable terminal record for one already-started delivery attempt.
OutboxAttemptHistoryVerifier
Streaming validator and state projector for one delivery’s attempt history.
OutboxAttemptStart
Durable admission record committed before one network request begins.
OutboxAttemptStartHead
Compact exact identity of one durable delivery-attempt start.
OutboxDelivery
Immutable outbox record atomically committed with its origin journal fact.
OutboxDeliveryHead
Compact, integrity-verifiable identity of one committed delivery.
OutboxDeliveryIntent
Idempotent pre-commit request to enqueue one notification.
OutboxDestinationRef
Immutable reference to one tenant-owned destination configuration snapshot.
PendingNodeResult
One immutable, worker-fenced and journal-anchored pending node result.
PendingNodeResultHead
Compact exact identity of one pending node result.
PendingNodeResultIntent
Immutable semantic result for one logical node activation before commit.
PrincipalIdentity
The stable external identity of an authenticated principal.
QuarantineId
A tenant-scoped durable run-quarantine observation identifier.
ReadyNodeRecoveryPlan
Immutable deterministic plan for the exact ready set of one checkpoint.
ReadyNodeRecoveryPlanner
Incremental, bounded verifier for one ready-node recovery snapshot.
ReadyNodes
Deterministically ordered set of nodes eligible for the next superstep.
ResolvedBudget
A complete, finite run budget after all applicable layers are intersected.
RetentionClass
An opaque, case-sensitive artifact retention-policy class.
RouteId
Stable conditional route identity declared by a compiled graph.
RunCancellation
Terminal acknowledgement of an earlier immutable cancellation request.
RunCancellationRequest
Immutable cancellation intent committed before cooperative cleanup.
RunFailure
Non-cancellation terminal failure with complete cumulative usage.
RunFence
Run-scoped proof of one physical execution attempt’s ownership epoch.
RunId
A tenant-scoped durable run identifier.
RunInterrupt
Immutable lifecycle marker for one unresolved interrupt.
RunLease
Snapshot of the current exclusive execution lease for one run.
RunLifecycle
Immutable snapshot of one admitted run’s protocol-neutral business state.
RunRevision
Monotonic optimistic revision of a run lifecycle snapshot.
RunTimer
Immutable marker for one unresolved durable timer.
RunWaits
Non-empty, bounded batch of conditions registered by one state transition.
SchedulerReservationId
A durable distributed-scheduler slot-reservation identifier.
SchedulerShardId
A stable distributed-scheduler shard identifier.
SchemaId
A normalized, absolute HTTPS identifier for a schema resource.
SchemaReference
An immutable reference to canonical JSON schema bytes.
Scope
A bounded, case-sensitive OAuth 2.0 scope token.
ScopeSet
A bounded set of unique scopes with deterministic canonical ordering.
SecurityLabel
An opaque, bounded label interpreted only by an explicit policy engine.
SharedStateSubgraph
A finite, shared-state subgraph template with explicit return ports.
SkillActingWindow
Durable database-clock Skill authority window.
SkillActingWindowDuration
Strict requested lifetime for an acting window.
SkillActingWindowId
A tenant-scoped durable Skill acting-window identifier.
SkillActingWindowOpenRequest
Idempotent request to open an approved acting window.
SkillActingWindowRevocation
Immutable first revocation event for an acting window.
SkillActivationApproval
Immutable policy approval for one exact Skill activation.
SkillActivationApprovalId
A tenant-scoped durable Skill activation approval identifier.
SkillActivationScope
Exact durable run scope in which one Skill may act.
SkillActivationStoreError
Payload-redacted durable Skill activation store failure.
SkillAuthorizationSubject
Exact external Skill content approved for activation.
SubjectId
A bounded, case-sensitive OIDC subject identifier.
Superstep
Zero-based graph superstep committed at a deterministic barrier.
TenantId
A validated tenant boundary identifier.
TextContent
Validated, bounded UTF-8 text with mandatory security metadata.
ThreadId
A tenant-scoped conversation thread identifier.
TimerFiring
Immutable timer firing committed with its journal fact.
TimerFiringIntent
Pre-commit request to fire one exact durable timer.
TimerId
A tenant-scoped durable timer identifier.
TimerRegistrationIntent
Pre-commit request to register one durable timer.
Timestamp
A UTC instant with canonical microsecond precision.
TokenCount
A count of model input, cached-input, reasoning, or output tokens.
ToolAdapter
Framework-owned typed-to-erased adapter with pinned schema enforcement.
ToolArtifacts
Canonical bounded set of artifact references returned by one tool call.
ToolAuthorizationProvenance
Exact durable invocation identity covered by an authorization decision.
ToolAuthorizationReceipt
Immutable approval evidence that must be durable before provider I/O.
ToolAuthorizationReceiptSinkError
Payload-redacted durable receipt sink failure.
ToolContext
Ephemeral, capability-limited context for exactly one tool attempt.
ToolDescriptor
Immutable, protocol-neutral description of one executable tool version.
ToolError
Public-safe typed failure returned by a tool implementation or adapter.
ToolErrorProvenance
Stable invocation and tool identity attached to a failed tool attempt.
ToolExecutionLimits
Finite per-invocation execution ceilings declared by a tool version.
ToolExecutionSemantics
Validated side-effect and recovery semantics for one tool version.
ToolIdempotencyKey
Stable provider-facing idempotency key for one logical tool invocation.
ToolInput
Schema-bound, resource-limited arguments for one erased tool invocation.
ToolInvocation
One immutable, journal-anchored revision of a logical tool invocation.
ToolInvocationCapabilities
Runtime-facing optional behavior supported by a tool implementation.
ToolInvocationHead
Compact exact identity of a validated invocation revision.
ToolInvocationHistoryVerifier
Streaming validator for one complete ascending invocation history.
ToolInvocationIntent
Immutable preparation intent for one logical tool invocation.
ToolInvocationRevision
Monotonic zero-based revision of one logical invocation record.
ToolOutput
Typed output plus independently bounded artifact references.
ToolProgressEvent
Ordered, identity-bound progress event accepted by the runtime sink.
ToolProgressProvenance
Stable identity attached to every progress event from one attempt.
ToolProgressReporter
Cloneable ordered progress handle bound to one physical attempt.
ToolProgressSinkError
Private diagnostic returned by a runtime progress sink.
ToolProgressUpdate
One normalized numeric progress observation requested by a tool.
ToolReconciliationContext
Ephemeral, capability-limited context for reconciling one physical tool attempt.
ToolReconciliationProbeError
Public-safe failure of the reconciliation probe itself.
ToolRecoveryHandle
Bounded opaque reference used to resume one provider-side operation.
ToolResourceRequirements
Resource categories that must be satisfied by an executor profile.
ToolResult
Successful erased tool result ready for durable validation and commit.
ToolResultProvenance
Stable invocation and tool identity attached to a successful tool result.
ToolSchemaValidationError
Private diagnostic returned by a trusted local tool schema registry.
Version
A canonical three-component semantic version.

Enums§

AgentAdmissionAuthorityError
Invalid trusted authorization snapshot.
AgentAdmissionBudgetLayerError
Invalid immutable budget policy layer.
AgentAdmissionError
Invalid or corrupted committed Agent admission.
AgentAdmissionIntentError
Invalid or corrupted pre-commit Agent admission input.
AgentArtifactsError
Invalid final artifact collection for one successful agent invocation.
AgentDescriptorError
Invalid cross-component agent definition snapshot.
AgentExecutionConfigError
Invalid prebuilt agent-loop controls.
AgentInstructionsError
Invalid agent instruction collection.
AgentRequestValidationError
Invalid relationship between an agent request and an admission snapshot.
AgentResultError
Intrinsic invalidity in a successful terminal agent result.
AgentResultProvenanceError
Descriptor-binding failure for trusted agent result provenance.
AgentResultValidationError
Invalid relationship between a terminal result and trusted run snapshots.
AgentStructuredOutputStrategy
Resolved mechanism used to obtain a typed final output.
AgentSubmissionKeyError
Invalid external Agent-submission idempotency key.
AgentToolConcurrency
Deterministic scheduling mode for ordinary tool calls from one response.
AgentToolsError
Invalid agent tool collection.
ArtifactDescriptionError
Validation failure for ArtifactDescription.
ArtifactModality
Semantic modality used for provider capability negotiation and rendering.
ArtifactNameError
Validation failure for ArtifactName.
ArtifactParentsError
Validation failure for ArtifactParents.
ArtifactRefError
Validation failure for ArtifactRef.
ArtifactRepresentationError
Validation failure for ArtifactRepresentation.
BarrierResultHeadsError
Invalid compact result set for a checkpoint barrier.
BoundedJsonError
JSON rejected by syntax, interoperability, or resource-safety validation.
BudgetDimension
Stable budget dimension used by resolution and enforcement errors.
BudgetEvaluationError
Failure while evaluating a complete budget against usage.
BudgetNarrowingError
An attempted child or delegated budget would widen immutable parent limits.
BudgetResolutionError
Failure while intersecting partial budget layers.
BudgetUsageError
Failure while constructing or monotonically accumulating usage.
CanonicalJsonError
Failure to produce integrity-bearing RFC 8785 bytes.
CapabilityDescriptionError
Invalid capability description text.
CapabilityKind
Stable classification of a discoverable capability.
CapabilityLifecycleError
Invalid capability lifecycle metadata.
CapabilityLifecycleState
Stable lifecycle classification for a capability version.
CapabilityMetadataError
Invalid cross-field capability metadata.
CapabilityNameError
Validation failure for a CapabilityName.
CapabilityTitleError
Invalid capability title text.
CheckpointBarrierError
Invalid or corrupted checkpoint barrier intent.
CheckpointBarrierIntegrityError
Failure to canonicalize checkpoint barrier integrity material.
CheckpointError
Invalid or corrupted committed checkpoint.
CheckpointHeadError
Invalid scope in a compact checkpoint head.
CheckpointIntegrityError
Failure to produce a domain-separated checkpoint checksum.
CheckpointLineageError
Rejected checkpoint in reverse lineage verification.
CheckpointStateError
Invalid or corrupted checkpoint state.
CheckpointWriteError
Structurally invalid or corrupted checkpoint write intent.
ChildRunAdmissionIntentError
Closed public-safe child preparation or fresh-admission validation failure.
ChildRunBudgetError
Closed, public-safe accounting refusal without child inputs or outputs.
ChildRunJoinError
Closed validation failures, without child inputs, outputs or diagnostics.
ChildRunKeyError
Failure constructing or restoring a logical child ownership key.
ChildRunPolicyError
Public-safe declaration/profile validation failure; no request data is exposed.
ContentPart
A closed v1 content value used across runtime boundaries.
ContentSource
The immediate domain source from which content entered StateKnot.
ContentTrust
An asserted content trust classification.
CostCollectionError
Validation or arithmetic failure for a currency-keyed cost collection.
CountParseError
Parse failure for a canonical token or byte count.
CumulativeBudgetReservationError
Invalid cumulative reservation or insufficient projected budget capacity.
CurrencyCodeError
Validation failure for a CurrencyCode.
DigestAlgorithm
An integrity hash algorithm supported by StateKnot.
DigestError
Parse failure for a canonical Digest.
DurableWait
One fully materialized durable wait registration.
DurableWaitError
Invalid durable wait registration, authorization, timing, or integrity.
DurationMillisError
Validation or conversion failure for DurationMillis.
ExtensionKeyError
Invalid extension namespace identity.
ExtensionKeyKind
Namespace form used by an ExtensionKey.
ExtensionLimit
Configurable dimension of the bounded extension-map contract.
ExtensionLimitsError
Invalid configurable extension-map limits.
ExtensionValue
Explicit trust mode for one extension value.
ExtensionsError
Invalid bounded extension-map data.
FailureBuildError
Invalid relationship between failure category and recovery advice.
FailureCategory
Stable semantic category shared by component-specific errors.
FailureDetailsError
Invalid schema-bound public failure details.
FailureIdentifierError
Validation failure shared by FailureCode and FailureOrigin.
FailureMessageError
Invalid public failure message text.
FencingEpochError
Invalid canonical fencing epoch.
GeneratedIdError
Parse or construction failure for a StateKnot-generated identifier.
GraphBarrierDisposition
Semantic lifecycle outcome selected by one complete graph barrier.
GraphBarrierPlanError
Failure to derive one deterministic, storage-ready barrier plan.
GraphCompileError
Invalid canonical graph definition.
GraphCompositionError
Fail-closed rejection of a shared-state composition before admission.
GraphExecutionLimitsError
Invalid compiled graph execution limits.
GraphNamespaceError
Invalid graph namespace.
GraphNodeError
Invalid local control shape for one graph node.
GraphReducerError
Public-safe failure returned by one pure graph reducer.
GraphRouteError
Invalid conditional graph route.
GraphRoutesError
Invalid route collection for one node.
GraphSchemaValidationError
Public-safe reason a schema registry could not validate a value.
GraphValueKind
Closed value class used in public-safe graph validation failures.
InstructionContent
A closed v1 instruction payload.
InstructionError
Validation failure for Instruction.
InstructionNameError
Validation failure for InstructionName.
IssuerIdError
Validation failure for an IssuerId.
JournalAppendError
Invalid exact-head scope in an append request.
JournalAuthorityError
Rejected worker-authority preflight.
JournalChainError
Rejected event in streaming journal-chain verification.
JournalEventError
Intrinsically invalid journal event or append materialization.
JournalEventKindError
Invalid durable event kind.
JournalEventSource
Trusted runtime origin assigned to one journal append.
JournalExpectation
Optimistic journal precondition supplied with an append request.
JournalIntegrityError
Failure to produce a small domain-separated journal checksum.
JournalIntentError
Invalid relationship or checksum in an event append intent.
JournalPayloadError
Invalid canonical durable event payload.
JournalSequenceError
Invalid canonical journal sequence.
JsonLimit
A configurable dimension of the bounded JSON contract.
JsonLimitsError
Invalid configuration for JsonLimits.
LanguageTagError
Validation failure for a LanguageTag.
MediaTypeError
Validation failure for MediaType.
MessageError
Validation failure for Message.
MessagePartsError
Validation failure for MessageParts.
MessageProducer
Typed attribution for the entity that produced a message.
MessageProducerKind
Stable classification of a message producer.
MessageRole
Stable semantic role of a conversation message.
ModelCapabilitiesError
Invalid cross-component model capability declaration.
ModelCapabilityIssue
One unmet model requirement with known available capacity where useful.
ModelCapabilityMismatchError
Invalid mismatch diagnostic set.
ModelContextError
Failure to construct a finite model-attempt context.
ModelDescriptorError
Invalid cross-component model descriptor.
ModelErrorPhase
Stage at which one model attempt failed.
ModelErrorValidationError
Invalid relationship between a model failure and its invocation snapshot.
ModelEventError
Intrinsically invalid provider-neutral model event.
ModelEventKind
Closed semantic body of a provider-neutral model event.
ModelEventStreamError
Invalid sequence or content in one normalized model event stream.
ModelFinishReason
Portable reason why model generation stopped.
ModelInvocationError
Invalid model invocation record, transition, provenance, or integrity layer.
ModelInvocationHeadError
Invalid compact model invocation head.
ModelInvocationHistoryError
Invalid ascending model invocation history.
ModelInvocationIntegrityError
Failure to canonicalize a closed model invocation checksum preimage.
ModelInvocationIntentError
Invalid durable model invocation intent.
ModelInvocationRevisionError
Invalid canonical model invocation revision.
ModelInvocationState
Integrity-bound state payload of one model invocation revision.
ModelInvocationStatus
Durable lifecycle state of one logical model invocation.
ModelInvocationTransition
Explicit transition appended to the run journal and model history.
ModelInvocationTransitionKind
Kind of one explicit model invocation state transition.
ModelModalitiesError
Invalid model modality set.
ModelModality
Coarse semantic media understood or produced by a model binding.
ModelOutputDelta
One typed exact fragment for an already-started output item.
ModelOutputDeltaKind
Closed classification of a semantic model-output delta.
ModelOutputItem
One item in provider order from a model response.
ModelOutputItemError
Invalid intrinsic metadata on an ordered model output item.
ModelOutputItemKind
Classification of one ordered model output item.
ModelOutputStart
Header that fixes the type and immutable metadata of one streamed output.
ModelProviderIdentifierError
Validation failure for an opaque provider identifier.
ModelProviderReplayError
Invalid opaque provider replay evidence.
ModelProviderReplayFormatError
Invalid provider replay format identifier.
ModelRequestError
Invalid provider-neutral model request.
ModelRequestLimitsError
Invalid finite request limits.
ModelRequirementsError
Invalid model requirements.
ModelResponseError
Invalid provider-neutral model response.
ModelResponseMode
How a model invocation delivers its response.
ModelStopReason
Reason a model boundary must stop before producing another result.
ModelStreamChunkError
Invalid semantic model-stream fragment.
ModelStructuredOutputCapabilitiesError
Invalid structured-output capability declaration.
ModelStructuredOutputLevel
Strength of structured final-output support.
ModelTextOutputFormat
Requested format for the text portion of a model response.
ModelTokenLimitsError
Invalid model token-limit snapshot.
ModelToolCallProposalError
Invalid model-produced tool-call proposal.
ModelToolCapabilitiesError
Invalid model tool capability declaration.
ModelToolChoice
Provider-neutral tool-selection control.
ModelToolChoicesError
Invalid model tool-choice set.
ModelToolFailureError
Invalid public-safe tool failure continuation evidence.
ModelToolOutcome
One exact tool outcome paired to a provider call identifier.
ModelToolRequirementsError
Invalid model tool requirements.
ModelToolSelection
Tool-selection behavior for one model request.
ModelTranscriptError
Invalid complete model/tool transcript.
ModelTranscriptTurnError
Invalid model/tool transcript turn.
ModelUsageError
Invalid normalized model-attempt usage.
ModelUsageField
Token-usage dimension used in monotonic stream diagnostics.
MoneyArithmeticError
Failure from checked monetary arithmetic.
NodeActivationError
Invalid deterministic construction of a ready-node activation.
NodeAttemptError
Invalid node-attempt scope, causation, lifecycle, or integrity material.
NodeAttemptHistoryError
Invalid physical-attempt history for one logical node activation.
NodeAttemptIntegrityError
Failure to canonicalize node-attempt integrity material.
NodeAttemptOutcome
Immutable terminal outcome of one physical node attempt.
NodeAttemptStatus
Durable lifecycle state of one physical node attempt.
NodeControl
Closed control outcome emitted alongside a node’s state contribution.
NodeControlKind
Stable discriminator for one node control result.
NodeDispatchReason
Stable reason that one logical activation may start a new physical attempt.
NodeIdError
Invalid graph node identity.
NodeInvocationBinding
Exact terminal external invocation consumed by one node result.
NodeInvocationBindingError
Invalid external invocation binding.
NodeInvocationBindingKind
Kind of external invocation referenced by a pending node result.
NodeInvocationBindingsError
Invalid pending-result invocation collection.
NodeStateChange
State contribution from one successful logical node activation.
NodeStateUpdateError
Invalid or corrupted schema-pinned node update.
NodeTerminalOutputError
Invalid or corrupted schema-pinned terminal output.
NodeWait
Complete, uncommitted lifecycle condition emitted by a graph node.
NodeWaitsError
Invalid graph wait specification batch.
OutboxAttemptError
Invalid attempt fence, timing, completion, or checksum.
OutboxAttemptHistoryError
Invalid physical-attempt history for one logical delivery.
OutboxAttemptIntegrityError
Failure to canonicalize attempt integrity material.
OutboxAttemptOutcome
Terminal outcome of one physical delivery attempt.
OutboxAttemptStatus
Lifecycle state of one physical outbox attempt.
OutboxDeliveryError
Invalid delivery scope, atomic origin binding, deadline, or checksum.
OutboxDeliveryIntegrityError
Failure to canonicalize delivery integrity material.
OutboxDeliveryStatus
Projected lifecycle of a complete delivery at one database observation.
PendingNodeResultError
Invalid or corrupted pending node-result record.
PendingNodeResultIntegrityError
Failure to canonicalize pending node-result integrity material.
PendingNodeResultIntentError
Invalid or corrupted pending node-result intent.
ReadyNodeRecoveryError
Invalid or contradictory inputs to deterministic ready-node recovery.
ReadyNodesError
Invalid next-superstep ready set.
RecoveryNode
Deterministic recovery decision for one logical ready-node activation.
RecoveryNodeKind
Closed scheduler classification for one checkpoint-ready node.
RedactionState
The redaction transformation recorded for this representation.
RetentionClassError
Validation failure for RetentionClass.
RetryAdvice
Explicit recovery advice supplied by the originating component.
RouteIdError
Invalid conditional route identity.
RunCancellationError
Invalid cancellation intent or acknowledgement.
RunFailureError
Invalid failure supplied to the ordinary failed terminal state.
RunInterruptError
Invalid intrinsic timing for a run interrupt.
RunInterruptKind
Semantic reason why a run needs an externally supplied resolution.
RunLeaseError
Intrinsically invalid lease acquisition, renewal, or supersession.
RunLeaseValidationError
Rejected worker write against the current lease snapshot.
RunLifecycleError
Intrinsically invalid serialized lifecycle snapshot.
RunStatus
Stable projection of a run’s current business lifecycle.
RunTimerError
Invalid intrinsic timing for a durable run timer.
RunTimerKind
Semantic purpose of one durable run timer.
RunTransition
One immutable input to the pure run lifecycle state machine.
RunTransitionError
Rejected pure lifecycle transition.
RunTransitionKind
Stable name of an attempted lifecycle transition.
RunWait
One explicit condition suspending semantic run progress.
RunWaitsError
Invalid batch of run wait conditions.
SchedulerShardIdError
Validation failure for a SchedulerShardId.
SchemaIdError
Validation failure for a SchemaId.
ScopeError
Validation failure for a Scope.
ScopeSetError
Construction or deserialization failure for a ScopeSet.
SecurityLabelError
Validation failure for a SecurityLabel.
SkillActingWindowError
Invalid or corrupted Skill approval/window evidence.
SkillActingWindowRevocationReason
Closed reason for permanently revoking an acting window.
SkillActivationSource
Why the exact Skill received fresh activation approval.
SkillActivationStoreFailure
Stable public class for durable Skill activation storage failures.
SkillAuthorizationSubjectError
Invalid external Skill subject.
SubjectIdError
Validation failure for a SubjectId.
SuperstepError
Invalid canonical superstep value.
TenantIdError
Validation failure for a TenantId.
TextContentError
Validation failure for TextContent.
TimestampError
Validation or conversion failure for a Timestamp.
ToolAdapterBuildError
Registration failure for a typed tool adapter.
ToolArtifactBinding
Artifact binding field rejected while restoring a durable result.
ToolArtifactsError
Invalid artifact collection returned by one tool attempt.
ToolAuthorizationOperation
Provider operation authorized by one immutable receipt.
ToolAuthorizationReceiptError
Invalid or corrupted Tool authorization receipt.
ToolAuthorizationReceiptSinkFailure
Stable failure class returned by a durable authorization-receipt sink.
ToolCancellationSupport
Cancellation behavior exposed by a tool implementation.
ToolContextBindingError
Invalid relationship between a tool context and descriptor snapshot.
ToolContextError
Failure to construct a finite tool-attempt context.
ToolDescriptorError
Invalid cross-component tool descriptor.
ToolErrorBuildError
Invalid intrinsic relationship within a ToolError.
ToolErrorPhase
Stage at which one physical tool attempt failed.
ToolErrorValidationError
Invalid relationship between a tool failure and invocation snapshot.
ToolExecutionLimitsError
Invalid per-invocation tool limits.
ToolExecutionSemanticsError
Invalid tool side-effect and recovery semantics.
ToolExternalEffect
Best available evidence about externally observable write effects.
ToolIdempotency
Mechanism governing repeated invocation of a tool operation.
ToolInputError
Invalid structural tool input.
ToolInputValidationError
Invalid relationship between tool input and an invocation snapshot.
ToolInvocationError
Invalid invocation record, transition, provenance, or integrity layer.
ToolInvocationHeadError
Invalid compact invocation head.
ToolInvocationHistoryError
Invalid ascending invocation history.
ToolInvocationIntegrityError
Failure to canonicalize a closed invocation checksum preimage.
ToolInvocationIntentError
Invalid durable tool invocation intent.
ToolInvocationLimit
One resolved limit field used in narrowed-limit diagnostics.
ToolInvocationRevisionError
Invalid canonical invocation revision.
ToolInvocationState
Integrity-bound state payload of one invocation revision.
ToolInvocationStatus
Durable lifecycle state of one logical tool invocation.
ToolInvocationTransition
Explicit transition appended to the run journal and invocation history.
ToolInvocationTransitionKind
Kind of one explicit invocation state transition.
ToolProgressError
Failure to emit an ordered tool progress event.
ToolProgressEventValidationError
Invalid relationship between a progress event and invocation snapshot.
ToolProgressUpdateError
Invalid structural progress observation.
ToolReconciliationContextBindingError
Invalid relationship between a reconciliation context and descriptor.
ToolReconciliationContextError
Failure to construct a finite reconciliation context.
ToolReconciliationObservation
One bounded observation produced by a tool reconciliation probe.
ToolReconciliationObservationError
Invalid polling advice returned by a reconciliation provider.
ToolReconciliationProbeErrorBuildError
Invalid recovery advice attached to a reconciliation-probe failure.
ToolRecoveryHandleError
Invalid provider operation handle.
ToolResourceAccess
Broad resource access required by a tool implementation.
ToolResultValidationError
Invalid relationship between a successful result and invocation snapshot.
ToolRisk
External side-effect class declared by a trusted tool registry.
ToolSchemaRole
Whether a schema participates in typed input or output validation.
ToolStopReason
Reason a tool boundary must stop before accepting another result.
VersionComponent
The component of a Version that failed validation.
VersionError
Parse failure for a canonical Version.
WaitRegistrationIntent
One protocol-neutral condition to register in an atomic waiting batch.

Constants§

MAX_BUDGET_LAYERS
Maximum number of independently configured layers resolved into one budget.
MAX_COST_CURRENCIES
Maximum number of currencies tracked by one run budget.
MAX_OUTBOX_ATTEMPTS
Hard bound on physical attempts retained for one delivery.
MAX_OUTBOX_ATTEMPT_LEASE_MILLIS
Longest permitted fixed attempt lease, in milliseconds.

Traits§

CancellationObserver
Runtime-provided observation of a permanent cooperative cancellation request.
ErasedTool
Object-safe tool boundary used by heterogeneous registries and runtimes.
GraphReducer
Exactly pinned pure reducer implementation used by graph planning.
GraphSchemaValidator
Local registry capable of validating one exact schema-pinned JSON value.
Model
Object-safe, provider-neutral model execution boundary.
ModelSchemaRegistry
Offline schema resources required by a concrete model adapter.
SkillActivationStore
Mandatory durable approval and acting-window authority.
Tool
Strongly typed application-authoring boundary for one immutable tool version.
ToolAuthorizationReceiptSink
Mandatory durable-before-provider-I/O receipt boundary.
ToolProgressSink
Runtime-owned durable sink for already ordered tool progress events.
ToolSchemaRegistry
Trusted offline registry for digest-pinned tool JSON schemas.

Type Aliases§

BoxFuture
A heap-allocated, Send future whose implementation is independent of an async executor.
BoxStream
A heap-allocated, Send stream whose implementation is independent of an async executor.