Struct ProviderDef 

pub struct ProviderDef {
    pub id: String,
    pub dialect: Dialect,
    pub base_url: String,
    pub api_key_env: Option<String>,
    pub auth: AuthScheme,
    pub region: Option<String>,
    pub project: Option<String>,
}

A model provider a ladder can route to. Declared as [[provider]] in TOML; referenced from a ladder as <id>/<model> (e.g. groq/llama-3.3-70b-versatile).

Fields

id: String

Ladder prefix for this provider, e.g. "groq". Overrides a built-in of the same id.

dialect: Dialect

Which wire API it speaks.

base_url: String

Base URL, e.g. "https://api.groq.com/openai" or "http://localhost:11434" for Ollama. Unused for aws_sigv4/gcp_oauth auth (those construct the URL from region/project).

api_key_env: Option<String>

Env var the API key is read from at call time, e.g. "GROQ_API_KEY". Omit for a keyless endpoint (local Ollama / vLLM). Per-request BYOK headers still apply to the built-in anthropic / openai providers.

auth: AuthScheme

How this provider’s requests are credentialed. api_key (default) is byte-identical to today; aws_sigv4 / gcp_oauth are the Bedrock/Vertex auth schemes (ADR 0006).

region: Option<String>

Cloud region, e.g. "us-east-1" — required for aws_sigv4 (Bedrock) and gcp_oauth (Vertex).

project: Option<String>

GCP project id — required for gcp_oauth (Vertex).

Trait Implementations

impl Clone for ProviderDef

fn clone(&self) -> ProviderDef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderDef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderDef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.