Skip to main content

ToolManager

Struct ToolManager 

Source
pub struct ToolManager { /* private fields */ }

Implementations§

Source§

impl ToolManager

Source

pub fn new() -> Self

Source

pub fn set_sandbox(&mut self, sandbox: Sandbox)

Enable sandboxing: all path-based tools (ls, read, write, edit, grep, glob) are confined to the sandbox root, and the run tool’s explicit cwd is checked against it.

Source

pub fn sandbox(&self) -> Option<&Sandbox>

The active sandbox, if any.

Source

pub fn sandbox_check( &self, tool_name: &str, arguments: &Value, ) -> Option<String>

If a sandbox is active and this tool call would access a path outside it, return the violation error message. Returns None if the call is allowed (or no sandbox is active).

Source

pub fn register_defaults(&mut self)

Register all built-in tools.

Source

pub fn register_tool(&mut self, tool: Tool)

Source

pub fn register_custom_tools(&mut self, tools: &[CustomToolDefinition])

Register custom tools from crate::custom_tools::CustomToolManager. Tools whose names collide with built-in tools are silently skipped.

Source

pub fn get_all_tool_definitions(&self) -> Vec<ToolDefinition>

Returns the tool definitions for all registered tools.

Source

pub fn tools_for_mode( &self, mode: AgentMode, availability: ToolAvailability, ) -> Vec<ToolDefinition>

Returns the tool definitions appropriate for the given agent mode.

Tools disabled in availability (e.g. auto_compact, question) are excluded, so the model never sees them.

Source

pub fn category_of(&self, tool_name: &str) -> Option<ToolCategory>

Returns the category of a tool by name, or None if not found.

Source

pub fn needs_approval(&self, tool_name: &str) -> bool

Returns true if the tool requires user approval before execution. Destructive tools (write, edit, run) and signal tools (switch_mode, question, auto_compact) require approval.

Source

pub fn is_signal_tool(&self, tool_name: &str) -> bool

Returns true if the tool is a signal tool (switch_mode, question, auto_compact). Signal tools are handled specially by the agent loop rather than executed generically.

Source

pub fn parse_signal_event( &self, tool_name: &str, arguments: &Value, ) -> Option<SignalEvent>

Parse a signal tool’s result string into a structured SignalEvent.

Signal tools return plain strings, but the agent loop needs structured data to dispatch them correctly. This method interprets the tool call arguments (not the result string) to produce the appropriate event.

Returns None if the tool is not a signal tool or the arguments are invalid.

Source

pub async fn execute_tool_call( &self, tool_name: &str, arguments: &Value, ) -> String

Trait Implementations§

Source§

impl Default for ToolManager

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more