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_path_guard(&mut self, guard: PathGuard)

Confine the built-in file tools (ls, read, write, edit, grep, glob) to the paths the guard allows.

Must be called before ToolManager::register_defaults: the guard is checked in ToolManager::execute_tool_call and cloned into the ls/read/write/edit handlers, which verify the opened file descriptor against it (closing the check-then-open race).

Source

pub fn path_guard(&self) -> Option<&PathGuard>

The active path guard, if any.

Source

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

Enable the OS-level sandbox for run and custom tools.

Must be called before register_defaults and register_custom_tools: tool handlers are opaque closures, so the sandbox is cloned into them at construction. Setting it afterwards leaves the already-registered tools unsandboxed.

Source

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

The active process sandbox, if any.

Source

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

Validate a tool call’s path arguments against the guard and return arguments with every path replaced by its resolved absolute form.

Substitution is the point: a handler that received the raw string would resolve a relative path against the process cwd, while the guard resolved it against the workspace root. Those coincide only when the harness happens to be started in the workspace, so checking one and opening the other leaves the containment purely incidental.

Returns Err(violation_message) when the guard rejects a path, or the arguments unchanged when no guard 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