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

google/genai/_interactions/types/speech_config_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__ = ["SpeechConfigParam"]
+
+
+class SpeechConfigParam(TypedDict, total=False):
+    """The configuration for speech interaction."""
+
+    language: str
+    """The language of the speech."""
+
+    speaker: str
+    """The speaker's name, it should match the speaker name given in the prompt."""
+
+    voice: str
+    """The voice of the speaker."""

google/genai/_interactions/types/text_content.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 typing import List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .annotation import Annotation
+
+__all__ = ["TextContent"]
+
+
+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."""
+
+    text: Optional[str] = None
+    """The text content."""

google/genai/_interactions/types/text_content_param.py

@@ -0,0 +1,38 @@
+# 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 .annotation_param import AnnotationParam
+
+__all__ = ["TextContentParam"]
+
+
+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."""
+
+    text: str
+    """The text content."""

google/genai/_interactions/types/thinking_level.py

@@ -0,0 +1,22 @@
+# 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_extensions import Literal, TypeAlias
+
+__all__ = ["ThinkingLevel"]
+
+ThinkingLevel: TypeAlias = Literal["low", "high"]

google/genai/_interactions/types/thought_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 List, Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .text_content import TextContent
+from .image_content import ImageContent
+
+__all__ = ["ThoughtContent", "Summary"]
+
+Summary: TypeAlias = Annotated[Union[TextContent, ImageContent], PropertyInfo(discriminator="type")]
+
+
+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."""
+
+    summary: Optional[List[Summary]] = None
+    """A summary of the thought."""

google/genai/_interactions/types/thought_content_param.py

@@ -0,0 +1,47 @@
+# 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, Iterable
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from .._types import Base64FileInput
+from .._utils import PropertyInfo
+from .._models import set_pydantic_config
+from .text_content_param import TextContentParam
+from .image_content_param import ImageContentParam
+
+__all__ = ["ThoughtContentParam", "Summary"]
+
+Summary: TypeAlias = Union[TextContentParam, ImageContentParam]
+
+
+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."""
+
+    summary: Iterable[Summary]
+    """A summary of the thought."""
+
+
+set_pydantic_config(ThoughtContentParam, {"arbitrary_types_allowed": True})

google/genai/_interactions/types/tool.py

@@ -0,0 +1,100 @@
+# 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 Dict, List, Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from pydantic import Field as FieldInfo
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .function import Function
+from .allowed_tools import AllowedTools
+
+__all__ = ["Tool", "GoogleSearch", "CodeExecution", "URLContext", "ComputerUse", "MCPServer", "FileSearch"]
+
+
+class GoogleSearch(BaseModel):
+    """A tool that can be used by the model to search Google."""
+
+    type: Literal["google_search"]
+
+
+class CodeExecution(BaseModel):
+    """A tool that can be used by the model to execute code."""
+
+    type: Literal["code_execution"]
+
+
+class URLContext(BaseModel):
+    """A tool that can be used by the model to fetch URL context."""
+
+    type: Literal["url_context"]
+
+
+class ComputerUse(BaseModel):
+    """A tool that can be used by the model to interact with the computer."""
+
+    type: Literal["computer_use"]
+
+    environment: Optional[Literal["browser"]] = None
+    """The environment being operated."""
+
+    excluded_predefined_functions: Optional[List[str]] = FieldInfo(alias="excludedPredefinedFunctions", default=None)
+    """The list of predefined functions that are excluded from the model call."""
+
+
+class MCPServer(BaseModel):
+    """A MCPServer is a server that can be called by the model to perform actions."""
+
+    type: Literal["mcp_server"]
+
+    allowed_tools: Optional[List[AllowedTools]] = None
+    """The allowed tools."""
+
+    headers: Optional[Dict[str, str]] = None
+    """Optional: Fields for authentication headers, timeouts, etc., if needed."""
+
+    name: Optional[str] = None
+    """The name of the MCPServer."""
+
+    url: Optional[str] = None
+    """
+    The full URL for the MCPServer endpoint.
+    Example: "https://api.example.com/mcp"
+    """
+
+
+class FileSearch(BaseModel):
+    """A tool that can be used by the model to search files."""
+
+    type: Literal["file_search"]
+
+    file_search_store_names: Optional[List[str]] = None
+    """The file search store names to search."""
+
+    metadata_filter: Optional[str] = None
+    """Metadata filter to apply to the semantic retrieval documents and chunks."""
+
+    top_k: Optional[int] = None
+    """The number of semantic retrieval chunks to retrieve."""
+
+
+Tool: TypeAlias = Annotated[
+    Union[Function, GoogleSearch, CodeExecution, URLContext, ComputerUse, MCPServer, FileSearch],
+    PropertyInfo(discriminator="type"),
+]

google/genai/_interactions/types/tool_choice.py

@@ -0,0 +1,26 @@
+# 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 TypeAlias
+
+from .tool_choice_type import ToolChoiceType
+from .tool_choice_config import ToolChoiceConfig
+
+__all__ = ["ToolChoice"]
+
+ToolChoice: TypeAlias = Union[ToolChoiceType, ToolChoiceConfig]

google/genai/_interactions/types/tool_choice_config.py

@@ -0,0 +1,28 @@
+# 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
+from .allowed_tools import AllowedTools
+
+__all__ = ["ToolChoiceConfig"]
+
+
+class ToolChoiceConfig(BaseModel):
+    allowed_tools: Optional[AllowedTools] = None
+    """The configuration for allowed tools."""

google/genai/_interactions/types/tool_choice_config_param.py

@@ -0,0 +1,29 @@
+# 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
+
+from .allowed_tools_param import AllowedToolsParam
+
+__all__ = ["ToolChoiceConfigParam"]
+
+
+class ToolChoiceConfigParam(TypedDict, total=False):
+    allowed_tools: AllowedToolsParam
+    """The configuration for allowed tools."""

google/genai/_interactions/types/tool_choice_param.py

@@ -0,0 +1,28 @@
+# 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 TypeAlias
+
+from .tool_choice_type import ToolChoiceType
+from .tool_choice_config_param import ToolChoiceConfigParam
+
+__all__ = ["ToolChoiceParam"]
+
+ToolChoiceParam: TypeAlias = Union[ToolChoiceType, ToolChoiceConfigParam]

google/genai/_interactions/types/tool_choice_type.py

@@ -0,0 +1,22 @@
+# 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_extensions import Literal, TypeAlias
+
+__all__ = ["ToolChoiceType"]
+
+ToolChoiceType: TypeAlias = Literal["auto", "any", "none", "validated"]

google/genai/_interactions/types/tool_param.py

@@ -0,0 +1,97 @@
+# 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 Dict, Union, Iterable
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+from .function_param import FunctionParam
+from .allowed_tools_param import AllowedToolsParam
+
+__all__ = ["ToolParam", "GoogleSearch", "CodeExecution", "URLContext", "ComputerUse", "MCPServer", "FileSearch"]
+
+
+class GoogleSearch(TypedDict, total=False):
+    """A tool that can be used by the model to search Google."""
+
+    type: Required[Literal["google_search"]]
+
+
+class CodeExecution(TypedDict, total=False):
+    """A tool that can be used by the model to execute code."""
+
+    type: Required[Literal["code_execution"]]
+
+
+class URLContext(TypedDict, total=False):
+    """A tool that can be used by the model to fetch URL context."""
+
+    type: Required[Literal["url_context"]]
+
+
+class ComputerUse(TypedDict, total=False):
+    """A tool that can be used by the model to interact with the computer."""
+
+    type: Required[Literal["computer_use"]]
+
+    environment: Literal["browser"]
+    """The environment being operated."""
+
+    excluded_predefined_functions: Annotated[SequenceNotStr[str], PropertyInfo(alias="excludedPredefinedFunctions")]
+    """The list of predefined functions that are excluded from the model call."""
+
+
+class MCPServer(TypedDict, total=False):
+    """A MCPServer is a server that can be called by the model to perform actions."""
+
+    type: Required[Literal["mcp_server"]]
+
+    allowed_tools: Iterable[AllowedToolsParam]
+    """The allowed tools."""
+
+    headers: Dict[str, str]
+    """Optional: Fields for authentication headers, timeouts, etc., if needed."""
+
+    name: str
+    """The name of the MCPServer."""
+
+    url: str
+    """
+    The full URL for the MCPServer endpoint.
+    Example: "https://api.example.com/mcp"
+    """
+
+
+class FileSearch(TypedDict, total=False):
+    """A tool that can be used by the model to search files."""
+
+    type: Required[Literal["file_search"]]
+
+    file_search_store_names: SequenceNotStr[str]
+    """The file search store names to search."""
+
+    metadata_filter: str
+    """Metadata filter to apply to the semantic retrieval documents and chunks."""
+
+    top_k: int
+    """The number of semantic retrieval chunks to retrieve."""
+
+
+ToolParam: TypeAlias = Union[FunctionParam, GoogleSearch, CodeExecution, URLContext, ComputerUse, MCPServer, FileSearch]

google/genai/_interactions/types/turn.py

@@ -0,0 +1,76 @@
+# 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 typing_extensions import Annotated, TypeAlias
+
+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 .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"),
+]
+
+
+class Turn(BaseModel):
+    content: Union[str, List[ContentUnionMember1], None] = None
+    """The content of the turn."""
+
+    role: Optional[str] = None
+    """The originator of this turn.
+
+    Must be user for input or model for
+    model output.
+    """