Struct SandboxTool 

pub struct SandboxTool<S: CodeSandbox> { /* private fields */ }

A BaseTool that executes code in a sandboxed environment.

Disabled by default. Call SandboxTool::with_dangerously_allow to enable execution. See the module docs for the security model.

Implementations

impl<S: CodeSandbox> SandboxTool<S>

pub fn new(sandbox: S, language: Language) -> Self

Create a new sandbox tool with the given backend and default language.

Execution is disabled until with_dangerously_allow is called.

pub fn with_timeout(self, ms: u64) -> Self

Set the execution timeout in milliseconds.

pub fn with_dangerously_allow(self, allow: bool) -> Self

Explicitly enables code execution (disabled by default).

Trait Implementations

impl<S: CodeSandbox + 'static> BaseTool for SandboxTool<S>

fn name(&self) -> &str

Returns the tool name.

fn description(&self) -> &str

Returns the tool description.

fn run<'life0, 'async_trait>( &'life0 self, input: String, ) -> Pin<Box<dyn Future<Output = Result<String, ToolError>> + Send + 'async_trait>>

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

Execute the tool (string version).

fn args_schema(&self) -> Option<Value>

Returns the input JSON Schema.

fn return_direct(&self) -> bool

Whether to return result directly to user.

fn risk(&self) -> ToolRiskProfile

Declared Rule-of-Two risk profile (A2, v0.22.1).

fn handle_error<'life0, 'async_trait>( &'life0 self, error: ToolError, ) -> Pin<Box<dyn Future<Output = String> + Send + 'async_trait>>

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

Handle execution error.