Struct ToolContext 

pub struct ToolContext {
    pub workspace: PathBuf,
    pub session_id: Option<String>,
    pub event_tx: Option<ToolEventSender>,
    pub agent_event_tx: Option<Sender<AgentEvent>>,
    pub search_config: Option<SearchConfig>,
    pub sandbox: Option<Arc<dyn BashSandbox>>,
}

Tool execution context

Provides tools with access to workspace and other runtime information.

Fields

workspace: PathBuf

Workspace root directory (sandbox boundary)

session_id: Option<String>

Optional session ID for session-aware tools

event_tx: Option<ToolEventSender>

Optional sender for streaming tool output deltas during execution

agent_event_tx: Option<Sender<AgentEvent>>

Optional agent event sender for tools that emit high-level agent events (e.g., SubagentStart)

search_config: Option<SearchConfig>

Optional search configuration for web_search tool

sandbox: Option<Arc<dyn BashSandbox>>

Optional sandbox for routing bash tool execution through A3S Box.

Implementations

impl ToolContext

pub fn new(workspace: PathBuf) -> Self

pub fn with_session_id(self, session_id: impl Into<String>) -> Self

Set the session ID for this context

pub fn with_event_tx(self, tx: ToolEventSender) -> Self

Set the event sender for streaming tool output

pub fn with_agent_event_tx(self, tx: Sender<AgentEvent>) -> Self

Set the agent event sender for high-level agent events (e.g., SubagentStart/End)

pub fn with_search_config(self, config: SearchConfig) -> Self

Set the search configuration

pub fn with_sandbox(self, sandbox: Arc<dyn BashSandbox>) -> Self

Set a sandbox executor for the bash tool.

When set, bash commands are routed through the sandbox instead of std::process::Command.

pub fn resolve_path(&self, path: &str) -> Result<PathBuf>

Resolve path relative to workspace, ensuring it stays within sandbox

pub fn resolve_path_for_write(&self, path: &str) -> Result<PathBuf>

Resolve path for writing (allows non-existent files)

Trait Implementations

impl Clone for ToolContext

fn clone(&self) -> ToolContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolContext

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

Formats the value using the given formatter.