Struct GeminiModelProvider 

pub struct GeminiModelProvider { /* private fields */ }

Gemini model_provider supporting multiple authentication methods.

Implementations

impl GeminiModelProvider

pub fn new(alias: &str, api_key: Option<&str>) -> Self

Create a new Gemini model_provider.

Authentication priority:

1. Explicit API key passed in (from [model_providers.gemini.<alias>] api_key, reachable via the schema-mirror env grammar)
2. Gemini CLI OAuth tokens (~/.gemini/oauth_creds.json)

pub fn new_with_auth( alias: &str, api_key: Option<&str>, auth_service: AuthService, profile_override: Option<String>, oauth_project_seed: Option<String>, oauth_client_id: Option<String>, oauth_client_secret: Option<String>, ) -> Self

Create a new Gemini model_provider with managed OAuth from auth-profiles.json.

Authentication priority:

1. Explicit API key passed in (from [model_providers.gemini.<alias>])
2. Managed OAuth from auth-profiles.json (if auth_service provided)
3. Gemini CLI OAuth tokens (~/.gemini/oauth_creds.json)

pub fn has_cli_credentials() -> bool

Check if Gemini CLI is configured and has valid credentials

pub fn has_any_auth() -> bool

Check if any Gemini authentication is available via the Gemini CLI OAuth credential cache. Per-alias config-supplied keys are tracked separately on the constructed provider, so this helper no longer reads process env.

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

Get authentication source description for diagnostics. Uses the stored enum variant — no env var re-reading at call time.

Trait Implementations

impl Attributable for GeminiModelProvider

fn role(&self) -> Role

fn alias(&self) -> &str

impl ModelProvider for GeminiModelProvider

fn default_base_url(&self) -> Option<&str>

Canonical public API endpoint, when there is one. Returned as a string slice so model_provider impls can serve from const &'static strs without allocations. None = model_provider has no universal endpoint (local model_providers, auth-less CLIs, user-BYO endpoints).

fn capabilities(&self) -> ProviderCapabilities

Query model_provider capabilities.

fn chat_with_system<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, system_prompt: Option<&'life1 str>, message: &'life2 str, model: &'life3 str, temperature: Option<f64>, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

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

One-shot chat with optional system prompt. See simple_chat for the temperature contract.

fn chat_with_history<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, messages: &'life1 [ChatMessage], model: &'life2 str, temperature: Option<f64>, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

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

Multi-turn conversation. See simple_chat for the temperature contract.

fn chat<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, request: ProviderChatRequest<'life1>, model: &'life2 str, temperature: Option<f64>, ) -> Pin<Box<dyn Future<Output = Result<ProviderChatResponse>> + Send + 'async_trait>>

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

Structured chat API for agent loop callers. See simple_chat for the temperature contract.

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

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

Warm up the HTTP connection pool.

fn list_models<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>>> + Send + 'async_trait>>

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

Fetch the list of available model IDs for this model_provider.

fn default_temperature(&self) -> f64

Temperature used when the caller passes None. Override per family.

fn default_max_tokens(&self) -> u32

Max output tokens used when the caller / config doesn’t set one.

fn default_timeout_secs(&self) -> u64

HTTP timeout (seconds) used when the caller / config doesn’t set one.

fn default_wire_api(&self) -> &str

Wire protocol variant. Either "responses" (OpenAI Codex-style) or "chat_completions" (everything else). Providers override to their native format.

fn convert_tools(&self, tools: &[ToolSpec]) -> ToolsPayload

Convert tool specifications to provider-native format.

fn simple_chat<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, message: &'life1 str, model: &'life2 str, temperature: Option<f64>, ) -> Pin<Box<dyn Future<Output = Result<String, Error>> + Send + 'async_trait>>

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

Simple one-shot chat (single user message, no explicit system prompt).

fn supports_native_tools(&self) -> bool

Whether model_provider supports native tool calls over API.

fn supports_vision(&self) -> bool

Whether model_provider supports multimodal vision input.

fn chat_with_tools<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, messages: &'life1 [ChatMessage], _tools: &'life2 [Value], model: &'life3 str, temperature: Option<f64>, ) -> Pin<Box<dyn Future<Output = Result<ChatResponse, Error>> + Send + 'async_trait>>

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

Chat with tool definitions for native function calling support. See simple_chat for the temperature contract.

fn supports_streaming(&self) -> bool

Whether model_provider supports streaming responses.

fn supports_streaming_tool_events(&self) -> bool

Whether model_provider can emit structured tool-call stream events.

fn stream_chat_with_system( &self, _system_prompt: Option<&str>, _message: &str, _model: &str, _temperature: Option<f64>, _options: StreamOptions, ) -> Pin<Box<dyn Stream<Item = Result<StreamChunk, StreamError>> + Send>>

Streaming chat with optional system prompt. See simple_chat for the temperature contract.

fn stream_chat_with_history( &self, messages: &[ChatMessage], model: &str, temperature: Option<f64>, options: StreamOptions, ) -> Pin<Box<dyn Stream<Item = Result<StreamChunk, StreamError>> + Send>>

Streaming chat with history. See simple_chat for the temperature contract.

fn stream_chat( &self, request: ChatRequest<'_>, model: &str, temperature: Option<f64>, options: StreamOptions, ) -> Pin<Box<dyn Stream<Item = Result<StreamEvent, StreamError>> + Send>>

Structured streaming chat interface. See simple_chat for the temperature contract.