oxios-kernel 1.2.0

Oxios kernel: supervisor, event bus, state store
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

//! Kernel tools — AgentTool wrappers for KernelHandle API domains.
//!
//! These tools expose kernel system calls to the agent's tool-calling loop.
//! Each tool wraps a specific domain API and uses an action-based parameter
//! schema to dispatch operations.
//!
//! ## Tools
//!
//! - [`ProjectTool`] — Project management (list, get, link_memory, unlink_memory)
//! - [`AgentTool`] — Agent lifecycle (list, kill, budget)
//! - [`PersonaTool`] — Persona management (list, set_active, get)
//! - [`CronTool`] — Cron scheduling (list, add, remove, trigger)
//! - [`SecurityTool`] — Security audit (verify_chain, query_audit, audit_count)
//! - [`BudgetTool`] — Budget management (check, set, reserve, reset)
//! - [`ResourceTool`] — Resource monitoring (snapshot, history, overloaded)
//! - [`CalendarTool`] — Calendar events (create, update, delete, list, search, freebusy)

pub mod agent_tool;
pub mod budget_tool;
pub mod calendar_tool;
pub mod cron_tool;
pub mod email_tool;
pub mod knowledge_tool;
pub mod marketplace_tool;
pub mod persona_tool;
pub mod project_tool;
pub mod resource_tool;
pub mod security_tool;

pub use agent_tool::AgentTool as KernelAgentTool;
pub use budget_tool::BudgetTool;
pub use calendar_tool::CalendarTool;
pub use cron_tool::CronTool;
pub use email_tool::EmailTool;
pub use knowledge_tool::KnowledgeTool;
pub use marketplace_tool::MarketplaceTool;
pub use persona_tool::PersonaTool;
pub use project_tool::ProjectTool;
pub use resource_tool::ResourceTool;
pub use security_tool::SecurityTool;

use crate::types::AgentId;
use crate::KernelHandle;
use oxi_sdk::ToolRegistry;

/// Register all kernel domain tools into the registry.
///
/// Called by [`super::kernel_bridge::OxiosKernelBridge`] during agent build.
/// This is the canonical list of kernel tools available in oxios agents.
pub fn register_all_kernel_tools(registry: &ToolRegistry, kernel: &KernelHandle, _agent_id: &str) {
    let agent_uuid = AgentId::new_v4();

    // ExecTool (stores Arc<KernelHandle>)
    registry.register(crate::tools::ExecTool::from_kernel(kernel));

    // Memory tools (each stores Arc<KernelHandle>)
    registry.register(crate::tools::MemoryReadTool::from_kernel(kernel));
    registry.register(crate::tools::MemorySearchTool::from_kernel(kernel));
    registry.register(crate::tools::MemoryWriteTool::from_kernel(kernel));

    // Kernel domain tools (take &KernelHandle)
    registry.register(ProjectTool::from_kernel(kernel));
    registry.register(KernelAgentTool::from_kernel(kernel));
    registry.register(PersonaTool::from_kernel(kernel));
    registry.register(CronTool::from_kernel(kernel));
    registry.register(SecurityTool::from_kernel(kernel));
    registry.register(BudgetTool::from_kernel(kernel));
    registry.register(ResourceTool::from_kernel(kernel));

    // A2A tools (each stores Arc<KernelHandle>)
    registry.register(crate::tools::A2aDelegateTool::from_kernel(
        kernel, agent_uuid,
    ));
    registry.register(crate::tools::A2aSendTool::from_kernel(kernel, agent_uuid));
    registry.register(crate::tools::A2aQueryTool::from_kernel(kernel));

    // MCP tool wrapper (stores Arc<KernelHandle>)
    registry.register(crate::tools::McpToolWrapper::from_kernel(
        kernel,
        "",
        "",
        "MCP tools via bridge".into(),
        serde_json::json!({"type": "object", "properties": {}}),
    ));

    // KnowledgeTool (markdown note management)
    registry.register(KnowledgeTool::from_kernel(kernel));

    // Browser (optional feature, stores Arc<KernelHandle>)
    #[cfg(feature = "native-browser")]
    {}

    // Marketplace (ClawHub — search, install, update)
    registry.register(MarketplaceTool::from_kernel(kernel));

    // Calendar (optional — only if [calendar] is enabled)
    if let Some(calendar_tool) = CalendarTool::try_from_kernel(kernel) {
        registry.register(calendar_tool);
    }

    // Email (optional — only if [email] is enabled)
    if let Some(email_tool) = EmailTool::try_from_kernel(kernel) {
        registry.register(email_tool);
    }
}