Struct GeminiClient 

pub struct GeminiClient { /* private fields */ }

Gemini API client.

Implementations

impl GeminiClient

pub fn new(config: ProviderConfig) -> Self

pub fn from_api_key( api_key: impl Into<String>, model: impl Into<String>, ) -> Self

Quick constructor for Google AI Studio (API key auth).

pub async fn call<T: JsonSchema + DeserializeOwned>( &self, messages: &[Message], tools: &[ToolDef], ) -> Result<SgrResponse<T>, SgrError>

SGR call: structured output (typed response) + function calling (tools).

Returns SgrResponse<T> where:

• output: parsed structured response (if model returned text)
• tool_calls: function calls (if model used tools)

The model may return either or both.

pub async fn structured<T: JsonSchema + DeserializeOwned>( &self, messages: &[Message], ) -> Result<T, SgrError>

SGR call with structured output only (no tools).

Shorthand for call::<T>(messages, &[]).

pub async fn flexible<T: JsonSchema + DeserializeOwned>( &self, messages: &[Message], ) -> Result<SgrResponse<T>, SgrError>

Flexible call: no structured output API, parse JSON from raw text.

For use with text-only proxies (CLI proxy, Codex proxy) where the model can’t enforce JSON schema. Uses AnyOf cascade + coercion.

Auto-injects JSON Schema into the system prompt so the model knows the expected format (like BAML does).

pub async fn tools_call( &self, messages: &[Message], tools: &[ToolDef], ) -> Result<Vec<ToolCall>, SgrError>

Tool-only call: no structured output schema, just function calling.

Returns raw tool calls.

Trait Implementations

impl LlmClient for GeminiClient

fn structured_call<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, messages: &'life1 [Message], schema: &'life2 Value, ) -> Pin<Box<dyn Future<Output = Result<(Option<Value>, Vec<ToolCall>, String), SgrError>> + Send + 'async_trait>>

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

Structured call: send messages with schema injected into system prompt. Returns (parsed_output, native_tool_calls, raw_text).

fn tools_call<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, messages: &'life1 [Message], tools: &'life2 [ToolDef], ) -> Pin<Box<dyn Future<Output = Result<Vec<ToolCall>, SgrError>> + Send + 'async_trait>>

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

Native function calling: send messages + tool defs, get tool calls.

fn complete<'life0, 'life1, 'async_trait>( &'life0 self, messages: &'life1 [Message], ) -> Pin<Box<dyn Future<Output = Result<String, SgrError>> + Send + 'async_trait>>

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

Plain text completion (no schema, no tools).