Struct AgentTool 

pub struct AgentTool { /* private fields */ }

Agent tool for agent lifecycle management.

Wraps the AgentApi domain of the KernelHandle. Allows agents to query peer status, terminate agents, and check budget state.

Actions

Action	Description	Required params	Optional params
list	List running agents	—	limit
kill	Kill a running agent	id	—
budget	Check budget for an agent	id	—

Note: Named AgentTool in this module but re-exported as KernelAgentTool to avoid collision with oxi_sdk’s AgentTool trait.

Implementations

impl AgentTool

pub fn from_kernel(kernel: &KernelHandle) -> Self

Create a new AgentTool from a KernelHandle.

Extracts the Supervisor and BudgetManager Arcs from the kernel’s Agent API.

Trait Implementations

impl AgentTool for AgentTool

fn name(&self) -> &str

Tool name (used in function calls)

fn label(&self) -> &str

Human-readable label

fn description(&self) -> &'static str

Description for the model

fn parameters_schema(&self) -> Value

JSON Schema for parameters

fn execute<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _tool_call_id: &'life1 str, params: Value, _signal: Option<Receiver<()>>, _ctx: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<AgentToolResult, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Execute the tool with the given tool call ID and parameters.

fn essential(&self) -> bool

Whether this tool is essential (cannot be disabled). Essential tools: read, write, edit, bash, grep, find, ls Optional tools: web_search, github, subagent, etc.

fn on_progress(&self, _callback: Arc<dyn Fn(String) + Send + Sync>)

Called with progress updates during execution. Tools can override this to emit streaming updates.

fn on_browse_progress( &self, _callback: Arc<dyn Fn(BrowseProgress) + Send + Sync>, )

Structured browse progress callback for browser tool context enrichment. Default implementation is no-op. Only browse tools override this to register a callback that enriches ToolCallContext with structured data from BrowseProgress events.

fn render_call(&self, _params: &Value) -> Option<RenderOutput>

Custom rendering for tool call (TUI visualization). Return None to use the default tool_renderer.rs formatter.

fn render_result(&self, _result: &AgentToolResult) -> Option<RenderOutput>

Custom rendering for tool result (TUI visualization). Return None to use the default tool_renderer.rs formatter.

fn execution_mode(&self) -> ToolExecutionMode

Execution mode for parallel safety. Defaults to ParallelSafe. Override for file-mutating or sequential tools.

fn current_tab_id(&self) -> Option<Uuid>

Return the current active tab ID, if this tool manages browser tabs. Defaults to None. Browser tools override this to return the tab ID of the currently-open tab during execution, so the agent loop can populate ToolExecutionUpdate.tab_id.

fn set_tab_id_slot(&self, _slot: Arc<Mutex<RawMutex, Option<Uuid>>>)

Receive a shared slot where the tool can write the current tab ID. The agent loop creates the slot and passes it before on_progress; the tool writes Some(tab_id) when it opens a tab and None when it closes it. Defaults to a no-op — only tab-aware tools override.

fn to_definition(&self) -> ToolDefinition

Convert to ToolDefinition

impl Debug for AgentTool

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

Formats the value using the given formatter.