Struct Routing 

pub struct Routing {
    pub free_first: bool,
    pub policy: HashMap<String, String>,
    pub on_budget: String,
    pub auto_discover: bool,
    pub preferred_provider: Option<String>,
    pub preferred_model: Option<String>,
    pub routing_mode: String,
}

Fields

free_first: bool

policy: HashMap<String, String>

on_budget: String

auto_discover: bool

When true, automatically scan /v1/models on every provider as soon as an API key is stored, and cache the results for 24h. Defaults to true.

preferred_provider: Option<String>

Pin ALL routing tiers to a single provider. When set, this overrides every entry in policy (but still respects capability hard constraints like vision/tools). Set via sparrow route set <provider> or directly in config.yaml under routing.preferred_provider.

preferred_model: Option<String>

Pin ALL routing tiers to a single MODEL. When set with routing_mode=manual, Sparrow uses exactly this model (e.g. "deepseek-v4-pro") and never falls back. Set via sparrow route model <model>.

routing_mode: String

Routing mode: "auto" (tier-based policy + free_first) or "manual" (always use preferred_provider or the model the user picked, never auto-fallback). Set via sparrow route manual.

Trait Implementations

impl Clone for Routing

fn clone(&self) -> Routing

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Routing

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

Formats the value using the given formatter.

impl Default for Routing

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Routing

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Routing

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.