Enum Provider 

pub enum Provider {
    Anthropic,
    OpenAI,
    OpenAIApi,
    OllamaCloud,
    Groq,
    Mistral,
    Together,
    OpenRouter,
    DeepSeek,
    Fireworks,
    Gemini,
    Local,
}

Variants

Anthropic

Anthropic claude.ai — OAuth, Anthropic wire format.

OpenAI

OpenAI chatgpt.com — OAuth, OpenAI-compat wire format.

OpenAIApi

OpenAI API (api.openai.com) — API key, OpenAI-compat wire format.

OllamaCloud

Ollama Cloud (api.ollama.com) — API key, OpenAI-compat wire format.

Groq

Groq (api.groq.com) — API key, OpenAI-compat wire format.

Mistral

Mistral AI (api.mistral.ai) — API key, OpenAI-compat wire format.

Together

Together AI (api.together.xyz) — API key, OpenAI-compat wire format.

OpenRouter

OpenRouter (openrouter.ai) — API key, OpenAI-compat wire format.

DeepSeek

DeepSeek (api.deepseek.com) — API key, OpenAI-compat wire format.

Fireworks

Fireworks AI (api.fireworks.ai) — API key, OpenAI-compat wire format.

Gemini

Google Gemini (generativelanguage.googleapis.com) — API key, OpenAI-compat wire format.

Local

Generic local OpenAI-compatible server (Ollama local, LM Studio, llama.cpp).

Implementations

impl Provider

pub fn from_str(s: &str) -> Self

pub fn auth_kind(&self) -> AuthKind

How this provider authenticates.

pub fn wire_protocol(&self) -> WireProtocol

Wire protocol used for requests/responses.

pub fn default_model(&self) -> &'static str

Default model name to use when the incoming request specifies a claude-* model that doesn’t exist on this provider.

Returns "" for Local — the model name is passed through unchanged so the local server decides what to serve.

pub fn accepts_claude_models(&self) -> bool

True when this provider understands claude-* model names natively. When false, incoming claude-* model names are remapped before forwarding.

pub fn api_key_env_var(&self) -> Option<&'static str>

Well-known environment variable that holds an API key for this provider. None for OAuth and Local providers.

pub fn default_upstream_url(&self) -> &'static str

Default upstream API base URL.

pub fn default_port(&self) -> u16

Default local proxy port (used when multiple providers are active).

pub fn inject_auth_headers( &self, headers: &mut HeaderMap, token: &str, ) -> Result<()>

Inject provider-specific auth and protocol headers into an upstream request.

Called by the forwarder before each proxied request. The live token has already been retrieved by the caller.

pub fn prefetch_extra_headers(&self) -> &'static [(&'static str, &'static str)]

Additional non-auth headers required for prefetch requests (not normal proxy requests).

Returns (header-name, header-value) pairs as static strings.

pub fn prefetch_request(&self) -> Option<(&'static str, Value)>

Path and minimal JSON body for a prefetch request that returns rate-limit headers.

Returns None if this provider doesn’t support prefetching.

pub fn auth_probe_get_path(&self) -> Option<&'static str>

GET path for a lightweight auth-validity check (no rate-limit data expected). Used for providers where prefetch_request is unavailable.

pub fn parse_rate_limits(&self, headers: &HeaderMap) -> Option<RateLimitInfo>

Extract rate-limit utilization from an upstream response’s headers.

Returns None when the response carries no recognisable rate-limit data.

pub fn read_local_credentials(&self) -> Option<Credential>

Read credentials from the provider’s local CLI tool or well-known environment variable.

• OAuth providers: import from the provider’s local CLI auth store.
• API-key providers: read from the well-known environment variable.
• Local provider: always returns None (no auth needed).

pub async fn refresh_token( &self, cred: &OAuthCredential, ) -> Result<OAuthCredential>

Refresh an expired access token using the provider’s token endpoint.

Only applicable to OAuth providers. Returns an error for API-key and Local providers.

Trait Implementations

impl Clone for Provider

fn clone(&self) -> Provider

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Provider

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

Formats the value using the given formatter.

impl Default for Provider

fn default() -> Provider

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Provider

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Provider

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

Formats the value using the given formatter.

impl PartialEq for Provider

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Provider

impl StructuralPartialEq for Provider