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.