Struct ShellTool 

pub struct ShellTool { /* private fields */ }

Shell command execution tool (with safety checks)

Optional sandbox executor integration: when sandbox is set, all commands execute through the sandbox, providing additional isolation and resource limits.

Implementations

impl ShellTool

pub fn new() -> ShellTool

Create a new Shell tool (default strict mode)

pub fn new_permissive() -> ShellTool

Create a non-strict mode Shell tool (not recommended!)

pub fn with_sandbox(self, sandbox: Arc<dyn SandboxExecutor>) -> ShellTool

Set the sandbox executor; commands will be executed through the sandbox

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

Check whether a command is safe

Trait Implementations

impl Default for ShellTool

fn default() -> ShellTool

Returns the “default value” for a type.

impl Tool for ShellTool

fn name(&self) -> &str

Stable tool identifier exposed to the model.

fn description(&self) -> &str

Human-readable tool description.

fn parameters(&self) -> Value

JSON Schema describing accepted parameters.

fn execute( &self, parameters: HashMap<String, Value>, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, ReactError>> + Send + '_>>

Execute the tool with untyped JSON parameters.

fn validate_parameters( &self, _params: &HashMap<String, Value>, ) -> Pin<Box<dyn Future<Output = Result<(), ReactError>> + Send + '_>>

Validate parameters before execution.

fn permissions(&self) -> Vec<ToolPermission>

Permissions required to invoke this tool.

fn risk_level(&self) -> ToolRiskLevel

Risk level of this tool. Dangerous tools require explicit approval.