Expand description
Stable host/kernel ABI.
The public protocol, runtime dispatcher, and contract tests live in focused submodules so the wire contract can evolve independently from step execution.
Structs§
- Budget
Grant - Governance
Config - K2: the governance sub-bundle of
RunConfig— the same five fields as theLoadGovernancePolicyevent, grouped so a run’s whole governance posture travels as one value. - Kernel
Action - Kernel
Diagnostics - Read-only runtime resource projection. Hosts use this for admission and monitoring; mutating kernel state still requires a versioned input transaction.
- Kernel
Fault - Kernel
Input - Kernel
Prepared Step - Host-visible description of a staged transition. The candidate runtime state remains opaque
inside
KernelRuntime; hosts persistinputplusstepbefore using the one-shot token to publish it. - Kernel
Reliability Config - Host-selectable reliability policy. These values bound retained replay state and retry ladders; omitted fields keep the kernel defaults.
- Kernel
Runtime - Pure kernel runtime wrapper. SDKs should migrate toward feeding
KernelInputvalues here instead of directly drivingLoopStateMachine. - Kernel
Snapshot - Portable runtime checkpoint. State is rebuilt from accepted public ABI transactions rather than serializing private scheduler structs, so internal refactors do not change this schema.
- Kernel
Snapshot Policy - JSON-portable scheduler policy. The 64-bit axes use decimal strings so JavaScript hosts do not lose precision while parsing and re-encoding a checkpoint.
- Kernel
Step - Policy
Rule - One permission rule for the governance ABI: glob
tool_pattern→ action. - Rate
Limit Spec - Per-tool rate limit for the governance ABI.
Maps to
crate::governance::rate_limit::RateLimit. - RunConfig
- K2: a bundle of run-setup configuration carried by the
KernelInputEvent::ConfigureRunevent. Each field maps 1:1 to a granularSet*/Load*event;None/absent leaves that aspect untouched. This is the host-side analogue of the SDK’sapplyKernelPolicies— one event for the whole setup. - Signal
Policy Config - Versioned, atomically validated signal-routing policy.
- Workflow
Spawn Failure
Enums§
- Cancellation
Reason - Constraint
Spec - Parameter constraint for the governance ABI.
Maps to
crate::governance::constraint::ConstraintRule(structural rules only; pattern/predicate matching stays in the SDK execution layer). - Kernel
Effect - Kernel
Fault Code - Kernel
Input Event - Kernel
Lifecycle - Kernel
Observation - Kernel
Preparation Status - Outcome of staging one kernel input before the host’s durable commit boundary.
- Kernel
Pressure Action - Policy
Action - Serializable permission action for the governance ABI.
Mirrors
crate::governance::permission::PermissionActionwithout coupling the wire format to the internal type.