Struct FallbackProvider 

pub struct FallbackProvider { /* private fields */ }

Provider that tries multiple inner providers in order, returning the first success.

Construction

Use FallbackProvider::new() with a non-empty Vec of providers. An empty vec is rejected with a config error.

Use FallbackProvider::with_retry() to enable per-provider retry with exponential backoff on transient errors.

Implementations

impl FallbackProvider

pub fn new(providers: Vec<Box<dyn LlmProvider>>) -> Result<Self, RunnerError>

Create a fallback chain from a non-empty list of providers.

No retries are attempted (equivalent to max_retries = 0).

Errors

Returns RunnerError with ErrorKind::Config if providers is empty.

pub fn with_retry( providers: Vec<Box<dyn LlmProvider>>, retry_config: RetryConfig, ) -> Result<Self, RunnerError>

Create a fallback chain with per-provider retry configuration.

When a provider returns a transient error, the request is retried up to retry_config.max_retries times with exponential backoff before moving to the next provider. Permanent errors skip retries immediately.

Errors

Returns RunnerError with ErrorKind::Config if providers is empty.

Trait Implementations

impl LlmProvider for FallbackProvider

fn name(&self) -> &'static str

Unique provider identifier (e.g., claude_code, copilot)

fn display_name(&self) -> &str

Human-readable display name for the provider

fn capabilities(&self) -> LlmCapabilities

Provider capabilities (streaming, function calling, etc.)

fn default_model(&self) -> &str

Default model to use if not specified in request

fn available_models(&self) -> &[String]

Available models for this provider

fn complete<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 ChatRequest, ) -> Pin<Box<dyn Future<Output = Result<ChatResponse, RunnerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Perform a chat completion (non-streaming)

fn complete_stream<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 ChatRequest, ) -> Pin<Box<dyn Future<Output = Result<ChatStream, RunnerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Perform a streaming chat completion

fn health_check<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<bool, RunnerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Check if the provider is healthy and ready to serve requests