Struct GeminiViaResponses 

pub struct GeminiViaResponses { /* private fields */ }

A prepared Gemini client request executed by the selected Responses endpoint.

Implementations

impl GeminiViaResponses

pub async fn prepare_with_image_resources<S: StateStore, R: ResourceAccess>( input: GenerateContentRequestBody, endpoint: Endpoint, identities: GenerationIdentity, state: &GenerationStateAccess<'_, S>, resources: &GenerationResources<'_, R>, ) -> Result<Self, TransformError>

URI delivery is handled by actual publication after generation. Only the mapped request uses inline delivery; original_request remains unchanged.

pub async fn convert_response_with_image_resources<S: StateStore, R: ResourceAccess>( &mut self, native: GenerateContentResponseBody, facts: GeminiReplayContext, state: &GenerationStateAccess<'_, S>, resources: &GenerationResources<'_, R>, progress: &mut ImageResourceProgress<GenerateContentResponseBody, R::PublishedHandle>, ) -> Result<Converted<GenerateContentResponseBody>, TransformError>

Convert and publish requested image URLs before persisting identities and returning any client result. The original native response stays separate.

pub async fn invoke_with_image_resources<U: Upstream, S: StateStore, R: ResourceAccess>( &mut self, upstream: &U, target: &U::Target, limits: CodecLimits, state: &GenerationStateAccess<'_, S>, resources: &GenerationResources<'_, R>, progress: &mut ImageResourceProgress<GenerateContentResponseBody, R::PublishedHandle>, facts: impl FnOnce(&GenerateContentResponseBody) -> Result<GeminiReplayContext, TransformError>, ) -> Result<GenerationOutcome<GenerateContentResponseBody>, TransformError>

pub async fn recover_with_image_resources<S: StateStore, R: ResourceAccess>( &mut self, limits: CodecLimits, state: &GenerationStateAccess<'_, S>, resources: &GenerationResources<'_, R>, progress: &mut ImageResourceProgress<GenerateContentResponseBody, R::PublishedHandle>, facts: impl FnOnce(&GenerateContentResponseBody) -> Result<GeminiReplayContext, TransformError>, ) -> Result<GenerationOutcome<GenerateContentResponseBody>, TransformError>

impl GeminiViaResponses

pub fn prepare( input: GenerateContentRequestBody, selected_model: impl Into<String>, endpoint: Endpoint, identities: GenerationIdentity, ) -> Result<Self, TransformError>

pub async fn prepare_with_state<S: StateStore>( input: GenerateContentRequestBody, endpoint: Endpoint, identities: GenerationIdentity, state: &GenerationStateAccess<'_, S>, ) -> Result<Self, TransformError>

Restore exact tool aliases and names from declared history/scoped state before mapping.

pub async fn prepare_with_capabilities<S: StateStore, R: ResourceAccess>( input: GenerateContentRequestBody, endpoint: Endpoint, identities: GenerationIdentity, state: &GenerationStateAccess<'_, S>, resources: &GenerationResources<'_, R>, ) -> Result<Self, TransformError>

Materialize foreign resources and restore scoped history before preparing the selected endpoint.

pub fn original_request(&self) -> &GenerateContentRequestBody

pub fn target_request(&self) -> &GenerateContentRequestBody

pub fn identities(&self) -> &GenerationIdentity

pub fn report(&self) -> &Report

pub fn selected_model(&self) -> &str

pub fn convert_response( &mut self, native: GenerateContentResponseBody, facts: GeminiReplayContext, ) -> Result<Converted<GenerateContentResponseBody>, TransformError>

pub async fn invoke<U: Upstream, S: StateStore>( &mut self, upstream: &U, target: &U::Target, limits: CodecLimits, state: &GenerationStateAccess<'_, S>, progress: &mut GenerationProgress<GenerateContentResponseBody>, facts: impl FnOnce(&GenerateContentResponseBody) -> Result<GeminiReplayContext, TransformError>, ) -> Result<GenerationOutcome<GenerateContentResponseBody>, TransformError>

Performs one POST. The factual supplement is obtained from the actual decoded response. Conversion errors keep native bytes/results in caller-owned progress.

pub async fn recover<S: StateStore>( &mut self, limits: CodecLimits, state: &GenerationStateAccess<'_, S>, progress: &mut GenerationProgress<GenerateContentResponseBody>, facts: impl FnOnce(&GenerateContentResponseBody) -> Result<GeminiReplayContext, TransformError>, ) -> Result<GenerationOutcome<GenerateContentResponseBody>, TransformError>

Complete response conversion and pending state writes using the retained result; sends no request.

impl GeminiViaResponses

pub async fn prepare_for_stream_synthesis<S: StateStore>( input: GenerateContentRequestBody, endpoint: Endpoint, identities: GenerationIdentity, state: &GenerationStateAccess<'_, S>, ) -> Result<Self, TransformError>

Prepare a buffered upstream result for later native stream synthesis, retaining the original client stream flag and all declared controls.

pub async fn prepare_for_stream_synthesis_with_capabilities<S: StateStore, R: ResourceAccess>( input: GenerateContentRequestBody, endpoint: Endpoint, identities: GenerationIdentity, state: &GenerationStateAccess<'_, S>, resources: &GenerationResources<'_, R>, ) -> Result<Self, TransformError>

Prepare a buffered upstream result for later native stream synthesis, retaining the original client stream flag and all declared controls.

impl GeminiViaResponses

pub async fn prepare_stream<S: StateStore>( input: GenerateContentRequestBody, target: StreamTarget, context: ResponsesToGeminiContext, settings: StreamSettings, state: &GenerationStateAccess<'_, S>, ) -> Result<StreamInvocation<ResponsesToGeminiStream>, TransformError>

pub async fn prepare_stream_with_capabilities<S: StateStore, R: ResourceAccess>( input: GenerateContentRequestBody, target: StreamTarget, context: ResponsesToGeminiContext, settings: StreamSettings, state: &GenerationStateAccess<'_, S>, resources: &GenerationResources<'_, R>, ) -> Result<StreamInvocation<ResponsesToGeminiStream>, TransformError>

Trait Implementations

impl Debug for GeminiViaResponses

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

Formats the value using the given formatter.