Crate oxios_kernel 

Oxios kernel: supervisor, event bus, state store.

The kernel is the core of the Oxios Agent OS. Everything passes through here: agent lifecycle, inter-agent communication, and persistent state management.

Re-exports

pub use telemetry_stub as telemetry;

pub use agent_group::OxiosAgentGroup;

pub use agent_group::OxiosAgentGroupStatus;

pub use agent_group::OxiosGroupAgent;

pub use agent_lifecycle::AgentLifecycleManager;

pub use agent_runtime::AgentRuntime;

pub use daemon::DaemonManager;

pub use daemon::DaemonStatus;

pub use supervisor::BasicSupervisor;

pub use supervisor::Supervisor;

pub use orchestrator::AgentRole;

pub use orchestrator::OrchestrationResult;

pub use orchestrator::Orchestrator;

pub use orchestrator::SubTask;

pub use scheduler::AgentScheduler;

pub use scheduler::Priority;

pub use scheduler::ScheduledTask;

pub use scheduler::SchedulerStats;

pub use scheduler::TaskStatus;

pub use cron::CronJob;

pub use cron::CronJobResult;

pub use cron::CronJobUpdate;

pub use cron::CronScheduler;

pub use cron::JobSource;

pub use budget::BudgetExceeded;

pub use budget::BudgetInfo;

pub use budget::BudgetKind;

pub use budget::BudgetLimit;

pub use budget::BudgetManager;

pub use circuit_breaker::CircuitBreaker;

pub use access_manager::AccessManager;

pub use access_manager::Action;

pub use access_manager::AgentPermissions;

pub use access_manager::ApprovalStatus;

pub use access_manager::PendingApproval;

pub use access_manager::RbacAuditEntry;

pub use access_manager::RbacManager;

pub use access_manager::RbacPolicy;

pub use access_manager::Role;

pub use access_manager::Subject;

pub use auth::AuthManager;

pub use auth::KeyMeta;

pub use capability::template::CapabilityTemplate;

pub use capability::CSpace;

pub use capability::Capability;

pub use capability::CapabilityId;

pub use capability::Issuer;

pub use capability::ResourceRef;

pub use capability::Rights;

pub use credential::CredentialStore;

pub use audit_trail::AgentId as AuditAgentId;

pub use audit_trail::AuditAction;

pub use audit_trail::AuditEntry;

pub use audit_trail::AuditError;

pub use audit_trail::AuditTrail;

pub use audit_trail::HashDigest;

pub use event_bus::EventBus;

pub use event_bus::KernelEvent;

pub use a2a::A2AMessage;

pub use a2a::A2AProtocol;

pub use a2a::A2ARequest;

pub use a2a::A2AResponse;

pub use a2a::AgentCard;

pub use a2a::AgentCardRegistry;

pub use a2a::DelegationHandler;

pub use a2a::TaskPriority;

pub use a2a::TaskSpec;

pub use mcp::McpBridge;

pub use mcp::McpCapabilities;

pub use mcp::McpServer;

pub use mcp::McpTool;

pub use mcp::McpToolCallResult as CallToolResult;

pub use memory::auto_memory_bridge::AutoMemoryBridge;

pub use memory::auto_memory_bridge::ExportResult;

pub use memory::auto_memory_bridge::GuidancePattern;

pub use memory::auto_memory_bridge::ImportResult;

pub use memory::auto_memory_bridge::InsightCategory;

pub use memory::auto_memory_bridge::MemoryInsight;

pub use memory::auto_memory_bridge::SyncDirection;

pub use memory::auto_memory_bridge::SyncResult;

pub use memory::flash_attention::BenchmarkResult as AttentionBenchmarkResult;

pub use memory::flash_attention::FlashAttention;

pub use memory::flash_attention::FlashAttentionConfig;

pub use memory::flash_attention::MemoryEstimate;

pub use memory::hyperbolic::batch_euclidean_to_poincare;

pub use memory::hyperbolic::euclidean_to_poincare;

pub use memory::hyperbolic::hyperbolic_distance;

pub use memory::hyperbolic::mobius_add;

pub use memory::hyperbolic::mobius_scalar_mul;

pub use memory::hyperbolic::HyperbolicConfig;

pub use memory::hyperbolic::HyperbolicEmbedding;

pub use memory::chunk_fixed;

pub use memory::chunk_paragraphs;

pub use memory::content_hash;

pub use memory::cosine_similarity_f32;

pub use memory::l2_normalize_f32;

pub use memory::l2_normalize_f64;

pub use memory::ChunkConfig;

pub use memory::CurationCandidate;

pub use memory::CurationReport;

pub use memory::HnswIndex;

pub use memory::HnswMemoryIndex;

pub use memory::MemoryBudget;

pub use memory::MemoryEntry;

pub use memory::MemoryGraph;

pub use memory::MemoryManager;

pub use memory::MemoryType;

pub use memory::SemanticHit;

pub use memory::TextChunk;

pub use memory::TextVector;

pub use embedding::EmbeddingProvider;

pub use embedding::EmbeddingVector;

pub use embedding::TfIdfEmbeddingProvider;

pub use persona::default_personas;

pub use persona::Persona;

pub use persona_manager::PersonaManager;

pub use persona_store::PersonaStore;

pub use tools::BrowserTool;

pub use tools::ExecTool;

pub use tools::ProgramTool;

pub use host_tools::common as host_tools_common;

pub use host_tools::HostToolStatus;

pub use host_tools::HostToolValidator;

pub use program::ArgumentDef;

pub use program::HostRequirementsCheck;

pub use program::InstallSource;

pub use program::Program;

pub use program::ProgramManager;

pub use program::ProgramMeta;

pub use program::ToolDef;

pub use skill::Skill;

pub use skill::SkillMeta;

pub use skill::SkillStore;

pub use state_store::AgentResponse;

pub use state_store::Session;

pub use state_store::SessionId;

pub use state_store::SessionSummary;

pub use state_store::StateStore;

pub use config::BrowserConfig;

pub use config::ChannelsConfig;

pub use config::CronConfig;

pub use config::DaemonConfig;

pub use config::EngineConfig;

pub use config::ExecConfig;

pub use config::GitConfig;

pub use config::InlineCronJob;

pub use config::McpConfig;

pub use config::McpServerDef;

pub use config::MemoryConfig;

pub use config::OxiosConfig;

pub use config::PersonaConfig;

pub use config::TelegramChannelConfig;

pub use backup::BackupManifest;

pub use backup::BackupSection;

pub use git_layer::CommitInfo;

pub use git_layer::GitLayer;

pub use git_layer::LogEntry;

pub use resource_monitor::OverloadThreshold;

pub use resource_monitor::ResourceMonitor;

pub use resource_monitor::ResourceSnapshot;

pub use space::extract_filesystem_path;

pub use space::match_keywords;

pub use space::ConversationBuffer;

pub use space::ConversationTurn;

pub use space::CrossRefEntry;

pub use space::KnowledgeBridge;

pub use space::KnowledgeFlow;

pub use space::PathMatcher;

pub use space::Space;

pub use space::SpaceId;

pub use space::SpaceManager;

pub use space::SpaceManagerError;

pub use space::SpaceSource;

pub use engine::EngineProvider;

pub use engine::OxiEngineProvider;

pub use engine::OxiosEngine;

pub use error::HttpStatus;

pub use error::KernelError;

pub use error::KernelResult;

pub use types::AgentId;

pub use types::AgentInfo;

pub use types::AgentStatus;

pub use metrics::get_metrics;

pub use metrics::register_builtin_metrics;

pub use metrics::registry;

pub use kernel_handle::KernelHandle;

pub use kernel_handle::A2aApi;

pub use kernel_handle::AgentApi;

pub use kernel_handle::BrowserApi;

pub use kernel_handle::ExecApi;

pub use kernel_handle::ExtensionApi;

pub use kernel_handle::InfraApi;

pub use kernel_handle::McpApi;

pub use kernel_handle::PersonaApi;

pub use kernel_handle::SecurityApi;

pub use kernel_handle::SpaceApi;

pub use kernel_handle::StateApi;

Modules

a2a

A2A (Agent-to-Agent) protocol for horizontal agent communication.

access_manager

Access Manager — least-privilege security for agents.

agent_group

Agent group types for oxios orchestration.

agent_lifecycle

Agent lifecycle management — fork, register, run, cleanup.

agent_runtime

Agent runtime: wraps oxi-agent’s AgentLoop for use by the kernel.

audit_trail

Tamper-evident audit trail with cryptographic hash chain.

auth

API key authentication manager.

backup

Backup and restore for Oxios state.

budget

Budget manager for agent-level token and call budget tracking.

capability

Capability-based access control for the Oxios kernel.

circuit_breaker

Circuit breaker for LLM provider calls.

config

Configuration loading from TOML files.

credential

Multi-source credential resolution.

cron

Cron scheduler for time-based autonomous agent execution.

daemon

Daemon lifecycle management — PID file, start/stop, system service install.

embedding

Embedding abstraction for semantic similarity.

engine

Engine provider — thin wrapper around oxi-sdk’s Oxi.

error

Typed error types for the Oxios kernel public API.

event_bus

Event bus: inter-agent communication via tokio broadcast channels.

git_layer

Git-based version control layer using gix. Provides in-process commits, logs, tags, and restore.

host_tools

Host tool validation for Oxios.

kernel_handle

Kernel facade — 10 domain Facades composing the System Call API.

mcp

MCP (Model Context Protocol) integration layer.

memory

Agent memory system.

metrics

Metrics — Prometheus-compatible counters, gauges, and histograms.

onboarding

Interactive first-run setup wizard.

orchestrator

Orchestrator: coordinates the full Ouroboros lifecycle for user messages.

persona

Persona system: multiple AI characters with distinct voices.

persona_manager

Persona manager: coordinates persona-aware execution.

persona_store

In-memory store for persona registry.

program

Programs: OS-level installable applications for AI agents.

resource_monitor

Resource monitoring for the Oxios kernel.

scheduler

Agent Scheduler — priority-based task queue inspired by AIOS / AgentRM.

skill

Skill system: markdown-based instructions for agents.

space

Space: logical work partition for context isolation.

state_store

Filesystem-based state store.

supervisor

Supervisor: agent lifecycle management.

telemetry_stub

Stub telemetry module (no OTel feature).

tools

Oxios-specific agent tools.

types

Core types for the Oxios kernel.

Structs

AgentLoop

AgentLoop.

InterAgentMessage

A message sent between agents.

KernelToolContext

Context provided to kernel tool providers during registration.

MessageBus

Broadcast-based message bus for inter-agent communication.

Model

LLM model definition.

Oxi

Oxi AI engine instance — holds isolated provider and model registries.

OxiBuilder

Builder for creating an Oxi instance.

StreamOptions

Options for streaming requests

Enums

AgentEvent

Events emitted during agent execution.

Traits

KernelToolProvider

Trait for providing kernel-level tools to the SDK.

Provider

LLM provider trait