Struct BrushShellTool 

pub struct BrushShellTool { /* private fields */ }

The carried brush engine (agent-bridle#20 / Track 2): a bash-in-Rust shell run in a dedicated sandboxed worker. Its CommandInterceptor provides the worker-local L2 leash; when an effective native backend engages, the worker and descendants inherit that L3 boundary. Opt-in via the brush feature; a construction-time alternative to ShellTool behind the ADR 0005 D2 seam, using the temporary brush-ocap-* fork (reubeno/brush#1184). The carried brush engine — a Tool that runs a free-form command string through a worker-hosted bash-in-Rust shell with a worker-local CommandInterceptor leash and any L3 boundary engaged by the effective caveats. Registered under "shell" (the ADR 0005 D2 seam), a peer of ShellTool / HostShellTool.

Implementations

impl BrushShellTool

pub fn new() -> BrushShellTool

The engine with default output cap and the embedded schema.

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

Override the wall-clock ceiling (three-Cs: Configuration). A run that exceeds timeout has its worker process group terminated on Unix (the worker process on other targets) and is reported timed_out:true with exit 124.

pub fn with_sandbox_policy(self, policy: Arc<SandboxPolicy>) -> BrushShellTool

Select the OS-sandbox mechanism policy for the private worker.

pub fn with_output_observer( self, observer: Arc<dyn ShellOutputObserver>, ) -> BrushShellTool

Attach a presentation-only observer for bounded stdout/stderr chunks.

The observer receives only output captured by an admitted invocation and cannot change the interceptor, authority, or final result envelope. Delivery may finish asynchronously after the invocation returns; on_finish marks the queue-drained boundary.

pub fn with_schema(self, schema: Value) -> BrushShellTool

Override the tool’s input schema (three-Cs: Configuration).

Trait Implementations

impl Clone for BrushShellTool

fn clone(&self) -> BrushShellTool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BrushShellTool

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

Formats the value using the given formatter.

impl Default for BrushShellTool

fn default() -> BrushShellTool

Returns the “default value” for a type.

impl Tool for BrushShellTool

fn name(&self) -> &str

The dispatch name (the key in tools/list and in crate::Registry::dispatch).

fn schema(&self) -> Value

The MCP inputSchema (JSON Schema) for this tool’s arguments.

fn invoke<'life0, 'life1, 'async_trait>( &'life0 self, args: Value, cx: &'life1 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<Value, ToolError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, BrushShellTool: 'async_trait,

Run the tool. The cx proves the leash was passed; the tool enforces per-operation policy by calling cx.check_exec, cx.check_path_*, etc.

fn required(&self) -> Caveats

The authority ceiling this tool promises to stay under.