Skip to content

feat: Introduce Server Side tools deltas #2409

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
copybara-service wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: Introduce Server Side tools deltas #2409

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
191 changes: 99 additions & 92 deletions google/genai/_interactions/types/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,117 +17,124 @@

from __future__ import annotations

from .step import Step as Step
from .tool import Tool as Tool
from .model import Model as Model
from .usage import Usage as Usage
from .content import Content as Content
from .webhook import Webhook as Webhook
from .function import Function as Function
from .step_stop import StepStop as StepStop
from .annotation import Annotation as Annotation
from .step_delta import StepDelta as StepDelta
from .step_param import StepParam as StepParam
from .step_start import StepStart as StepStart
from .tool_param import ToolParam as ToolParam
from .error_event import ErrorEvent as ErrorEvent
from .interaction import Interaction as Interaction
from .model_param import ModelParam as ModelParam
from .usage_param import UsageParam as UsageParam
from .image_config import ImageConfig as ImageConfig
from .text_content import TextContent as TextContent
from .thought_step import ThoughtStep as ThoughtStep
from .url_citation import URLCitation as URLCitation
from .allowed_tools import AllowedTools as AllowedTools
from .allowed_tools_param import AllowedToolsParam as AllowedToolsParam
from .annotation import Annotation as Annotation
from .annotation_param import AnnotationParam as AnnotationParam
from .audio_content import AudioContent as AudioContent
from .audio_content_param import AudioContentParam as AudioContentParam
from .audio_response_format import AudioResponseFormat as AudioResponseFormat
from .audio_response_format_param import AudioResponseFormatParam as AudioResponseFormatParam
from .code_execution_call_arguments import CodeExecutionCallArguments as CodeExecutionCallArguments
from .code_execution_call_step import CodeExecutionCallStep as CodeExecutionCallStep
from .code_execution_call_step_param import CodeExecutionCallStepParam as CodeExecutionCallStepParam
from .code_execution_result_step import CodeExecutionResultStep as CodeExecutionResultStep
from .code_execution_result_step_param import CodeExecutionResultStepParam as CodeExecutionResultStepParam
from .content import Content as Content
from .content_param import ContentParam as ContentParam
from .file_citation import FileCitation as FileCitation
from .image_content import ImageContent as ImageContent
from .speech_config import SpeechConfig as SpeechConfig
from .video_content import VideoContent as VideoContent
from .function_param import FunctionParam as FunctionParam
from .place_citation import PlaceCitation as PlaceCitation
from .signing_secret import SigningSecret as SigningSecret
from .thinking_level import ThinkingLevel as ThinkingLevel
from .webhook_config import WebhookConfig as WebhookConfig
from .user_input_step import UserInputStep as UserInputStep
from .annotation_param import AnnotationParam as AnnotationParam
from .deep_research_agent_config import DeepResearchAgentConfig as DeepResearchAgentConfig
from .deep_research_agent_config_param import DeepResearchAgentConfigParam as DeepResearchAgentConfigParam
from .document_content import DocumentContent as DocumentContent
from .tool_choice_type import ToolChoiceType as ToolChoiceType
from .generation_config import GenerationConfig as GenerationConfig
from .model_output_step import ModelOutputStep as ModelOutputStep
from .function_call_step import FunctionCallStep as FunctionCallStep
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 .allowed_tools_param import AllowedToolsParam as AllowedToolsParam
from .audio_content_param import AudioContentParam as AudioContentParam
from .file_citation_param import FileCitationParam as FileCitationParam
from .image_content_param import ImageContentParam as ImageContentParam
from .speech_config_param import SpeechConfigParam as SpeechConfigParam
from .video_content_param import VideoContentParam as VideoContentParam
from .webhook_list_params import WebhookListParams as WebhookListParams
from .webhook_ping_params import WebhookPingParams as WebhookPingParams
from .document_content_param import DocumentContentParam as DocumentContentParam
from .dynamic_agent_config import DynamicAgentConfig as DynamicAgentConfig
from .function_result_step import FunctionResultStep as FunctionResultStep
from .place_citation_param import PlaceCitationParam as PlaceCitationParam
from .text_response_format import TextResponseFormat as TextResponseFormat
from .webhook_config_param import WebhookConfigParam as WebhookConfigParam
from .audio_response_format import AudioResponseFormat as AudioResponseFormat
from .dynamic_agent_config_param import DynamicAgentConfigParam as DynamicAgentConfigParam
from .error_event import ErrorEvent as ErrorEvent
from .file_citation import FileCitation as FileCitation
from .file_citation_param import FileCitationParam as FileCitationParam
from .file_search_call_step import FileSearchCallStep as FileSearchCallStep
from .google_maps_call_step import GoogleMapsCallStep as GoogleMapsCallStep
from .image_response_format import ImageResponseFormat as ImageResponseFormat
from .interaction_sse_event import InteractionSSEEvent as InteractionSSEEvent
from .url_context_call_step import URLContextCallStep as URLContextCallStep
from .user_input_step_param import UserInputStepParam as UserInputStepParam
from .video_response_format import VideoResponseFormat as VideoResponseFormat
from .webhook_create_params import WebhookCreateParams as WebhookCreateParams
from .webhook_list_response import WebhookListResponse as WebhookListResponse
from .webhook_ping_response import WebhookPingResponse as WebhookPingResponse
from .webhook_update_params import WebhookUpdateParams as WebhookUpdateParams
from .document_content_param import DocumentContentParam as DocumentContentParam
from .interaction_get_params import InteractionGetParams as InteractionGetParams
from .file_search_call_step_param import FileSearchCallStepParam as FileSearchCallStepParam
from .file_search_result_step import FileSearchResultStep as FileSearchResultStep
from .file_search_result_step_param import FileSearchResultStepParam as FileSearchResultStepParam
from .function import Function as Function
from .function_call_step import FunctionCallStep as FunctionCallStep
from .function_call_step_param import FunctionCallStepParam as FunctionCallStepParam
from .function_param import FunctionParam as FunctionParam
from .function_result_step import FunctionResultStep as FunctionResultStep
from .function_result_step_param import FunctionResultStepParam as FunctionResultStepParam
from .generation_config import GenerationConfig as GenerationConfig
from .generation_config_param import GenerationConfigParam as GenerationConfigParam
from .google_maps_call_arguments import GoogleMapsCallArguments as GoogleMapsCallArguments
from .google_maps_call_step import GoogleMapsCallStep as GoogleMapsCallStep
from .google_maps_call_step_param import GoogleMapsCallStepParam as GoogleMapsCallStepParam
from .google_maps_result import GoogleMapsResult as GoogleMapsResult
from .google_maps_result_step import GoogleMapsResultStep as GoogleMapsResultStep
from .google_maps_result_step_param import GoogleMapsResultStepParam as GoogleMapsResultStepParam
from .google_search_call_arguments import GoogleSearchCallArguments as GoogleSearchCallArguments
from .google_search_call_step import GoogleSearchCallStep as GoogleSearchCallStep
from .model_output_step_param import ModelOutputStepParam as ModelOutputStepParam
from .url_context_result_step import URLContextResultStep as URLContextResultStep
from .webhook_delete_response import WebhookDeleteResponse as WebhookDeleteResponse
from .code_execution_call_step import CodeExecutionCallStep as CodeExecutionCallStep
from .function_call_step_param import FunctionCallStepParam as FunctionCallStepParam
from .tool_choice_config_param import ToolChoiceConfigParam as ToolChoiceConfigParam
from .google_search_call_step_param import GoogleSearchCallStepParam as GoogleSearchCallStepParam
from .google_search_result import GoogleSearchResult as GoogleSearchResult
from .google_search_result_step import GoogleSearchResultStep as GoogleSearchResultStep
from .google_search_result_step_param import GoogleSearchResultStepParam as GoogleSearchResultStepParam
from .image_config import ImageConfig as ImageConfig
from .image_config_param import ImageConfigParam as ImageConfigParam
from .image_content import ImageContent as ImageContent
from .image_content_param import ImageContentParam as ImageContentParam
from .image_response_format import ImageResponseFormat as ImageResponseFormat
from .image_response_format_param import ImageResponseFormatParam as ImageResponseFormatParam
from .interaction import Interaction as Interaction
from .interaction_completed_event import InteractionCompletedEvent as InteractionCompletedEvent
from .interaction_create_params import InteractionCreateParams as InteractionCreateParams
from .interaction_created_event import InteractionCreatedEvent as InteractionCreatedEvent
from .interaction_get_params import InteractionGetParams as InteractionGetParams
from .interaction_sse_event import InteractionSSEEvent as InteractionSSEEvent
from .interaction_status_update import InteractionStatusUpdate as InteractionStatusUpdate
from .mcp_server_tool_call_step import MCPServerToolCallStep as MCPServerToolCallStep
from .code_execution_result_step import CodeExecutionResultStep as CodeExecutionResultStep
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 .text_response_format_param import TextResponseFormatParam as TextResponseFormatParam
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
from .image_response_format_param import ImageResponseFormatParam as ImageResponseFormatParam
from .interaction_completed_event import InteractionCompletedEvent as InteractionCompletedEvent
from .mcp_server_tool_call_step_param import MCPServerToolCallStepParam as MCPServerToolCallStepParam
from .mcp_server_tool_result_step import MCPServerToolResultStep as MCPServerToolResultStep
from .mcp_server_tool_result_step_param import MCPServerToolResultStepParam as MCPServerToolResultStepParam
from .model import Model as Model
from .model_output_step import ModelOutputStep as ModelOutputStep
from .model_output_step_param import ModelOutputStepParam as ModelOutputStepParam
from .model_param import ModelParam as ModelParam
from .place_citation import PlaceCitation as PlaceCitation
from .place_citation_param import PlaceCitationParam as PlaceCitationParam
from .signing_secret import SigningSecret as SigningSecret
from .speech_config import SpeechConfig as SpeechConfig
from .speech_config_param import SpeechConfigParam as SpeechConfigParam
from .step import Step as Step
from .step_delta import StepDelta as StepDelta
from .step_param import StepParam as StepParam
from .step_start import StepStart as StepStart
from .step_stop import StepStop as StepStop
from .text_content import TextContent as TextContent
from .text_content_param import TextContentParam as TextContentParam
from .text_response_format import TextResponseFormat as TextResponseFormat
from .text_response_format_param import TextResponseFormatParam as TextResponseFormatParam
from .thinking_level import ThinkingLevel as ThinkingLevel
from .thought_step import ThoughtStep as ThoughtStep
from .thought_step_param import ThoughtStepParam as ThoughtStepParam
from .tool import Tool as Tool
from .tool_choice_config import ToolChoiceConfig as ToolChoiceConfig
from .tool_choice_config_param import ToolChoiceConfigParam as ToolChoiceConfigParam
from .tool_choice_type import ToolChoiceType as ToolChoiceType
from .tool_param import ToolParam as ToolParam
from .url_citation import URLCitation as URLCitation
from .url_citation_param import URLCitationParam as URLCitationParam
from .url_context_call_arguments import URLContextCallArguments as URLContextCallArguments
from .url_context_call_step import URLContextCallStep as URLContextCallStep
from .url_context_call_step_param import URLContextCallStepParam as URLContextCallStepParam
from .video_response_format_param import VideoResponseFormatParam as VideoResponseFormatParam
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
from .url_context_result import URLContextResult as URLContextResult
from .url_context_result_step import URLContextResultStep as URLContextResultStep
from .url_context_result_step_param import URLContextResultStepParam as URLContextResultStepParam
from .code_execution_call_step_param import CodeExecutionCallStepParam as CodeExecutionCallStepParam
from .google_search_result_step_param import GoogleSearchResultStepParam as GoogleSearchResultStepParam
from .mcp_server_tool_call_step_param import MCPServerToolCallStepParam as MCPServerToolCallStepParam
from .code_execution_result_step_param import CodeExecutionResultStepParam as CodeExecutionResultStepParam
from .deep_research_agent_config_param import DeepResearchAgentConfigParam as DeepResearchAgentConfigParam
from .mcp_server_tool_result_step_param import MCPServerToolResultStepParam as MCPServerToolResultStepParam
from .usage import Usage as Usage
from .usage_param import UsageParam as UsageParam
from .user_input_step import UserInputStep as UserInputStep
from .user_input_step_param import UserInputStepParam as UserInputStepParam
from .video_content import VideoContent as VideoContent
from .video_content_param import VideoContentParam as VideoContentParam
from .video_response_format import VideoResponseFormat as VideoResponseFormat
from .video_response_format_param import VideoResponseFormatParam as VideoResponseFormatParam
from .webhook import Webhook as Webhook
from .webhook_config import WebhookConfig as WebhookConfig
from .webhook_config_param import WebhookConfigParam as WebhookConfigParam
from .webhook_create_params import WebhookCreateParams as WebhookCreateParams
from .webhook_delete_response import WebhookDeleteResponse as WebhookDeleteResponse
from .webhook_list_params import WebhookListParams as WebhookListParams
from .webhook_list_response import WebhookListResponse as WebhookListResponse
from .webhook_ping_params import WebhookPingParams as WebhookPingParams
from .webhook_ping_response import WebhookPingResponse as WebhookPingResponse
from .webhook_rotate_signing_secret_params import WebhookRotateSigningSecretParams as WebhookRotateSigningSecretParams
from .webhook_rotate_signing_secret_response import (
WebhookRotateSigningSecretResponse as WebhookRotateSigningSecretResponse,
)
from .webhook_update_params import WebhookUpdateParams as WebhookUpdateParams
34 changes: 34 additions & 0 deletions google/genai/_interactions/types/code_execution_call_arguments.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# 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`."""
29 changes: 29 additions & 0 deletions google/genai/_interactions/types/google_maps_call_arguments.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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."""
65 changes: 65 additions & 0 deletions google/genai/_interactions/types/google_maps_result.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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."""
Loading
Loading