Struct Tool 

pub struct Tool {
    pub name: String,
    pub executable: PathBuf,
    pub default_args: Vec<String>,
    pub description: String,
}

A registered external tool.

Tools are registered with their executable path, default arguments, and description. When invoked, default arguments are combined with invocation-specific arguments.

Fields

name: String

Tool identifier (e.g., “magellan”, “cargo”, “splice”)

executable: PathBuf

Path to the executable

default_args: Vec<String>

Default arguments passed to every invocation

description: String

Human-readable description of the tool

Implementations

impl Tool

pub fn new(name: impl Into<String>, executable: impl Into<PathBuf>) -> Self

Creates a new Tool with the given name and executable.

Arguments

• name - Tool identifier
• executable - Path to the executable (can be relative or absolute)

Example

use forge_agent::workflow::tools::Tool;
use std::path::PathBuf;

let tool = Tool::new("magellan", PathBuf::from("/usr/bin/magellan"));

pub fn default_args(self, args: Vec<String>) -> Self

Sets the default arguments for the tool.

Arguments

• args - Vector of default argument strings

Returns

Self for builder pattern chaining

Example

use forge_agent::workflow::tools::Tool;

let tool = Tool::new("magellan", "/usr/bin/magellan")
    .default_args(vec!["--db".to_string(), ".forge/graph.db".to_string()]);

pub fn description(self, description: impl Into<String>) -> Self

Sets the description for the tool.

Arguments

• description - Human-readable description

Returns

Self for builder pattern chaining

Trait Implementations

impl Clone for Tool

fn clone(&self) -> Tool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tool

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Tool

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Tool

fn eq(&self, other: &Tool) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Tool

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Tool