Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry for external tools.

ToolRegistry stores registered tools and provides methods for invoking them with proper process lifecycle management.

Example

use forge_agent::workflow::tools::{Tool, ToolRegistry, ToolInvocation};

let mut registry = ToolRegistry::new();

// Register magellan
let magellan = Tool::new("magellan", "/usr/bin/magellan")
    .default_args(vec!["--db".to_string(), ".forge/graph.db".to_string()])
    .description("Graph-based code indexer");
registry.register(magellan)?;

// Check registration
assert!(registry.is_registered("magellan"));

// List all tools
let tools = registry.list_tools();
assert!(tools.contains(&"magellan"));

Implementations

impl ToolRegistry

pub fn new() -> Self

Creates a new empty ToolRegistry.

Example

use forge_agent::workflow::tools::ToolRegistry;

let registry = ToolRegistry::new();
assert_eq!(registry.len(), 0);

pub fn register(&mut self, tool: Tool) -> Result<(), ToolError>

Registers a tool in the registry.

Arguments

• tool - Tool to register

Returns

• Ok(()) if registration succeeded
• Err(ToolError::AlreadyRegistered) if tool with same name exists

Example

use forge_agent::workflow::tools::{Tool, ToolRegistry};

let mut registry = ToolRegistry::new();
let tool = Tool::new("magellan", "/usr/bin/magellan");
registry.register(tool)?;

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

Gets a tool by name.

Arguments

• name - Tool name to look up

Returns

• Some(&Tool) if tool exists
• None if tool not found

Example

use forge_agent::workflow::tools::{Tool, ToolRegistry};

let mut registry = ToolRegistry::new();
registry.register(Tool::new("magellan", "/usr/bin/magellan")).unwrap();

let tool = registry.get("magellan");
assert!(tool.is_some());
assert_eq!(tool.unwrap().name, "magellan");

pub async fn invoke( &self, invocation: &ToolInvocation, ) -> Result<ToolInvocationResult, ToolError>

Invokes a tool with the given invocation parameters.

Arguments

• invocation - Tool invocation request

Returns

• Ok(ToolInvocationResult) with result and optional process guard
• Err(ToolError) if tool not found or execution fails

Example

use forge_agent::workflow::tools::{ToolRegistry, ToolInvocation, Tool};

let mut registry = ToolRegistry::new();
registry.register(Tool::new("echo", "/bin/echo")).unwrap();

let invocation = ToolInvocation::new("echo")
    .args(vec!["hello".to_string(), "world".to_string()]);

let result = registry.invoke(&invocation).await?;
assert!(result.result.success);

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

Lists all registered tool names.

Returns

Vector of tool names

Example

use forge_agent::workflow::tools::{Tool, ToolRegistry};

let mut registry = ToolRegistry::new();
registry.register(Tool::new("magellan", "/usr/bin/magellan")).unwrap();
registry.register(Tool::new("cargo", "/usr/bin/cargo")).unwrap();

let tools = registry.list_tools();
assert_eq!(tools.len(), 2);

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

Checks if a tool is registered.

Arguments

• name - Tool name to check

Returns

• true if tool is registered
• false if tool is not registered

Example

use forge_agent::workflow::tools::{Tool, ToolRegistry};

let mut registry = ToolRegistry::new();
registry.register(Tool::new("magellan", "/usr/bin/magellan")).unwrap();

assert!(registry.is_registered("magellan"));
assert!(!registry.is_registered("cargo"));

pub fn len(&self) -> usize

Returns the number of registered tools.

Example

use forge_agent::workflow::tools::{Tool, ToolRegistry};

let mut registry = ToolRegistry::new();
assert_eq!(registry.len(), 0);

registry.register(Tool::new("magellan", "/usr/bin/magellan")).unwrap();
assert_eq!(registry.len(), 1);

pub fn is_empty(&self) -> bool

Returns true if the registry is empty.

Example

use forge_agent::workflow::tools::ToolRegistry;

let registry = ToolRegistry::new();
assert!(registry.is_empty());

pub fn with_standard_tools() -> Self

Creates a ToolRegistry with standard tools pre-registered.

This method attempts to discover and register commonly-used tools:

• magellan (graph-based code indexer)
• cargo (Rust package manager)
• splice (precision code editor)

Tools that are not found are logged but don’t cause failure (graceful degradation).

Returns

A ToolRegistry with discovered tools registered

Example

use forge_agent::workflow::tools::ToolRegistry;

let registry = ToolRegistry::with_standard_tools();
// registry may have magellan, cargo, splice if they were found

Trait Implementations

impl Clone for ToolRegistry

fn clone(&self) -> ToolRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.