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§
- Agent
Admission - Fully committed Agent admission using the authoritative database clock.
- Agent
Admission Authority - Authenticated principal and policy decision that authorized one new run.
- Agent
Admission Budget Layer - One immutable, attributable budget-policy layer used at admission.
- Agent
Admission Intent - Caller-controlled, integrity-bound input to database-time admission.
- Agent
Artifacts - Canonical bounded final artifact references returned by one agent invocation.
- Agent
Descriptor - Immutable, registry-resolved definition of one typed agent version.
- Agent
Execution Config - Finite, deterministic controls for the prebuilt model/tool agent loop.
- Agent
Instructions - Ordered, non-empty trusted instructions pinned into one agent definition.
- Agent
Request - Schema-bound input and request-local budget constraints for one agent run.
- Agent
Result - Successful, schema-bound terminal result of one agent invocation.
- Agent
Result Provenance - Trusted execution identity attached to one successful agent result.
- Agent
Submission Key - Opaque caller key for durable Agent-submission idempotency.
- Agent
Tools - Canonically ordered, registry-resolved tools exposed by one agent.
- Artifact
Description - A bounded human-readable artifact description.
- Artifact
Id - A tenant-scoped artifact identifier.
- Artifact
Identity - The tenant-qualified identity of an artifact.
- Artifact
Name - A bounded logical artifact name that is never a filesystem path.
- Artifact
Parents - A canonical bounded set of direct artifact parents.
- Artifact
Presentation - Human-facing artifact metadata, separate from storage coordinates.
- Artifact
Provenance - Append-only creator and causation attribution for an artifact.
- Artifact
Ref - A complete durable reference to immutable artifact bytes.
- Artifact
Representation - Integrity and interpretation metadata for immutable artifact bytes.
- Attempt
Id - A tenant-scoped node or dependency attempt identifier.
- Authorization
Receipt Id - A tenant-scoped durable authorization receipt identifier.
- Barrier
Result Heads - Canonically ordered, duplicate-free result heads consumed by one barrier.
- Bounded
Json - An immutable JSON value materialized under validated resource limits.
- Budget
Limits - Optional limits supplied by one configuration or request layer.
- Budget
Remaining - Remaining finite capacity after evaluating one usage snapshot.
- Budget
Usage - Monotonic run usage with explicit provider-observability gaps.
- Budget
Usage Builder - Builder for a validated
BudgetUsagesnapshot or delta. - Byte
Count - A count of input, output, event, checkpoint, or artifact bytes.
- Cancellation
Signal - Cloneable, runtime-neutral handle to cooperative cancellation state.
- Canonical
Json - Immutable RFC 8785 JSON Canonicalization Scheme bytes.
- Capability
Description - Bounded trusted-registry description text for a capability.
- Capability
Identity - An owner-qualified, version-pinned capability identity.
- Capability
Lifecycle - Validated lifecycle metadata for one pinned capability version.
- Capability
Metadata - Common discovery metadata shared by specialized capability descriptors.
- Capability
Name - A stable, case-sensitive capability name.
- Capability
Reference - A version-pinned reference to a registered capability.
- Capability
Title - A bounded single-line display title for a capability.
- Checkpoint
- One committed, self-validating graph checkpoint.
- Checkpoint
Barrier - Integrity-bound semantic input to one successor checkpoint transaction.
- Checkpoint
Head - Compact exact identity of a previously validated committed checkpoint.
- Checkpoint
Id - A tenant-scoped immutable checkpoint identifier.
- Checkpoint
Lineage Verifier - Streaming verifier for a checkpoint lineage read from newest to oldest.
- Checkpoint
State - Immutable, schema-pinned JSON graph state with a verified checksum.
- Checkpoint
Write - Stable checkpoint write intent before the anchoring journal event commits.
- Child
Agent Reference - Exact Agent definition pin, including instructions, tools, model and limits.
- Child
RunAdmission Intent - A bounded, immutable child admission candidate and its stable retry digest.
- Child
RunBudget Account - Bounded, integrity-bound accounting state for one parent admission.
- Child
RunBudget Entry - A lifetime child slot record. Settled entries are retained for retry identity.
- Child
RunBudget Settlement - Exact, fully priced terminal contribution of one immediate child subtree.
- Child
RunDeclaration - One node-owned, named delegation slot with pinned Agent and graph contracts.
- Child
RunJoin Binding - 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.
- Child
RunJoin Head - 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.
- Child
RunJoin Request - 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.
- Child
RunKey - Integrity-bound logical ownership key for one isolated child Run.
- Child
RunSlot - A stable, case-sensitive child slot declared by an executable definition.
- Child
RunTopology Limits - Finite topology limits pinned by a parent graph, never unlimited defaults.
- Compiled
Graph - Canonical, schema-pinned declarative graph compiled before admission.
- Content
Metadata - Security and source metadata carried by each content value.
- Cost
Limits - A bounded set of monetary ceilings keyed by currency.
- Cumulative
Budget Reservation - An immutable ceiling reserved for cumulative work, not observed usage.
- Currency
Code - A structurally valid ISO 4217 alphabetic currency code.
- Delivery
Fence - Fencing token authorizing one fixed physical delivery attempt.
- Delivery
Id - A tenant-scoped durable outbox delivery identifier.
- Destination
Id - A tenant-scoped durable outbox destination identifier.
- Digest
- A canonical integrity digest.
- Durable
Timer - Immutable timer committed with its registration journal fact.
- Durable
Timer Head - Compact immutable timer anchor carried by a firing intent.
- Durable
Timer Record - Complete durable timer history: one registration and at most one firing.
- Duration
Millis - A non-negative duration represented as signed 64-bit milliseconds.
- EventId
- A tenant-scoped durable event identifier.
- Execution
Count - A count of graph steps, model attempts, tool calls, branches, delegations, or retries.
- Extension
Key - A stable namespace identity for one extension value.
- Extension
Limits - 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.
- Failure
Code - A stable, machine-readable failure code owned by an application or adapter.
- Failure
Details - Schema-bound, resource-limited structured information safe to expose.
- Failure
Id - A tenant-scoped failure occurrence identifier.
- Failure
Message - A bounded message explicitly approved for public error surfaces.
- Failure
Origin - A stable component or dependency namespace that originated a failure.
- Fencing
Epoch - Positive, monotonically increasing database fencing epoch for one run.
- Graph
Barrier Plan - Complete deterministic plan ready for an existing atomic barrier API.
- Graph
Child RunPolicy - Closed version-one delegation profile embedded in the parent graph digest.
- Graph
Composition - A canonical ordinary graph plus its deterministic executor source map.
- Graph
Execution Limits - Hard execution ceilings embedded in one graph definition.
- Graph
Namespace - Slash-separated namespace of one node inside a root or nested graph.
- Graph
Node - Declarative control surface for one stable graph node.
- Graph
Node Source - Original executable role for one generated node identity.
- Graph
Reducer Input - One immutable update presented to a reducer in canonical node order.
- Graph
Reducer Reference - Exact executable reducer revision required by a compiled graph.
- Graph
Reference - Exact graph definition and state schema required to resume a checkpoint.
- Graph
Route - One declared conditional branch and its non-empty successor set.
- Graph
Routes - Canonically ordered, duplicate-free route collection for one node.
- Graph
Subgraph Call - One static call-site replacement in a parent graph.
- Instruction
- A versioned, owner-attributed, integrity-bound trusted instruction.
- Instruction
Identity - Stable identity of an application-owned instruction record.
- Instruction
Name - A stable, case-sensitive instruction name.
- Instruction
Provenance - Application-owned provenance for a trusted instruction.
- Interrupt
Id - A tenant-scoped interrupt identifier.
- Interrupt
Record - Complete durable interrupt history: one request and at most one resolution.
- Interrupt
Request - Immutable interrupt request committed with its registration journal fact.
- Interrupt
Request Head - Compact immutable interrupt anchor carried by a resolution.
- Interrupt
Request Intent - Pre-commit request to register one externally resolvable interrupt.
- Interrupt
Resolution - Immutable authorized resolution committed with its journal fact.
- Interrupt
Resolution Intent - Pre-commit authenticated resolution of one exact interrupt request.
- Interrupt
Resolver - Authenticated identity and granted authorization scopes of one resolver.
- Invocation
Id - A tenant-scoped external invocation identifier.
- Issuer
Id - An exact, case-sensitive OIDC/OAuth issuer identifier.
- Journal
Append - Atomic append request combining an idempotent intent and exact head check.
- Journal
Chain Verifier - Streaming verifier for a complete journal or a suffix after a trusted head.
- Journal
Event - One committed, self-validating record in a run’s append-only journal.
- Journal
Event Intent - Stable idempotent request to append one semantic event.
- Journal
Event Kind - Stable lower-kebab-case semantic name of a durable event payload.
- Journal
Head - Exact committed journal head used for optimistic append comparison.
- Journal
Payload - Schema-bound durable event payload whose checksum uses RFC 8785 bytes.
- Journal
Sequence - Positive, contiguous event position within one tenant-scoped run journal.
- Json
Content - Structured content materialized under bounded JSON limits.
- Json
Limits - Validated resource limits applied while JSON is materialized.
- Json
Stats - Safe aggregate statistics for a materialized
BoundedJsonvalue. - Known
Costs - Known accumulated monetary charges keyed by currency.
- Language
Tag - A stable, case-normalized RFC 5646 language tag.
- Media
Type - A concrete, canonical media type for stored artifact bytes.
- Message
- A durable, provenance-bound conversation message.
- Message
Id - A tenant-scoped durable message identifier.
- Message
Parts - A bounded, ordered, non-empty list of content parts.
- Message
Provenance - Durable causation and producer attribution for a message.
- Model
Capabilities - Immutable capabilities of one exact model, adapter, and endpoint binding.
- Model
Capability Mismatch - Deterministic, non-empty set of every unmet model requirement.
- Model
Context - Ephemeral, capability-limited context for exactly one model attempt.
- Model
Descriptor - Immutable, protocol-neutral description of one executable model binding.
- Model
Error - Public-safe typed failure returned by a model adapter.
- Model
Error Provenance - Correlation evidence attached to a failed model attempt.
- Model
Event - Provider-neutral semantic event emitted by one model attempt.
- Model
Event Accumulator - Fail-closed state machine that assembles one verified streaming response.
- Model
Invocation - One immutable, journal-anchored revision of a logical model invocation.
- Model
Invocation Head - Compact exact identity of a validated model invocation revision.
- Model
Invocation History Verifier - Streaming validator for one complete ascending model invocation history.
- Model
Invocation Intent - Immutable preparation intent for one logical model invocation.
- Model
Invocation Revision - Monotonic zero-based revision of one logical model invocation.
- Model
Modalities - Sorted, duplicate-free model modality set.
- Model
Provider Model Id - An opaque model identifier reported by the selected provider binding.
- Model
Provider Replay - Exact bounded provider response fragment required for stateless continuation.
- Model
Provider Replay Format - Versioned adapter-owned syntax for one exact provider replay fragment.
- Model
Provider Request Id - An opaque request correlation identifier reported or recognized by a model provider.
- Model
Provider Response Id - An opaque response identifier reported by a model provider.
- Model
Provider Tool Call Id - An opaque provider correlation identifier for one proposed tool call.
- Model
Request - Immutable, fully normalized request passed to a model adapter.
- Model
Request Builder - Fluent, fail-closed builder for
ModelRequest. - Model
Request Limits - Finite, provider-neutral ceilings for one model request.
- Model
Requirements - Provider-neutral requirements derived from one concrete model request.
- Model
Response - Immutable, fully normalized result of one model attempt.
- Model
Response Provenance - Stable and provider-reported identity for one model attempt response.
- Model
Stream Chunk - One exact, non-empty provider-normalized stream fragment.
- Model
Structured Output Capabilities - Structured final-output support for one model binding.
- Model
Token Limits - Explicitly known token ceilings for one model-and-endpoint binding.
- Model
Tool Call Proposal - A complete, unapproved tool-call proposal emitted by a model.
- Model
Tool Capabilities - Model support for tool definitions, selection, and emitted calls.
- Model
Tool Choices - Sorted, duplicate-free set of tool-selection controls.
- Model
Tool Failure - Public-safe durable failure snapshot supplied back to a model.
- Model
Tool Requirements - Minimum tool support needed by one model request.
- Model
Transcript - Bounded ordered prior model/tool turns for one stateless request.
- Model
Transcript Turn - One completed model tool-call turn and its complete durable outcomes.
- Model
Usage - Normalized token accounting for exactly one model attempt.
- Money
- A non-negative known monetary cost in integer micro-units.
- Node
Activation - Exact graph-node activation that owns a logical tool invocation.
- Node
Attempt - Fully restored physical node attempt, executing or terminal.
- Node
Attempt Completion - Immutable terminal record for one already-started physical node attempt.
- Node
Attempt History Verifier - Streaming validator for one logical activation’s physical attempts.
- Node
Attempt Start - Immutable proof that one physical node execution was durably admitted.
- Node
Attempt Start Head - Exact compact identity of one durable node-attempt start.
- NodeId
- Stable, case-sensitive identity of one compiled graph node.
- Node
Invocation Bindings - Canonically ordered, duplicate-free, bounded external invocation bindings.
- Node
State Update - Schema-pinned bounded update emitted by one successful node activation.
- Node
Terminal Output - Schema-pinned bounded output emitted by a terminal graph node.
- Node
Waits - Non-empty, bounded, identity-unique uncommitted wait batch.
- Outbox
Attempt - Fully restored physical delivery attempt, active or terminal.
- Outbox
Attempt Completion - Immutable terminal record for one already-started delivery attempt.
- Outbox
Attempt History Verifier - Streaming validator and state projector for one delivery’s attempt history.
- Outbox
Attempt Start - Durable admission record committed before one network request begins.
- Outbox
Attempt Start Head - Compact exact identity of one durable delivery-attempt start.
- Outbox
Delivery - Immutable outbox record atomically committed with its origin journal fact.
- Outbox
Delivery Head - Compact, integrity-verifiable identity of one committed delivery.
- Outbox
Delivery Intent - Idempotent pre-commit request to enqueue one notification.
- Outbox
Destination Ref - Immutable reference to one tenant-owned destination configuration snapshot.
- Pending
Node Result - One immutable, worker-fenced and journal-anchored pending node result.
- Pending
Node Result Head - Compact exact identity of one pending node result.
- Pending
Node Result Intent - Immutable semantic result for one logical node activation before commit.
- Principal
Identity - The stable external identity of an authenticated principal.
- Quarantine
Id - A tenant-scoped durable run-quarantine observation identifier.
- Ready
Node Recovery Plan - Immutable deterministic plan for the exact ready set of one checkpoint.
- Ready
Node Recovery Planner - Incremental, bounded verifier for one ready-node recovery snapshot.
- Ready
Nodes - Deterministically ordered set of nodes eligible for the next superstep.
- Resolved
Budget - A complete, finite run budget after all applicable layers are intersected.
- Retention
Class - 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.
- RunCancellation
Request - 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.
- Scheduler
Reservation Id - A durable distributed-scheduler slot-reservation identifier.
- Scheduler
Shard Id - A stable distributed-scheduler shard identifier.
- Schema
Id - A normalized, absolute HTTPS identifier for a schema resource.
- Schema
Reference - An immutable reference to canonical JSON schema bytes.
- Scope
- A bounded, case-sensitive OAuth 2.0 scope token.
- Scope
Set - A bounded set of unique scopes with deterministic canonical ordering.
- Security
Label - An opaque, bounded label interpreted only by an explicit policy engine.
- Shared
State Subgraph - A finite, shared-state subgraph template with explicit return ports.
- Skill
Acting Window - Durable database-clock Skill authority window.
- Skill
Acting Window Duration - Strict requested lifetime for an acting window.
- Skill
Acting Window Id - A tenant-scoped durable Skill acting-window identifier.
- Skill
Acting Window Open Request - Idempotent request to open an approved acting window.
- Skill
Acting Window Revocation - Immutable first revocation event for an acting window.
- Skill
Activation Approval - Immutable policy approval for one exact Skill activation.
- Skill
Activation Approval Id - A tenant-scoped durable Skill activation approval identifier.
- Skill
Activation Scope - Exact durable run scope in which one Skill may act.
- Skill
Activation Store Error - Payload-redacted durable Skill activation store failure.
- Skill
Authorization Subject - Exact external Skill content approved for activation.
- Subject
Id - A bounded, case-sensitive OIDC subject identifier.
- Superstep
- Zero-based graph superstep committed at a deterministic barrier.
- Tenant
Id - A validated tenant boundary identifier.
- Text
Content - Validated, bounded UTF-8 text with mandatory security metadata.
- Thread
Id - A tenant-scoped conversation thread identifier.
- Timer
Firing - Immutable timer firing committed with its journal fact.
- Timer
Firing Intent - Pre-commit request to fire one exact durable timer.
- TimerId
- A tenant-scoped durable timer identifier.
- Timer
Registration Intent - Pre-commit request to register one durable timer.
- Timestamp
- A UTC instant with canonical microsecond precision.
- Token
Count - A count of model input, cached-input, reasoning, or output tokens.
- Tool
Adapter - Framework-owned typed-to-erased adapter with pinned schema enforcement.
- Tool
Artifacts - Canonical bounded set of artifact references returned by one tool call.
- Tool
Authorization Provenance - Exact durable invocation identity covered by an authorization decision.
- Tool
Authorization Receipt - Immutable approval evidence that must be durable before provider I/O.
- Tool
Authorization Receipt Sink Error - Payload-redacted durable receipt sink failure.
- Tool
Context - Ephemeral, capability-limited context for exactly one tool attempt.
- Tool
Descriptor - Immutable, protocol-neutral description of one executable tool version.
- Tool
Error - Public-safe typed failure returned by a tool implementation or adapter.
- Tool
Error Provenance - Stable invocation and tool identity attached to a failed tool attempt.
- Tool
Execution Limits - Finite per-invocation execution ceilings declared by a tool version.
- Tool
Execution Semantics - Validated side-effect and recovery semantics for one tool version.
- Tool
Idempotency Key - Stable provider-facing idempotency key for one logical tool invocation.
- Tool
Input - Schema-bound, resource-limited arguments for one erased tool invocation.
- Tool
Invocation - One immutable, journal-anchored revision of a logical tool invocation.
- Tool
Invocation Capabilities - Runtime-facing optional behavior supported by a tool implementation.
- Tool
Invocation Head - Compact exact identity of a validated invocation revision.
- Tool
Invocation History Verifier - Streaming validator for one complete ascending invocation history.
- Tool
Invocation Intent - Immutable preparation intent for one logical tool invocation.
- Tool
Invocation Revision - Monotonic zero-based revision of one logical invocation record.
- Tool
Output - Typed output plus independently bounded artifact references.
- Tool
Progress Event - Ordered, identity-bound progress event accepted by the runtime sink.
- Tool
Progress Provenance - Stable identity attached to every progress event from one attempt.
- Tool
Progress Reporter - Cloneable ordered progress handle bound to one physical attempt.
- Tool
Progress Sink Error - Private diagnostic returned by a runtime progress sink.
- Tool
Progress Update - One normalized numeric progress observation requested by a tool.
- Tool
Reconciliation Context - Ephemeral, capability-limited context for reconciling one physical tool attempt.
- Tool
Reconciliation Probe Error - Public-safe failure of the reconciliation probe itself.
- Tool
Recovery Handle - Bounded opaque reference used to resume one provider-side operation.
- Tool
Resource Requirements - Resource categories that must be satisfied by an executor profile.
- Tool
Result - Successful erased tool result ready for durable validation and commit.
- Tool
Result Provenance - Stable invocation and tool identity attached to a successful tool result.
- Tool
Schema Validation Error - Private diagnostic returned by a trusted local tool schema registry.
- Version
- A canonical three-component semantic version.
Enums§
- Agent
Admission Authority Error - Invalid trusted authorization snapshot.
- Agent
Admission Budget Layer Error - Invalid immutable budget policy layer.
- Agent
Admission Error - Invalid or corrupted committed Agent admission.
- Agent
Admission Intent Error - Invalid or corrupted pre-commit Agent admission input.
- Agent
Artifacts Error - Invalid final artifact collection for one successful agent invocation.
- Agent
Descriptor Error - Invalid cross-component agent definition snapshot.
- Agent
Execution Config Error - Invalid prebuilt agent-loop controls.
- Agent
Instructions Error - Invalid agent instruction collection.
- Agent
Request Validation Error - Invalid relationship between an agent request and an admission snapshot.
- Agent
Result Error - Intrinsic invalidity in a successful terminal agent result.
- Agent
Result Provenance Error - Descriptor-binding failure for trusted agent result provenance.
- Agent
Result Validation Error - Invalid relationship between a terminal result and trusted run snapshots.
- Agent
Structured Output Strategy - Resolved mechanism used to obtain a typed final output.
- Agent
Submission KeyError - Invalid external Agent-submission idempotency key.
- Agent
Tool Concurrency - Deterministic scheduling mode for ordinary tool calls from one response.
- Agent
Tools Error - Invalid agent tool collection.
- Artifact
Description Error - Validation failure for
ArtifactDescription. - Artifact
Modality - Semantic modality used for provider capability negotiation and rendering.
- Artifact
Name Error - Validation failure for
ArtifactName. - Artifact
Parents Error - Validation failure for
ArtifactParents. - Artifact
RefError - Validation failure for
ArtifactRef. - Artifact
Representation Error - Validation failure for
ArtifactRepresentation. - Barrier
Result Heads Error - Invalid compact result set for a checkpoint barrier.
- Bounded
Json Error - JSON rejected by syntax, interoperability, or resource-safety validation.
- Budget
Dimension - Stable budget dimension used by resolution and enforcement errors.
- Budget
Evaluation Error - Failure while evaluating a complete budget against usage.
- Budget
Narrowing Error - An attempted child or delegated budget would widen immutable parent limits.
- Budget
Resolution Error - Failure while intersecting partial budget layers.
- Budget
Usage Error - Failure while constructing or monotonically accumulating usage.
- Canonical
Json Error - Failure to produce integrity-bearing RFC 8785 bytes.
- Capability
Description Error - Invalid capability description text.
- Capability
Kind - Stable classification of a discoverable capability.
- Capability
Lifecycle Error - Invalid capability lifecycle metadata.
- Capability
Lifecycle State - Stable lifecycle classification for a capability version.
- Capability
Metadata Error - Invalid cross-field capability metadata.
- Capability
Name Error - Validation failure for a
CapabilityName. - Capability
Title Error - Invalid capability title text.
- Checkpoint
Barrier Error - Invalid or corrupted checkpoint barrier intent.
- Checkpoint
Barrier Integrity Error - Failure to canonicalize checkpoint barrier integrity material.
- Checkpoint
Error - Invalid or corrupted committed checkpoint.
- Checkpoint
Head Error - Invalid scope in a compact checkpoint head.
- Checkpoint
Integrity Error - Failure to produce a domain-separated checkpoint checksum.
- Checkpoint
Lineage Error - Rejected checkpoint in reverse lineage verification.
- Checkpoint
State Error - Invalid or corrupted checkpoint state.
- Checkpoint
Write Error - Structurally invalid or corrupted checkpoint write intent.
- Child
RunAdmission Intent Error - Closed public-safe child preparation or fresh-admission validation failure.
- Child
RunBudget Error - Closed, public-safe accounting refusal without child inputs or outputs.
- Child
RunJoin Error - Closed validation failures, without child inputs, outputs or diagnostics.
- Child
RunKey Error - Failure constructing or restoring a logical child ownership key.
- Child
RunPolicy Error - Public-safe declaration/profile validation failure; no request data is exposed.
- Content
Part - A closed v1 content value used across runtime boundaries.
- Content
Source - The immediate domain source from which content entered
StateKnot. - Content
Trust - An asserted content trust classification.
- Cost
Collection Error - Validation or arithmetic failure for a currency-keyed cost collection.
- Count
Parse Error - Parse failure for a canonical token or byte count.
- Cumulative
Budget Reservation Error - Invalid cumulative reservation or insufficient projected budget capacity.
- Currency
Code Error - Validation failure for a
CurrencyCode. - Digest
Algorithm - An integrity hash algorithm supported by
StateKnot. - Digest
Error - Parse failure for a canonical
Digest. - Durable
Wait - One fully materialized durable wait registration.
- Durable
Wait Error - Invalid durable wait registration, authorization, timing, or integrity.
- Duration
Millis Error - Validation or conversion failure for
DurationMillis. - Extension
KeyError - Invalid extension namespace identity.
- Extension
KeyKind - Namespace form used by an
ExtensionKey. - Extension
Limit - Configurable dimension of the bounded extension-map contract.
- Extension
Limits Error - Invalid configurable extension-map limits.
- Extension
Value - Explicit trust mode for one extension value.
- Extensions
Error - Invalid bounded extension-map data.
- Failure
Build Error - Invalid relationship between failure category and recovery advice.
- Failure
Category - Stable semantic category shared by component-specific errors.
- Failure
Details Error - Invalid schema-bound public failure details.
- Failure
Identifier Error - Validation failure shared by
FailureCodeandFailureOrigin. - Failure
Message Error - Invalid public failure message text.
- Fencing
Epoch Error - Invalid canonical fencing epoch.
- Generated
IdError - Parse or construction failure for a StateKnot-generated identifier.
- Graph
Barrier Disposition - Semantic lifecycle outcome selected by one complete graph barrier.
- Graph
Barrier Plan Error - Failure to derive one deterministic, storage-ready barrier plan.
- Graph
Compile Error - Invalid canonical graph definition.
- Graph
Composition Error - Fail-closed rejection of a shared-state composition before admission.
- Graph
Execution Limits Error - Invalid compiled graph execution limits.
- Graph
Namespace Error - Invalid graph namespace.
- Graph
Node Error - Invalid local control shape for one graph node.
- Graph
Reducer Error - Public-safe failure returned by one pure graph reducer.
- Graph
Route Error - Invalid conditional graph route.
- Graph
Routes Error - Invalid route collection for one node.
- Graph
Schema Validation Error - Public-safe reason a schema registry could not validate a value.
- Graph
Value Kind - Closed value class used in public-safe graph validation failures.
- Instruction
Content - A closed v1 instruction payload.
- Instruction
Error - Validation failure for
Instruction. - Instruction
Name Error - Validation failure for
InstructionName. - Issuer
IdError - Validation failure for an
IssuerId. - Journal
Append Error - Invalid exact-head scope in an append request.
- Journal
Authority Error - Rejected worker-authority preflight.
- Journal
Chain Error - Rejected event in streaming journal-chain verification.
- Journal
Event Error - Intrinsically invalid journal event or append materialization.
- Journal
Event Kind Error - Invalid durable event kind.
- Journal
Event Source - Trusted runtime origin assigned to one journal append.
- Journal
Expectation - Optimistic journal precondition supplied with an append request.
- Journal
Integrity Error - Failure to produce a small domain-separated journal checksum.
- Journal
Intent Error - Invalid relationship or checksum in an event append intent.
- Journal
Payload Error - Invalid canonical durable event payload.
- Journal
Sequence Error - Invalid canonical journal sequence.
- Json
Limit - A configurable dimension of the bounded JSON contract.
- Json
Limits Error - Invalid configuration for
JsonLimits. - Language
TagError - Validation failure for a
LanguageTag. - Media
Type Error - Validation failure for
MediaType. - Message
Error - Validation failure for
Message. - Message
Parts Error - Validation failure for
MessageParts. - Message
Producer - Typed attribution for the entity that produced a message.
- Message
Producer Kind - Stable classification of a message producer.
- Message
Role - Stable semantic role of a conversation message.
- Model
Capabilities Error - Invalid cross-component model capability declaration.
- Model
Capability Issue - One unmet model requirement with known available capacity where useful.
- Model
Capability Mismatch Error - Invalid mismatch diagnostic set.
- Model
Context Error - Failure to construct a finite model-attempt context.
- Model
Descriptor Error - Invalid cross-component model descriptor.
- Model
Error Phase - Stage at which one model attempt failed.
- Model
Error Validation Error - Invalid relationship between a model failure and its invocation snapshot.
- Model
Event Error - Intrinsically invalid provider-neutral model event.
- Model
Event Kind - Closed semantic body of a provider-neutral model event.
- Model
Event Stream Error - Invalid sequence or content in one normalized model event stream.
- Model
Finish Reason - Portable reason why model generation stopped.
- Model
Invocation Error - Invalid model invocation record, transition, provenance, or integrity layer.
- Model
Invocation Head Error - Invalid compact model invocation head.
- Model
Invocation History Error - Invalid ascending model invocation history.
- Model
Invocation Integrity Error - Failure to canonicalize a closed model invocation checksum preimage.
- Model
Invocation Intent Error - Invalid durable model invocation intent.
- Model
Invocation Revision Error - Invalid canonical model invocation revision.
- Model
Invocation State - Integrity-bound state payload of one model invocation revision.
- Model
Invocation Status - Durable lifecycle state of one logical model invocation.
- Model
Invocation Transition - Explicit transition appended to the run journal and model history.
- Model
Invocation Transition Kind - Kind of one explicit model invocation state transition.
- Model
Modalities Error - Invalid model modality set.
- Model
Modality - Coarse semantic media understood or produced by a model binding.
- Model
Output Delta - One typed exact fragment for an already-started output item.
- Model
Output Delta Kind - Closed classification of a semantic model-output delta.
- Model
Output Item - One item in provider order from a model response.
- Model
Output Item Error - Invalid intrinsic metadata on an ordered model output item.
- Model
Output Item Kind - Classification of one ordered model output item.
- Model
Output Start - Header that fixes the type and immutable metadata of one streamed output.
- Model
Provider Identifier Error - Validation failure for an opaque provider identifier.
- Model
Provider Replay Error - Invalid opaque provider replay evidence.
- Model
Provider Replay Format Error - Invalid provider replay format identifier.
- Model
Request Error - Invalid provider-neutral model request.
- Model
Request Limits Error - Invalid finite request limits.
- Model
Requirements Error - Invalid model requirements.
- Model
Response Error - Invalid provider-neutral model response.
- Model
Response Mode - How a model invocation delivers its response.
- Model
Stop Reason - Reason a model boundary must stop before producing another result.
- Model
Stream Chunk Error - Invalid semantic model-stream fragment.
- Model
Structured Output Capabilities Error - Invalid structured-output capability declaration.
- Model
Structured Output Level - Strength of structured final-output support.
- Model
Text Output Format - Requested format for the text portion of a model response.
- Model
Token Limits Error - Invalid model token-limit snapshot.
- Model
Tool Call Proposal Error - Invalid model-produced tool-call proposal.
- Model
Tool Capabilities Error - Invalid model tool capability declaration.
- Model
Tool Choice - Provider-neutral tool-selection control.
- Model
Tool Choices Error - Invalid model tool-choice set.
- Model
Tool Failure Error - Invalid public-safe tool failure continuation evidence.
- Model
Tool Outcome - One exact tool outcome paired to a provider call identifier.
- Model
Tool Requirements Error - Invalid model tool requirements.
- Model
Tool Selection - Tool-selection behavior for one model request.
- Model
Transcript Error - Invalid complete model/tool transcript.
- Model
Transcript Turn Error - Invalid model/tool transcript turn.
- Model
Usage Error - Invalid normalized model-attempt usage.
- Model
Usage Field - Token-usage dimension used in monotonic stream diagnostics.
- Money
Arithmetic Error - Failure from checked monetary arithmetic.
- Node
Activation Error - Invalid deterministic construction of a ready-node activation.
- Node
Attempt Error - Invalid node-attempt scope, causation, lifecycle, or integrity material.
- Node
Attempt History Error - Invalid physical-attempt history for one logical node activation.
- Node
Attempt Integrity Error - Failure to canonicalize node-attempt integrity material.
- Node
Attempt Outcome - Immutable terminal outcome of one physical node attempt.
- Node
Attempt Status - Durable lifecycle state of one physical node attempt.
- Node
Control - Closed control outcome emitted alongside a node’s state contribution.
- Node
Control Kind - Stable discriminator for one node control result.
- Node
Dispatch Reason - Stable reason that one logical activation may start a new physical attempt.
- Node
IdError - Invalid graph node identity.
- Node
Invocation Binding - Exact terminal external invocation consumed by one node result.
- Node
Invocation Binding Error - Invalid external invocation binding.
- Node
Invocation Binding Kind - Kind of external invocation referenced by a pending node result.
- Node
Invocation Bindings Error - Invalid pending-result invocation collection.
- Node
State Change - State contribution from one successful logical node activation.
- Node
State Update Error - Invalid or corrupted schema-pinned node update.
- Node
Terminal Output Error - Invalid or corrupted schema-pinned terminal output.
- Node
Wait - Complete, uncommitted lifecycle condition emitted by a graph node.
- Node
Waits Error - Invalid graph wait specification batch.
- Outbox
Attempt Error - Invalid attempt fence, timing, completion, or checksum.
- Outbox
Attempt History Error - Invalid physical-attempt history for one logical delivery.
- Outbox
Attempt Integrity Error - Failure to canonicalize attempt integrity material.
- Outbox
Attempt Outcome - Terminal outcome of one physical delivery attempt.
- Outbox
Attempt Status - Lifecycle state of one physical outbox attempt.
- Outbox
Delivery Error - Invalid delivery scope, atomic origin binding, deadline, or checksum.
- Outbox
Delivery Integrity Error - Failure to canonicalize delivery integrity material.
- Outbox
Delivery Status - Projected lifecycle of a complete delivery at one database observation.
- Pending
Node Result Error - Invalid or corrupted pending node-result record.
- Pending
Node Result Integrity Error - Failure to canonicalize pending node-result integrity material.
- Pending
Node Result Intent Error - Invalid or corrupted pending node-result intent.
- Ready
Node Recovery Error - Invalid or contradictory inputs to deterministic ready-node recovery.
- Ready
Nodes Error - Invalid next-superstep ready set.
- Recovery
Node - Deterministic recovery decision for one logical ready-node activation.
- Recovery
Node Kind - Closed scheduler classification for one checkpoint-ready node.
- Redaction
State - The redaction transformation recorded for this representation.
- Retention
Class Error - Validation failure for
RetentionClass. - Retry
Advice - Explicit recovery advice supplied by the originating component.
- Route
IdError - Invalid conditional route identity.
- RunCancellation
Error - Invalid cancellation intent or acknowledgement.
- RunFailure
Error - Invalid failure supplied to the ordinary failed terminal state.
- RunInterrupt
Error - Invalid intrinsic timing for a run interrupt.
- RunInterrupt
Kind - Semantic reason why a run needs an externally supplied resolution.
- RunLease
Error - Intrinsically invalid lease acquisition, renewal, or supersession.
- RunLease
Validation Error - Rejected worker write against the current lease snapshot.
- RunLifecycle
Error - Intrinsically invalid serialized lifecycle snapshot.
- RunStatus
- Stable projection of a run’s current business lifecycle.
- RunTimer
Error - Invalid intrinsic timing for a durable run timer.
- RunTimer
Kind - Semantic purpose of one durable run timer.
- RunTransition
- One immutable input to the pure run lifecycle state machine.
- RunTransition
Error - Rejected pure lifecycle transition.
- RunTransition
Kind - Stable name of an attempted lifecycle transition.
- RunWait
- One explicit condition suspending semantic run progress.
- RunWaits
Error - Invalid batch of run wait conditions.
- Scheduler
Shard IdError - Validation failure for a
SchedulerShardId. - Schema
IdError - Validation failure for a
SchemaId. - Scope
Error - Validation failure for a
Scope. - Scope
SetError - Construction or deserialization failure for a
ScopeSet. - Security
Label Error - Validation failure for a
SecurityLabel. - Skill
Acting Window Error - Invalid or corrupted Skill approval/window evidence.
- Skill
Acting Window Revocation Reason - Closed reason for permanently revoking an acting window.
- Skill
Activation Source - Why the exact Skill received fresh activation approval.
- Skill
Activation Store Failure - Stable public class for durable Skill activation storage failures.
- Skill
Authorization Subject Error - Invalid external Skill subject.
- Subject
IdError - Validation failure for a
SubjectId. - Superstep
Error - Invalid canonical superstep value.
- Tenant
IdError - Validation failure for a
TenantId. - Text
Content Error - Validation failure for
TextContent. - Timestamp
Error - Validation or conversion failure for a
Timestamp. - Tool
Adapter Build Error - Registration failure for a typed tool adapter.
- Tool
Artifact Binding - Artifact binding field rejected while restoring a durable result.
- Tool
Artifacts Error - Invalid artifact collection returned by one tool attempt.
- Tool
Authorization Operation - Provider operation authorized by one immutable receipt.
- Tool
Authorization Receipt Error - Invalid or corrupted Tool authorization receipt.
- Tool
Authorization Receipt Sink Failure - Stable failure class returned by a durable authorization-receipt sink.
- Tool
Cancellation Support - Cancellation behavior exposed by a tool implementation.
- Tool
Context Binding Error - Invalid relationship between a tool context and descriptor snapshot.
- Tool
Context Error - Failure to construct a finite tool-attempt context.
- Tool
Descriptor Error - Invalid cross-component tool descriptor.
- Tool
Error Build Error - Invalid intrinsic relationship within a
ToolError. - Tool
Error Phase - Stage at which one physical tool attempt failed.
- Tool
Error Validation Error - Invalid relationship between a tool failure and invocation snapshot.
- Tool
Execution Limits Error - Invalid per-invocation tool limits.
- Tool
Execution Semantics Error - Invalid tool side-effect and recovery semantics.
- Tool
External Effect - Best available evidence about externally observable write effects.
- Tool
Idempotency - Mechanism governing repeated invocation of a tool operation.
- Tool
Input Error - Invalid structural tool input.
- Tool
Input Validation Error - Invalid relationship between tool input and an invocation snapshot.
- Tool
Invocation Error - Invalid invocation record, transition, provenance, or integrity layer.
- Tool
Invocation Head Error - Invalid compact invocation head.
- Tool
Invocation History Error - Invalid ascending invocation history.
- Tool
Invocation Integrity Error - Failure to canonicalize a closed invocation checksum preimage.
- Tool
Invocation Intent Error - Invalid durable tool invocation intent.
- Tool
Invocation Limit - One resolved limit field used in narrowed-limit diagnostics.
- Tool
Invocation Revision Error - Invalid canonical invocation revision.
- Tool
Invocation State - Integrity-bound state payload of one invocation revision.
- Tool
Invocation Status - Durable lifecycle state of one logical tool invocation.
- Tool
Invocation Transition - Explicit transition appended to the run journal and invocation history.
- Tool
Invocation Transition Kind - Kind of one explicit invocation state transition.
- Tool
Progress Error - Failure to emit an ordered tool progress event.
- Tool
Progress Event Validation Error - Invalid relationship between a progress event and invocation snapshot.
- Tool
Progress Update Error - Invalid structural progress observation.
- Tool
Reconciliation Context Binding Error - Invalid relationship between a reconciliation context and descriptor.
- Tool
Reconciliation Context Error - Failure to construct a finite reconciliation context.
- Tool
Reconciliation Observation - One bounded observation produced by a tool reconciliation probe.
- Tool
Reconciliation Observation Error - Invalid polling advice returned by a reconciliation provider.
- Tool
Reconciliation Probe Error Build Error - Invalid recovery advice attached to a reconciliation-probe failure.
- Tool
Recovery Handle Error - Invalid provider operation handle.
- Tool
Resource Access - Broad resource access required by a tool implementation.
- Tool
Result Validation Error - Invalid relationship between a successful result and invocation snapshot.
- Tool
Risk - External side-effect class declared by a trusted tool registry.
- Tool
Schema Role - Whether a schema participates in typed input or output validation.
- Tool
Stop Reason - Reason a tool boundary must stop before accepting another result.
- Version
Component - The component of a
Versionthat failed validation. - Version
Error - Parse failure for a canonical
Version. - Wait
Registration Intent - 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§
- Cancellation
Observer - Runtime-provided observation of a permanent cooperative cancellation request.
- Erased
Tool - Object-safe tool boundary used by heterogeneous registries and runtimes.
- Graph
Reducer - Exactly pinned pure reducer implementation used by graph planning.
- Graph
Schema Validator - Local registry capable of validating one exact schema-pinned JSON value.
- Model
- Object-safe, provider-neutral model execution boundary.
- Model
Schema Registry - Offline schema resources required by a concrete model adapter.
- Skill
Activation Store - Mandatory durable approval and acting-window authority.
- Tool
- Strongly typed application-authoring boundary for one immutable tool version.
- Tool
Authorization Receipt Sink - Mandatory durable-before-provider-I/O receipt boundary.
- Tool
Progress Sink - Runtime-owned durable sink for already ordered tool progress events.
- Tool
Schema Registry - Trusted offline registry for digest-pinned tool JSON schemas.