Struct WorkspaceRouter 

pub struct WorkspaceRouter {
    default_workspace: Option<String>,
    workspaces: HashMap<String, Arc<WorkspaceRuntime>>,
    order: Vec<String>,
    mode: ServerMode,
    search_deadline: Duration,
}

Routes built-in operations to the selected WorkspaceRuntime.

Fields

default_workspace: Option<String>

workspaces: HashMap<String, Arc<WorkspaceRuntime>>

order: Vec<String>

Stable iteration order for discovery/listing.

mode: ServerMode

search_deadline: Duration

Per-workspace deadline for all fan-out (R33). Defaults to DEFAULT_SEARCH_DEADLINE_MS; overridden by with_search_deadline.

Implementations

impl WorkspaceRouter

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

Build the one-workspace router that backs compatibility mode.

pub fn multi( runtimes: Vec<WorkspaceRuntime>, default_workspace: Option<String>, ) -> Self

Build a multi-workspace router from pre-resolved runtimes.

runtimes is consumed in the order it should be listed by discovery. default_workspace is the [defaults].workspace id, if any.

pub fn mode(&self) -> ServerMode

The server mode this router represents.

pub fn default_id(&self) -> Option<&str>

The configured default workspace id, if set.

pub fn is_registered(&self, id: &str) -> bool

Whether id is a registered workspace (used for qualified-id parsing, R40).

pub fn list(&self) -> Vec<Arc<WorkspaceRuntime>>

All runtimes in stable listing order (for the workspaces tool).

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

A config to back convenience-method access in a [ToolContext]. Returns the default workspace’s config, else the first enabled, else the first. In multi mode built-in tools resolve per-call and do not rely on this.

fn enabled_ids(&self) -> Vec<String>

Ids of all enabled workspaces (used in workspace_required messages).

pub fn resolve( &self, selector: Option<&str>, ) -> Result<Arc<WorkspaceRuntime>, RouterError>

Resolve a selector to a single runtime (SPEC-0014 R19–R26).

Precedence: explicit id → [defaults].workspace → single enabled → otherwise workspace_required. The all selector is rejected here in Phase 1 (unsupported_workspace_selector); fan-out is Phase 2.

fn resolve_id(&self, id: &str) -> Result<Arc<WorkspaceRuntime>, RouterError>

Resolve a concrete workspace id, applying enabled/health checks.

pub fn search_deadline(&self) -> Duration

The configured per-workspace all-search deadline (R33).

pub fn with_search_deadline(self, ms: Option<u64>) -> Self

Override the per-workspace all-search deadline. None leaves the current value (the default) unchanged. Builder-style so existing multi(...) call sites need no change.

pub fn resolve_all( &self, ) -> (Vec<Arc<WorkspaceRuntime>>, Vec<(String, RouterError)>)

Resolve the all selector (SPEC-0014 R21) into the enabled workspaces, partitioned into healthy runtimes (to search) and enabled-but-unavailable workspaces as pre-built error entries (R26/R37). Disabled workspaces are excluded entirely — they are not part of all and are not errors (R7). Output follows the stable registry order.

pub fn split_qualified_id<'a>(&self, id: &'a str) -> (Option<&'a str>, &'a str)

Split a get id into (workspace, raw_id) using qualified-id rules (R40).

An id is qualified only when it contains : and the prefix matches a registered workspace id; otherwise the whole value is a raw id. Returns the workspace prefix (if qualified) and the bare document id.