Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry of available tools for dispatch.

Supports hierarchical lookup: a child registry can overlay a parent. The parent chain is walked when a tool is not found locally.

Implementations

impl ToolRegistry

pub fn new() -> Self

Create an empty registry with no parent.

pub fn with_parent(parent: Arc<ToolRegistry>) -> Self

Create a child registry that delegates to parent for missing tools.

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

Register a tool (local to this registry level).

When require_signatures is enabled, this rejects unsigned tools with ToolError::SignatureRequired. Use [register_signed] to supply a signature, or disable the requirement.

pub fn try_register( &mut self, tool: Arc<dyn BuiltinTool>, ) -> Result<(), ToolError>

Register a tool, checking signatures when required.

Returns Err(SignatureRequired) when require_signatures is on and no signature is provided. Returns Ok(()) otherwise.

pub fn register_signed( &mut self, tool: Arc<dyn BuiltinTool>, signature: ToolSignature, ) -> Result<(), ToolError>

Register a tool with a cryptographic signature.

Verifies the signature against trusted keys before allowing registration. The signature is stored and the tool is chain-logged if ExoChain is available.

pub fn verify_tool_signature(&self, signature: &ToolSignature) -> bool

Check whether a tool signature is valid against any trusted key.

pub fn set_require_signatures(&mut self, require: bool)

Enable or disable mandatory signature verification for tool registration.

pub fn requires_signatures(&self) -> bool

Whether signatures are required for tool registration.

pub fn add_trusted_key(&mut self, key: [u8; 32])

Add a trusted Ed25519 public key for signature verification.

pub fn get_signature(&self, tool_name: &str) -> Option<&ToolSignature>

Get the signature for a registered tool, if any.

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

Look up a tool by name, walking the parent chain.

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

Execute a tool by name, walking the parent chain.

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

List all registered tool names (merges parent + local, local wins).

pub fn len(&self) -> usize

Number of registered tools (parent + local, deduplicated).

pub fn is_empty(&self) -> bool

Whether the registry has no tools (including parent).

pub fn parent(&self) -> Option<&Arc<ToolRegistry>>

Get a reference to the parent registry, if any.

Trait Implementations

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.

impl Send for ToolRegistry

impl Sync for ToolRegistry