Struct ToolContext 

pub struct ToolContext<'a> { /* private fields */ }

Execution context provided to RustTool::execute.

Created by the dispatcher before calling a tool. Provides:

• Sandbox: path validation for file I/O
• ChildContext (optional): runtime interaction (command permissions, output emission, etc.)

Lifetime

Borrows from the dispatcher’s lock scope. Tools must not store references beyond execute().

Implementations

impl<'a> ToolContext<'a>

pub fn new(sandbox: &'a dyn SandboxPolicy) -> Self

Create a context with only sandbox (for tests or standalone use).

pub fn with_child_ctx(self, ctx: &'a dyn ChildContext) -> Self

Attach a child context (builder pattern).

pub fn sandbox(&self) -> &dyn SandboxPolicy

Sandbox policy for file path validation.

pub fn child_ctx(&self) -> Option<&dyn ChildContext>

Optional child context for runtime interaction.

Available when running inside a Component’s execution context. None in standalone or test scenarios.

Trait Implementations

impl Debug for ToolContext<'_>

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

Formats the value using the given formatter.