Annie Luc

This commit introduces a **new feature** to the `google.genai` library by adding a dedicated `DeltaTextAnnotation` class within `google/genai/_interactions/types/content_delta.py`. This new type specifically supports the handling of **text annotations in streaming tool responses**, allowing for more granular and structured updates. The `Delta` type alias is updated to include this new annotation type, enhancing the system's ability to process incremental content changes. This change is crucial for improving the fidelity and utility of streamed outputs from generative AI models by providing explicit support for annotation deltas.

This commit performs a **maintenance refactoring** within the `google.genai` library, specifically impacting **image content handling and validation**. It **removes `image/jpg` from the list of allowed MIME types** for image content across the `DeltaImage` class in `content_delta.py`, the `ImageContent` class in `image_content.py`, and the `ImageContentParam` TypedDict in `image_content_param.py`. This change standardizes the accepted image MIME types, likely consolidating `image/jpg` under `image/jpeg` for consistency. Consequently, users should now specify `image/jpeg` for JPEG images when interacting with these **image content definition types**.

This commit **introduces support for several new generative AI models** within the `google.genai` client library. It's a **feature enhancement** that updates the `Model` and `ModelParam` type aliases in the `google/genai/_interactions/types` module to include 'gemini-2.5-computer-use-preview-10-2025', 'gemini-3.1-flash-lite-preview', 'lyria-3-clip-preview', and 'lyria-3-pro-preview'. This change allows users to **programmatically specify and interact with these latest model offerings**, expanding the library's capabilities and ensuring it remains up-to-date with available AI services.

This commit introduces a **new capability** to the **`google.genai` library's interaction types**, specifically enhancing **file search results**. It adds a `custom_metadata` field to `FileSearchResult`, `DeltaFileSearchResult`, and their associated content and parameter types within the `_interactions/types` module. This allows users to attach arbitrary, user-defined metadata to file search results, providing greater flexibility and descriptive power for these objects. The change impacts how file search results are structured and processed, enabling richer data representation for file search operations.

This commit **expands the supported MIME types** for image and audio content within the `google.genai._interactions` subsystem. It introduces support for `audio/m4a` for audio content and `image/jpg`, `image/gif`, `image/bmp`, `image/tiff` for image content. This **new capability** affects content definition classes such as `AudioContent`, `ImageContent`, `AudioContentParam`, `ImageContentParam`, and `ContentDelta`. By **enhancing data compatibility**, this change allows users to more flexibly provide and receive a broader array of media formats when interacting with the generative AI models.

This commit introduces a **breaking change** to the **Interactions API** by **refactoring** the representation of `TextContent` annotations. The previous generic annotation mechanism is replaced with specific, strongly-typed citation objects: `URLCitation`, `FileCitation`, and `PlaceCitation`. This involves **adding new classes** for each citation type and their corresponding parameter types within `google/genai/_interactions/types/`, while redefining `Annotation` and `AnnotationParam` as `TypeAlias` unions of these new types. This **enhances the expressiveness and type safety** of the API, allowing for more precise handling of different citation sources. Users of the **Interactions API** will need to update their code to accommodate these new, more granular citation objects.

This commit introduces a **new capability** by adding an optional `signature` field to various **tool call and result content types** within the `google.genai` library. Specifically, it updates classes like `CodeExecutionCallContent`, `FunctionCallContent`, `FileSearchCallContent`, `GoogleMapsCallContent`, `GoogleSearchCallContent`, `MCPServerToolCallContent`, `URLContextCallContent`, and their corresponding `*Param` TypedDicts, as well as `ContentDelta`. This `signature` field, which can accept string or Base64 file input, is crucial for **backend validation** of tool interactions. This enhancement improves the integrity and security of tool execution and result processing across the **tool calling and result handling** subsystems.

This commit introduces **new capabilities** to the `google.genai._interactions` module by adding comprehensive support for **Google Maps tool calls**. It defines new type definitions, such as `GoogleMapsCallArguments`, `GoogleMapsCallContent`, and `GoogleMapsResult`, along with their parameter and delta counterparts, to represent Google Maps interactions. These new types are integrated into the existing `Content`, `Delta`, `Input`, and `Tool` TypeAliases, enabling the `genai` library to seamlessly handle Google Maps as a first-class tool. This enhancement allows models to make Google Maps-related requests and process the structured results within the interaction framework.

This commit introduces a **breaking change** to the **Interactions API** by **refactoring** the naming of a key field within its data structures. Specifically, the `rendered_content` field has been **renamed** to `search_suggestions` in both the `GoogleSearchResult` model and the `GoogleSearchResultParam` TypedDict. This change affects the `google/genai/_interactions/types` module, requiring consumers of the API to update their code to reflect the new field name when accessing search-related suggestions. The **API contract** for search results is modified to use more descriptive terminology, improving clarity for developers.

This commit performs a **refactoring** of **data models** within the `google.genai` library's interaction types. It **removes the `signature` field** from several **tool call content and delta types**, including `FunctionCallContent`, `MCPServerToolCallContent`, and their associated parameter definitions, streamlining their structure. Concurrently, the commit **enhances the `DeltaFileSearchResultDelta` model** by adding new fields: `call_id` and `signature`. This adjustment standardizes the representation of tool call information and enriches file search results with crucial identifiers, impacting how these interaction types are structured and processed within the `_interactions` module.

This commit introduces a **new capability** by adding a `signature` field to all **Interaction tool types** within the `google.genai._interactions.types` module. It modifies numerous `*CallContent`, `*ResultContent`, `*CallContentParam`, and `*ResultContentParam` models and TypedDicts, including `CodeExecutionCallContent`, `FileSearchCallContent`, `FunctionCallContent`, and `GoogleSearchCallContent`, to include this field. This **feature enhancement** is crucial for enabling **backend validation** across all tool interactions, ensuring data integrity and security. The consistent addition of this field across various content types standardizes how signatures are handled for tool calls and their results, impacting the robustness of the `genai` library's interaction handling.

This commit introduces **support for the new `gemini-3.1-flash-image-preview` model** within the `google-genai` library. It **adds this model identifier** to the `Model` and `ModelParam` type aliases in `google/genai/_interactions/types/model.py` and `google/genai/_interactions/types/model_param.py` respectively. This **feature addition** allows developers to specify and interact with the `gemini-3.1-flash-image-preview` model when making API calls. The change ensures the library correctly recognizes and validates the new model, enabling its use in applications.

This commit introduces **new capabilities** for configuring image generation and Google Search tool usage within the generative AI system. Specifically, it **expands the supported `aspect_ratio` and `image_size` literal values** within the `ImageConfig` and `ImageConfigParam` models, allowing for a broader range of image dimensions and resolutions. Additionally, it **enhances the Google Search tool integration** by adding an optional `search_type` field to `GoogleSearchCallContent` and `search_types` to the `GoogleSearch` tool configuration, enabling users to specify the desired type of search grounding. These updates provide greater flexibility and control for users interacting with **image generation and search-grounded models**.

This commit **improves the error message** within the `google/genai/_api_client.py` module, specifically for scenarios where an **API key is missing**. It enhances the clarity of the message by providing users with more explicit instructions and a direct link to relevant documentation. This **usability improvement** helps users quickly resolve configuration issues during API client initialization, making the setup process smoother. The change is a **chore** that significantly improves the developer experience by reducing confusion and potential support inquiries.

This commit performs a significant **refactoring** within the `google.genai._interactions.types` module by marking numerous fields as **required** across various data models and TypedDicts. This change affects the definitions of interaction-related objects, including `CodeExecution`, `FileSearch`, `GoogleSearch`, and `URLContext` calls and results, as well as core `Interaction` events and content types. By enforcing the presence of critical fields like `id`, `arguments`, `call_id`, `result`, `created`, `updated`, and `text`, this work enhances the **robustness and predictability** of the `genai` library's interaction handling. Downstream code that constructs or processes these interaction types will now be subject to stricter validation, ensuring data integrity and preventing potential runtime issues from missing essential information.

This commit introduces **new capabilities** to the **`Interaction` class** in `google.genai._interactions.types/interaction.py`, significantly **enhancing the definition of Generative AI interactions**. It adds several optional fields, including agent configuration, response formatting, modalities, system instructions, and tools, alongside explicitly supporting `input` as a configurable field. This expansion allows for more comprehensive and flexible specification of interaction structures, enabling richer configurations for various aspects of AI agent behavior and response generation.

This commit **refactors** the **GenAI Interactions client** to standardize the handling of request options within its streaming components. Specifically, the `_streaming.py` module is updated to introduce an `_options` attribute and parameter to the `Stream` and `AsyncStream` classes' constructors. Concurrently, the `_response.py` module's `_build_stream` method is modified to correctly pass these internal `_options` to the stream wrapper constructors. This **internal maintenance** ensures consistent propagation of request options throughout the streaming mechanism, enhancing the robustness and maintainability of the client's streaming capabilities.

This commit introduces **support for the new `gemini-3.1-pro-preview` model** within the `google.genai` library, representing a **new capability**. It expands the list of recognized models by updating the `Model` type alias in `google/genai/_interactions/types/model.py` and the `ModelParam` type alias in `google/genai/_interactions/types/model_param.py`. This change allows the system to correctly identify and interact with the new Gemini model, enabling developers to leverage its features in their applications.

This commit performs a **refactoring** to enhance type safety within the **`google.genai._interactions.types` module**. It makes discriminator properties, specifically `event_type` and `type`, **mandatory** across various interaction event and agent configuration classes, including `ContentDelta`, `ErrorEvent`, `DeepResearchAgentConfig`, and `DynamicAgentConfig`. This change ensures that critical fields used for distinguishing between different interaction events and agent configurations are always present, preventing potential runtime errors and improving the robustness of **interaction event processing** and **agent configuration handling**.

chore: Add aiohttp as a required dependency.