google-genai 1.55.0__py3-none-any.whl → 1.57.0__py3-none-any.whl

google/genai/_interactions/types/document_mime_type.py

@@ -0,0 +1,23 @@
+# 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 Union
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["DocumentMimeType"]
+
+DocumentMimeType: TypeAlias = Union[str, Literal["application/pdf"]]

google/genai/_interactions/types/document_mime_type_param.py

@@ -0,0 +1,25 @@
+# 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 import Union
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["DocumentMimeTypeParam"]
+
+DocumentMimeTypeParam: TypeAlias = Union[str, Literal["application/pdf"]]

google/genai/_interactions/types/dynamic_agent_config.py

@@ -29,7 +29,6 @@ class DynamicAgentConfig(BaseModel):
     """Configuration for dynamic agents."""
 
     type: Optional[Literal["dynamic"]] = None
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     if TYPE_CHECKING:
         # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a

google/genai/_interactions/types/dynamic_agent_config_param.py

@@ -27,7 +27,6 @@ class DynamicAgentConfigParamTyped(TypedDict, total=False):
     """Configuration for dynamic agents."""
 
     type: Literal["dynamic"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
 
 DynamicAgentConfigParam: TypeAlias = Union[DynamicAgentConfigParamTyped, Dict[str, object]]

google/genai/_interactions/types/file_search_result_content.py

@@ -40,7 +40,6 @@ class FileSearchResultContent(BaseModel):
     """File Search result content."""
 
     type: Literal["file_search_result"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     result: Optional[List[Result]] = None
     """The results of the File Search."""

google/genai/_interactions/types/file_search_result_content_param.py

@@ -40,7 +40,6 @@ class FileSearchResultContentParam(TypedDict, total=False):
     """File Search result content."""
 
     type: Required[Literal["file_search_result"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     result: Iterable[Result]
     """The results of the File Search."""

google/genai/_interactions/types/function_call_content.py

@@ -36,4 +36,3 @@ class FunctionCallContent(BaseModel):
     """The name of the tool to call."""
 
     type: Literal["function_call"]
-    """Used as the OpenAPI type discriminator for the content oneof."""

google/genai/_interactions/types/function_call_content_param.py

@@ -36,4 +36,3 @@ class FunctionCallContentParam(TypedDict, total=False):
     """The name of the tool to call."""
 
     type: Required[Literal["function_call"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""

google/genai/_interactions/types/function_result_content.py

@@ -23,7 +23,7 @@ from .image_content import ImageContent
 
 __all__ = ["FunctionResultContent", "Result", "ResultItems", "ResultItemsItem"]
 
-ResultItemsItem: TypeAlias = Union[str, ImageContent]
+ResultItemsItem: TypeAlias = Union[str, ImageContent, object]
 
 
 class ResultItems(BaseModel):
@@ -43,7 +43,6 @@ class FunctionResultContent(BaseModel):
     """The result of the tool call."""
 
     type: Literal["function_result"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     is_error: Optional[bool] = None
     """Whether the tool call resulted in an error."""

google/genai/_interactions/types/function_result_content_param.py

@@ -25,7 +25,7 @@ from .image_content_param import ImageContentParam
 
 __all__ = ["FunctionResultContentParam", "Result", "ResultItems", "ResultItemsItem"]
 
-ResultItemsItem: TypeAlias = Union[str, ImageContentParam]
+ResultItemsItem: TypeAlias = Union[str, ImageContentParam, object]
 
 
 class ResultItems(TypedDict, total=False):
@@ -45,7 +45,6 @@ class FunctionResultContentParam(TypedDict, total=False):
     """The result of the tool call."""
 
     type: Required[Literal["function_result"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     is_error: bool
     """Whether the tool call resulted in an error."""

google/genai/_interactions/types/google_search_call_content.py

@@ -28,7 +28,6 @@ class GoogleSearchCallContent(BaseModel):
     """Google Search content."""
 
     type: Literal["google_search_call"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     id: Optional[str] = None
     """A unique ID for this specific tool call."""

google/genai/_interactions/types/google_search_call_content_param.py

@@ -28,7 +28,6 @@ class GoogleSearchCallContentParam(TypedDict, total=False):
     """Google Search content."""
 
     type: Required[Literal["google_search_call"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     id: str
     """A unique ID for this specific tool call."""

google/genai/_interactions/types/google_search_result_content.py

@@ -28,7 +28,6 @@ class GoogleSearchResultContent(BaseModel):
     """Google Search result content."""
 
     type: Literal["google_search_result"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     call_id: Optional[str] = None
     """ID to match the ID from the google search call block."""

google/genai/_interactions/types/google_search_result_content_param.py

@@ -29,7 +29,6 @@ class GoogleSearchResultContentParam(TypedDict, total=False):
     """Google Search result content."""
 
     type: Required[Literal["google_search_result"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     call_id: str
     """ID to match the ID from the google search call block."""

google/genai/_interactions/types/image_content.py

@@ -28,14 +28,13 @@ class ImageContent(BaseModel):
     """An image content block."""
 
     type: Literal["image"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     data: Optional[str] = None
 
     mime_type: Optional[ImageMimeType] = None
     """The mime type of the image."""
 
-    resolution: Optional[Literal["low", "medium", "high"]] = None
+    resolution: Optional[Literal["low", "medium", "high", "ultra_high"]] = None
     """The resolution of the media."""
 
     uri: Optional[str] = None

google/genai/_interactions/types/image_content_param.py

@@ -32,14 +32,13 @@ class ImageContentParam(TypedDict, total=False):
     """An image content block."""
 
     type: Required[Literal["image"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     data: Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]
 
     mime_type: ImageMimeTypeParam
     """The mime type of the image."""
 
-    resolution: Literal["low", "medium", "high"]
+    resolution: Literal["low", "medium", "high", "ultra_high"]
     """The resolution of the media."""
 
     uri: str

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
@@ -44,38 +45,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,
@@ -96,29 +74,6 @@ Input: TypeAlias = Union[
     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 +97,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
@@ -47,7 +48,6 @@ from .mcp_server_tool_result_content_param import MCPServerToolResultContentPara
 __all__ = [
     "BaseCreateModelInteractionParams",
     "Input",
-    "ContentList",
     "BaseCreateAgentInteractionParams",
     "AgentConfig",
     "CreateModelInteractionParamsNonStreaming",
@@ -97,29 +97,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,

google/genai/_interactions/types/mcp_server_tool_call_content.py

@@ -39,4 +39,3 @@ class MCPServerToolCallContent(BaseModel):
     """The name of the used MCP server."""
 
     type: Literal["mcp_server_tool_call"]
-    """Used as the OpenAPI type discriminator for the content oneof."""

google/genai/_interactions/types/mcp_server_tool_call_content_param.py

@@ -39,4 +39,3 @@ class MCPServerToolCallContentParam(TypedDict, total=False):
     """The name of the used MCP server."""
 
     type: Required[Literal["mcp_server_tool_call"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""

google/genai/_interactions/types/mcp_server_tool_result_content.py

@@ -23,7 +23,7 @@ from .image_content import ImageContent
 
 __all__ = ["MCPServerToolResultContent", "Result", "ResultItems", "ResultItemsItem"]
 
-ResultItemsItem: TypeAlias = Union[str, ImageContent]
+ResultItemsItem: TypeAlias = Union[str, ImageContent, object]
 
 
 class ResultItems(BaseModel):
@@ -43,7 +43,6 @@ class MCPServerToolResultContent(BaseModel):
     """The result of the tool call."""
 
     type: Literal["mcp_server_tool_result"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     name: Optional[str] = None
     """Name of the tool which is called for this specific tool call."""

google/genai/_interactions/types/mcp_server_tool_result_content_param.py

@@ -25,7 +25,7 @@ from .image_content_param import ImageContentParam
 
 __all__ = ["MCPServerToolResultContentParam", "Result", "ResultItems", "ResultItemsItem"]
 
-ResultItemsItem: TypeAlias = Union[str, ImageContentParam]
+ResultItemsItem: TypeAlias = Union[str, ImageContentParam, object]
 
 
 class ResultItems(TypedDict, total=False):
@@ -45,7 +45,6 @@ class MCPServerToolResultContentParam(TypedDict, total=False):
     """The result of the tool call."""
 
     type: Required[Literal["mcp_server_tool_result"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     name: str
     """Name of the tool which is called for this specific tool call."""

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/text_content.py

@@ -28,7 +28,6 @@ class TextContent(BaseModel):
     """A text content block."""
 
     type: Literal["text"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     annotations: Optional[List[Annotation]] = None
     """Citation information for model-generated content."""

google/genai/_interactions/types/text_content_param.py

@@ -29,7 +29,6 @@ class TextContentParam(TypedDict, total=False):
     """A text content block."""
 
     type: Required[Literal["text"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     annotations: Iterable[AnnotationParam]
     """Citation information for model-generated content."""

google/genai/_interactions/types/thinking_level.py

@@ -19,4 +19,4 @@ from typing_extensions import Literal, TypeAlias
 
 __all__ = ["ThinkingLevel"]
 
-ThinkingLevel: TypeAlias = Literal["low", "high"]
+ThinkingLevel: TypeAlias = Literal["minimal", "low", "medium", "high"]

google/genai/_interactions/types/thought_content.py

@@ -32,7 +32,6 @@ class ThoughtContent(BaseModel):
     """A thought content block."""
 
     type: Literal["thought"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     signature: Optional[str] = None
     """Signature to match the backend source to be part of the generation."""

google/genai/_interactions/types/thought_content_param.py

@@ -35,7 +35,6 @@ class ThoughtContentParam(TypedDict, total=False):
     """A thought content block."""
 
     type: Required[Literal["thought"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     signature: Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]
     """Signature to match the backend source to be part of the generation."""

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/url_context_call_content.py

@@ -28,7 +28,6 @@ class URLContextCallContent(BaseModel):
     """URL context content."""
 
     type: Literal["url_context_call"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     id: Optional[str] = None
     """A unique ID for this specific tool call."""

google/genai/_interactions/types/url_context_call_content_param.py

@@ -28,7 +28,6 @@ class URLContextCallContentParam(TypedDict, total=False):
     """URL context content."""
 
     type: Required[Literal["url_context_call"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     id: str
     """A unique ID for this specific tool call."""

google/genai/_interactions/types/url_context_result_content.py

@@ -28,7 +28,6 @@ class URLContextResultContent(BaseModel):
     """URL context result content."""
 
     type: Literal["url_context_result"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     call_id: Optional[str] = None
     """ID to match the ID from the url context call block."""

google/genai/_interactions/types/url_context_result_content_param.py

@@ -29,7 +29,6 @@ class URLContextResultContentParam(TypedDict, total=False):
     """URL context result content."""
 
     type: Required[Literal["url_context_result"]]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     call_id: str
     """ID to match the ID from the url context call block."""

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

@@ -28,14 +28,13 @@ class VideoContent(BaseModel):
     """A video content block."""
 
     type: Literal["video"]
-    """Used as the OpenAPI type discriminator for the content oneof."""
 
     data: Optional[str] = None
 
     mime_type: Optional[VideoMimeType] = None
     """The mime type of the video."""
 
-    resolution: Optional[Literal["low", "medium", "high"]] = None
+    resolution: Optional[Literal["low", "medium", "high", "ultra_high"]] = None
     """The resolution of the media."""
 
     uri: Optional[str] = None