Struct DispatchProvenance 

pub struct DispatchProvenance {
    pub provider: Option<String>,
    pub model: Option<String>,
    pub wire_format: Option<String>,
    pub thinking: Option<String>,
    pub tool_format: Option<String>,
}

Where a single resolved dispatch field came from. Carried on [LlmCallOptions::dispatch_provenance], populated by the pipeline resolver (Burin’s smart-escalation / model-selection layers, threaded through the agent-loop options). Unknown is the default when no resolver annotated the call — e.g. a raw llm_call(...) from script context.

The string values are a small, stable vocabulary so downstream tooling (the harness-debugger dispatch_trace MCP tool) can filter on them:

• operator_pin: an explicit operator/env pin, such as BURIN_EVAL_SMART_PROVIDER.
• pipeline_input: a selected_* field on the pipeline input.
• escalation_override: chosen by the smart-escalation resolver.
• catalog_default: filled from the provider catalog / capability registry.
• inherited_from_primary: no pin/override existed, so the value fell through from the cheap primary model. THIS is the value that flags a silent-inheritance bug.

Fields

provider: Option<String>

model: Option<String>

wire_format: Option<String>

thinking: Option<String>

tool_format: Option<String>

Implementations

impl DispatchProvenance

pub const INHERITED_FROM_PRIMARY: &'static str = "inherited_from_primary"

Canonical provenance origin for a value that fell through from the primary model with no pin or override. Named as a constant so the resolver and the tests reference the same smoking-gun literal.

pub const OPERATOR_PIN: &'static str = "operator_pin"

pub const ESCALATION_OVERRIDE: &'static str = "escalation_override"

pub const PIPELINE_INPUT: &'static str = "pipeline_input"

pub const CATALOG_DEFAULT: &'static str = "catalog_default"

pub fn from_vm_value(value: &VmValue) -> Option<Self>

Parse a dispatch_provenance option dict supplied by the pipeline resolver into the typed provenance. Each entry is a per-field origin string (operator_pin, escalation_override, inherited_from_primary, …); absent entries stay None and surface as "unknown" in the record. Returns None when the value is absent or not a dict, so a non-annotating caller pays nothing.

Trait Implementations

impl Clone for DispatchProvenance

fn clone(&self) -> DispatchProvenance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DispatchProvenance

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

Formats the value using the given formatter.

impl Default for DispatchProvenance

fn default() -> DispatchProvenance

Returns the “default value” for a type.

impl Eq for DispatchProvenance

impl PartialEq for DispatchProvenance

fn eq(&self, other: &DispatchProvenance) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DispatchProvenance