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

google/genai/_interactions/types/google_search_call_content_param.py

@@ -0,0 +1,37 @@
+# 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
+
+from .google_search_call_arguments_param import GoogleSearchCallArgumentsParam
+
+__all__ = ["GoogleSearchCallContentParam"]
+
+
+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."""
+
+    arguments: GoogleSearchCallArgumentsParam
+    """The arguments to pass to Google Search."""

google/genai/_interactions/types/google_search_result.py

@@ -0,0 +1,35 @@
+# 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 .._models import BaseModel
+
+__all__ = ["GoogleSearchResult"]
+
+
+class GoogleSearchResult(BaseModel):
+    """The result of the Google Search."""
+
+    rendered_content: Optional[str] = None
+    """Web content snippet that can be embedded in a web page or an app webview."""
+
+    title: Optional[str] = None
+    """Title of the search result."""
+
+    url: Optional[str] = None
+    """URI reference of the search result."""

google/genai/_interactions/types/google_search_result_content.py

@@ -0,0 +1,43 @@
+# 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 List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .google_search_result import GoogleSearchResult
+
+__all__ = ["GoogleSearchResultContent"]
+
+
+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."""
+
+    is_error: Optional[bool] = None
+    """Whether the Google Search resulted in an error."""
+
+    result: Optional[List[GoogleSearchResult]] = None
+    """The results of the Google Search."""
+
+    signature: Optional[str] = None
+    """The signature of the Google Search result."""

google/genai/_interactions/types/google_search_result_content_param.py

@@ -0,0 +1,44 @@
+# 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 Iterable
+from typing_extensions import Literal, Required, TypedDict
+
+from .google_search_result_param import GoogleSearchResultParam
+
+__all__ = ["GoogleSearchResultContentParam"]
+
+
+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."""
+
+    is_error: bool
+    """Whether the Google Search resulted in an error."""
+
+    result: Iterable[GoogleSearchResultParam]
+    """The results of the Google Search."""
+
+    signature: str
+    """The signature of the Google Search result."""

google/genai/_interactions/types/google_search_result_param.py

@@ -0,0 +1,35 @@
+# 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 TypedDict
+
+__all__ = ["GoogleSearchResultParam"]
+
+
+class GoogleSearchResultParam(TypedDict, total=False):
+    """The result of the Google Search."""
+
+    rendered_content: str
+    """Web content snippet that can be embedded in a web page or an app webview."""
+
+    title: str
+    """Title of the search result."""
+
+    url: str
+    """URI reference of the search result."""

google/genai/_interactions/types/image_content.py

@@ -0,0 +1,41 @@
+# 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
+from .image_mime_type import ImageMimeType
+
+__all__ = ["ImageContent"]
+
+
+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
+    """The resolution of the media."""
+
+    uri: Optional[str] = None

google/genai/_interactions/types/image_content_param.py

@@ -0,0 +1,48 @@
+# 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, Required, Annotated, TypedDict
+
+from .._types import Base64FileInput
+from .._utils import PropertyInfo
+from .._models import set_pydantic_config
+from .image_mime_type_param import ImageMimeTypeParam
+
+__all__ = ["ImageContentParam"]
+
+
+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"]
+    """The resolution of the media."""
+
+    uri: str
+
+
+set_pydantic_config(ImageContentParam, {"arbitrary_types_allowed": True})

google/genai/_interactions/types/image_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__ = ["ImageMimeType"]
+
+ImageMimeType: TypeAlias = Union[Literal["image/png", "image/jpeg", "image/webp", "image/heic", "image/heif"], str]

google/genai/_interactions/types/image_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__ = ["ImageMimeTypeParam"]
+
+ImageMimeTypeParam: TypeAlias = Union[Literal["image/png", "image/jpeg", "image/webp", "image/heic", "image/heif"], str]

google/genai/_interactions/types/interaction.py

@@ -0,0 +1,165 @@
+# 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 List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from .turn import Turn
+from .model import Model
+from .usage import Usage
+from .._utils import PropertyInfo
+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 .dynamic_agent_config import DynamicAgentConfig
+from .function_call_content import FunctionCallContent
+from .function_result_content import FunctionResultContent
+from .url_context_call_content import URLContextCallContent
+from .deep_research_agent_config import DeepResearchAgentConfig
+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__ = ["Interaction", "AgentConfig", "Input", "InputContentList", "Output"]
+
+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[Turn],
+    TextContent,
+    ImageContent,
+    AudioContent,
+    DocumentContent,
+    VideoContent,
+    ThoughtContent,
+    FunctionCallContent,
+    FunctionResultContent,
+    CodeExecutionCallContent,
+    CodeExecutionResultContent,
+    URLContextCallContent,
+    URLContextResultContent,
+    GoogleSearchCallContent,
+    GoogleSearchResultContent,
+    MCPServerToolCallContent,
+    MCPServerToolResultContent,
+    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."""
+
+    id: str
+    """Output only. A unique identifier for the interaction completion."""
+
+    status: Literal["in_progress", "requires_action", "completed", "failed", "cancelled"]
+    """Output only. The status of the interaction."""
+
+    agent: Union[str, Literal["deep-research-pro-preview-12-2025"], None] = None
+    """The name of the `Agent` used for generating the interaction."""
+
+    created: Optional[datetime] = None
+    """Output only.
+
+    The time at which the response was created in ISO 8601 format
+    (YYYY-MM-DDThh:mm:ssZ).
+    """
+
+    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
+    """Output only. Responses from the model."""
+
+    previous_interaction_id: Optional[str] = None
+    """The ID of the previous interaction, if any."""
+
+    role: Optional[str] = None
+    """Output only. The role of the interaction."""
+
+    updated: Optional[datetime] = None
+    """Output only.
+
+    The time at which the response was last updated in ISO 8601 format
+    (YYYY-MM-DDThh:mm:ssZ).
+    """
+
+    usage: Optional[Usage] = None
+    """Output only. Statistics on the interaction request's token usage."""