Skip to main content

stateknot_core/
lib.rs

1// Copyright 2026 StateKnot contributors
2// SPDX-License-Identifier: Apache-2.0
3
4//! Provider-independent domain types shared across `StateKnot` runtime boundaries.
5//!
6//! This crate is intentionally independent of model providers, wire protocols,
7//! databases, HTTP servers, and async executors. Implemented contracts are
8//! introduced only with strict validation, schemas, and versioned wire
9//! fixtures from RFC-0001.
10//! Agent admission values freeze authenticated authority, deterministic finite
11//! budgets, executable graph identity, and a database-clock commit without
12//! depending on any storage implementation.
13
14#![forbid(unsafe_code)]
15
16mod accounting;
17mod agent;
18mod agent_admission;
19mod agent_runtime;
20mod artifact;
21mod barrier;
22mod budget;
23mod budget_reservation;
24mod canonical;
25mod capability;
26mod checkpoint;
27mod child_join;
28mod child_run;
29mod child_run_admission;
30mod child_run_budget;
31mod child_run_policy;
32mod content;
33mod decimal;
34mod digest;
35mod extension;
36mod failure;
37mod graph;
38mod graph_composition;
39mod identity;
40mod ids;
41mod journal;
42mod json;
43mod lease;
44mod message;
45mod model;
46mod model_event;
47mod model_invocation;
48mod model_request;
49mod model_response;
50mod model_runtime;
51mod model_transcript;
52mod node_attempt;
53mod node_result;
54mod outbox;
55mod recovery;
56mod run;
57mod schema;
58mod scope;
59mod skill_authorization;
60mod time;
61mod tool;
62mod tool_authorization;
63mod tool_invocation;
64mod tool_runtime;
65mod version;
66mod wait;
67
68pub use accounting::{
69    ByteCount, CountParseError, CurrencyCode, CurrencyCodeError, ExecutionCount, Money,
70    MoneyArithmeticError, TokenCount,
71};
72pub use agent::{
73    AgentDescriptor, AgentDescriptorError, AgentExecutionConfig, AgentExecutionConfigError,
74    AgentInstructions, AgentInstructionsError, AgentStructuredOutputStrategy, AgentToolConcurrency,
75    AgentTools, AgentToolsError,
76};
77pub use agent_admission::{
78    AgentAdmission, AgentAdmissionAuthority, AgentAdmissionAuthorityError,
79    AgentAdmissionBudgetLayer, AgentAdmissionBudgetLayerError, AgentAdmissionError,
80    AgentAdmissionIntent, AgentAdmissionIntentError,
81};
82pub use agent_runtime::{
83    AgentArtifacts, AgentArtifactsError, AgentRequest, AgentRequestValidationError, AgentResult,
84    AgentResultError, AgentResultProvenance, AgentResultProvenanceError,
85    AgentResultValidationError,
86};
87pub use artifact::{
88    ArtifactDescription, ArtifactDescriptionError, ArtifactIdentity, ArtifactModality,
89    ArtifactName, ArtifactNameError, ArtifactParents, ArtifactParentsError, ArtifactPresentation,
90    ArtifactProvenance, ArtifactRef, ArtifactRefError, ArtifactRepresentation,
91    ArtifactRepresentationError, ContentPart, MediaType, MediaTypeError, RetentionClass,
92    RetentionClassError,
93};
94pub use barrier::{
95    BarrierResultHeads, BarrierResultHeadsError, CheckpointBarrier, CheckpointBarrierError,
96    CheckpointBarrierIntegrityError,
97};
98pub use budget::{
99    BudgetDimension, BudgetEvaluationError, BudgetLimits, BudgetNarrowingError, BudgetRemaining,
100    BudgetResolutionError, BudgetUsage, BudgetUsageBuilder, BudgetUsageError, CostCollectionError,
101    CostLimits, KnownCosts, MAX_BUDGET_LAYERS, MAX_COST_CURRENCIES, ResolvedBudget,
102};
103pub use budget_reservation::{CumulativeBudgetReservation, CumulativeBudgetReservationError};
104pub use canonical::{CanonicalJson, CanonicalJsonError};
105pub use capability::{
106    CapabilityDescription, CapabilityDescriptionError, CapabilityIdentity, CapabilityKind,
107    CapabilityLifecycle, CapabilityLifecycleError, CapabilityLifecycleState, CapabilityMetadata,
108    CapabilityMetadataError, CapabilityName, CapabilityNameError, CapabilityReference,
109    CapabilityTitle, CapabilityTitleError,
110};
111pub use checkpoint::{
112    Checkpoint, CheckpointError, CheckpointHead, CheckpointHeadError, CheckpointIntegrityError,
113    CheckpointLineageError, CheckpointLineageVerifier, CheckpointState, CheckpointStateError,
114    CheckpointWrite, CheckpointWriteError, GraphReference, NodeId, NodeIdError, ReadyNodes,
115    ReadyNodesError, Superstep, SuperstepError,
116};
117pub use child_join::{
118    ChildRunJoinBinding, ChildRunJoinError, ChildRunJoinHead, ChildRunJoinRequest,
119};
120pub use child_run::{ChildRunKey, ChildRunKeyError, ChildRunSlot};
121pub use child_run_admission::{ChildRunAdmissionIntent, ChildRunAdmissionIntentError};
122pub use child_run_budget::{
123    ChildRunBudgetAccount, ChildRunBudgetEntry, ChildRunBudgetError, ChildRunBudgetSettlement,
124};
125pub use child_run_policy::{
126    ChildAgentReference, ChildRunDeclaration, ChildRunPolicyError, ChildRunTopologyLimits,
127    GraphChildRunPolicy,
128};
129pub use content::{
130    ContentMetadata, ContentSource, ContentTrust, JsonContent, LanguageTag, LanguageTagError,
131    RedactionState, SecurityLabel, SecurityLabelError, TextContent, TextContentError,
132};
133pub use digest::{Digest, DigestAlgorithm, DigestError};
134pub use extension::{
135    ExtensionKey, ExtensionKeyError, ExtensionKeyKind, ExtensionLimit, ExtensionLimits,
136    ExtensionLimitsError, ExtensionValue, Extensions, ExtensionsError,
137};
138pub use failure::{
139    Failure, FailureBuildError, FailureCategory, FailureCode, FailureDetails, FailureDetailsError,
140    FailureIdentifierError, FailureMessage, FailureMessageError, FailureOrigin, RetryAdvice,
141};
142pub use graph::{
143    CompiledGraph, GraphBarrierDisposition, GraphBarrierPlan, GraphBarrierPlanError,
144    GraphCompileError, GraphExecutionLimits, GraphExecutionLimitsError, GraphNode, GraphNodeError,
145    GraphReducer, GraphReducerError, GraphReducerInput, GraphReducerReference, GraphRoute,
146    GraphRouteError, GraphRoutes, GraphRoutesError, GraphSchemaValidationError,
147    GraphSchemaValidator, GraphValueKind,
148};
149pub use graph_composition::{
150    GraphComposition, GraphCompositionError, GraphNodeSource, GraphSubgraphCall,
151    SharedStateSubgraph,
152};
153pub use identity::{IssuerId, IssuerIdError, PrincipalIdentity, SubjectId, SubjectIdError};
154pub use ids::{
155    AgentSubmissionKey, AgentSubmissionKeyError, ArtifactId, AttemptId, AuthorizationReceiptId,
156    CheckpointId, DeliveryId, DestinationId, EventId, FailureId, GeneratedIdError, InterruptId,
157    InvocationId, MessageId, QuarantineId, RunId, SchedulerReservationId, SchedulerShardId,
158    SchedulerShardIdError, SkillActingWindowId, SkillActivationApprovalId, TenantId, TenantIdError,
159    ThreadId, TimerId,
160};
161pub use journal::{
162    JournalAppend, JournalAppendError, JournalAuthorityError, JournalChainError,
163    JournalChainVerifier, JournalEvent, JournalEventError, JournalEventIntent, JournalEventKind,
164    JournalEventKindError, JournalEventSource, JournalExpectation, JournalHead,
165    JournalIntegrityError, JournalIntentError, JournalPayload, JournalPayloadError,
166    JournalSequence, JournalSequenceError,
167};
168pub use json::{BoundedJson, BoundedJsonError, JsonLimit, JsonLimits, JsonLimitsError, JsonStats};
169pub use lease::{
170    FencingEpoch, FencingEpochError, RunFence, RunLease, RunLeaseError, RunLeaseValidationError,
171};
172pub use message::{
173    Instruction, InstructionContent, InstructionError, InstructionIdentity, InstructionName,
174    InstructionNameError, InstructionProvenance, Message, MessageError, MessageParts,
175    MessagePartsError, MessageProducer, MessageProducerKind, MessageProvenance, MessageRole,
176};
177pub use model::{
178    ModelCapabilities, ModelCapabilitiesError, ModelCapabilityIssue, ModelCapabilityMismatch,
179    ModelCapabilityMismatchError, ModelDescriptor, ModelDescriptorError, ModelModalities,
180    ModelModalitiesError, ModelModality, ModelRequirements, ModelRequirementsError,
181    ModelStructuredOutputCapabilities, ModelStructuredOutputCapabilitiesError,
182    ModelStructuredOutputLevel, ModelTokenLimits, ModelTokenLimitsError, ModelToolCapabilities,
183    ModelToolCapabilitiesError, ModelToolChoice, ModelToolChoices, ModelToolChoicesError,
184    ModelToolRequirements, ModelToolRequirementsError,
185};
186pub use model_event::{
187    ModelEvent, ModelEventAccumulator, ModelEventError, ModelEventKind, ModelEventStreamError,
188    ModelOutputDelta, ModelOutputDeltaKind, ModelOutputStart, ModelStreamChunk,
189    ModelStreamChunkError, ModelUsageField,
190};
191pub use model_invocation::{
192    ModelInvocation, ModelInvocationError, ModelInvocationHead, ModelInvocationHeadError,
193    ModelInvocationHistoryError, ModelInvocationHistoryVerifier, ModelInvocationIntegrityError,
194    ModelInvocationIntent, ModelInvocationIntentError, ModelInvocationRevision,
195    ModelInvocationRevisionError, ModelInvocationState, ModelInvocationStatus,
196    ModelInvocationTransition, ModelInvocationTransitionKind,
197};
198pub use model_request::{
199    ModelRequest, ModelRequestBuilder, ModelRequestError, ModelRequestLimits,
200    ModelRequestLimitsError, ModelResponseMode, ModelTextOutputFormat, ModelToolSelection,
201};
202pub use model_response::{
203    ModelFinishReason, ModelOutputItem, ModelOutputItemError, ModelOutputItemKind,
204    ModelProviderIdentifierError, ModelProviderModelId, ModelProviderRequestId,
205    ModelProviderResponseId, ModelProviderToolCallId, ModelResponse, ModelResponseError,
206    ModelResponseProvenance, ModelToolCallProposal, ModelToolCallProposalError, ModelUsage,
207    ModelUsageError,
208};
209pub use model_runtime::{
210    BoxFuture, BoxStream, CancellationObserver, CancellationSignal, Model, ModelContext,
211    ModelContextError, ModelError, ModelErrorPhase, ModelErrorProvenance,
212    ModelErrorValidationError, ModelSchemaRegistry, ModelStopReason,
213};
214pub use model_transcript::{
215    ModelProviderReplay, ModelProviderReplayError, ModelProviderReplayFormat,
216    ModelProviderReplayFormatError, ModelToolFailure, ModelToolFailureError, ModelToolOutcome,
217    ModelTranscript, ModelTranscriptError, ModelTranscriptTurn, ModelTranscriptTurnError,
218};
219pub use node_attempt::{
220    NodeAttempt, NodeAttemptCompletion, NodeAttemptError, NodeAttemptHistoryError,
221    NodeAttemptHistoryVerifier, NodeAttemptIntegrityError, NodeAttemptOutcome, NodeAttemptStart,
222    NodeAttemptStartHead, NodeAttemptStatus,
223};
224pub use node_result::{
225    NodeControl, NodeControlKind, NodeInvocationBinding, NodeInvocationBindingError,
226    NodeInvocationBindingKind, NodeInvocationBindings, NodeInvocationBindingsError,
227    NodeStateChange, NodeStateUpdate, NodeStateUpdateError, NodeTerminalOutput,
228    NodeTerminalOutputError, NodeWait, NodeWaits, NodeWaitsError, PendingNodeResult,
229    PendingNodeResultError, PendingNodeResultHead, PendingNodeResultIntegrityError,
230    PendingNodeResultIntent, PendingNodeResultIntentError, RouteId, RouteIdError,
231};
232pub use outbox::{
233    DeliveryFence, MAX_OUTBOX_ATTEMPT_LEASE_MILLIS, MAX_OUTBOX_ATTEMPTS, OutboxAttempt,
234    OutboxAttemptCompletion, OutboxAttemptError, OutboxAttemptHistoryError,
235    OutboxAttemptHistoryVerifier, OutboxAttemptIntegrityError, OutboxAttemptOutcome,
236    OutboxAttemptStart, OutboxAttemptStartHead, OutboxAttemptStatus, OutboxDelivery,
237    OutboxDeliveryError, OutboxDeliveryHead, OutboxDeliveryIntegrityError, OutboxDeliveryIntent,
238    OutboxDeliveryStatus, OutboxDestinationRef,
239};
240pub use recovery::{
241    NodeDispatchReason, ReadyNodeRecoveryError, ReadyNodeRecoveryPlan, ReadyNodeRecoveryPlanner,
242    RecoveryNode, RecoveryNodeKind,
243};
244pub use run::{
245    RunCancellation, RunCancellationError, RunCancellationRequest, RunFailure, RunFailureError,
246    RunInterrupt, RunInterruptError, RunInterruptKind, RunLifecycle, RunLifecycleError,
247    RunRevision, RunStatus, RunTimer, RunTimerError, RunTimerKind, RunTransition,
248    RunTransitionError, RunTransitionKind, RunWait, RunWaits, RunWaitsError,
249};
250pub use schema::{SchemaId, SchemaIdError, SchemaReference};
251pub use scope::{Scope, ScopeError, ScopeSet, ScopeSetError};
252pub use skill_authorization::{
253    SkillActingWindow, SkillActingWindowDuration, SkillActingWindowError,
254    SkillActingWindowOpenRequest, SkillActingWindowRevocation, SkillActingWindowRevocationReason,
255    SkillActivationApproval, SkillActivationScope, SkillActivationSource, SkillActivationStore,
256    SkillActivationStoreError, SkillActivationStoreFailure, SkillAuthorizationSubject,
257    SkillAuthorizationSubjectError,
258};
259pub use time::{DurationMillis, DurationMillisError, Timestamp, TimestampError};
260pub use tool::{
261    ToolCancellationSupport, ToolDescriptor, ToolDescriptorError, ToolExecutionLimits,
262    ToolExecutionLimitsError, ToolExecutionSemantics, ToolExecutionSemanticsError, ToolIdempotency,
263    ToolInvocationCapabilities, ToolResourceAccess, ToolResourceRequirements, ToolRisk,
264};
265pub use tool_authorization::{
266    ToolAuthorizationOperation, ToolAuthorizationProvenance, ToolAuthorizationReceipt,
267    ToolAuthorizationReceiptError, ToolAuthorizationReceiptSink, ToolAuthorizationReceiptSinkError,
268    ToolAuthorizationReceiptSinkFailure,
269};
270pub use tool_invocation::{
271    GraphNamespace, GraphNamespaceError, NodeActivation, NodeActivationError, ToolArtifactBinding,
272    ToolInvocation, ToolInvocationError, ToolInvocationHead, ToolInvocationHeadError,
273    ToolInvocationHistoryError, ToolInvocationHistoryVerifier, ToolInvocationIntegrityError,
274    ToolInvocationIntent, ToolInvocationIntentError, ToolInvocationLimit, ToolInvocationRevision,
275    ToolInvocationRevisionError, ToolInvocationState, ToolInvocationStatus,
276    ToolInvocationTransition, ToolInvocationTransitionKind,
277};
278pub use tool_runtime::{
279    ErasedTool, Tool, ToolAdapter, ToolAdapterBuildError, ToolArtifacts, ToolArtifactsError,
280    ToolContext, ToolContextBindingError, ToolContextError, ToolError, ToolErrorBuildError,
281    ToolErrorPhase, ToolErrorProvenance, ToolErrorValidationError, ToolExternalEffect,
282    ToolIdempotencyKey, ToolInput, ToolInputError, ToolInputValidationError, ToolOutput,
283    ToolProgressError, ToolProgressEvent, ToolProgressEventValidationError, ToolProgressProvenance,
284    ToolProgressReporter, ToolProgressSink, ToolProgressSinkError, ToolProgressUpdate,
285    ToolProgressUpdateError, ToolReconciliationContext, ToolReconciliationContextBindingError,
286    ToolReconciliationContextError, ToolReconciliationObservation,
287    ToolReconciliationObservationError, ToolReconciliationProbeError,
288    ToolReconciliationProbeErrorBuildError, ToolRecoveryHandle, ToolRecoveryHandleError,
289    ToolResult, ToolResultProvenance, ToolResultValidationError, ToolSchemaRegistry,
290    ToolSchemaRole, ToolSchemaValidationError, ToolStopReason,
291};
292pub use version::{Version, VersionComponent, VersionError};
293pub use wait::{
294    DurableTimer, DurableTimerHead, DurableTimerRecord, DurableWait, DurableWaitError,
295    InterruptRecord, InterruptRequest, InterruptRequestHead, InterruptRequestIntent,
296    InterruptResolution, InterruptResolutionIntent, InterruptResolver, TimerFiring,
297    TimerFiringIntent, TimerRegistrationIntent, WaitRegistrationIntent,
298};