Struct ProviderEntry 

pub struct ProviderEntry {

    pub provider_type: ProviderKind,
    pub name: Option<String>,
    pub model: Option<String>,
    pub base_url: Option<String>,
    pub max_tokens: Option<u32>,
    pub embedding_model: Option<String>,
    pub stt_model: Option<String>,
    pub embed: bool,
    pub default: bool,
    pub thinking: Option<ThinkingConfig>,
    pub server_compaction: bool,
    pub enable_extended_context: bool,
    pub reasoning_effort: Option<String>,
    pub thinking_level: Option<GeminiThinkingLevel>,
    pub thinking_budget: Option<i32>,
    pub include_thoughts: Option<bool>,
    pub api_key: Option<String>,
    pub candle: Option<CandleInlineConfig>,
    pub vision_model: Option<String>,
    pub instruction_file: Option<PathBuf>,
}

Unified provider entry: one struct replaces CloudLlmConfig, OpenAiConfig, GeminiConfig, OllamaConfig, CompatibleConfig, and OrchestratorProviderConfig.

Provider-specific fields use #[serde(default)] and are ignored by backends that do not use them (flat-union pattern).

Fields

provider_type: ProviderKind

Required: provider backend type.

name: Option<String>

Optional name for multi-provider configs. Auto-generated from type if absent.

model: Option<String>

Model identifier. Required for most types.

base_url: Option<String>

API base URL. Each type has its own default.

max_tokens: Option<u32>

Max output tokens.

embedding_model: Option<String>

Embedding model. When set, this provider supports embed() calls.

stt_model: Option<String>

STT model. When set, this provider supports speech-to-text via the Whisper API or Candle-local inference.

embed: bool

Mark this entry as the embedding provider (handles embed() calls).

default: bool

Mark this entry as the default chat provider (overrides position-based default).

thinking: Option<ThinkingConfig>

server_compaction: bool

enable_extended_context: bool

reasoning_effort: Option<String>

thinking_level: Option<GeminiThinkingLevel>

thinking_budget: Option<i32>

include_thoughts: Option<bool>

api_key: Option<String>

candle: Option<CandleInlineConfig>

vision_model: Option<String>

instruction_file: Option<PathBuf>

Provider-specific instruction file.

Implementations

impl ProviderEntry

pub fn effective_name(&self) -> String

Resolve the effective name: explicit name field or type string.

pub fn effective_model(&self) -> String

Resolve the effective model: explicit model field or the provider-type default.

Defaults mirror those used in build_provider_from_entry so that runtime.model_name always reflects the actual model being used rather than the provider type string.

pub fn validate(&self) -> Result<(), ConfigError>

Validate this entry for cross-field consistency.

Errors

Returns ConfigError when a fatal invariant is violated (e.g. compatible provider without a name).

Trait Implementations

impl Clone for ProviderEntry

fn clone(&self) -> ProviderEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderEntry

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

Formats the value using the given formatter.

impl Default for ProviderEntry

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ProviderEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProviderEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.