Struct ModelRouter 

pub struct ModelRouter { /* private fields */ }

Ordered, provider-neutral fallback routing behind the canonical Model boundary.

A router owns process-local retry and circuit-breaker state. Applications should build it once and reuse this value or its clones for the lifetime of the service. Clones share route health; rebuilding a router intentionally starts with fresh health state.

Implementations

impl ModelRouter

pub fn builder(logical: ModelRef) -> ModelRouterBuilder

Starts a router builder for one logical model identity.

pub const fn logical_model(&self) -> &ModelRef

Returns the identity applications use in ModelRequest.

pub fn routes(&self) -> &[ModelRoute]

Returns physical routes in deterministic selection order.

pub fn route_health(&self) -> Vec<ModelRouteHealth>

Returns a point-in-time health snapshot for every physical route.

Trait Implementations

impl Clone for ModelRouter

fn clone(&self) -> ModelRouter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelRouter

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

Formats the value using the given formatter.

impl Model for ModelRouter

fn capabilities<'a>( &'a self, model: &'a ModelRef, ) -> ModelFuture<'a, Result<ModelCapabilities, ModelError>>

Resolves capabilities for a provider-qualified model.

fn stream( &self, request: ModelRequest, context: ModelCallContext, ) -> ModelFuture<'_, Result<ModelEventStream, ModelError>>

Opens a canonical event stream for a request.

fn invoke( &self, request: ModelRequest, context: ModelCallContext, ) -> ModelFuture<'_, Result<ModelResponse, ModelError>>

Invokes the model and reconstructs its terminal response.