Struct KernelToolContext 

pub struct KernelToolContext {
    pub workspace_dir: PathBuf,
    pub agent_id: String,
    pub session_id: Option<String>,
    pub permissions: Vec<String>,
    pub metadata: HashMap<String, Value>,
}

Context provided to kernel tool providers during registration.

Contains the metadata that kernel tools need to operate correctly within an oxios agent session.

The metadata map is an extension point for kernel-specific data (e.g., space_id, cspace_name, seed_id) without requiring SDK changes for every new field.

Fields

workspace_dir: PathBuf

Agent’s workspace directory.

agent_id: String

oxios agent identifier.

session_id: Option<String>

Session identifier, if available.

permissions: Vec<String>

CSpace-based permission list.

metadata: HashMap<String, Value>

Extension metadata for kernel-specific data.

Keys are conventionally lowercase snake_case (e.g., "space_id", "cspace_name", "seed_id"). Consumers should use Self::get_meta / Self::get_meta_str for typed access.

Implementations

impl KernelToolContext

pub fn new( workspace_dir: impl Into<PathBuf>, agent_id: impl Into<String>, ) -> KernelToolContext

Create a new context with the given workspace and agent ID.

pub fn with_session(self, session_id: impl Into<String>) -> KernelToolContext

Set the session ID.

pub fn with_permissions(self, permissions: Vec<String>) -> KernelToolContext

Set the permissions list.

pub fn with_meta( self, key: impl Into<String>, value: Value, ) -> KernelToolContext

Add an extension metadata entry.

Example

let ctx = KernelToolContext::new("/workspace", "agent-001")
    .with_meta("space_id", serde_json::json!(uuid::Uuid::new_v4()))
    .with_meta("cspace_name", serde_json::json!("full"));

pub fn get_meta(&self, key: &str) -> Option<&Value>

Get a metadata value by key.

pub fn get_meta_str(&self, key: &str) -> Option<&str>

Get a metadata value as a string.

Trait Implementations

impl Clone for KernelToolContext

fn clone(&self) -> KernelToolContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KernelToolContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.