Struct ToolContext 

pub struct ToolContext {

    pub project_root: String,
    pub minimal: bool,
    pub resolved_paths: HashMap<String, String>,
    pub crp_mode: CrpMode,
    pub cache: Option<SharedCache>,
    pub session: Option<Arc<RwLock<SessionState>>>,
    pub tool_calls: Option<Arc<RwLock<Vec<ToolCallRecord>>>>,
    pub agent_id: Option<Arc<RwLock<Option<String>>>>,
    pub workflow: Option<Arc<RwLock<Option<WorkflowRun>>>>,
    pub ledger: Option<Arc<RwLock<ContextLedger>>>,
    pub client_name: Option<Arc<RwLock<String>>>,
    pub pipeline_stats: Option<Arc<RwLock<PipelineStats>>>,
    pub call_count: Option<Arc<AtomicUsize>>,
    pub autonomy: Option<Arc<AutonomyState>>,
}

Context passed to tool handlers. Contains pre-resolved values that many tools need, avoiding repeated async lock acquisition inside handlers. Extended with shared server state for tools that need cache/session access.

Fields

project_root: String

minimal: bool

resolved_paths: HashMap<String, String>

Pre-resolved paths keyed by argument name (e.g. “path” -> “/abs/dir”).

crp_mode: CrpMode

CRP mode for compression-aware tools.

cache: Option<SharedCache>

Shared cache handle for tools that need read/write access.

session: Option<Arc<RwLock<SessionState>>>

Shared session handle for tools that need session access.

tool_calls: Option<Arc<RwLock<Vec<ToolCallRecord>>>>

Tool call records for session-aware tools (e.g. ctx_session status).

agent_id: Option<Arc<RwLock<Option<String>>>>

Current agent identity for multi-agent tools.

workflow: Option<Arc<RwLock<Option<WorkflowRun>>>>

Active workflow run state.

ledger: Option<Arc<RwLock<ContextLedger>>>

Context ledger for handoff operations.

client_name: Option<Arc<RwLock<String>>>

Client name (cursor, claude, etc.).

pipeline_stats: Option<Arc<RwLock<PipelineStats>>>

Pipeline stats for metrics/proof tools.

call_count: Option<Arc<AtomicUsize>>

Global call counter for context tools.

autonomy: Option<Arc<AutonomyState>>

Autonomy state for search repeat detection.

Implementations

impl ToolContext

pub fn resolved_path(&self, arg: &str) -> Option<&str>

pub fn resolve_path_sync(&self, path: &str) -> Result<String, String>

Sync path resolution using project_root. Simplified version of LeanCtxServer::resolve_path for use in sync tool handlers.