Skip to main content

Crate oxide_k

Crate oxide_k 

Source
Expand description

§Oxide Kernel (oxide-k)

The oxide-k crate is the central micro-kernel of the Rust Oxide Agent-Native OS. It orchestrates modules, mediates inter-module communication through a secure message bus, and maintains a global state registry backed by SQLite.

The kernel is designed around three independent yet cooperating subsystems:

  • module – Module orchestration. Defines the Module and WasmModule traits and provides a ModuleManager that handles lifecycle (load, start, stop, unload) for both native Rust and WebAssembly plugins.
  • bus – Secure message bus. An asynchronous message-passing layer built on tokio::sync::mpsc with strongly-typed Command and Event messages, plus an Envelope that carries provenance metadata.
  • registry – Global state registry. A sqlx-backed SQLite store (in-memory by default for development) for module metadata and configuration values.

These are tied together by the Kernel façade, which exposes a single entry point for kernel initialization and orchestration.

Re-exports§

pub use error::KernelError;
pub use error::Result;
pub use kernel::Kernel;

Modules§

bus
Secure Message Bus
error
Unified error and result types for the Oxide Kernel.
kernel
The Kernel façade ties the three subsystems together.
manifest
Module manifests
module
Module Orchestration
registry
Global State Registry
wasm_exec
wasmtime-backed Wasm executor
xai
Explainable AI (XAI) — Decision Log