Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Tool registry for managing all available tools

Implementations

impl ToolRegistry

pub fn new(workspace: PathBuf) -> Self

Create a new tool registry

pub fn with_artifact_limits( workspace: PathBuf, artifact_limits: ArtifactStoreLimits, ) -> Self

Create a new tool registry with custom artifact retention limits.

pub fn register_builtin(&self, tool: Arc<dyn Tool>)

Register a builtin tool (cannot be overridden by dynamic tools)

pub fn register(&self, tool: Arc<dyn Tool>)

Register a tool

If a tool with the same name already exists as a builtin, the registration is rejected to prevent shadowing of core tools.

pub fn unregister(&self, name: &str) -> bool

Unregister a tool by name

Returns true if the tool was found and removed.

pub fn unregister_by_prefix(&self, prefix: &str)

Unregister all tools whose names start with the given prefix.

pub fn get(&self, name: &str) -> Option<Arc<dyn Tool>>

Get a tool by name

pub fn contains(&self, name: &str) -> bool

Check if a tool exists

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

Get all tool definitions for LLM

pub fn list(&self) -> Vec<String>

List all registered tool names

pub fn len(&self) -> usize

Get the number of registered tools

pub fn is_empty(&self) -> bool

Check if registry is empty

pub fn context(&self) -> ToolContext

Get the tool context

pub fn artifact_store(&self) -> ArtifactStore

Return a clone of the registry’s artifact store handle.

pub fn get_artifact(&self, artifact_uri: &str) -> Option<ToolArtifact>

Get a stored tool artifact by URI.

pub fn set_trace_sink(&self, sink: Arc<dyn TraceSink>)

Replace the trace sink used for compact tool/program execution events.

pub fn trace_sink(&self) -> Arc<dyn TraceSink>

Return the current trace sink.

pub fn set_search_config(&self, config: SearchConfig)

Set the search configuration for the tool context

pub fn set_sandbox(&self, sandbox: Arc<dyn BashSandbox>)

Set a sandbox executor so that bash tool calls use the sandbox even when executed without an explicit ToolContext (i.e., via execute()).

pub async fn execute(&self, name: &str, args: &Value) -> Result<ToolResult>

Execute a tool by name using the registry’s default context

pub async fn execute_with_context( &self, name: &str, args: &Value, ctx: &ToolContext, ) -> Result<ToolResult>

Execute a tool by name with an external context

pub async fn execute_raw( &self, name: &str, args: &Value, ) -> Result<Option<ToolOutput>>

Execute a tool and return raw output using the registry’s default context

pub async fn execute_raw_with_context( &self, name: &str, args: &Value, ctx: &ToolContext, ) -> Result<Option<ToolOutput>>

Execute a tool and return raw output with an external context