Skip to main content

stateknot_runtime/
lib.rs

1// Copyright 2026 StateKnot contributors
2// SPDX-License-Identifier: Apache-2.0
3
4//! Executable, offline-frozen runtime bindings for `StateKnot` graphs.
5//!
6//! Declarative graph descriptors remain in `stateknot-core`. This crate binds
7//! those immutable descriptors to locally installed JSON Schemas, reducers,
8//! and node executors, then drives them against a durable provider without
9//! loading code or schemas from the network while a run is active.
10//! [`DurableAgentAdmission`] validates one authenticated immutable Agent intent
11//! against that same deployment snapshot before atomically initializing its
12//! executable `PostgreSQL` run. [`DurableAgentRuns`] adds tenant-scoped durable
13//! submission keys and integrity-verifying public run/result snapshots for
14//! lost-ack recovery and polling.
15
16#![forbid(unsafe_code)]
17
18mod admission_schema;
19mod agent_deadlines;
20pub mod agent_maintenance;
21mod failure_close;
22pub use failure_close::{
23    DurableRunFailureCloser, RunFailureCloseBuildError, RunFailureCloseItem,
24    RunFailureCloseSweepCursor, RunFailureCloseTick, STANDARD_RUN_FAILURE_CLOSE_EVENT_SCHEMA_ID,
25    register_standard_run_failure_close_event_schema, standard_run_failure_close_event_schema,
26};
27mod agent_loop;
28mod execution_activity;
29pub use execution_activity::GraphExecutionActivity;
30mod agent_service;
31/// Bounded declarative resource authorization, separate from identity verification.
32pub use agent_service::policy as agent_policy;
33mod agent_typed;
34mod cancellation_schema;
35mod child_join;
36mod child_reconciler;
37mod driver;
38mod driver_schema;
39mod durable_admission;
40mod durable_runs;
41mod fair_scheduler;
42mod invocation_executor;
43mod invocation_schema;
44mod lifecycle;
45mod lifecycle_schema;
46mod provider_native_agent;
47mod provider_registry;
48mod registry;
49mod schema;
50mod service_schema;
51mod tenant_scheduler;
52
53pub use child_join::{
54    ChildJoinPublicationCursor, ChildJoinPublicationItem, ChildJoinPublicationTick,
55    DurableChildJoinPublisher, GraphChildJoin, STANDARD_CHILD_JOIN_EVENT_SCHEMA_ID,
56    register_standard_child_join_event_schema, standard_child_join_event_schema,
57};
58
59pub use agent_deadlines::{
60    AgentDeadlineBuildError, AgentDeadlineItem, AgentDeadlineSweepCursor, AgentDeadlineTick,
61    DurableAgentDeadlineReconciler, STANDARD_AGENT_DEADLINE_EVENT_SCHEMA_ID,
62    register_standard_agent_deadline_event_schema, standard_agent_deadline_event_schema,
63};
64
65pub use child_reconciler::{
66    ChildReconcilerBuildError, ChildReconciliationCommit, ChildReconciliationCursor,
67    ChildReconciliationItem, ChildReconciliationKind, ChildReconciliationTick,
68    DurableChildReconciler, DurableChildReconcilerOptions,
69    STANDARD_CHILD_RECONCILIATION_EVENT_SCHEMA_ID,
70    register_standard_child_reconciliation_event_schema,
71    standard_child_reconciliation_event_schema,
72};
73
74pub use admission_schema::{
75    STANDARD_AGENT_ADMISSION_EVENT_SCHEMA_ID, StandardAgentAdmissionSchemaError,
76    StandardAgentAdmissionSchemaRegistrationError, register_standard_agent_admission_event_schema,
77    standard_agent_admission_event_schema,
78};
79pub use agent_loop::{
80    AgentLoopError, AgentLoopOutcome, AgentLoopResult, DurableAgentLoop, DurableAgentLoopBuildError,
81};
82pub use agent_service::{
83    AGENT_SERVICE_API_VERSION, AgentCancellationIds, AgentCancellationOutcome,
84    AgentRunActivityPage, AgentServiceAuthorizationError, AgentServiceAuthorizer,
85    AgentServiceBuildError, AgentServiceCaller, AgentServiceDeployment,
86    AgentServiceDeploymentError, AgentServiceError, AgentServiceReadinessError,
87    AgentServiceRegistry, AgentServiceRegistryBuilder, AgentServiceRegistryError,
88    AgentServiceRunAuthorization, AgentServiceRunGrant, AgentServiceRunOperation,
89    AgentServiceRunTarget, AgentServiceSubmissionAuthorization, AgentServiceSubmissionGrant,
90    AgentServiceV1,
91};
92pub use agent_typed::{
93    AgentBuilder, AgentBuilderError, AgentSchemaRegistrationError, AgentSchemaRole, TypedAgent,
94    TypedAgentBindError, TypedAgentDefinition, TypedAgentInputError, TypedAgentOutputError,
95};
96pub use cancellation_schema::{
97    STANDARD_AGENT_CANCELLATION_EVENT_SCHEMA_ID, StandardAgentCancellationSchemaError,
98    StandardAgentCancellationSchemaRegistrationError,
99    register_standard_agent_cancellation_event_schema, standard_agent_cancellation_event_schema,
100};
101pub use driver_schema::{
102    STANDARD_GRAPH_DRIVER_EVENT_SCHEMA_ID, StandardGraphDriverSchemaError,
103    StandardGraphDriverSchemaRegistrationError, register_standard_graph_driver_event_schema,
104    standard_graph_driver_event_schema,
105};
106pub use durable_admission::{
107    AgentRunIds, ChildAdmissionPreparationError, DurableAgentAdmission,
108    DurableAgentAdmissionBuildError, DurableAgentAdmissionError, DurableAgentAdmissionRequest,
109    DurableAgentAdmissionRequestError,
110};
111pub use durable_runs::{
112    AgentRunAdmissionOutcome, AgentRunSnapshot, AgentRunSnapshotError, AgentRunTerminalOutcome,
113    DurableAgentRuns, DurableAgentRunsBuildError, DurableAgentRunsError,
114};
115pub use invocation_executor::{
116    DurableInvocationExecutor, DurableInvocationExecutorBuildError,
117    DurableInvocationExecutorOptions, DurableInvocationExecutorOptionsError,
118    InvocationAttemptEventIds, InvocationAttemptEventIdsError, InvocationAttemptHandoffError,
119    InvocationBoundaryKind, InvocationBudgetContext, InvocationBudgetProvider,
120    InvocationBudgetProviderError, InvocationClock, InvocationClockError,
121    InvocationClockObservation, InvocationEventPayloadError, InvocationTerminalCommitFailure,
122    ModelAttemptExecutionError, ModelAttemptHandoff, ModelAttemptOutcome, ModelAttemptTerminalKind,
123    ModelEventSink, ModelEventSinkError, ModelTerminalCommitError, ModelTerminalCommitHandoff,
124    SystemInvocationClock, ToolAttemptExecutionError, ToolAttemptHandoff, ToolAttemptOutcome,
125    ToolAttemptStartOutcome, ToolAttemptTerminalKind, ToolDispatchHandoff,
126    ToolReconciliationAttemptExecutionError, ToolReconciliationAttemptHandoff,
127    ToolReconciliationAttemptHandoffError, ToolReconciliationAttemptOutcome,
128    ToolReconciliationCommitError, ToolReconciliationCommitFailure, ToolReconciliationHandoff,
129    ToolReconciliationHandoffError, ToolReconciliationKind, ToolReconciliationOutcome,
130    ToolTerminalCommitError, ToolTerminalCommitHandoff,
131};
132pub use invocation_schema::{
133    STANDARD_INVOCATION_EXECUTION_EVENT_SCHEMA_ID, StandardInvocationExecutionSchemaError,
134    StandardInvocationExecutionSchemaRegistrationError,
135    register_standard_invocation_execution_event_schema,
136    standard_invocation_execution_event_schema,
137};
138pub use lifecycle_schema::{
139    STANDARD_GRAPH_LIFECYCLE_EVENT_SCHEMA_ID, StandardGraphLifecycleSchemaError,
140    StandardGraphLifecycleSchemaRegistrationError, register_standard_graph_lifecycle_event_schema,
141    standard_graph_lifecycle_event_schema,
142};
143
144pub use driver::{
145    DurableGraphDriver, DurableGraphDriverBuildError, DurableGraphDriverOptions,
146    DurableGraphDriverOptionsError, GraphBlockedHandoff, GraphCancellationHandoff,
147    GraphDriveBlockers, GraphDriveOutcome, GraphDriveReport, GraphDriveResult, GraphDriverError,
148    GraphLifecycleBarrierHandoff,
149};
150pub use fair_scheduler::{
151    DurableFairScheduler, DurableFairSchedulerBuildError, DurableFairSchedulerOptions,
152    DurableFairSchedulerOptionsError, FairSchedulerError, FairSchedulerTick, TenantFairnessWeight,
153    TenantFairnessWeightError, TenantStarvationBound, WeightedFairnessPolicy,
154    WeightedFairnessPolicyError,
155};
156pub use lifecycle::{
157    DurableGraphLifecycle, DurableGraphLifecycleBuildError, DurableGraphLifecycleOptions,
158    DurableGraphLifecycleOptionsError, GraphBarrierLifecycleOutcome, GraphCancellationEvidence,
159    GraphCancellationEvidenceContext, GraphFailureEvidence, GraphFailureEvidenceContext,
160    GraphLifecycleError, GraphLifecycleEvidenceError, GraphLifecycleEvidenceProvider,
161    GraphTerminalEvidence, GraphTerminalEvidenceContext,
162};
163pub use provider_native_agent::{
164    AgentInvocationAccounting, AgentInvocationAccountingReference, AgentInvocationCharge,
165    AgentToolPolicy, AgentToolPolicyContext, AgentToolPolicyDecision, AgentToolPolicyError,
166    AgentToolPolicyReference, PROVIDER_NATIVE_MODEL_NODE_ID, PROVIDER_NATIVE_TOOLS_NODE_ID,
167    PROVIDER_NATIVE_TOOLS_ROUTE_ID, ProviderNativeAgentGraph, ProviderNativeAgentGraphBuildError,
168    ProviderNativeAgentLifecycleEvidence, ProviderNativeAgentPhase,
169    ProviderNativeAgentRegistrationError, ProviderNativeAgentState, ProviderNativeAgentStateError,
170    ProviderNativeCompletedTurn, ProviderNativeModelPlan, ProviderNativeToolPlan,
171};
172pub use provider_registry::{
173    ModelProviderRegistry, ModelProviderRegistryBuilder, ModelProviderRegistryError,
174    ToolProviderRegistry, ToolProviderRegistryBuilder, ToolProviderRegistryError,
175};
176pub use registry::{
177    ExecutableGraph, ExecutableGraphRegistry, ExecutableGraphRegistryBuilder,
178    ExecutableGraphRegistryError, GraphNodeContext, GraphNodeContextError, GraphNodeExecution,
179    GraphNodeExecutionError, GraphNodeExecutionErrorBuildError, GraphNodeExecutor,
180    GraphNodeScheduling,
181};
182pub use schema::{
183    JsonSchemaRegistry, JsonSchemaRegistryBuilder, JsonSchemaRegistryError,
184    JsonSchemaRegistryLimits, JsonSchemaRegistryLimitsError,
185};
186pub use service_schema::{
187    STANDARD_AGENT_SERVICE_CONTROL_EVENT_SCHEMA_ID, StandardAgentServiceControlSchemaError,
188    StandardAgentServiceControlSchemaRegistrationError,
189    register_standard_agent_service_control_event_schema,
190    standard_agent_service_control_event_schema,
191};
192pub use tenant_scheduler::{
193    DurableTenantScheduler, DurableTenantSchedulerBuildError, DurableTenantSchedulerOptions,
194    DurableTenantSchedulerOptionsError, TenantSchedulerError, TenantSchedulerOutcome,
195    TenantSchedulerReport, TenantSchedulerTick,
196};