Struct ScriptedTool 

pub struct ScriptedTool { /* private fields */ }

A Tool that orchestrates multiple tools via bash scripts.

Each registered tool (defined by ToolDef + callback) becomes a bash builtin. The LLM sends a bash script that can pipe, loop, branch, and compose these builtins together with standard utilities like jq, grep, sed, etc.

Arguments are passed as --key value flags and parsed into typed JSON per the tool’s input_schema.

Reusable — execute() can be called multiple times. Each call gets a fresh Bash interpreter with the same set of tool builtins.

Create via ScriptedTool::builder.

Implementations

impl ScriptedTool

pub fn builder(name: impl Into<String>) -> ScriptedToolBuilder

Create a builder with the given tool name.

pub fn take_last_execution_trace(&self) -> Option<ScriptedExecutionTrace>

Return and clear the trace from the most recent execute call.

Trait Implementations

impl Clone for ScriptedTool

fn clone(&self) -> ScriptedTool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Tool for ScriptedTool

fn name(&self) -> &str

Tool identifier (e.g., “bashkit”, “calculator”)

fn display_name(&self) -> &str

Human-readable display name for UI.

fn short_description(&self) -> &str

One-line description for tool listings

fn description(&self) -> &str

Token-efficient description for LLMs.

fn help(&self) -> String

Full documentation for LLMs (markdown, with examples)

fn system_prompt(&self) -> String

Condensed description for system prompts (token-efficient)

fn locale(&self) -> &str

Locale used for user-facing text.

fn input_schema(&self) -> Value

JSON Schema for input validation

fn output_schema(&self) -> Value

JSON Schema for output structure

fn version(&self) -> &str

Library/tool version

fn execution(&self, args: Value) -> Result<ToolExecution, ToolError>

Create a single-use execution.

fn execute<'life0, 'async_trait>( &'life0 self, req: ToolRequest, ) -> Pin<Box<dyn Future<Output = ToolResponse> + Send + 'async_trait>>

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

Execute the tool

fn execute_with_status<'life0, 'async_trait>( &'life0 self, req: ToolRequest, status_callback: Box<dyn FnMut(ToolStatus) + Send>, ) -> Pin<Box<dyn Future<Output = ToolResponse> + Send + 'async_trait>>

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

Execute with status callbacks for progress tracking