feat: Introduce Server Side tools deltas

PiperOrigin-RevId: 913995290

Author: IvanLH

google/genai/_interactions/types/__init__.py

@@ -57,11 +57,13 @@
 from .generation_config import GenerationConfig as GenerationConfig
 from .model_output_step import ModelOutputStep as ModelOutputStep
 from .function_call_step import FunctionCallStep as FunctionCallStep
+from .google_maps_result import GoogleMapsResult as GoogleMapsResult
 from .image_config_param import ImageConfigParam as ImageConfigParam
 from .text_content_param import TextContentParam as TextContentParam
 from .thought_step_param import ThoughtStepParam as ThoughtStepParam
 from .tool_choice_config import ToolChoiceConfig as ToolChoiceConfig
 from .url_citation_param import URLCitationParam as URLCitationParam
+from .url_context_result import URLContextResult as URLContextResult
 from .allowed_tools_param import AllowedToolsParam as AllowedToolsParam
 from .audio_content_param import AudioContentParam as AudioContentParam
 from .file_citation_param import FileCitationParam as FileCitationParam
@@ -72,6 +74,7 @@
 from .webhook_ping_params import WebhookPingParams as WebhookPingParams
 from .dynamic_agent_config import DynamicAgentConfig as DynamicAgentConfig
 from .function_result_step import FunctionResultStep as FunctionResultStep
+from .google_search_result import GoogleSearchResult as GoogleSearchResult
 from .place_citation_param import PlaceCitationParam as PlaceCitationParam
 from .text_response_format import TextResponseFormat as TextResponseFormat
 from .webhook_config_param import WebhookConfigParam as WebhookConfigParam
@@ -108,7 +111,9 @@
 from .deep_research_agent_config import DeepResearchAgentConfig as DeepResearchAgentConfig
 from .dynamic_agent_config_param import DynamicAgentConfigParam as DynamicAgentConfigParam
 from .function_result_step_param import FunctionResultStepParam as FunctionResultStepParam
+from .google_maps_call_arguments import GoogleMapsCallArguments as GoogleMapsCallArguments
 from .text_response_format_param import TextResponseFormatParam as TextResponseFormatParam
+from .url_context_call_arguments import URLContextCallArguments as URLContextCallArguments
 from .audio_response_format_param import AudioResponseFormatParam as AudioResponseFormatParam
 from .file_search_call_step_param import FileSearchCallStepParam as FileSearchCallStepParam
 from .google_maps_call_step_param import GoogleMapsCallStepParam as GoogleMapsCallStepParam
@@ -117,6 +122,8 @@
 from .mcp_server_tool_result_step import MCPServerToolResultStep as MCPServerToolResultStep
 from .url_context_call_step_param import URLContextCallStepParam as URLContextCallStepParam
 from .video_response_format_param import VideoResponseFormatParam as VideoResponseFormatParam
+from .google_search_call_arguments import GoogleSearchCallArguments as GoogleSearchCallArguments
+from .code_execution_call_arguments import CodeExecutionCallArguments as CodeExecutionCallArguments
 from .file_search_result_step_param import FileSearchResultStepParam as FileSearchResultStepParam
 from .google_maps_result_step_param import GoogleMapsResultStepParam as GoogleMapsResultStepParam
 from .google_search_call_step_param import GoogleSearchCallStepParam as GoogleSearchCallStepParam

google/genai/_interactions/types/code_execution_call_arguments.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 typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["CodeExecutionCallArguments"]
+
+
+class CodeExecutionCallArguments(BaseModel):
+    """The arguments to pass to the code execution."""
+
+    code: Optional[str] = None
+    """The code to be executed."""
+
+    language: Optional[Literal["python"]] = None
+    """Programming language of the `code`."""

google/genai/_interactions/types/google_maps_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__ = ["GoogleMapsCallArguments"]
+
+
+class GoogleMapsCallArguments(BaseModel):
+    """The arguments to pass to the Google Maps tool."""
+
+    queries: Optional[List[str]] = None
+    """The queries to be executed."""

google/genai/_interactions/types/google_maps_result.py

@@ -0,0 +1,65 @@
+# 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__ = ["GoogleMapsResult", "Place", "PlaceReviewSnippet"]
+
+
+class PlaceReviewSnippet(BaseModel):
+    """
+    Encapsulates a snippet of a user review that answers a question about
+    the features of a specific place in Google Maps.
+    """
+
+    review_id: Optional[str] = None
+    """The ID of the review snippet."""
+
+    title: Optional[str] = None
+    """Title of the review."""
+
+    url: Optional[str] = None
+    """A link that corresponds to the user review on Google Maps."""
+
+
+class Place(BaseModel):
+    name: Optional[str] = None
+    """Title of the place."""
+
+    place_id: Optional[str] = None
+    """The ID of the place, in `places/{place_id}` format."""
+
+    review_snippets: Optional[List[PlaceReviewSnippet]] = None
+    """
+    Snippets of reviews that are used to generate answers about the features of a
+    given place in Google Maps.
+    """
+
+    url: Optional[str] = None
+    """URI reference of the place."""
+
+
+class GoogleMapsResult(BaseModel):
+    """The result of the Google Maps."""
+
+    places: Optional[List[Place]] = None
+    """The places that were found."""
+
+    widget_context_token: Optional[str] = None
+    """Resource name of the Google Maps widget context token."""

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_result.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 Optional
+
+from .._models import BaseModel
+
+__all__ = ["GoogleSearchResult"]
+
+
+class GoogleSearchResult(BaseModel):
+    """The result of the Google Search."""
+
+    search_suggestions: Optional[str] = None
+    """Web content snippet that can be embedded in a web page or an app webview."""