v2.4.0

2.4.0 (2026-07-07)

Features

• Add mTLS support for DiscoveryEngineSearchTool (8ba0e6a)
• Add mTLS support to Google API tools (3466586)
• add OpenAI Responses API support in labs (6b831d5), closes #3209
• Add support for reusing an existing SQLAlchemy AsyncEngine in DatabaseSessionService (f4c7e4c)
• add support for session TTL and expiration in Vertex AI session service (49d4441)
• adk: add Anthropic effort config handling, thinking parameter propagation, and conflict mitigation (4c862b9)
• agents: add ManagedAgent backed by the Managed Agents API (cf91b84)
• bigquery: expose thinking and tool-use token columns in analytics views (c14258d)
• bigtable: Support parameterized views with secure parameter inj… (14a24f2)
• HTTP traces for MCP server requests/errors (4c4f77a)
• Implement Workflow as Tool core feature (1263ed6)
• integrations: Add DaytonaEnvironment for remote sandbox workspaces (df6baf4)
• interactions: stream thought, media, code-exec and function-result deltas (b2dda6e)
• interactions: surface streamed grounding and final usage metadata (6a50b8d)
• memory: add Vertex AI load_profiles tool (fb2b3af)
• models: Add configuration options to Gemini class (037ec12), closes #3813
• models: surface and recover environment_id from interactions (81f9f2e)
• plugins: add otel correlation, custom_metadata allowlist, and column projection to BigQuery analytics (38d715c)
• scripts: add check for private-by-default new Python files (63561ce)
• support file_data URI references in GcsArtifactService (43115b2)
• support mTLS and GOOGLE_API_USE_MTLS_ENDPOINT for GDA client (e85a7b2)
• Support passing dynamic custom headers to LiteLLM via RunConfig (000d74d)
• Support provider-prefixed Gemini model IDs (816a87f)
• tools: add response_scheduling to control Live function response behavior (7443bfa)
• tools: exposed configurable parameter as property in McpToolset (cca8c56)
• tools: resolve built-in tools for managed-agent requests (f11d19d)
• tools: Support tuple tool parameters (a57c3e4)
• utils: Add support for nested state access in template injection (94c43a2)
• workflow: Allow ToolNode to accept JSON string or Content inputs (4e44632)

Bug Fixes

• adapt interactions conversion to google-genai 2.9 SDK changes (9f3aeef)
• Add credential_key to ApplicationIntegrationToolset and IntegrationConnectorTool (c6a94b8), closes #4553
• Add debug level logging to mcp sse agent sample (3962d0b)
• add DNS-rebinding protection to _OriginCheckMiddleware (9a4f479)
• add module blocklist for YAML agent config code references (6a5be34)
• add parameter validation for sync tools in ADK functions.py (9b9d27d)
• add trailing newline to check_new_py_files.sh (21512ea)
• Address mypy failures in google_api_tool/ (5301ffa)
• agents: persist output_key when before_agent_callback short-circuits LlmAgent (0e263f1)
• agents: preserve text streamed before tool calls in output_key (5a0b4af)
• agents: prevent path traversal in AgentTool config_path resolution (171ae9e)
• ApplicationIntegrationTool: implement dynamic mTLS endpoint resolution (37ca6fb)
• apply run_config custom_metadata to user event in node runtime (066fbce)
• artifacts: Preserve .text on GcsArtifactService load (ba51ff2), closes #3157
• auth: allow configuring OAuth prompt parameter (ac99770)
• auth: strip redirect_uri from credential_key (ffa1843)
• avoid mutating event validation input (6b385e4)
• Avoid overwriting existing isolation scope in stamp_event_branch_context (798207a)
• avoid yielding a None function-response event in live mode (4d88a52)
• catch RecursionError in safe JSON serialization helpers (5515800), closes #5411
• check if transfer target is a sibling agent (fa18d26)
• ci: Restrict GitHub Actions to main/v1 branches and main repository (8c4173e)
• cli: detailed error message on sse stream specifying stacktrack (error type on client side as well) (56b84e1)
• cli: enable interspersed option parsing for cloud_run command (7b049b9)
• cli: Ensure ADK compatibility in agent engine requirements (ea772b9), closes #5966
• cli: respect ignore files in adk deploy commands (ee79e71)
• cli: support flat-module agents in _determine_agent_language (7a553b7)
• concatenate list values in deep_merge_dicts during parallel tool call merge (fda2347), closes #5190
• concatenate list values in deep_merge_dicts during parallel tool call ...

Release 1.36.1

1.36.1 (2026-07-06)

Bug Fixes

• exit connection cleanly on expected GoAway signal in bidi streaming (v1) (#6264) (de2abdf)
• Fix Vertex AI Live API session replay on reconnect / modality switch (#6218) (4caf782)

Release 1.36.0

1.36.0 (2026-06-22)

Features

• interactions: support for GenAI SDK upgraded to 2.9+ (#6191) (7a9152a)

v2.3.0

2.3.0 (2026-06-17)

Features

• add create_http_options to ContextCacheConfig for cache creation timeout (ffc9677), closes #4703
• add GCS first party toolset to ADK integrations (fb19e1a)
• Add log_level option for adk run CLI (1ac69a9)
• Add mTLS support in AgentRegistry client (03671c6)
• add request timeout to load_web_page (792775f)
• core: migrate core and CLI to enterprise parameters (68221f0)
• Create GEPARootAgentOptimizer (654145a)
• eval: expose user_simulator_config in generate_responses (e7a673c)
• gemma4: support Gemma4 in Gemini (573f043)
• integrations: Add E2BEnvironment for remote sandbox workspaces (92d608f)
• labs: add experimental Antigravity SDK agent wrapper (4cb27fd)
• lazily initialize the Vertex AI client in GCPSkillRegistry, and fix the import path for vertexai (65dca53)
• live: Handle input transcription differently for Gemini Live 3.1 models (048deea)
• live: support Live API translation config in RunConfig (463040f)
• Migrate McpToolset to AsyncAuthorizedSession for mTLS support (fe497a4)
• plugins: ADK 2.0 minimum producer cut for the BigQuery Agent Analytics plugin (e2676fc)
• report cached token counts for Anthropic and OpenAI models (b15c8a0)
• telemetry: support per-request OpenTelemetry configuration (abcaa08)
• Update gcp_auth client UI to support Remote Agents (57bdecf)
• utils: add GOOGLE_GENAI_USE_ENTERPRISE env var with deprecation fallback (4e85e9c)

Bug Fixes

• a2a: Preserve execution metadata in final events (e90b119)
• a2a: render HITL interrupt when prompt is in a data part (b9e7fca)
• a2a: set final=True for error TaskStatusUpdateEvent in event_converter (5efe53d)
• a2a: suppress part_metadata in Vertex AI mode (065f4ae)
• add a2a as a required dependency for agent_engine deployment (d2ebacb)
• adk: propagate exceptions from run_node in standalone mode (63841c3)
• adk: propagate isolation_scope to prevent history filtering loops (f39d75b)
• agents: await cancelled tasks in _merge_agent_run_pre_3_11 to prevent aclose() RuntimeError (9310ba7)
• api-registry to fetch all services (81b8067), closes #5478
• artifacts: Support nested API names (b99546b)
• auth: handle missing client-credentials scopes safely (a546bcf), closes #5345
• avoid UserWarning in _build_response_log when response has funct… (f022307)
• call to sanitize schema for complex union types (9808451)
• ci: add repository check to prevent workflows from running on forks (90bd38f)
• ci: Resolve missing sqlalchemy error in adk_release_analyzer (107dc38)
• cli: Serialize LiteLlm graph models safely (c1e852f)
• conformance: normalize tool declarations in replay verification (dd97e76)
• Default subagents to chat mode in build_node (ad560ce)
• deps: Require otel google-genai instrumentor >=0.7b1 for genai 2.x (2b8c80c)
• eval: handle failed inference results without invocations (9a6cf60)
• eval: handle unevaluated final response v2 results (5cfef01)
• eval: include function-call events in invocation_events when skip_summarization is set (5b16a86)
• eval: preserve custom eval metadata (780b0ab)
• Extract grounding_metadata from Live API server_content (8a294af)
• Fix silent dead end when conditional routes are unmatched (6af4562)
• Fix typing for create_client in mcp_session_manager (c6546a7)
• fix vertex_ai_session_service crashing when Agent Engine passes full resource names instead of short session IDs (60c55ad)
• flows: terminate invocation at tool-level EUC (883ff98)
• Format files to fix pre-commit failures (395848a)
• Format the files (9670ce2)
• gate pr-triage secrets on same-repository pull_request_target (0d20b7c)
• handle missing agent name in readonly context (a890399)
• improve error message when beautifulsoup4/lxml not installed for load_web_page (d9f189c), closes #4852
• live: history_config rejection on Vertex/Enterprise Live sessions (8f85260)
• live: propagate output token count in live API usage metadata (7e8965d)
• log diagnostics for empty or unparseable rubric auto-rater output (fe56f31), closes #5732
• make DatabaseSessionService visible in API docs (69ecf07), closes #4331
• Mock google.auth.default in test_fast_api.py (a7ceb3f)
• models: pass NOT_GIVEN to Anthropic when no system_instruction (3f505d2), closes [#531...

Release 1.35.2

1.35.2 (2026-06-17)

Bug Fixes

• remove live event buffering in runner (#6151) (afe4083)

Release 1.35.1

1.35.1 (2026-06-15)

Bug Fixes

• Only send grounding_metadata for 3.1 live at the end of each turn (#6129) (847a259)
• streaming: Ensure final partial=False frame is always yielded (#6096) (6e59c61)

Release 1.35.0

1.35.0 (2026-06-10)

Features

• live: Handle input transcription differently for Gemini Live 3.1 models (#6045) (ecfdaf5)

Bug Fixes

• add missing Gemini imports in base_llm_flow (#5943) (6d027b4)
• flows: Reset reconnect attempts on connection success (#6042) (87abf23)
• models: Default grounding metadata for Gemini 3.1 live (#6018) (fafafb3)
• Support generalized history config injection for Gemini 3.1 Live on Vertex AI (#5999) (aafd97f)

v2.2.0

2.2.0 (2026-06-04)

⚠ BREAKING CHANGES

• agents: LlmAgent default model changed from gemini-2.5-flash to gemini-3-flash-preview (a preview model), ahead of the 2026-10-16 gemini-2.5-flash shutdown. Agents without an explicit model= now run on the new preview default; set model="gemini-2.5-flash" to retain prior behavior. DEFAULT_LIVE_MODEL is unchanged. (ad8b6c7)
• interactions: GenAI SDK v2.0.0 support renames the turn-based helpers in interactions_utils.py (e.g. convert_contents_to_turns → convert_contents_to_steps) and moves from "turns" to "steps" terminology. Update any direct callers. (da1d8f1)

Features

• Add --trigger_sources and ADK service options to cli_deploy_agent_engine (ffa057c)
• add AutoTracingPlugin for OpenTelemetry auto-instrumentation (bc3a4fa)
• add RubricBasedMultiTurnTrajectoryEvaluator (cae2337)
• agents: restore 1.x agent config wiring for backward compatibility (44cd116)
• api_server: Abort runs on client drops to avoid leaks (6a53357)
• BigQuery Agent Analytics reliability fixes (a5fa3da)
• distinguish input-required vs auth-required in A2A conversion (9d139ea)
• emit OTel gen_ai.client.* metrics natively (0bb329b)
• forward custom_metadata from run requests into the run config (460cb8c)
• include thoughts and tool calls in compaction summaries (bdb5582)
• interactions: update ADK to support Google GenAI SDK v2.0.0 (da1d8f1)
• models: Support turn_complete_reason in Live responses to capture safety info (9126acb)
• preserve A2A message metadata field in ADK event (d4d955d)
• raise explicit error for unsupported LiteLlm file attachments (8847f23), closes #5546
• sessions: add get_user_state(app_name, user_id) to BaseSessionService (d029bce)
• Support additional scopes and custom discovery doc in Google API Tools (dc6e293)
• tools: expose httpx_client_factory on RestApiTool and OpenAPIToolset (7eb9b3d)
• tools: Standardize request_input tool for proactive LLM clarification (afb0a64)

Bug Fixes

• a2a: Support to_a2a(Workflow) and reject non-agent root nodes (0478b02)
• accept Azure assistant file ids (b73679e), closes #5664
• add artifacts in each agent's .adk folder (bae5b1a)
• add future annotations import and prefix task models logger (2874874)
• add missing crop helper to data file helper lib (b5181cf), closes #4011
• add PEP 604 union syntax in function tool parameters (551445e)
• add telemetry metric assertions to the test's own agent (b7766ce)
• agents: restore abc.ABC base for BaseAgent and LlmAgent (020386a)
• allow internal builder assistant app name (f6e26cc)
• append trailing newline to runtime-config.json in ADK Web Server (4baccf6)
• auth: omit scope from OAuth2 token requests (6ce4b87)
• block path traversal in Agent Builder file tools (1fa7cda)
• dependencies: clarify missing Vertex AI extra (fde6a2b)
• deps: bump starlette and fastapi to address CVE-2026-48710 (81add39)
• eval: Support include_intermediate_responses_in_final in final_response_match_v2 (8519602), closes #5695
• Event.message honors subclass field (5bebfd4)
• exclude temp: state keys from Firestore session writes (a5db346)
• Fix path traversal in GCS skill extraction (Zip Slip) (2f15c6c)
• flows: preserve transparent config on live session reconnect (5ad1942), closes #5675
• Format the files to fix pre-commit failures (af8bfe0)
• guard peer agent mode access in agent transfer (bb16958), closes #5863
• live: Resolve 1007 error and support Gemini 3.1 Flash Live protocol (e5af12c)
• mcp: Prevent initialization hangs and task group leaks (334ef81), closes #5886
• migration: restrict unpickling of v0 actions blobs (9db48ce)
• models: Prevent grounding metadata loss in Gemini 3.1 (e896c62)
• parse noncanonical litellm tool call arguments (31cc5a1)
• populate user_content in resumed invocations (660bbd4)
• preserve media blocks in ollama content flattening (47ceeba), closes #4975
• runners: fall back to root agent when a resumed call author is not in the tree (a86efa6)
• runners: Preserve state_delta in NodeRunner path (c56bec8)
• sessions: guard None event.actions before reading state_delta (03ef3f6)
• Support generalized history config injection for Gemini 3.1 Live on Vertex AI (61a3933)
• terminate infinite retry loop in LoadSkillResourceTool on RESOURCE_NOT_FOUND (bc45ee6)
• tolerate context-likes without user_content or session in record_agent_invocation (0775da5)
• tools: add skill script dir to sys.path (9296198)
• tools: don't close parent's plugins from AgentTool's sub-Ru...

Release 1.34.2

1.34.2 (2026-06-01)

Bug Fixes

• Fix bug where grounding metadata in Gemini 3.1 live was being silently discarded (9b6b9e9)
• fix input and output transcription finished events for Gemini v3.1 (13763d7)
• tools: Prevent session drop on MCP tool error (1fd406b)

v2.1.0

2.1.0 (2026-05-23)

Features

• Add chart generation and artifact loading to data agent (db06416)
• Add support for creating sandboxes from templates and snapshots (cbd14eb)
• Add user.id to gen_ai.user.message log records for telemetry (eb379be)
• Fix error message telemetry for tool calls (e56c021)
• Preserve transcription event order in conversation trajectory (b3d0759)

Bug Fixes

• ci: Add python-dateutil dependency to stale-bot workflow (84fa984)
• ci: Prevent workflow failures in relocated adk_team samples (55cbc8c)
• ci: Use absolute path for PYTHONPATH in upload docs workflow (85223e6)
• cli: Fix --reload_agents for web (1307f8e)
• cli: Inform user to install optional dependency on missing google.cloud (57d677c)
• convert Union[Pydantic, Pydantic] tool args at runtime (104edc8), closes #5799
• Fix bug where grounding metadata in Gemini 3.1 live was being silently discarded (b9751eb)
• fix input and output transcription finished events for Gemini v3.1 (d17a2a3)
• lazy-import GCS evaluation managers in evals utility (5f91a9d)
• Make google-cloud-storage import lazy in skill utils (416775d)
• resolve circular import caused by llm_request (7e38fc8)
• Resolve circular import in base_tool (92cf192)
• tests: Append trailing newline to JSON test outputs (3329ced)
• tools: Prevent session drop on MCP tool error (933653c)
• update EditFileTool to handle cross-platform line breaks and escape regex characters (1f24553)