Struct CommandTool 

pub struct CommandTool { /* private fields */ }

A Tool implementation backed by a subprocess command.

Arguments are serialized to JSON and piped to the command’s stdin. The command must write a JSON value to stdout before exiting.

Implementations

impl CommandTool

pub fn from_spec(spec: ToolSpec, plugin_root: &Path) -> Self

Build a CommandTool from a parsed ToolSpec.

plugin_root is prepended to relative command paths and substituted for ${PLUGIN_ROOT} in args and env values.

pub fn new( definition: ToolDefinition, command: String, args: Vec<String>, env: HashMap<String, String>, timeout: Duration, is_concurrency_safe: bool, default_permission: PermissionDecision, ) -> Self

Create a CommandTool directly (for programmatic construction).

Trait Implementations

impl Tool for CommandTool

fn definition(&self) -> ToolDefinition

Describe the tool’s name, prose description, and JSON-schema input.

fn is_concurrency_safe(&self, _arguments: &Value) -> bool

Whether the tool is safe to run concurrently with other invocations.

fn interrupt_behavior(&self) -> InterruptBehavior

How the tool wants to be interrupted.

fn check_permission<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _arguments: &'life1 Value, _context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<PermissionDecision, AgentError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Decide whether the call is allowed, denied, or needs human approval.

fn invoke<'life0, 'async_trait>( &'life0 self, arguments: Value, context: ToolContext, ) -> Pin<Box<dyn Future<Output = Result<ToolOutput, AgentError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute the tool. Errors are surfaced as is_error: true tool results rather than aborting the turn, so the model can try to recover.

fn prompt_text(&self) -> Option<&'static str>

Optional detailed usage instructions injected into the system prompt. Return None if the tool has no extra behavioral guidance.

fn validate<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _arguments: &'life1 Value, _context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<(), AgentError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Validate raw arguments before the permission check runs.

fn invocation_detail(&self, arguments: &Value) -> String

Return a human-readable summary of the invocation from its arguments.