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

google/genai/_interactions/types/dynamic_agent_config_param.py

@@ -0,0 +1,33 @@
+# 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
+from typing_extensions import Literal, TypeAlias, TypedDict
+
+__all__ = ["DynamicAgentConfigParam"]
+
+
+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/error_event.py

@@ -0,0 +1,46 @@
+# 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__ = ["ErrorEvent", "Error"]
+
+
+class Error(BaseModel):
+    """Error message from an interaction."""
+
+    code: Optional[str] = None
+    """A URI that identifies the error type."""
+
+    message: Optional[str] = None
+    """A human-readable error message."""
+
+
+class ErrorEvent(BaseModel):
+    error: Optional[Error] = None
+    """Error message from an interaction."""
+
+    event_id: Optional[str] = None
+    """
+    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_result_content.py

@@ -0,0 +1,46 @@
+# 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
+
+__all__ = ["FileSearchResultContent", "Result"]
+
+
+class Result(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 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

@@ -0,0 +1,46 @@
+# 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
+
+__all__ = ["FileSearchResultContentParam", "Result"]
+
+
+class Result(TypedDict, total=False):
+    """The result of the File Search."""
+
+    file_search_store: str
+    """The name of the file search store."""
+
+    text: str
+    """The text of the search result."""
+
+    title: str
+    """The title of the search result."""
+
+
+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.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 typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["Function"]
+
+
+class Function(BaseModel):
+    """A tool that can be used by the model."""
+
+    type: Literal["function"]
+
+    description: Optional[str] = None
+    """A description of the function."""
+
+    name: Optional[str] = None
+    """The name of the function."""
+
+    parameters: Optional[object] = None
+    """The JSON Schema for the function's parameters."""

google/genai/_interactions/types/function_call_content.py

@@ -0,0 +1,39 @@
+# 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
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["FunctionCallContent"]
+
+
+class FunctionCallContent(BaseModel):
+    """A function tool call content block."""
+
+    id: str
+    """A unique ID for this specific tool call."""
+
+    arguments: Dict[str, object]
+    """The arguments to pass to the function."""
+
+    name: str
+    """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

@@ -0,0 +1,39 @@
+# 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
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["FunctionCallContentParam"]
+
+
+class FunctionCallContentParam(TypedDict, total=False):
+    """A function tool call content block."""
+
+    id: Required[str]
+    """A unique ID for this specific tool call."""
+
+    arguments: Required[Dict[str, object]]
+    """The arguments to pass to the function."""
+
+    name: Required[str]
+    """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_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
+
+__all__ = ["FunctionParam"]
+
+
+class FunctionParam(TypedDict, total=False):
+    """A tool that can be used by the model."""
+
+    type: Required[Literal["function"]]
+
+    description: str
+    """A description of the function."""
+
+    name: str
+    """The name of the function."""
+
+    parameters: object
+    """The JSON Schema for the function's parameters."""

google/genai/_interactions/types/function_result_content.py

@@ -0,0 +1,52 @@
+# 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, TypeAlias
+
+from .._models import BaseModel
+from .image_content import ImageContent
+
+__all__ = ["FunctionResultContent", "Result", "ResultItems", "ResultItemsItem"]
+
+ResultItemsItem: TypeAlias = Union[str, ImageContent]
+
+
+class ResultItems(BaseModel):
+    items: Optional[List[ResultItemsItem]] = None
+
+
+Result: TypeAlias = Union[ResultItems, str, object]
+
+
+class FunctionResultContent(BaseModel):
+    """A function tool result content block."""
+
+    call_id: str
+    """ID to match the ID from the function call block."""
+
+    result: Result
+    """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."""
+
+    name: Optional[str] = None
+    """The name of the tool that was called."""

google/genai/_interactions/types/function_result_content_param.py

@@ -0,0 +1,54 @@
+# 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, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .image_content_param import ImageContentParam
+
+__all__ = ["FunctionResultContentParam", "Result", "ResultItems", "ResultItemsItem"]
+
+ResultItemsItem: TypeAlias = Union[str, ImageContentParam]
+
+
+class ResultItems(TypedDict, total=False):
+    items: SequenceNotStr[ResultItemsItem]
+
+
+Result: TypeAlias = Union[ResultItems, str, object]
+
+
+class FunctionResultContentParam(TypedDict, total=False):
+    """A function tool result content block."""
+
+    call_id: Required[str]
+    """ID to match the ID from the function call block."""
+
+    result: Required[Result]
+    """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."""
+
+    name: str
+    """The name of the tool that was called."""

google/genai/_interactions/types/generation_config.py

@@ -0,0 +1,57 @@
+# 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 .tool_choice import ToolChoice
+from .speech_config import SpeechConfig
+from .thinking_level import ThinkingLevel
+
+__all__ = ["GenerationConfig"]
+
+
+class GenerationConfig(BaseModel):
+    """Configuration parameters for model interactions."""
+
+    max_output_tokens: Optional[int] = None
+    """The maximum number of tokens to include in the response."""
+
+    seed: Optional[int] = None
+    """Seed used in decoding for reproducibility."""
+
+    speech_config: Optional[List[SpeechConfig]] = None
+    """Configuration for speech interaction."""
+
+    stop_sequences: Optional[List[str]] = None
+    """A list of character sequences that will stop output interaction."""
+
+    temperature: Optional[float] = None
+    """Controls the randomness of the output."""
+
+    thinking_level: Optional[ThinkingLevel] = None
+    """The level of thought tokens that the model should generate."""
+
+    thinking_summaries: Optional[Literal["auto", "none"]] = None
+    """Whether to include thought summaries in the response."""
+
+    tool_choice: Optional[ToolChoice] = None
+    """The tool choice for the interaction."""
+
+    top_p: Optional[float] = None
+    """The maximum cumulative probability of tokens to consider when sampling."""

google/genai/_interactions/types/generation_config_param.py

@@ -0,0 +1,59 @@
+# 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, TypedDict
+
+from .._types import SequenceNotStr
+from .thinking_level import ThinkingLevel
+from .tool_choice_param import ToolChoiceParam
+from .speech_config_param import SpeechConfigParam
+
+__all__ = ["GenerationConfigParam"]
+
+
+class GenerationConfigParam(TypedDict, total=False):
+    """Configuration parameters for model interactions."""
+
+    max_output_tokens: int
+    """The maximum number of tokens to include in the response."""
+
+    seed: int
+    """Seed used in decoding for reproducibility."""
+
+    speech_config: Iterable[SpeechConfigParam]
+    """Configuration for speech interaction."""
+
+    stop_sequences: SequenceNotStr[str]
+    """A list of character sequences that will stop output interaction."""
+
+    temperature: float
+    """Controls the randomness of the output."""
+
+    thinking_level: ThinkingLevel
+    """The level of thought tokens that the model should generate."""
+
+    thinking_summaries: Literal["auto", "none"]
+    """Whether to include thought summaries in the response."""
+
+    tool_choice: ToolChoiceParam
+    """The tool choice for the interaction."""
+
+    top_p: float
+    """The maximum cumulative probability of tokens to consider when sampling."""

google/genai/_interactions/types/google_search_call_arguments.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 typing import List, Optional
+
+from .._models import BaseModel
+
+__all__ = ["GoogleSearchCallArguments"]
+
+
+class GoogleSearchCallArguments(BaseModel):
+    """The arguments to pass to Google Search."""
+
+    queries: Optional[List[str]] = None
+    """Web search queries for the following-up web search."""

google/genai/_interactions/types/google_search_call_arguments_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 TypedDict
+
+from .._types import SequenceNotStr
+
+__all__ = ["GoogleSearchCallArgumentsParam"]
+
+
+class GoogleSearchCallArgumentsParam(TypedDict, total=False):
+    """The arguments to pass to Google Search."""
+
+    queries: SequenceNotStr[str]
+    """Web search queries for the following-up web search."""

google/genai/_interactions/types/google_search_call_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 .google_search_call_arguments import GoogleSearchCallArguments
+
+__all__ = ["GoogleSearchCallContent"]
+
+
+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."""
+
+    arguments: Optional[GoogleSearchCallArguments] = None
+    """The arguments to pass to Google Search."""