google-genai 1.56.0__py3-none-any.whl → 1.58.0__py3-none-any.whl

google/genai/_interactions/types/document_content.py

@@ -30,8 +30,10 @@ class DocumentContent(BaseModel):
     type: Literal["document"]
 
     data: Optional[str] = None
+    """The document content."""
 
     mime_type: Optional[DocumentMimeType] = None
     """The mime type of the document."""
 
     uri: Optional[str] = None
+    """The URI of the document."""

google/genai/_interactions/types/document_content_param.py

@@ -34,11 +34,13 @@ class DocumentContentParam(TypedDict, total=False):
     type: Required[Literal["document"]]
 
     data: Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]
+    """The document content."""
 
     mime_type: DocumentMimeTypeParam
     """The mime type of the document."""
 
     uri: str
+    """The URI of the document."""
 
 
 set_pydantic_config(DocumentContentParam, {"arbitrary_types_allowed": True})

google/genai/_interactions/types/error_event.py

@@ -39,8 +39,7 @@ class ErrorEvent(BaseModel):
 
     event_id: Optional[str] = None
     """
-    The event_id token to be used to resume the interaction stream, from
-    this event.
+    The event_id token to be used to resume the interaction stream, from this event.
     """
 
     event_type: Optional[Literal["error"]] = None

google/genai/_interactions/types/file_search_call_content.py

@@ -0,0 +1,32 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["FileSearchCallContent"]
+
+
+class FileSearchCallContent(BaseModel):
+    """File Search content."""
+
+    type: Literal["file_search_call"]
+
+    id: Optional[str] = None
+    """A unique ID for this specific tool call."""

google/genai/_interactions/types/file_search_call_content_param.py

@@ -0,0 +1,31 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["FileSearchCallContentParam"]
+
+
+class FileSearchCallContentParam(TypedDict, total=False):
+    """File Search content."""
+
+    type: Required[Literal["file_search_call"]]
+
+    id: str
+    """A unique ID for this specific tool call."""

google/genai/_interactions/types/generation_config.py

@@ -20,6 +20,7 @@ from typing_extensions import Literal
 
 from .._models import BaseModel
 from .tool_choice import ToolChoice
+from .image_config import ImageConfig
 from .speech_config import SpeechConfig
 from .thinking_level import ThinkingLevel
 
@@ -29,6 +30,9 @@ __all__ = ["GenerationConfig"]
 class GenerationConfig(BaseModel):
     """Configuration parameters for model interactions."""
 
+    image_config: Optional[ImageConfig] = None
+    """Configuration for image interaction."""
+
     max_output_tokens: Optional[int] = None
     """The maximum number of tokens to include in the response."""
 

google/genai/_interactions/types/generation_config_param.py

@@ -23,6 +23,7 @@ from typing_extensions import Literal, TypedDict
 from .._types import SequenceNotStr
 from .thinking_level import ThinkingLevel
 from .tool_choice_param import ToolChoiceParam
+from .image_config_param import ImageConfigParam
 from .speech_config_param import SpeechConfigParam
 
 __all__ = ["GenerationConfigParam"]
@@ -31,6 +32,9 @@ __all__ = ["GenerationConfigParam"]
 class GenerationConfigParam(TypedDict, total=False):
     """Configuration parameters for model interactions."""
 
+    image_config: ImageConfigParam
+    """Configuration for image interaction."""
+
     max_output_tokens: int
     """The maximum number of tokens to include in the response."""
 

google/genai/_interactions/types/image_config.py

@@ -0,0 +1,31 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["ImageConfig"]
+
+
+class ImageConfig(BaseModel):
+    """The configuration for image interaction."""
+
+    aspect_ratio: Optional[Literal["1:1", "2:3", "3:2", "3:4", "4:3", "9:16", "16:9", "21:9"]] = None
+
+    image_size: Optional[Literal["1K", "2K", "4K"]] = None

google/genai/_interactions/types/image_config_param.py

@@ -0,0 +1,30 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["ImageConfigParam"]
+
+
+class ImageConfigParam(TypedDict, total=False):
+    """The configuration for image interaction."""
+
+    aspect_ratio: Literal["1:1", "2:3", "3:2", "3:4", "4:3", "9:16", "16:9", "21:9"]
+
+    image_size: Literal["1K", "2K", "4K"]

google/genai/_interactions/types/image_content.py

@@ -30,6 +30,7 @@ class ImageContent(BaseModel):
     type: Literal["image"]
 
     data: Optional[str] = None
+    """The image content."""
 
     mime_type: Optional[ImageMimeType] = None
     """The mime type of the image."""
@@ -38,3 +39,4 @@ class ImageContent(BaseModel):
     """The resolution of the media."""
 
     uri: Optional[str] = None
+    """The URI of the image."""

google/genai/_interactions/types/image_content_param.py

@@ -34,6 +34,7 @@ class ImageContentParam(TypedDict, total=False):
     type: Required[Literal["image"]]
 
     data: Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]
+    """The image content."""
 
     mime_type: ImageMimeTypeParam
     """The mime type of the image."""
@@ -42,6 +43,7 @@ class ImageContentParam(TypedDict, total=False):
     """The resolution of the media."""
 
     uri: str
+    """The URI of the image."""
 
 
 set_pydantic_config(ImageContentParam, {"arbitrary_types_allowed": True})

google/genai/_interactions/types/interaction.py

@@ -23,6 +23,7 @@ from .turn import Turn
 from .model import Model
 from .usage import Usage
 from .._utils import PropertyInfo
+from .content import Content
 from .._models import BaseModel
 from .text_content import TextContent
 from .audio_content import AudioContent
@@ -33,6 +34,7 @@ from .document_content import DocumentContent
 from .dynamic_agent_config import DynamicAgentConfig
 from .function_call_content import FunctionCallContent
 from .function_result_content import FunctionResultContent
+from .file_search_call_content import FileSearchCallContent
 from .url_context_call_content import URLContextCallContent
 from .deep_research_agent_config import DeepResearchAgentConfig
 from .file_search_result_content import FileSearchResultContent
@@ -44,38 +46,15 @@ from .mcp_server_tool_call_content import MCPServerToolCallContent
 from .code_execution_result_content import CodeExecutionResultContent
 from .mcp_server_tool_result_content import MCPServerToolResultContent
 
-__all__ = ["Interaction", "AgentConfig", "Input", "InputContentList", "Output"]
+__all__ = ["Interaction", "AgentConfig", "Input"]
 
 AgentConfig: TypeAlias = Annotated[
     Union[DynamicAgentConfig, DeepResearchAgentConfig], PropertyInfo(discriminator="type")
 ]
 
-InputContentList: TypeAlias = Annotated[
-    Union[
-        TextContent,
-        ImageContent,
-        AudioContent,
-        DocumentContent,
-        VideoContent,
-        ThoughtContent,
-        FunctionCallContent,
-        FunctionResultContent,
-        CodeExecutionCallContent,
-        CodeExecutionResultContent,
-        URLContextCallContent,
-        URLContextResultContent,
-        GoogleSearchCallContent,
-        GoogleSearchResultContent,
-        MCPServerToolCallContent,
-        MCPServerToolResultContent,
-        FileSearchResultContent,
-    ],
-    PropertyInfo(discriminator="type"),
-]
-
 Input: TypeAlias = Union[
     str,
-    List[InputContentList],
+    List[Content],
     List[Turn],
     TextContent,
     ImageContent,
@@ -93,32 +72,10 @@ Input: TypeAlias = Union[
     GoogleSearchResultContent,
     MCPServerToolCallContent,
     MCPServerToolResultContent,
+    FileSearchCallContent,
     FileSearchResultContent,
 ]
 
-Output: TypeAlias = Annotated[
-    Union[
-        TextContent,
-        ImageContent,
-        AudioContent,
-        DocumentContent,
-        VideoContent,
-        ThoughtContent,
-        FunctionCallContent,
-        FunctionResultContent,
-        CodeExecutionCallContent,
-        CodeExecutionResultContent,
-        URLContextCallContent,
-        URLContextResultContent,
-        GoogleSearchCallContent,
-        GoogleSearchResultContent,
-        MCPServerToolCallContent,
-        MCPServerToolResultContent,
-        FileSearchResultContent,
-    ],
-    PropertyInfo(discriminator="type"),
-]
-
 
 class Interaction(BaseModel):
     """The Interaction resource."""
@@ -142,10 +99,7 @@ class Interaction(BaseModel):
     model: Optional[Model] = None
     """The name of the `Model` used for generating the interaction."""
 
-    object: Optional[Literal["interaction"]] = None
-    """Output only. The object type of the interaction. Always set to `interaction`."""
-
-    outputs: Optional[List[Output]] = None
+    outputs: Optional[List[Content]] = None
     """Output only. Responses from the model."""
 
     previous_interaction_id: Optional[str] = None

google/genai/_interactions/types/interaction_create_params.py

@@ -23,6 +23,7 @@ from typing_extensions import Literal, Required, TypeAlias, TypedDict
 from .tool_param import ToolParam
 from .turn_param import TurnParam
 from .model_param import ModelParam
+from .content_param import ContentParam
 from .text_content_param import TextContentParam
 from .audio_content_param import AudioContentParam
 from .image_content_param import ImageContentParam
@@ -33,6 +34,7 @@ from .generation_config_param import GenerationConfigParam
 from .dynamic_agent_config_param import DynamicAgentConfigParam
 from .function_call_content_param import FunctionCallContentParam
 from .function_result_content_param import FunctionResultContentParam
+from .file_search_call_content_param import FileSearchCallContentParam
 from .url_context_call_content_param import URLContextCallContentParam
 from .deep_research_agent_config_param import DeepResearchAgentConfigParam
 from .file_search_result_content_param import FileSearchResultContentParam
@@ -47,7 +49,6 @@ from .mcp_server_tool_result_content_param import MCPServerToolResultContentPara
 __all__ = [
     "BaseCreateModelInteractionParams",
     "Input",
-    "ContentList",
     "BaseCreateAgentInteractionParams",
     "AgentConfig",
     "CreateModelInteractionParamsNonStreaming",
@@ -97,29 +98,9 @@ class BaseCreateModelInteractionParams(TypedDict, total=False):
     """A list of tool declarations the model may call during interaction."""
 
 
-ContentList: TypeAlias = Union[
-    TextContentParam,
-    ImageContentParam,
-    AudioContentParam,
-    DocumentContentParam,
-    VideoContentParam,
-    ThoughtContentParam,
-    FunctionCallContentParam,
-    FunctionResultContentParam,
-    CodeExecutionCallContentParam,
-    CodeExecutionResultContentParam,
-    URLContextCallContentParam,
-    URLContextResultContentParam,
-    GoogleSearchCallContentParam,
-    GoogleSearchResultContentParam,
-    MCPServerToolCallContentParam,
-    MCPServerToolResultContentParam,
-    FileSearchResultContentParam,
-]
-
 Input: TypeAlias = Union[
     str,
-    Iterable[ContentList],
+    Iterable[ContentParam],
     Iterable[TurnParam],
     TextContentParam,
     ImageContentParam,
@@ -137,6 +118,7 @@ Input: TypeAlias = Union[
     GoogleSearchResultContentParam,
     MCPServerToolCallContentParam,
     MCPServerToolResultContentParam,
+    FileSearchCallContentParam,
     FileSearchResultContentParam,
 ]
 

google/genai/_interactions/types/interaction_event.py

@@ -27,8 +27,7 @@ __all__ = ["InteractionEvent"]
 class InteractionEvent(BaseModel):
     event_id: Optional[str] = None
     """
-    The event_id token to be used to resume the interaction stream, from
-    this event.
+    The event_id token to be used to resume the interaction stream, from this event.
     """
 
     event_type: Optional[Literal["interaction.start", "interaction.complete"]] = None

google/genai/_interactions/types/interaction_sse_event.py

@@ -16,8 +16,9 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import Union
-from typing_extensions import TypeAlias
+from typing_extensions import Annotated, TypeAlias
 
+from .._utils import PropertyInfo
 from .error_event import ErrorEvent
 from .content_stop import ContentStop
 from .content_delta import ContentDelta
@@ -27,6 +28,7 @@ from .interaction_status_update import InteractionStatusUpdate
 
 __all__ = ["InteractionSSEEvent"]
 
-InteractionSSEEvent: TypeAlias = Union[
-    InteractionEvent, InteractionStatusUpdate, ContentStart, ContentDelta, ContentStop, ErrorEvent
+InteractionSSEEvent: TypeAlias = Annotated[
+    Union[InteractionEvent, InteractionStatusUpdate, ContentStart, ContentDelta, ContentStop, ErrorEvent],
+    PropertyInfo(discriminator="event_type"),
 ]

google/genai/_interactions/types/interaction_status_update.py

@@ -26,8 +26,7 @@ __all__ = ["InteractionStatusUpdate"]
 class InteractionStatusUpdate(BaseModel):
     event_id: Optional[str] = None
     """
-    The event_id token to be used to resume the interaction stream, from
-    this event.
+    The event_id token to be used to resume the interaction stream, from this event.
     """
 
     event_type: Optional[Literal["interaction.status_update"]] = None

google/genai/_interactions/types/model.py

@@ -31,6 +31,7 @@ Model: TypeAlias = Union[
         "gemini-2.5-flash-image-preview",
         "gemini-2.5-pro-preview-tts",
         "gemini-3-pro-preview",
+        "gemini-3-flash-preview",
     ],
     str,
 ]

google/genai/_interactions/types/model_param.py

@@ -33,6 +33,7 @@ ModelParam: TypeAlias = Union[
         "gemini-2.5-flash-image-preview",
         "gemini-2.5-pro-preview-tts",
         "gemini-3-pro-preview",
+        "gemini-3-flash-preview",
     ],
     str,
 ]

google/genai/_interactions/types/turn.py

@@ -16,56 +16,15 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import List, Union, Optional
-from typing_extensions import Annotated, TypeAlias
 
-from .._utils import PropertyInfo
+from .content import Content
 from .._models import BaseModel
-from .text_content import TextContent
-from .audio_content import AudioContent
-from .image_content import ImageContent
-from .video_content import VideoContent
-from .thought_content import ThoughtContent
-from .document_content import DocumentContent
-from .function_call_content import FunctionCallContent
-from .function_result_content import FunctionResultContent
-from .url_context_call_content import URLContextCallContent
-from .file_search_result_content import FileSearchResultContent
-from .google_search_call_content import GoogleSearchCallContent
-from .url_context_result_content import URLContextResultContent
-from .code_execution_call_content import CodeExecutionCallContent
-from .google_search_result_content import GoogleSearchResultContent
-from .mcp_server_tool_call_content import MCPServerToolCallContent
-from .code_execution_result_content import CodeExecutionResultContent
-from .mcp_server_tool_result_content import MCPServerToolResultContent
 
-__all__ = ["Turn", "ContentUnionMember1"]
-
-ContentUnionMember1: TypeAlias = Annotated[
-    Union[
-        TextContent,
-        ImageContent,
-        AudioContent,
-        DocumentContent,
-        VideoContent,
-        ThoughtContent,
-        FunctionCallContent,
-        FunctionResultContent,
-        CodeExecutionCallContent,
-        CodeExecutionResultContent,
-        URLContextCallContent,
-        URLContextResultContent,
-        GoogleSearchCallContent,
-        GoogleSearchResultContent,
-        MCPServerToolCallContent,
-        MCPServerToolResultContent,
-        FileSearchResultContent,
-    ],
-    PropertyInfo(discriminator="type"),
-]
+__all__ = ["Turn"]
 
 
 class Turn(BaseModel):
-    content: Union[str, List[ContentUnionMember1], None] = None
+    content: Union[str, List[Content], None] = None
     """The content of the turn."""
 
     role: Optional[str] = None

google/genai/_interactions/types/turn_param.py

@@ -18,51 +18,15 @@
 from __future__ import annotations
 
 from typing import Union, Iterable
-from typing_extensions import TypeAlias, TypedDict
+from typing_extensions import TypedDict
 
-from .text_content_param import TextContentParam
-from .audio_content_param import AudioContentParam
-from .image_content_param import ImageContentParam
-from .video_content_param import VideoContentParam
-from .thought_content_param import ThoughtContentParam
-from .document_content_param import DocumentContentParam
-from .function_call_content_param import FunctionCallContentParam
-from .function_result_content_param import FunctionResultContentParam
-from .url_context_call_content_param import URLContextCallContentParam
-from .file_search_result_content_param import FileSearchResultContentParam
-from .google_search_call_content_param import GoogleSearchCallContentParam
-from .url_context_result_content_param import URLContextResultContentParam
-from .code_execution_call_content_param import CodeExecutionCallContentParam
-from .google_search_result_content_param import GoogleSearchResultContentParam
-from .mcp_server_tool_call_content_param import MCPServerToolCallContentParam
-from .code_execution_result_content_param import CodeExecutionResultContentParam
-from .mcp_server_tool_result_content_param import MCPServerToolResultContentParam
+from .content_param import ContentParam
 
-__all__ = ["TurnParam", "ContentUnionMember1"]
-
-ContentUnionMember1: TypeAlias = Union[
-    TextContentParam,
-    ImageContentParam,
-    AudioContentParam,
-    DocumentContentParam,
-    VideoContentParam,
-    ThoughtContentParam,
-    FunctionCallContentParam,
-    FunctionResultContentParam,
-    CodeExecutionCallContentParam,
-    CodeExecutionResultContentParam,
-    URLContextCallContentParam,
-    URLContextResultContentParam,
-    GoogleSearchCallContentParam,
-    GoogleSearchResultContentParam,
-    MCPServerToolCallContentParam,
-    MCPServerToolResultContentParam,
-    FileSearchResultContentParam,
-]
+__all__ = ["TurnParam"]
 
 
 class TurnParam(TypedDict, total=False):
-    content: Union[str, Iterable[ContentUnionMember1]]
+    content: Union[str, Iterable[ContentParam]]
     """The content of the turn."""
 
     role: str

google/genai/_interactions/types/usage.py

@@ -93,7 +93,7 @@ class Usage(BaseModel):
     total_output_tokens: Optional[int] = None
     """Total number of tokens across all the generated responses."""
 
-    total_reasoning_tokens: Optional[int] = None
+    total_thought_tokens: Optional[int] = None
     """Number of tokens of thoughts for thinking models."""
 
     total_tokens: Optional[int] = None

google/genai/_interactions/types/usage_param.py

@@ -93,7 +93,7 @@ class UsageParam(TypedDict, total=False):
     total_output_tokens: int
     """Total number of tokens across all the generated responses."""
 
-    total_reasoning_tokens: int
+    total_thought_tokens: int
     """Number of tokens of thoughts for thinking models."""
 
     total_tokens: int

google/genai/_interactions/types/video_content.py

@@ -30,6 +30,7 @@ class VideoContent(BaseModel):
     type: Literal["video"]
 
     data: Optional[str] = None
+    """The video content."""
 
     mime_type: Optional[VideoMimeType] = None
     """The mime type of the video."""
@@ -38,3 +39,4 @@ class VideoContent(BaseModel):
     """The resolution of the media."""
 
     uri: Optional[str] = None
+    """The URI of the video."""

google/genai/_interactions/types/video_content_param.py

@@ -34,6 +34,7 @@ class VideoContentParam(TypedDict, total=False):
     type: Required[Literal["video"]]
 
     data: Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]
+    """The video content."""
 
     mime_type: VideoMimeTypeParam
     """The mime type of the video."""
@@ -42,6 +43,7 @@ class VideoContentParam(TypedDict, total=False):
     """The resolution of the media."""
 
     uri: str
+    """The URI of the video."""
 
 
 set_pydantic_config(VideoContentParam, {"arbitrary_types_allowed": True})