Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry of allowed AI tools with validation.

This is the policy enforcement layer. AI models can only invoke tools that are registered here, and their arguments must conform to the registered schema.

Example

use extro_core::*;

let mut registry = ToolRegistry::new();
registry.register(ToolDefinition {
    name: "summarize".into(),
    description: "Summarize page content".into(),
    parameters_schema: serde_json::json!({"type": "object"}),
});

let call = AIToolCall {
    tool_name: "summarize".into(),
    arguments: serde_json::json!({}),
};
assert!(registry.validate(&call).is_ok());

let bad_call = AIToolCall {
    tool_name: "delete_everything".into(),
    arguments: serde_json::json!({}),
};
assert!(registry.validate(&bad_call).is_err());

Implementations

impl ToolRegistry

pub fn new() -> Self

Create an empty tool registry.

pub fn register(&mut self, tool: ToolDefinition)

Register a tool that AI models are allowed to invoke.

pub fn validate(&self, call: &AIToolCall) -> Result<&ToolDefinition, CoreError>

Validate an AI tool call against the registry.

Returns Ok(()) if the tool exists and is registered. Returns Err(CoreError::ToolNotRegistered) if the tool is not allowed.

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

List all registered tools (for agent discovery).

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

Check if a specific tool is registered.

Trait Implementations

impl Debug for ToolRegistry

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

Formats the value using the given formatter.

impl Default for ToolRegistry

fn default() -> ToolRegistry

Returns the “default value” for a type.