Merge branch 'main' into feat/gcs-file-data-support

Author: blueeye-040

.github/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.30.0"
+  ".": "1.31.0"
 }

.github/release-please-config.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
-  "last-release-sha": "80a7ecf4b31e4c6de4a1425b03422f384c1a032d",
+  "last-release-sha": "d69477f6ff348311e1d53e3f2c389dcf037fb049",
   "packages": {
     ".": {
       "release-type": "python",

CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [1.31.0](https://github.com/google/adk-python/compare/v1.30.0...v1.31.0) (2026-04-16)
+
+
+### Features
+
+* Add "google-adk" user agent to Parameter Manager and Secret Manager clients ([b8e8f6b](https://github.com/google/adk-python/commit/b8e8f6b90290e48e134f48bbe7e2b800276e7269))
+* Add support for memories.ingest_events in VertexAiMemoryBankService ([d69477f](https://github.com/google/adk-python/commit/d69477f6ff348311e1d53e3f2c389dcf037fb049))
+* Add Vertex AI Agent Engine Sandbox integration for computer use ([7686848](https://github.com/google/adk-python/commit/76868485519090c5fa2a0287bccca040e438d94e))
+* Firestore support ([1a9df8f](https://github.com/google/adk-python/commit/1a9df8f77410a08a85d04744f199d25f20d55ebd))
+* **live:** Add live_session_id to LlmResponse ([bf84e2c](https://github.com/google/adk-python/commit/bf84e2cee84f04c886914eb72318875f3c29ea13))
+
+
+### Bug Fixes
+
+* Bump minimum mcp version from 1.23.0 to 1.24.0 ([494c360](https://github.com/google/adk-python/commit/494c360b2a82af5130f153ff615f84e4c2604a73))
+* **cli:** correct console URL path after adk deploy agent_engine ([64ed1a6](https://github.com/google/adk-python/commit/64ed1a68c98e32d61aff43857fa4e756b129b13f)), closes [#5336](https://github.com/google/adk-python/issues/5336)
+* execute on_event_callback before append_event to persist plugin modifications ([454188d](https://github.com/google/adk-python/commit/454188de5de0ef44adb7716230eacddcb060dab2)), closes [#3990](https://github.com/google/adk-python/issues/3990)
+* make `_EvalMetricResultWithInvocation.expected_invocation` `Optional` for conversation_scenario support ([#5215](https://github.com/google/adk-python/issues/5215)) ([a4c9387](https://github.com/google/adk-python/commit/a4c938775764794f42e00a89e3cb33da5119c38b))
+* Pass in auth headers with header provider instead of connection params ([e12b0af](https://github.com/google/adk-python/commit/e12b0af20d9a025e3d75f309de836b139b6d3e88))
+* populate required fields in FunctionDeclaration json_schema fallback ([9b9faa4](https://github.com/google/adk-python/commit/9b9faa4ba21d566252e4c25bd55ab9db2658051e))
+* Resolve BigQuery plugin issues with A2A transfers, spans, and metadata ([9ca8c38](https://github.com/google/adk-python/commit/9ca8c384324e07e945146359f21010b438eb1bc6))
+* upgrade google-genai lower bound ([8bc5728](https://github.com/google/adk-python/commit/8bc57283f3c584a5a6d6d774a316fe63342ed481))
+
+
+### Code Refactoring
+
+* **live:** Use `send_client_content` to send conversation history ([67dc2eb](https://github.com/google/adk-python/commit/67dc2ebfd42f175f2dd6ea58df51a03c575062c6))
+* **live:** Use `send_tool_response` for function responses ([70c5fc8](https://github.com/google/adk-python/commit/70c5fc83a62d1e81d20986223f5c275b086f9822))
+
+
+### Documentation
+
+* update MCP Toolbox branding, binary version, and asset references ([47fa7b7](https://github.com/google/adk-python/commit/47fa7b743c37e3aa8302e78be552876c2784e6ff))
+
 ## [1.30.0](https://github.com/google/adk-python/compare/v1.29.0...v1.30.0) (2026-04-13)
 
 

contributing/samples/live_bidi_streaming_multi_agent/agent.py

@@ -30,11 +30,10 @@ def roll_die(sides: int) -> int:
 roll_agent = Agent(
     name="roll_agent",
     model=Gemini(
-        # see https://docs.cloud.google.com/vertex-ai/generative-ai/docs/migrate
-        # for vertex model names
-        model="gemini-live-2.5-flash-native-audio",  # vertex
-        # see https://ai.google.dev/gemini-api/docs/models for AIS model names
-        # model='gemini-2.5-flash-native-audio-latest',  # for AI studio
+        # Find supported models in Vertex here: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/live-api
+        model="gemini-live-2.5-flash-native-audio",  # Vertex
+        # Find supported models in Gemini API here: https://ai.google.dev/gemini-api/docs/models
+        # model='gemini-2.5-flash-native-audio-preview-12-2025',  # Gemini API
         speech_config=types.SpeechConfig(
             voice_config=types.VoiceConfig(
                 prebuilt_voice_config=types.PrebuiltVoiceConfig(
@@ -85,11 +84,10 @@ def check_prime(nums: list[int]) -> str:
 prime_agent = Agent(
     name="prime_agent",
     model=Gemini(
-        # see https://docs.cloud.google.com/vertex-ai/generative-ai/docs/migrate
-        # for vertex model names
-        model="gemini-live-2.5-flash-native-audio",  # vertex
-        # see https://ai.google.dev/gemini-api/docs/models for AIS model names
-        # model='gemini-2.5-flash-native-audio-latest',  # for AI studio
+        # Find supported models in Vertex here: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/live-api
+        model="gemini-live-2.5-flash-native-audio",  # Vertex
+        # Find supported models in Gemini API here: https://ai.google.dev/gemini-api/docs/models
+        # model='gemini-2.5-flash-native-audio-preview-12-2025',  # Gemini API
         speech_config=types.SpeechConfig(
             voice_config=types.VoiceConfig(
                 prebuilt_voice_config=types.PrebuiltVoiceConfig(
@@ -128,13 +126,11 @@ def get_current_weather(location: str):
 
 
 root_agent = Agent(
-    # find supported models here: https://google.github.io/adk-docs/get-started/streaming/quickstart-streaming/
     model=Gemini(
-        # see https://docs.cloud.google.com/vertex-ai/generative-ai/docs/migrate
-        # for vertex model names
-        model="gemini-live-2.5-flash-native-audio",  # vertex
-        # see https://ai.google.dev/gemini-api/docs/models for AIS model names
-        # model='gemini-2.5-flash-native-audio-latest',  # for AI studio
+        # Find supported models in Vertex here: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/live-api
+        model="gemini-live-2.5-flash-native-audio",  # Vertex
+        # Find supported models in Gemini API here: https://ai.google.dev/gemini-api/docs/models
+        # model='gemini-2.5-flash-native-audio-preview-12-2025',  # Gemini API
         speech_config=types.SpeechConfig(
             voice_config=types.VoiceConfig(
                 prebuilt_voice_config=types.PrebuiltVoiceConfig(

contributing/samples/live_bidi_streaming_parallel_tools_agent/agent.py

@@ -29,7 +29,10 @@ def turn_on_tv():
 
 
 root_agent = Agent(
-    model="gemini-live-2.5-flash-native-audio",
+    # Find supported models in Vertex here: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/live-api
+    model="gemini-live-2.5-flash-native-audio",  # Vertex
+    # Find supported models in Gemini API here: https://ai.google.dev/gemini-api/docs/models
+    # model='gemini-2.5-flash-native-audio-preview-12-2025',  # Gemini API
     name="Home_helper",
     instruction="Be polite and answer all user's questions.",
     tools=[turn_on_lights, turn_on_tv],

contributing/samples/live_bidi_streaming_single_agent/agent.py

@@ -65,11 +65,10 @@ async def check_prime(nums: list[int]) -> str:
 
 
 root_agent = Agent(
-    # see https://docs.cloud.google.com/vertex-ai/generative-ai/docs/migrate
-    # for vertex model names
-    model='gemini-live-2.5-flash-native-audio',  # vertex
-    # see https://ai.google.dev/gemini-api/docs/models for AIS model names
-    # model='gemini-2.5-flash-native-audio-latest',  # for AI studio
+    # Find supported models in Vertex here: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/live-api
+    model='gemini-live-2.5-flash-native-audio',  # Vertex
+    # Find supported models in Gemini API here: https://ai.google.dev/gemini-api/docs/models
+    # model='gemini-2.5-flash-native-audio-preview-12-2025',  # Gemini API
     name='roll_dice_agent',
     description=(
         'hello world agent that can roll a dice of 6 sides and check prime'

contributing/samples/live_bidi_streaming_tools_agent/agent.py

@@ -124,11 +124,10 @@ def stop_streaming(function_name: str):
 
 
 root_agent = Agent(
-    # see https://docs.cloud.google.com/vertex-ai/generative-ai/docs/migrate
-    # for vertex model names
-    model="gemini-live-2.5-flash-native-audio",  # vertex
-    # see https://ai.google.dev/gemini-api/docs/models for AIS model names
-    # model='gemini-2.5-flash-native-audio-latest',  # for AI studio
+    # Find supported models in Vertex here: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/live-api
+    model="gemini-live-2.5-flash-native-audio",  # Vertex
+    # Find supported models in Gemini API here: https://ai.google.dev/gemini-api/docs/models
+    # model='gemini-2.5-flash-native-audio-preview-12-2025',  # Gemini API
     name="video_streaming_agent",
     instruction="""
       You are a monitoring agent. You can do video monitoring and stock price monitoring

contributing/samples/live_tool_callbacks_agent/agent.py

@@ -217,9 +217,10 @@ async def after_tool_async_callback(
 
 # Create the agent with tool callbacks
 root_agent = Agent(
-    # find supported models here: https://google.github.io/adk-docs/get-started/streaming/quickstart-streaming/
-    model="gemini-2.0-flash-live-preview-04-09",  # for Vertex project
-    # model="gemini-live-2.5-flash-preview",  # for AI studio key
+    # Find supported models in Vertex here: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/live-api
+    model="gemini-live-2.5-flash-native-audio",  # Vertex
+    # Find supported models in Gemini API here: https://ai.google.dev/gemini-api/docs/models
+    # model='gemini-2.5-flash-native-audio-preview-12-2025',  # Gemini API
     name="tool_callbacks_agent",
     description=(
         "Live streaming agent that demonstrates tool callbacks functionality. "

contributing/samples/local_environment_skill/agent.py

@@ -15,38 +15,7 @@
 
 from google.adk import Agent
 from google.adk.environment import LocalEnvironment
-from google.adk.tools.base_tool import BaseTool
 from google.adk.tools.environment import EnvironmentToolset
-from google.genai import types
-
-
-class GetTimezoneTool(BaseTool):
-  """A tool to get the timezone for a given location."""
-
-  def __init__(self):
-    super().__init__(
-        name="get_timezone",
-        description="Returns the timezone for a given location.",
-    )
-
-  def _get_declaration(self) -> types.FunctionDeclaration | None:
-    return types.FunctionDeclaration(
-        name=self.name,
-        description=self.description,
-        parameters_json_schema={
-            "type": "object",
-            "properties": {
-                "location": {
-                    "type": "string",
-                    "description": "The location to get the timezone for.",
-                },
-            },
-            "required": ["location"],
-        },
-    )
-
-  async def run_async(self, *, args: dict, tool_context) -> str:
-    return f"The timezone for {args['location']} is UTC+00:00."
 
 
 def get_wind_speed(location: str) -> str:
@@ -89,7 +58,6 @@ def get_wind_speed(location: str) -> str:
                 working_dir=pathlib.Path(__file__).parent
             ),
         ),
-        GetTimezoneTool(),
         get_wind_speed,
     ],
 )

contributing/samples/local_environment_skill/skills/weather-skill/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: weather-skill
 description: A skill that provides weather information based on reference data.
-metadata:
-  adk_additional_tools:
-    - get_wind_speed
 ---
 
 Step 1: Check 'references/weather_info.md' for the current weather.