Struct BashTool 

pub struct BashTool { /* private fields */ }

Bash Tool for executing shell commands

Provides secure shell command execution with:

• Dangerous command blacklist
• Warning pattern detection
• Cross-platform support
• Timeout control
• Output truncation

Requirements: 3.1

Implementations

impl BashTool

pub fn new() -> Self

Create a new BashTool with default settings

pub fn with_task_manager(task_manager: Arc<TaskManager>) -> Self

Create a BashTool with custom task manager

pub fn with_sandbox(self, config: SandboxConfig) -> Self

Set sandbox configuration

pub fn with_dangerous_commands(self, commands: Vec<String>) -> Self

Set custom dangerous commands

pub fn add_dangerous_commands(&mut self, commands: Vec<String>)

Add additional dangerous commands

pub fn with_warning_patterns(self, patterns: Vec<Regex>) -> Self

Set custom warning patterns

pub fn task_manager(&self) -> &Arc<TaskManager>

Get the task manager

impl BashTool

pub fn check_command_safety(&self, command: &str) -> SafetyCheckResult

Check if a command is safe to execute

This method checks the command against:

1. Dangerous command blacklist (blocks execution)
2. Warning patterns (allows with warning)

Requirements: 3.2, 3.3

pub fn is_dangerous_command(&self, command: &str) -> bool

Check if a command is in the dangerous commands list

pub fn has_warning(&self, command: &str) -> bool

Check if a command triggers any warning patterns

impl BashTool

pub async fn execute_foreground( &self, command: &str, timeout: Duration, context: &ToolContext, ) -> Result<ToolResult, ToolError>

Execute a command in the foreground with timeout

Supports cross-platform execution:

• Windows: Uses PowerShell or CMD
• macOS/Linux: Uses sh -c

Requirements: 3.1, 3.5

impl BashTool

pub async fn execute_background( &self, command: &str, context: &ToolContext, ) -> Result<ToolResult, ToolError>

Execute a command in the background

Returns a task_id that can be used to query status and output. The actual task management is delegated to TaskManager.

Requirements: 3.4

impl BashTool

pub fn truncate_output(&self, output: &str) -> String

Truncate output if it exceeds MAX_OUTPUT_LENGTH

Adds a truncation indicator when output is truncated.

Requirements: 3.9

pub fn would_truncate(&self, output: &str) -> bool

Check if output would be truncated

Trait Implementations

impl Debug for BashTool

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

Formats the value using the given formatter.

impl Default for BashTool

fn default() -> Self

Returns the “default value” for a type.

impl Tool for BashTool

fn name(&self) -> &str

Returns the tool name

fn description(&self) -> &str

Returns the tool description

fn input_schema(&self) -> Value

Returns the JSON Schema for input parameters

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

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

Execute the bash command

Requirements: 3.6, 3.7

fn check_permissions<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, params: &'life1 Value, _context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = PermissionCheckResult> + Send + 'async_trait>>

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

Check permissions before execution

Performs safety check and returns appropriate permission result.

Requirements: 3.8

fn options(&self) -> ToolOptions

Get tool options

fn dynamic_description(&self) -> Option<String>

Returns a dynamically generated description of the tool

fn get_definition(&self) -> ToolDefinition

Get the tool definition for LLM consumption