Struct BashTool 

pub struct BashTool {
    pub cwd: Option<String>,
    pub timeout: Duration,
    pub max_output_bytes: usize,
    pub deny_patterns: Vec<String>,
    pub confirm_fn: Option<ConfirmFn>,
}

Execute shell commands. Captures stdout + stderr.

Fields

cwd: Option<String>

Working directory for commands (None = inherit from current process)

timeout: Duration

Max execution time per command (default: 120s)

max_output_bytes: usize

Max output bytes to capture (prevents OOM on huge outputs, default: 256KB)

deny_patterns: Vec<String>

Commands/patterns that are always blocked (e.g., “rm -rf /”)

confirm_fn: Option<ConfirmFn>

Optional callback for confirming dangerous commands (None = auto-allow)

Implementations

impl BashTool

pub fn new() -> Self

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

pub fn with_timeout(self, timeout: Duration) -> Self

pub fn with_deny_patterns(self, patterns: Vec<String>) -> Self

pub fn with_confirm( self, f: impl Fn(&str) -> bool + Send + Sync + 'static, ) -> Self

Trait Implementations

impl AgentTool for BashTool

fn name(&self) -> &str

Unique tool name (used in LLM tool_use)

fn label(&self) -> &str

Human-readable label for UI

fn description(&self) -> &str

Description for the LLM

fn parameters_schema(&self) -> Value

JSON Schema for parameters

fn execute<'life0, 'async_trait>( &'life0 self, params: Value, ctx: ToolContext, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, ToolError>> + Send + 'async_trait>>

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

Execute the tool.

fn timeout(&self) -> Option<Duration>

Optional per-tool execution timeout.

impl Default for BashTool

fn default() -> Self

Returns the “default value” for a type.