Struct OpenRouterRoutingConfig 

pub struct OpenRouterRoutingConfig {
    pub models: Vec<String>,
    pub route: Option<OpenRouterRoute>,
    pub provider: Option<OpenRouterProviderRouting>,
    pub plugins: Option<OpenRouterPluginConfig>,
    pub capacity_strategy: Option<OpenRouterCapacityStrategy>,
    pub presets: Vec<OpenRouterRoutingPreset>,
    pub server_tools: Vec<OpenRouterServerTool>,
}

These fields mirror OpenRouter’s request-level routing extensions. Drivers must only forward this config to OpenRouter-compatible endpoints.

Fields

models: Vec<String>

Candidate models to try in OpenRouter’s fallback order.

route: Option<OpenRouterRoute>

OpenRouter route strategy. Currently fallback is the stable route value used with models.

provider: Option<OpenRouterProviderRouting>

Provider ordering, policy, and sorting preferences.

plugins: Option<OpenRouterPluginConfig>

Optional plugin activations (web search, file reader).

capacity_strategy: Option<OpenRouterCapacityStrategy>

Org-level capacity strategy. Compiled into provider routing before dispatch; not forwarded verbatim. None and SharedCapacity are equivalent (no routing changes).

presets: Vec<OpenRouterRoutingPreset>

High-level routing quality/policy presets. Compiled into provider flags by apply_presets() before the request is serialized. Explicit provider fields override preset-derived values.

server_tools: Vec<OpenRouterServerTool>

OpenRouter server tools (beta) the model may invoke. Provider-executed; appended to the request tools array as {"type":"openrouter:<name>"}.

Implementations

impl OpenRouterRoutingConfig

pub fn is_empty(&self) -> bool

pub fn fallback_models( models: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Build an ordered model-fallback routing config.

pub fn validate_for_primary_model( &self, primary_model: &str, ) -> Result<(), String>

pub fn apply_capacity_strategy(&self) -> Result<Self, String>

Apply the capacity strategy, returning a derived config with provider routing adjusted accordingly.

• SharedCapacity / None — returns self unchanged.
• ByokFirst — sets provider.allow_fallbacks = true when not already set.
• ByokOnly — requires provider.only to list at least one provider slug; sets provider.allow_fallbacks = false.

Returns Err when the strategy constraints cannot be satisfied.

pub fn apply_presets(&self) -> Result<Self, String>

Compile presets into OpenRouterProviderRouting flags and merge with any explicit provider overrides. Returns a derived config with the presets list cleared and provider reflecting the merged result.

Explicit provider fields always win over preset-derived values. When multiple presets target the same provider field, later presets in the list override earlier ones.

Returns Err if any preset values are invalid (e.g. negative MaxPrice values).

Trait Implementations

impl Clone for OpenRouterRoutingConfig

fn clone(&self) -> OpenRouterRoutingConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpenRouterRoutingConfig

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

Formats the value using the given formatter.

impl Default for OpenRouterRoutingConfig

fn default() -> OpenRouterRoutingConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OpenRouterRoutingConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for OpenRouterRoutingConfig

fn eq(&self, other: &OpenRouterRoutingConfig) -> 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 Serialize for OpenRouterRoutingConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OpenRouterRoutingConfig