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

google/genai/_interactions/types/content_delta.py

@@ -0,0 +1,342 @@
+# 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 .._utils import PropertyInfo
+from .._models import BaseModel
+from .annotation import Annotation
+from .text_content import TextContent
+from .image_content import ImageContent
+from .audio_mime_type import AudioMimeType
+from .image_mime_type import ImageMimeType
+from .video_mime_type import VideoMimeType
+from .document_mime_type import DocumentMimeType
+from .url_context_result import URLContextResult
+from .google_search_result import GoogleSearchResult
+from .url_context_call_arguments import URLContextCallArguments
+from .google_search_call_arguments import GoogleSearchCallArguments
+from .code_execution_call_arguments import CodeExecutionCallArguments
+
+__all__ = [
+    "ContentDelta",
+    "Delta",
+    "DeltaTextDelta",
+    "DeltaImageDelta",
+    "DeltaAudioDelta",
+    "DeltaDocumentDelta",
+    "DeltaVideoDelta",
+    "DeltaThoughtSummaryDelta",
+    "DeltaThoughtSummaryDeltaContent",
+    "DeltaThoughtSignatureDelta",
+    "DeltaFunctionCallDelta",
+    "DeltaFunctionResultDelta",
+    "DeltaFunctionResultDeltaResult",
+    "DeltaFunctionResultDeltaResultItems",
+    "DeltaFunctionResultDeltaResultItemsItem",
+    "DeltaCodeExecutionCallDelta",
+    "DeltaCodeExecutionResultDelta",
+    "DeltaURLContextCallDelta",
+    "DeltaURLContextResultDelta",
+    "DeltaGoogleSearchCallDelta",
+    "DeltaGoogleSearchResultDelta",
+    "DeltaMCPServerToolCallDelta",
+    "DeltaMCPServerToolResultDelta",
+    "DeltaMCPServerToolResultDeltaResult",
+    "DeltaMCPServerToolResultDeltaResultItems",
+    "DeltaMCPServerToolResultDeltaResultItemsItem",
+    "DeltaFileSearchResultDelta",
+    "DeltaFileSearchResultDeltaResult",
+]
+
+
+class DeltaTextDelta(BaseModel):
+    type: Literal["text"]
+
+    annotations: Optional[List[Annotation]] = None
+    """Citation information for model-generated content."""
+
+    text: Optional[str] = None
+
+
+class DeltaImageDelta(BaseModel):
+    type: Literal["image"]
+
+    data: Optional[str] = None
+
+    mime_type: Optional[ImageMimeType] = None
+    """The mime type of the image."""
+
+    resolution: Optional[Literal["low", "medium", "high", "ultra_high"]] = None
+    """The resolution of the media."""
+
+    uri: Optional[str] = None
+
+
+class DeltaAudioDelta(BaseModel):
+    type: Literal["audio"]
+
+    data: Optional[str] = None
+
+    mime_type: Optional[AudioMimeType] = None
+    """The mime type of the audio."""
+
+    uri: Optional[str] = None
+
+
+class DeltaDocumentDelta(BaseModel):
+    type: Literal["document"]
+
+    data: Optional[str] = None
+
+    mime_type: Optional[DocumentMimeType] = None
+    """The mime type of the document."""
+
+    uri: Optional[str] = None
+
+
+class DeltaVideoDelta(BaseModel):
+    type: Literal["video"]
+
+    data: Optional[str] = None
+
+    mime_type: Optional[VideoMimeType] = None
+    """The mime type of the video."""
+
+    resolution: Optional[Literal["low", "medium", "high", "ultra_high"]] = None
+    """The resolution of the media."""
+
+    uri: Optional[str] = None
+
+
+DeltaThoughtSummaryDeltaContent: TypeAlias = Annotated[
+    Union[TextContent, ImageContent], PropertyInfo(discriminator="type")
+]
+
+
+class DeltaThoughtSummaryDelta(BaseModel):
+    type: Literal["thought_summary"]
+
+    content: Optional[DeltaThoughtSummaryDeltaContent] = None
+    """A text content block."""
+
+
+class DeltaThoughtSignatureDelta(BaseModel):
+    type: Literal["thought_signature"]
+
+    signature: Optional[str] = None
+    """Signature to match the backend source to be part of the generation."""
+
+
+class DeltaFunctionCallDelta(BaseModel):
+    type: Literal["function_call"]
+
+    id: Optional[str] = None
+    """A unique ID for this specific tool call."""
+
+    arguments: Optional[Dict[str, object]] = None
+
+    name: Optional[str] = None
+
+
+DeltaFunctionResultDeltaResultItemsItem: TypeAlias = Union[str, ImageContent, object]
+
+
+class DeltaFunctionResultDeltaResultItems(BaseModel):
+    items: Optional[List[DeltaFunctionResultDeltaResultItemsItem]] = None
+
+
+DeltaFunctionResultDeltaResult: TypeAlias = Union[DeltaFunctionResultDeltaResultItems, str]
+
+
+class DeltaFunctionResultDelta(BaseModel):
+    type: Literal["function_result"]
+
+    call_id: Optional[str] = None
+    """ID to match the ID from the function call block."""
+
+    is_error: Optional[bool] = None
+
+    name: Optional[str] = None
+
+    result: Optional[DeltaFunctionResultDeltaResult] = None
+    """Tool call result delta."""
+
+
+class DeltaCodeExecutionCallDelta(BaseModel):
+    type: Literal["code_execution_call"]
+
+    id: Optional[str] = None
+    """A unique ID for this specific tool call."""
+
+    arguments: Optional[CodeExecutionCallArguments] = None
+    """The arguments to pass to the code execution."""
+
+
+class DeltaCodeExecutionResultDelta(BaseModel):
+    type: Literal["code_execution_result"]
+
+    call_id: Optional[str] = None
+    """ID to match the ID from the function call block."""
+
+    is_error: Optional[bool] = None
+
+    result: Optional[str] = None
+
+    signature: Optional[str] = None
+
+
+class DeltaURLContextCallDelta(BaseModel):
+    type: Literal["url_context_call"]
+
+    id: Optional[str] = None
+    """A unique ID for this specific tool call."""
+
+    arguments: Optional[URLContextCallArguments] = None
+    """The arguments to pass to the URL context."""
+
+
+class DeltaURLContextResultDelta(BaseModel):
+    type: Literal["url_context_result"]
+
+    call_id: Optional[str] = None
+    """ID to match the ID from the function call block."""
+
+    is_error: Optional[bool] = None
+
+    result: Optional[List[URLContextResult]] = None
+
+    signature: Optional[str] = None
+
+
+class DeltaGoogleSearchCallDelta(BaseModel):
+    type: Literal["google_search_call"]
+
+    id: Optional[str] = None
+    """A unique ID for this specific tool call."""
+
+    arguments: Optional[GoogleSearchCallArguments] = None
+    """The arguments to pass to Google Search."""
+
+
+class DeltaGoogleSearchResultDelta(BaseModel):
+    type: Literal["google_search_result"]
+
+    call_id: Optional[str] = None
+    """ID to match the ID from the function call block."""
+
+    is_error: Optional[bool] = None
+
+    result: Optional[List[GoogleSearchResult]] = None
+
+    signature: Optional[str] = None
+
+
+class DeltaMCPServerToolCallDelta(BaseModel):
+    type: Literal["mcp_server_tool_call"]
+
+    id: Optional[str] = None
+    """A unique ID for this specific tool call."""
+
+    arguments: Optional[Dict[str, object]] = None
+
+    name: Optional[str] = None
+
+    server_name: Optional[str] = None
+
+
+DeltaMCPServerToolResultDeltaResultItemsItem: TypeAlias = Union[str, ImageContent, object]
+
+
+class DeltaMCPServerToolResultDeltaResultItems(BaseModel):
+    items: Optional[List[DeltaMCPServerToolResultDeltaResultItemsItem]] = None
+
+
+DeltaMCPServerToolResultDeltaResult: TypeAlias = Union[DeltaMCPServerToolResultDeltaResultItems, str]
+
+
+class DeltaMCPServerToolResultDelta(BaseModel):
+    type: Literal["mcp_server_tool_result"]
+
+    call_id: Optional[str] = None
+    """ID to match the ID from the function call block."""
+
+    name: Optional[str] = None
+
+    result: Optional[DeltaMCPServerToolResultDeltaResult] = None
+    """Tool call result delta."""
+
+    server_name: Optional[str] = None
+
+
+class DeltaFileSearchResultDeltaResult(BaseModel):
+    """The result of the File Search."""
+
+    file_search_store: Optional[str] = None
+    """The name of the file search store."""
+
+    text: Optional[str] = None
+    """The text of the search result."""
+
+    title: Optional[str] = None
+    """The title of the search result."""
+
+
+class DeltaFileSearchResultDelta(BaseModel):
+    type: Literal["file_search_result"]
+
+    result: Optional[List[DeltaFileSearchResultDeltaResult]] = None
+
+
+Delta: TypeAlias = Annotated[
+    Union[
+        DeltaTextDelta,
+        DeltaImageDelta,
+        DeltaAudioDelta,
+        DeltaDocumentDelta,
+        DeltaVideoDelta,
+        DeltaThoughtSummaryDelta,
+        DeltaThoughtSignatureDelta,
+        DeltaFunctionCallDelta,
+        DeltaFunctionResultDelta,
+        DeltaCodeExecutionCallDelta,
+        DeltaCodeExecutionResultDelta,
+        DeltaURLContextCallDelta,
+        DeltaURLContextResultDelta,
+        DeltaGoogleSearchCallDelta,
+        DeltaGoogleSearchResultDelta,
+        DeltaMCPServerToolCallDelta,
+        DeltaMCPServerToolResultDelta,
+        DeltaFileSearchResultDelta,
+    ],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ContentDelta(BaseModel):
+    delta: Optional[Delta] = None
+
+    event_id: Optional[str] = None
+    """
+    The event_id token to be used to resume the interaction stream, from
+    this event.
+    """
+
+    event_type: Optional[Literal["content.delta"]] = None
+
+    index: Optional[int] = None

google/genai/_interactions/types/content_start.py

@@ -0,0 +1,79 @@
+# 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, Optional
+from typing_extensions import Literal, 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__ = ["ContentStart", "Content"]
+
+Content: TypeAlias = Annotated[
+    Union[
+        TextContent,
+        ImageContent,
+        AudioContent,
+        DocumentContent,
+        VideoContent,
+        ThoughtContent,
+        FunctionCallContent,
+        FunctionResultContent,
+        CodeExecutionCallContent,
+        CodeExecutionResultContent,
+        URLContextCallContent,
+        URLContextResultContent,
+        GoogleSearchCallContent,
+        GoogleSearchResultContent,
+        MCPServerToolCallContent,
+        MCPServerToolResultContent,
+        FileSearchResultContent,
+    ],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ContentStart(BaseModel):
+    content: Optional[Content] = None
+    """The content of the response."""
+
+    event_id: Optional[str] = None
+    """
+    The event_id token to be used to resume the interaction stream, from
+    this event.
+    """
+
+    event_type: Optional[Literal["content.start"]] = None
+
+    index: Optional[int] = None

google/genai/_interactions/types/content_stop.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 typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["ContentStop"]
+
+
+class ContentStop(BaseModel):
+    event_id: Optional[str] = None
+    """
+    The event_id token to be used to resume the interaction stream, from
+    this event.
+    """
+
+    event_type: Optional[Literal["content.stop"]] = None
+
+    index: Optional[int] = None

google/genai/_interactions/types/deep_research_agent_config.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__ = ["DeepResearchAgentConfig"]
+
+
+class DeepResearchAgentConfig(BaseModel):
+    """Configuration for the Deep Research agent."""
+
+    thinking_summaries: Optional[Literal["auto", "none"]] = None
+    """Whether to include thought summaries in the response."""
+
+    type: Optional[Literal["deep-research"]] = None

google/genai/_interactions/types/deep_research_agent_config_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, TypedDict
+
+__all__ = ["DeepResearchAgentConfigParam"]
+
+
+class DeepResearchAgentConfigParam(TypedDict, total=False):
+    """Configuration for the Deep Research agent."""
+
+    thinking_summaries: Literal["auto", "none"]
+    """Whether to include thought summaries in the response."""
+
+    type: Literal["deep-research"]

google/genai/_interactions/types/document_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 Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .document_mime_type import DocumentMimeType
+
+__all__ = ["DocumentContent"]
+
+
+class DocumentContent(BaseModel):
+    """A document content block."""
+
+    type: Literal["document"]
+
+    data: Optional[str] = None
+
+    mime_type: Optional[DocumentMimeType] = None
+    """The mime type of the document."""
+
+    uri: Optional[str] = None

google/genai/_interactions/types/document_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 Union
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from .._types import Base64FileInput
+from .._utils import PropertyInfo
+from .._models import set_pydantic_config
+from .document_mime_type_param import DocumentMimeTypeParam
+
+__all__ = ["DocumentContentParam"]
+
+
+class DocumentContentParam(TypedDict, total=False):
+    """A document content block."""
+
+    type: Required[Literal["document"]]
+
+    data: Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]
+
+    mime_type: DocumentMimeTypeParam
+    """The mime type of the document."""
+
+    uri: str
+
+
+set_pydantic_config(DocumentContentParam, {"arbitrary_types_allowed": True})

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

@@ -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 TYPE_CHECKING, Dict, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["DynamicAgentConfig"]
+
+
+class DynamicAgentConfig(BaseModel):
+    """Configuration for dynamic agents."""
+
+    type: Optional[Literal["dynamic"]] = None
+
+    if TYPE_CHECKING:
+        # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a
+        # value to this field, so for compatibility we avoid doing it at runtime.
+        __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
+
+        # Stub to indicate that arbitrary properties are accepted.
+        # To access properties that are not valid identifiers you can use `getattr`, e.g.
+        # `getattr(obj, '$type')`
+        def __getattr__(self, attr: str) -> object: ...
+    else:
+        __pydantic_extra__: Dict[str, object]