Struct KernelHandle 

pub struct KernelHandle {

    pub state: StateApi,
    pub agents: AgentApi,
    pub security: SecurityApi,
    pub persona: PersonaApi,
    pub extensions: ExtensionApi,
    pub mcp: McpApi,
    pub infra: InfraApi,
    pub projects: Option<ProjectApi>,
    pub exec: ExecApi,
    pub a2a: A2aApi,
    pub engine: EngineApi,
    pub knowledge: Arc<KnowledgeBase>,
    pub knowledge_lens: Arc<KnowledgeLens>,
    pub marketplace_api: MarketplaceApi,
    pub calendar: Option<CalendarApi>,
    pub email: Option<EmailApi>,
}

Oxios kernel System Call API — composed of 13 domain Facades.

Each Facade groups related system calls:

• StateApi — data persistence, sessions
• AgentApi — agent lifecycle, budgets, memory
• SecurityApi — auth, audit trail, RBAC, approvals
• PersonaApi — multi-persona management
• ExtensionApi — programs, skills, host tools
• McpApi — MCP server bridge
• ProjectApi — Project management, memory linking
• ExecApi — execution config, access management
• A2aApi — agent-to-agent communication
• EngineApi — LLM engine providers, models, config
• [KnowledgeBase] — markdown note management (kernel-free, via oxios-markdown)

Fields

state: StateApi

State management: save/load/sessions.

agents: AgentApi

Agent management: lifecycle/budgets/memory.

security: SecurityApi

Security: auth/audit/RBAC/approvals.

persona: PersonaApi

Persona management.

extensions: ExtensionApi

Extensions: programs/skills/host tools.

mcp: McpApi

MCP server bridge.

infra: InfraApi

Infrastructure: Git/scheduler/cron/resources/events/system.

projects: Option<ProjectApi>

Project management: work context (RFC-011).

exec: ExecApi

Execution: config + access management.

a2a: A2aApi

Agent-to-agent communication.

engine: EngineApi

Engine: LLM providers, models, config.

knowledge: Arc<KnowledgeBase>

Knowledge base: markdown notes (direct access, no kernel dependency).

knowledge_lens: Arc<KnowledgeLens>

Semantic knowledge overlay (HNSW index + agent recall).

marketplace_api: MarketplaceApi

Marketplace API — ClawHub search, install, update.

calendar: Option<CalendarApi>

Calendar events — create, update, delete, list, search, freebusy.

email: Option<EmailApi>

Email — send HTML emails via SMTP, template management.

Implementations

impl KernelHandle

pub fn new( state: StateApi, agents: AgentApi, security: SecurityApi, persona: PersonaApi, extensions: ExtensionApi, mcp: McpApi, infra: InfraApi, projects: Option<ProjectApi>, exec: ExecApi, a2a: A2aApi, engine: EngineApi, knowledge: Arc<KnowledgeBase>, knowledge_lens: Arc<KnowledgeLens>, marketplace_api: MarketplaceApi, calendar: Option<CalendarApi>, email: Option<EmailApi>, ) -> Self

Create a new KernelHandle from 13 domain Facades.

Each Facade is assembled independently in kernel.rs and passed here. This enables testing individual Facades without the full kernel.

pub fn from_subsystems( state_store: Arc<StateStore>, event_bus: EventBus, supervisor: Arc<dyn Supervisor>, scheduler: Arc<AgentScheduler>, memory_manager: Arc<MemoryManager>, git_layer: Arc<GitLayer>, audit_trail: Arc<AuditTrail>, budget_manager: Arc<BudgetManager>, resource_monitor: Arc<ResourceMonitor>, cron_scheduler: Arc<CronScheduler>, skill_manager: Arc<SkillManager>, persona_manager: Arc<PersonaManager>, mcp_bridge: Arc<McpBridge>, auth_manager: Arc<Mutex<AuthManager>>, access_manager: Arc<Mutex<AccessManager>>, config: OxiosConfig, start_time: Instant, ) -> Self

👎Deprecated:

Use KernelHandle::new() with pre-built Facades instead

Build a KernelHandle from raw subsystem parameters.

Prefer KernelHandle::new() which takes pre-built Facades.

pub async fn save_and_commit<T: Serialize>( &self, category: &str, name: &str, data: &T, ) -> Result<()>

Save data and commit to git (State + Infra).

pub async fn save_markdown_and_commit( &self, category: &str, name: &str, content: &str, ) -> Result<()>

Save markdown and commit to git (State + Infra).

pub async fn delete_and_commit( &self, category: &str, name: &str, ) -> Result<bool>

Delete a file and commit the removal to git (State + Infra).

pub fn commit_all(&self, message: &str) -> Result<Option<CommitInfo>>

Commit all current changes to git.

pub fn flush_audit(&self) -> Result<()>

Flush audit trail and commit to git (Security + Infra).

pub async fn schedule( &self, cron_expr: &str, task: &str, persona: Option<&str>, ) -> Result<String>

Schedule a cron job by expression (convenience wrapper).

pub async fn unschedule(&self, job_id: &str) -> Result<bool>

Unschedule a cron job by string ID (convenience wrapper).

pub fn list_schedules(&self) -> Vec<CronJob>

List cron jobs (convenience wrapper).

pub async fn load_json<T: DeserializeOwned>( &self, category: &str, name: &str, ) -> Result<Option<T>>

Load JSON from state store.

pub fn start_time(&self) -> Instant

Get kernel start time.

pub fn marketplace_api(&self) -> &MarketplaceApi

Marketplace API — ClawHub search, install, update.

pub fn memory(&self) -> MemoryApi

Get a MemoryApi facade for memory operations.

Constructs (lazily, on first call) a MemoryApi that wraps the MemoryManager from AgentApi. This is the 14th typed API in KernelHandle (alongside A2aApi, AgentApi, etc.).

The MemoryApi is cached — multiple calls return the same instance.