Struct ToolContext 

pub struct ToolContext {
    pub workspace_dir: PathBuf,
    pub root_dir: Option<PathBuf>,
    pub session_id: Option<String>,
    pub snapshot_store: Option<Arc<dyn SnapshotStore>>,
    pub memory: Option<Arc<dyn MemoryBackend>>,
    pub url_resolver: Option<Arc<dyn UrlResolver>>,
    pub todo: Option<Arc<dyn TodoStateProvider>>,
    pub agent_pool: Option<Arc<dyn AgentPoolProvider>>,
    pub lsp: Option<Arc<dyn LspProvider>>,
}

Context passed to tools at execution time.

This allows tools to operate on a specific workspace without being rebuilt. When root_dir is Some, tools use it as their base directory. When None, tools should fall back to workspace_dir.

Fields

workspace_dir: PathBuf

Primary workspace directory (used when root_dir is None).

root_dir: Option<PathBuf>

Optional explicit root directory for file tools. Takes priority over workspace_dir if present.

session_id: Option<String>

Session identifier for logging/tracing.

snapshot_store: Option<Arc<dyn SnapshotStore>>

Snapshot store for hashline tag emission/validation. When None, hashline edit mode is unavailable.

memory: Option<Arc<dyn MemoryBackend>>

Memory backend for memory_* tools. When None, memory tools return an error.

url_resolver: Option<Arc<dyn UrlResolver>>

URL resolver for internal protocol schemes (issue://, pr://, etc.). When None, URL-prefixed paths are treated as regular file paths.

todo: Option<Arc<dyn TodoStateProvider>>

Todo state for the todo agent tool. When None, the todo tool returns an error.

agent_pool: Option<Arc<dyn AgentPoolProvider>>

Agent pool for Hub display and todo sub-agent matching.

lsp: Option<Arc<dyn LspProvider>>

LSP provider for the lsp tool.

Implementations

impl ToolContext

pub fn new(workspace_dir: impl Into<PathBuf>) -> Self

Create a new context with the given workspace.

pub fn root(&self) -> &Path

Get the effective root directory. Returns root_dir if set, otherwise workspace_dir.

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

Set a session ID.

pub fn with_root(self, root_dir: impl Into<PathBuf>) -> Self

Set an explicit root directory.

pub fn with_snapshot_store(self, store: Arc<dyn SnapshotStore>) -> Self

Set the snapshot store (enables hashline edit mode).

pub fn with_memory(self, memory: Arc<dyn MemoryBackend>) -> Self

Set the memory backend (enables memory tools).

pub fn with_url_resolver(self, resolver: Arc<dyn UrlResolver>) -> Self

Set the URL resolver (enables internal URL dispatch).

pub fn with_todo(self, todo: Arc<dyn TodoStateProvider>) -> Self

Set the todo state (enables the todo agent tool).

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.

impl Default for ToolContext

fn default() -> Self

Returns the “default value” for a type.