Struct ToolContext 

pub struct ToolContext {
    config: Arc<Config>,
    router: Arc<WorkspaceRouter>,
    mode: ServerMode,
}

Context bridge for tool execution.

Provides tools with access to the Context Harness knowledge base during execution. Created by the server for each tool invocation.

All methods delegate to the same core functions used by the CLI and HTTP server, ensuring tools have identical capabilities.

Fields

config: Arc<Config>

The active workspace config used by the convenience methods below and by compatibility-mode built-in tools. In multi mode this is the default workspace’s config; router-aware tools resolve per call instead.

router: Arc<WorkspaceRouter>

The workspace router. In compatibility mode this is a one-workspace router; router-aware (multi-mode) tools dispatch through it.

mode: ServerMode

Whether this context serves the pre-router flat shapes or labeled shapes.

Implementations

impl ToolContext

pub fn new(config: Arc<Config>) -> Self

Create a single-workspace (compatibility) tool context from a config.

Internally wraps the config in a one-workspace WorkspaceRouter, so a compatibility context is just “a router with one workspace”.

pub fn routed(router: Arc<WorkspaceRouter>, mode: ServerMode) -> Self

Create a tool context backed by a (possibly multi-workspace) router.

The convenience methods default to the router’s default workspace; the router-aware built-in tools resolve the request’s workspace selector against ToolContext::router per call.

pub fn mode(&self) -> ServerMode

The server mode this context serves.

pub fn router(&self) -> &Arc<WorkspaceRouter>

The workspace router, for router-aware tools.

pub fn config(&self) -> &Arc<Config>

The active workspace config (the default workspace in multi mode).

pub async fn search( &self, query: &str, opts: SearchOptions, ) -> Result<Vec<SearchResultItem>>

Search the knowledge base.

Equivalent to POST /tools/search or ctx search.

Example

let results = ctx.search("deployment runbook", SearchOptions {
    mode: Some("hybrid".to_string()),
    limit: Some(5),
    ..Default::default()
}).await?;

pub async fn get(&self, id: &str) -> Result<DocumentResponse>

Retrieve a document by UUID.

Equivalent to POST /tools/get or ctx get.

pub fn sources(&self) -> Result<Vec<SourceStatus>>

List all configured connectors and their status.

Equivalent to GET /tools/sources or ctx sources.