Struct RoutingDecision 

pub struct RoutingDecision {
    pub primary: RoutingTarget,
    pub fallback: Option<RoutingTarget>,
    pub reason: RoutingReason,
    pub resolved_name: String,
    pub decided_at: Instant,
}

Final routing plan for one invocation.

Fields

primary: RoutingTarget

Executor to try first.

fallback: Option<RoutingTarget>

Executor to retry on error. None when no fallback applies.

reason: RoutingReason

Why this decision was made — included in telemetry and debug logs.

resolved_name: String

The resolved unprefixed tool name after stripping any explicit prefix.

decided_at: Instant

Moment the decision was made. Useful downstream for timing analysis.

Implementations

impl RoutingDecision

pub fn to_meta_json(&self) -> Value

Produce a _meta.routing JSON blob suitable for attaching to an MCP response. Consumers pack this under _meta so downstream tooling (CLI debug output, logs) can inspect the decision without parsing free-form text.

pub fn emit_tracing(&self, requested_name: &str)

Structured tracing log describing this decision. Emitted once per invocation at info level so operators can grep for routing outcomes without enabling debug.

pub fn local(name: impl Into<String>, reason: RoutingReason) -> Self

pub fn remote( prefix: impl Into<String>, original_name: impl Into<String>, reason: RoutingReason, ) -> Self

pub fn reject(name: impl Into<String>, reason: RoutingReason) -> Self

pub fn with_fallback(self, fallback: RoutingTarget) -> Self

Trait Implementations

impl Clone for RoutingDecision

fn clone(&self) -> RoutingDecision

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RoutingDecision

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

Formats the value using the given formatter.