oxide-k 0.3.0

Oxide Kernel - micro-kernel core for the Rust Oxide Agent-Native OS
Documentation

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.