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 spaces: SpaceApi,
    pub exec: ExecApi,
    pub browser: BrowserApi,
    pub a2a: A2aApi,
    pub knowledge: Arc<KnowledgeBase>,
    pub knowledge_lens: Arc<KnowledgeLens>,
}

Oxios kernel System Call API — composed of 12 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
• SpaceApi — Space management, knowledge flow
• ExecApi — execution config, access management
• BrowserApi — browser backend
• A2aApi — agent-to-agent communication
• [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.

spaces: SpaceApi

Space management: context partitioning, knowledge flow.

exec: ExecApi

Execution: config + access management.

browser: BrowserApi

Browser backend (zero-sized when browser feature is disabled).

a2a: A2aApi

Agent-to-agent communication.

knowledge: Arc<KnowledgeBase>

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

knowledge_lens: Arc<KnowledgeLens>

Semantic knowledge overlay (HNSW index + agent recall).

Implementations

impl KernelHandle

pub fn new( state: StateApi, agents: AgentApi, security: SecurityApi, persona: PersonaApi, extensions: ExtensionApi, mcp: McpApi, infra: InfraApi, spaces: SpaceApi, exec: ExecApi, browser: BrowserApi, a2a: A2aApi, knowledge: Arc<KnowledgeBase>, knowledge_lens: Arc<KnowledgeLens>, ) -> Self

Create a new KernelHandle from 12 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>, program_manager: Arc<ProgramManager>, skill_store: Arc<SkillStore>, persona_manager: Arc<PersonaManager>, mcp_bridge: Arc<McpBridge>, auth_manager: Arc<Mutex<AuthManager>>, access_manager: Arc<Mutex<AccessManager>>, host_tool_validator: Arc<HostToolValidator>, config: OxiosConfig, start_time: Instant, space_manager: Arc<SpaceManager>, ) -> 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 async fn activate_space(&self, id: &str) -> Result<()>

Activate a Space.

Note: Knowledge base is global (~/.oxios/knowledge/), not Space-scoped. Space activation only switches the agent’s execution context and memory graph.