google-adk

1.20.0 (2025-12-01)

Features

• [Core]

  • Add enum constraint to agent_name for transfer_to_agent (4a42d0d)
  • Add validation for unique sub-agent names (#3557) (2247a45)
  • Support streaming function call arguments in progressive SSE streaming feature (786aaed)

• [Models]

  • Enable multi-provider support for Claude and LiteLLM (d29261a)

• [Tools]

  • Create APIRegistryToolset to add tools from Cloud API registry to agent (ec4ccd7)
  • Add an option to disallow propagating runner plugins to AgentTool runner (777dba3)

• [Web]

  • Added an endpoint to list apps with details (b57fe5f)

Bug Fixes

• Allow image parts in user messages for Anthropic Claude (5453b5b)
• Mark the Content as non-empty if its first part contains text or inline_data or file_data or func call/response (631b583)
• Fixes double response processing issue in base_llm_flow.py where, in Bidi-streaming (live) mode, the multi-agent structure causes duplicated responses after tool calling. (cf21ca3)
• Fix out of bounds error in _run_async_impl (8fc6128)
• Fix paths for public docs (cd54f48)
• Ensure request bodies without explicit names are named 'body' (084c2de), closes #2213
• Optimize Stale Agent with GraphQL and Search API to resolve 429 Quota errors (cb19d07)
• Update AgentTool to use Agent's description when input_schema is provided in FunctionDeclaration (52674e7)
• Update LiteLLM system instruction role from "developer" to "system" (2e1f730), closes #3657
• Update session last update time when appending events (a3e4ad3), closes #2721
• Update the retry_on_closed_resource decorator to retry on all errors (a3aa077)
• Windows Path Handling and Normalize Cross-Platform Path Resolution in AgentLoader (a1c09b7)

Documentation

• Add Code Wiki badge to README (caf23ac)

1.19.0 (2025-11-19)

Highlights

• Breaking! Raise minimum Python version to 3.10
• Add a File based Artifact Service
• Reduce ADK API server startup latency by lazy loading
• ADK web light mode support
• BigQuery Agent Analytics Plugin

Features

• [Core]

  • Add id and custom_metadata fields to MemoryEntry (4dd28a3)
  • Add progressive SSE streaming feature (a5ac1d5)
  • Add a2a_request_meta_provider to RemoteAgent init (d12468e)
  • Add feature decorator for the feature registry system (871da73)
  • Breaking: Raise minimum Python version to 3_10 (8402832)
  • Refactor and rename BigQuery agent analytics plugin (6b14f88)
  • Pass custom_metadata through forwarding artifact service (c642f13)
  • Update save_files_as_artifacts_plugin to never keep inline data (857de04)

• [Evals]

  • Add support for InOrder and AnyOrder match in ToolTrajectoryAvgScore Metric (e2d3b2d)

• [Integrations]

  • Enhance BQ Plugin Schema, Error Handling, and Logging (5ac5129)
  • Schema Enhancements with Descriptions, Partitioning, and Truncation Indicator (7c993b0)

• [Services]

  • Add file-backed artifact service (99ca6aa)
  • Add service factory for configurable session and artifact backends (a12ae81)
  • Add SqliteSessionService and a migration script to migrate existing DB using DatabaseSessionService to SqliteSessionService (e218254)
  • Add transcription fields to session events (3ad30a5)
  • Full async implementation of DatabaseSessionService (7495941)

• [Models]

  • Add experimental feature to use parameters_json_schema and response_json_schema for McpTool (1dd97f5)
  • Add support for parsing inline JSON tool calls in LiteLLM responses (22eb7e5)
  • Expose artifact URLs to the model when available (e3caf79)

• [Tools]

  • Add BigQuery related label handling (ffbab4c)
  • Allow setting max_billed_bytes in BigQuery tools config (ffbb0b3)
  • Propagate application_name set for the BigQuery Tools as BigQuery job labels (f13a11e)
  • Set per-tool user agent in BQ calls and tool label in BQ jobs (c0be1df)

• [Observability]

  • Migrate BigQuery logging to Storage Write API (a2ce34a)

Bug Fixes

• Add jsonschema dependency for Agent Builder config validation (0fa7e46)
• Add None check for event in remote_a2a_agent.py (744f94f)
• Add vertexai initialization for code being deployed to AgentEngine (b8e4aed)
• Change LiteLLM content and tool parameter handling (a19be12)
• Change name for builder agent (131d39c)
• Ensure event compaction completes by awaiting task (b5f5df9)
• Fix deploy to cloud run on Windows (29fea7e)
• Fix error handling when MCP server is unreachable (ee8106b)
• Fix error when query job destination is None (0ccc43c)
• Fix Improve logic for checking if a MCP session is disconnected (a754c96)
• Fix McpToolset crashing with anyio.BrokenResourceError (8e0648d)
• Fix Safely handle FunctionDeclaration without a required attribute (93aad61)
• Fix status code in error message in RestApiTool (9b75456)
• Fix Use async for to loop through event iterator to get all events in vertex_ai_session_service (9211f4c)
• Fix: Fixes DeprecationWarning when using send method (2882995)
• Improve logic for checking if a MCP session is disconnected (a48a1a9)
• Improve handling of partial and complete transcriptions in live calls (1819ecb)
• Keep vertex session event after the session update time (0ec0195)
• Let part converters also return multiple parts so they can support more usecases (824ab07)
• Load agent/app before creating session (236f562)
• Remove app name from FileArtifactService directory structure (12db84f)
• Remove hardcoded google-cloud-aiplatform version in agent engine requirements (e15e19d)
• Stop updating write mode in the global settings during tool execution (5adbf95)
• Update description for load_artifacts tool (c485889)

Improvements

• Add BigQuery related label handling (ffbab4c)
• Add demo for rewind (8eb1bdb)
• Add debug logging for live connection (5d5708b)
• Add debug logging for missing function call events (f3d6fcf)
• Add default retry options as fall back to llm_request that are made during evals (696852a)
• Add plugin for returning GenAI Parts from tools into the model request (116b26c)
• Add support for abstract types in AFC (2efc184)
• Add support for structured output schemas in LiteLLM models (7ea4aed)
• Add tests for max_query_result_rows in BigQuery tool config (fd33610)
• Add type hints in cleanup_unused_files.py (2dea573)
• Add util to build our llms.txt and llms-full.txt files
• ADK changes (f1f4467)
• Defer import of google.cloud.storage in GCSArtifactService (999af55)
• Defer import of live, Client and _transformers in google.genai (22c6dbe)
• Enhance the messaging with possible fixes for RESOURCE_EXHAUSTED errors from Gemini (b2c45f8)
• Improve gepa tau-bench colab for external use (e02f177)
• Improve gepa voter agent demo colab (d118479)
• Lazy import DatabaseSessionService in the adk/sessions/ module (5f05749)
• Move adk_agent_builder_assistant to built_in_agents (b2b7f2d)
• Plumb memory service from LocalEvalService to EvaluationGenerator (dc3f60c)
• Removes the unrealistic todo comment of visibility management (e511eb1)
• Returns agent state regardless if ctx.is_resumable (d6b928b)
• Stop logging the full content of LLM blobs (0826755)
• Update ADK web to match main branch (14e3802)
• Update agent instructions and retry limit in plugin_reflect_tool_retry sample (01bac62)
• Update conformance test CLI to handle long-running tool calls (dd706bd)
• Update Gemini Live model names in live bidi streaming sample (aa77834)

1.18.0 (2025-11-05)

Features

• [ADK Visual Agent Builder]

  • Core Features
    • Visual workflow designer for agent creation
    • Support for multiple agent types (LLM, Sequential, Parallel, Loop, Workflow)
    • Agent tool support with nested agent tools
    • Built-in and custom tool integration
    • Callback management for all ADK callback types (before/after agent, model, tool)
    • Assistant to help you build your agents with natural language
    • Assistant proposes and writes agent configuration yaml files for you
    • Save to test with chat interfaces as normal
    • Build and debug at the same time in adk web!

• [Core]

  • Add support for extracting cache-related token counts from LiteLLM usage (4f85e86)
  • Expose the Python code run by the code interpreter in the logs (a2c6a8a)
  • Add run_debug() helper method for quick agent experimentation (0487eea)
  • Allow injecting a custom Runner into agent_to_a2a (156d235)
  • Support MCP prompts via the McpInstructionProvider class (88032cf)

• [Models]

  • Add model tracking to LiteLlm and introduce a LiteLLM with fallbacks demo (d4c63fc)
  • Add ApigeeLlm as a model that lets ADK Agent developers to connect with an Apigee proxy (87dcb3f)

• [Integrations]

  • Add example and fix for loading and upgrading old ADK session databases (338c3c8)
  • Add support for specifying logging level for adk eval cli command (b1ff85f)
  • Propagate LiteLLM finish_reason to LlmResponse for use in callbacks (71aa564)
  • Allow LLM request to override the model used in the generate content async method in LiteLLM (ce8f674)
  • Add api key argument to Vertex Session and Memory services for Express Mode support (9014a84)
  • Added support for enums as arguments for function tools (240ef5b)
  • Implement artifact_version related methods in GcsArtifactService (e194ebb)

• [Services]

  • Add support for Vertex AI Express Mode when deploying to Agent Engine (d4b2a8b)
  • Remove custom polling logic for Vertex AI Session Service since LRO polling is supported in express mode (546c2a6)
  • Make VertexAiSessionService fully asynchronous (f7e2a7a)

• [Tools]

  • Add Bigquery detect_anomalies tool (9851340)
  • Extend Bigquery detect_anomalies tool to support future data anomaly detection (38ea749)
  • Add get_job_info tool to BigQuery toolset (6429457)

• [Evals]

  • Add "final_session_state" to the EvalCase data model (2274c4f)
  • Marked expected_invocation as optional field on evaluator interface (b17c8f1)
  • Adds LLM-backed user simulator (54c4ecc)

• [Observability]

  • Add BigQueryLoggingPlugin for event logging to BigQuery (b7dbfed)

• [Live]

  • Add token usage to live events for bidi streaming (6e5c0eb)

Bug Fixes

• Reduce logging spam for MCP tools without authentication (11571c3)
• Fix typo in several files (d2888a3)
• Disable SetModelResponseTool workaround for Vertex AI Gemini 2+ models (6a94af2)
• Bug when callback_context_invocation_context is missing in GlobalInstructionPlugin (f81ebdb)
• Support models slash prefix in model name extraction (8dff850)
• Do not consider events with state delta and no content as final response (1ee93c8)
• Parameter filtering for CrewAI functions with **kwargs (74a3500)
• Do not treat FinishReason.STOP as error case for LLM responses containing candidates with empty contents (2f72ceb)
• Fixes null check for reflect_retry plugin sample (86f0155)
• Creates evalset directory on evalset create (6c3882f)
• Add ADK_DISABLE_LOAD_DOTENV environment variable that disables automatic loading of .env when running ADK cli, if set to true or 1 (15afbcd)
• Allow tenacity 9.0.0 (ee8acc5)
• Output file uploading to artifact service should handle both base64 encoded and raw bytes (496f8cd)
• Correct message part ordering in A2A history (5eca72f)
• Change instruction insertion to respect tool call/response pairs (1e6a9da)
• DynamicPickleType to support MySQL dialect (fc15c9a)
• Enable usage metadata in LiteLLM streaming (f9569bb)
• Fix issue with MCP tools throwing an error (1a4261a)
• Remove redundant format field from LiteLLM content objects (489c39d)
• Update the contribution analysis tool to use original write mode (54db3d4)
• Fix agent evaluations detailed output rows wrapping issue(4284c61)
• Update dependency version constraints to be based on PyPI versions(0b1784e)

Improvements

• Add Community Repo section to README (432d30a)
• Undo adding MCP tools output schema to FunctionDeclaration (92a7d19)
• Refactor ADK README for clarity and consistency (b0017ae)
• Add support for reversed proxy in adk web (a0df75b)
• Avoid rendering empty columns as part of detailed results rendering of eval results (5cb35db)
• Clear the behavior of disallow_transfer_to_parent (48ddd07)
• Disable the scheduled execution for issue triage workflow (a02f321)
• Include delimiter when matching events from parent nodes in content processor (b8a2b6c)
• Improve Tau-bench ADK colab stability (04dbc42)
• Implement ADK-based agent factory for Tau-bench (c0c67c8)
• Add util to run ADK LLM Agent with simulation environment (87f415a)
• Demonstrate CodeExecutor customization for environment setup (8eeff35)
• Add sample agent for VertexAiCodeExecutor (edfe553)
• Adds a new sample agent that demonstrates how to integrate PostgreSQL databases using the Model Context Protocol (MCP) (45a2168)
• Add example for using ADK with Fast MCP sampling (d3796f9)
• Refactor gepa sample code and clean-up user demo colab(63353b2)

1.17.0 (2025-10-22)

Features

• [Core]

  • Add a service registry to provide a generic way to register custom service implementations to be used in FastAPI server. See short instruction here. (391628f)
  • Add the ability to rewind a session to before a previous invocation (9dce06f)
  • Support resuming a parallel agent with multiple branches paused on tool confirmation requests (9939e0b)
  • Support content union as static instruction (cc24d61)

• [Evals]

  • ADK cli allows developers to create an eval set and add an eval case (ae139bb)

• [Integrations]

  • Allow custom request and event converters in A2aAgentExecutor (a17f3b2)

• [Observability]

  • Env variable for disabling llm_request and llm_response in spans (e50f05a)

• [Services]

  • Allow passing extra kwargs to create_session of VertexAiSessionService (6a5eac0)
  • Implement new methods in in-memory artifact service to support custom metadata, artifact versions, etc. (5a543c0)
  • Add create_time and mime_type to ArtifactVersion (2c7a342)
  • Support returning all sessions when user id is none (141318f)

• [Tools]

  • Support additional headers for Google API toolset (ed37e34)
  • Introduces a new AgentEngineSandboxCodeExecutor class that supports executing agent-generated code using the Vertex AI Code Execution Sandbox API (ee39a89)
  • Support dynamic per-request headers in MCPToolset (6dcbb5a)
  • Add bypass_multi_tools_limit option to GoogleSearchTool and VertexAiSearchTool (9a6b850, 6da7274)
  • Extend ReflectAndRetryToolPlugin to support hallucinating function calls (f51380f)
  • Add require_confirmation param for MCP tool/toolset (78e74b5)

• [UI]

  • Granular per agent speech configuration (409df13)

Bug Fixes

• Returns dict as result from McpTool to comply with BaseTool expectations (4df9263)
• Fixes the identity prompt to be one line (7d5c6b9)
• Fix the broken langchain importing caused their 1.0.0 release (c850da3)
• Fix BuiltInCodeExecutor to support visualizations (ce3418a)
• Relax runner app-name enforcement and improve agent origin inference (dc4975d)
• Improve error message when adk web is run in wrong directory (4a842c5)
• Handle App objects in eval and graph endpoints (0b73a69)
• Exclude additionalProperties from Gemini schemas (307896a)
• Overall eval status should be NOT_EVALUATED if no invocations were evaluated (9fbed0b)
• Create context cache only when prefix matches with previous request (9e0b1fb)
• Handle App instances returned by agent_loader.load_agent (847df16)
• Add support for file URIs in LiteLLM content conversion (85ed500)
• Only exclude scores that are None (998264a)
• Better handling the A2A streaming tasks (bddc70b)
• Correctly populate context_id in remote_a2a_agent library (2158b3c)
• Remove unnecessary Aclosing (2f4f561)
• Fix pickle data was truncated error in database session using MySql (36c96ec)

Improvements

• Improve hint message in agent loader (fe1fc75)
• Fixes MCPToolset --> McpToolset in various places (d4dc645)
• Add span for context caching handling and new cache creation (a2d9f13)
• Checks gemini version for 2 and above for gemini-builtin tools (0df6759)
• Refactor and fix state management in the session service (8b3ed05)
• Update agent builder instructions and remove run command details (89344da)
• Clarify how to use adk built-in tool in instruction (d22b8bf)
• Delegate the agent state reset logic to LoopAgent (bb1ea74)
• Adjust the instruction about default model (214986e)
• Migrate invocation_context to callback_context (e2072af)
• Correct the callback signatures (fa84bcb)
• Set default for bypass_multi_tools_limit to False for GoogleSearchTool and VertexAiSearchTool (6da7274)
• Add more clear instruction to the doc updater agent about one PR for each recommended change (b21d0a5)
• Add a guideline to avoid content deletion (16b030b)
• Add an sample agent for the ReflectAndRetryToolPlugin (9b8a4aa)
• Improve error message when adk web is run in wrong directory (4a842c5)
• Add an sample agent for the ReflectAndRetryToolPlugin (9b8a4aa)
• Add span for context caching handling and new cache creation (a2d9f13)
• Disable the scheduled execution for issue triage workflow (bae2102)
• Correct the callback signatures (fa84bcb)

Documentation

• Format README.md for samples (0bdba30)
• Bump models in llms and llms-full to Gemini 2.5 (ce46386)
• Update gemini_llm_connection.py - typo spelling correction (e6e2767)
• Announce the first ADK Community Call in the README (731bb90)

1.16.0 (2025-10-08)

Features

• [Core]
  • Implementation of LLM context compaction (e0dd06f)
  • Support pause and resume an invocation in ADK (ce9c39f, 2f1040f, 1ee01cc, f005414, fbf7576)
• [Models]
  • Add citation_metadata to LlmResponse (3f28e30)
  • Add support for gemma model via gemini api (2b5acb9)
• [Tools]
  • Add dry_run functionality to BigQuery execute_sql tool (960eda3)
  • Add BigQuery analyze_contribution tool (4bb089d)
  • Spanner ADK toolset supports customizable template SQL and parameterized SQL (da62700)
  • Support Oauth2 client credentials grant type (5c6cdcd)
  • Add ReflectRetryToolPlugin to reflect from errors and retry with different arguments when tool errors (e55b894)
  • Support using VertexAiSearchTool built-in tool with other tools in the same agent (4485379)
  • Support using google search built-in tool with other tools in the same agent (d3148da)
• [Evals]
  • Add HallucinationsV1 evaluation metric (8c73d29)
  • Add Rubric based tool use metric (c984b9e)
• [UI]
  • Adds adk web options for custom logo (822efe0)
• [Observability]
  • otel: Switch CloudTraceSpanExporter to telemetry.googleapis.com (bd76b46)

Bug Fixes

• Adapt to new computer use tool name in genai sdk 1.41.0 (c6dd444)
• Add AuthConfig json serialization in vertex ai session service (636def3)
• Added more agent instructions for doc content changes (7459962)
• Convert argument to pydantic model when tool declares it accepts pydantic model as argument (571c802)
• Do not re-create App object when loader returns an App (d5c46e4)
• Fix compaction logic (3f2b457)
• Fix the instruction in workflow_triage example agent (8f3ca03)
• Fixes a bug that causes intermittent pydantic validation errors when uploading files (e680063)
• Handle A2A Task Status Update Event when streaming in remote_a2a_agent (a5cf80b)
• Make compactor optional in Events Compaction Config and add a default (3f4bd67)
• Rename SlidingWindowCompactor to LlmEventSummarizer and refine its docstring (f1abdb1)
• Rollback compaction handling from _get_contents (84f2f41)
• Set max_output_tokens for the agent builder (2e2d61b)
• Set default response modality to AUDIO in run_session (68402bd)
• Update remote_a2a_agent to better handle streaming events and avoid duplicate responses (8e5f361)
• Update the load_artifacts tool so that the model can reliably call it for follow up questions about the same artifact (238472d)
• Fix VertexAiSessionService base_url override to preserve initialized http_options (8110e41, c51ea0b)
• Handle App instances returned by agent_loader.load_agent (847df16)

Improvements

• Migrate VertexAiSessionService to use Agent Engine SDK (90d4c19)
• Migrate VertexAiMemoryBankService to use Agent Engine SDK (d1efc84, 97b950b, 83fd045)
• Add support for resolving $ref and $defs in OpenAPI schemas (a239716)

Documentation

• Update BigQuery samples README (3021266)

1.15.1 (2025-09-26)

Bug Fixes

• Fix the deployment failure for Agent Engine (e172811)

1.15.0 (2025-09-24)

Features

• [Core]
  • Adding the ContextFilterPlugin (a06bf27)
  • Adds plugin to save artifacts for issue #2176 (657369c)
  • Expose log probs of candidates in LlmResponse (f7bd3c1)
• [Context Caching]
  • Support context caching (c66245a)

    • Support explicit context caching auto creation and lifecycle management.

      Usage: App(root_agent=..., plugins=..., context_cache_config=...)

  • Support non-text content in static instruction (61213ce)
  • Support static instructions (9be9cc2)

    • Support static instruction that won't change, put at the beginning of the instruction. Static instruction support inline_data and file_data as contents. Dynamic instruction moved to the end of LlmRequest, increasing prefix caching matching size.

      Usage: LlmAgent(model=...,static_instruction =types.Content(parts=...), ... )

• [Telemetry]
  • Add --otel_to_cloud experimental support (1ae0b82, b131268, 7870480)
  • Add GenAI Instrumentation if --otel_to_cloud is enabled (cee365a)
  • Support standard OTel env variables for exporter endpoints (f157b2e)
  • Temporarily disable Cloud Monitoring integration in --otel_to_cloud (3b80337)
• [Services]
  • Add endpoint to generate memory from session (2595824)
• [Tools]
  • Add Google Maps Grounding Tool to ADK (6b49391)
  • MCP: Initialize tool_name_prefix in MCPToolse (86dea5b)
• [Evals]
  • Data model for storing App Details and data model for steps (01923a9)
  • Adds Rubric based final response evaluator (5a485b0)
  • Populate AppDetails to each Invocation (d486795)
• [Samples]
  • Make the bigquery sample agent run with ADC out-of-the-box (10cf377)

Bug Fixes

• Close runners after running eval (86ee6e3)
• Filter out thought parts when saving agent output to state (632bf8b)
• Ignore empty function chunk in LiteLlm streaming response (8a92fd1)
• Introduces a raw_mcp_tool method in McpTool to provide direct access to the underlying MCP tool (6158075)
• Make a copy of the columns instead of modifying it in place (aef1ee9)
• Prevent escaping of Latin characters in LLM response (c9ea80a)
• Retain the consumers and transport registry when recreating the ClientFactory in remote_a2a_agent.py (6bd33e1)
• Remove unsupported 'type': 'unknown' in test_common.py for fastapi 0.117.1 (3745221)

Documentation

• Correct the documentation of after_agent_callback (b9735b2)

1.14.1 (2025-09-14)

Bug Fixes

• Fix logging issues with RemoteA2aAgent 0c1f1fa

1.14.0 (2025-09-10)

Features

• [A2A]
  • Allow users to pass their own agent card to to_a2a method a1679da
  • Allow custom part converters in A2A classes b05fef9
• [Tools]
  • Allow setting agent/application name and compute project for BigQuery tools 11a2ffe
  • Add BigQuery forecast tool 0935a40
  • Add GkeCodeExecutor for sandboxed code execution on GKE 72ff9c6
  • Add a tool confirmation flow that can guard tool execution with explicit confirmation and custom input a17bcbb
  • Add audience and prompt as configurable for OAuth flows edda922
  • Allow user specify embedding model for file retrieval 67f23df
• [Core]
  • Allow all possible values for agent_class field in all Agent Configs 3bc2d77
  • Allow agent loader to load built-in agents from special directories in adk folder 578fad7
  • Upgrade ADK runner to use App in addition to root_agent 4df79dd
  • Allow inject artifact into instructions bb4cfde
• [Misc] Create an initial ADK release analyzer agent to find the doc updates needed between releases e3422c6

Bug Fixes

• Add custom_metadata to DatabaseSessionService fb009d8
  • NOTE: This requires DB migration, run ALTER TABLE events ADD COLUMN custom_metadata JSON; to migrate existing database tables.
• Add a NOTE to agent transfer instructions listing available agents 43eec82
• Fix pagination of list_sessions in VertexAiSessionService e63fe0c
• Fix AttributeError and indentation in parameter processing of LiteLlm 1e23652
• Allow AgentTool to inherit/use plugins from its invocation context when running 1979dcf
• Enforce foreign key constraint for SQLite DB 0c87907
• Add back installing requirements.txt to Dockerfile template for cloud run 8e43f0d
• Only process the auth responses in the last event with content (if applicable i.e. it's authored by user) 3b922a2
• Extract a utility for aggregating partial streaming responses and emitting LlmResponses for them as needed 7975e8e
• Support saving text artifacts in GCS artifact service cecf7e8
• Fixes thought handling in contents.py and refactors its unit tests a30851e
• Fixes the thought field handling in _planning.py fe8b37b
• Pass state_delta to runner in /run endpoint a3410fa
• Fix discussion answering github action workflow to escape the quote in the discussion content JSON 43c9681
• Send full MIME types for image/video/pdf in get_content e45c3be
• Fix flaky unit tests: tests/unittests/flows/llm_flows/test_functions_simple.py b92b288
• Make UT of a2a consistent about how tests should be skipped when python verison < 3.10 98b0426

Improvements

• Update contribution guide 8174a29
• Skip PR triage for already triaged or Google-contributor PRs 78eea1a
• Avoid mutable default arguments in local_eval_service and runners 64f11a6
• Avoid mutable default arguments in local_eval_service and runners 5b465fd
• Reorder dependencies in pyproject.toml ca5f7f1
• Follow pydantic convention to make field_validator a public method 1448406
• Update comment to clarify after_run callbacks 7720616
• Tune instructions to not ask root directory if it's already provided in the context 25df6c2
• Load discussion data from event content to avoid additional GraphQL API call a503a0c
• Refactor discussion answering agent to merge answer_discussions.py into main.py 408d3df
• Add community repo dependency group to pyproject toml 7b077ac
• Add warning for using Gemini models via LiteLLM 9291daa

Documentation

• Update root_agent description for clarity 467df1a
• Update the ask_data_insights docstring aad1533
• Add contributing Spanner tools RAG agent sample fcd748e

Tests

• Add functional telemetry tests bc6b546
• Add unit tests for the App class and improve Runner initialization tests fc90ce9

Chores

• Use lazy % formatting in logging functions to fix pylint warnings b431072
• Update release cadence in README decc19b
• Update create_session endpoint to use Request message as post body 219815d

1.13.0 (2025-08-27)

Features

• [Tools] Add the ask_data_insights tool for natural language queries on BigQuery data 47b88d2

Bug Fixes

• Add the missing from_config class method in BaseToolset 2dd432c
• Change LlmResponse to use Content for transcriptions 3b997a0
• AgentTool returns last content, instead of the content in the last event bcf0dda
• Fix adk deploy docker file permission ad81aa5
• Updating BaseAgent.clone() and LlmAgent.clone() to properly clone fields that are lists 29bb75f
• Make tool description for bigquery execute_sql for various write modes self contained 167182b
• Set invocation_id and branch for event generated when both output_schema and tools are used 3f3aa7b
• Rework parallel_agent.py to always aclose async generators 826f554
• Add table metadata info into Spanner tool get_table_schema and fix the key usage info 81a53b5
• Fix Spanner DatabaseSessionService support 54ed079
• Add support for required params c144b53
• Replaced hard coded value for user_id to the value from the tool context from parent agent. 0b89f18

Improvements

• Allow user to specify protocol for A2A RPC URL in to_a2a utility 157f731
• Passthrough extra args for adk deploy cloud_run as Cloud Run args 6806dea
• Renames MCPTool and MCPToolset to McpTool and McpToolset 4c70606
• Ignore hidden files in autoformat.sh 0eb65c0

Documentation

• Clean up docs in sample a360bc2
• Fixes root_agent.yaml in tool_mcp_stdio_notion_config for Agent Config sample and add README.md 2c088ac
• Add What's new section to README.md ccab076

Features

[Agent Config] 🌟 NEW FEATURE: Support using config file (YAML) to author agents in addition to python code. See the documentation for details.

• [Agent Config] Support deploying config agent to Agent Engine in CLI (b3b7003)
• [Tools] Add a dedicated Bigtable toolset to provide an easier, integrated way to interact with Bigtable for building AI Agent applications(experimental feature) (a953807)
• [Tools] Support custom tool_name_prefix in auto-generated GoogleApiToolset (a2832d5) See oauth_calendar_agent as an example.
• [CLI] Add build_image option for adk deploy cloud_run CLI (c843503)
• [Services] Add setdefault method to the ADK State object (77ed1f5)

Bug Fixes

• Lazy load VertexAiCodeExecutor and ContainerCodeExecutor (018db79)
• Fix the path for agent card in A2A demo (fa64545)
• Fix the path for agent card in A2A demo (a117cf0)
• litellm-test due to breaking change in dep library of extension extra (004a0a0)
• Using base event's invocation id when merge multiple function response event (279e4fe)
• Avoid crash when there is no candidates_token_count, which is Optional (22f34e9)
• Fix the packaging version comparison logic in adk cli (a2b7909)
• Add Spanner admin scope to Spanner tool default Oauth scopes (b66054d)
• Fixes SequentialAgent.config_type type hint (8a9a271)
• Fixes the host in the ansi bracket of adk web (cd357bf)
• Add spanner tool name prefix (a27927d)

Improvements

• Support ADK_SUPPRESS_EXPERIMENTAL_FEATURE_WARNINGS as environment variable to suppress experimental warnings (4afc9b2)
• Uses pydantic Field for Agent configs, so that the generated AgentConfig.json json schema can carry field description (5b999ed)
• Update openai dependency version, based on correct OPENAI release (bb8ebd1)
• Add the missing license header for core_callback_config init file (f8fd6a4)
• Creates yaml_utils.py in utils to allow adk dump yaml in the same style (1fd58cb)
• Return explict None type for DELETE endpoints (f03f167)
• Add _config suffix to all yaml-based agent examples (43f302c)
• Rename run related method and request to align with the conventions (ecaa7b4)
• Update models in samples/ folder to be gemini 2.0+ (6c217ba)
• Remove the "one commit" requirement from the contributing guide (c32cb6e)
• Bump version to 1.11.0 (8005270)

Documentation

• Add contributing bigtable sample (fef5318)
• Fix core_callback example (ba6e85e)
• Adds a minimal sample to demo how to use Agent Config to create a multi-agent setup (1328e6e)

1.11.0 (2025-08-14)

Features

• [Tools] Support adding prefix to tool names returned by toolset (ebd726f)
• [Eval] Expose print_detailed_results param to AgentEvaluator.evaluate (7e08808)
• [Tools] Add Spanner toolset (breaking change to BigQueryTool, consolidating into generic GoogleTool) (1fc8d20)
• [Core] Support both output_schema and tools at the same time in LlmAgent(sample) (af63567)

Bug Fixes

• A2A RPC URL got overriden by host and port param of adk api server (52284b1)
• Aclose all async generators to fix OTel tracing context (a30c63c)
• Use PreciseTimestamp for create and update time in database session service to improve precision (585141e)
• Ignore AsyncGenerator return types in function declarations (e2518dc)
• Make all subclass of BaseToolset to call parent constructor (8c65967)
• Path parameter extraction for complex Google API endpoints (54680ed)
• Docstring concatenation in 3.13 (88f759a)
• Lazy load retrieval tools and prompt users to install extensions if import failed (9478a31)
• Incorrect logic in LlmRequest.append_tools and make BaseTool to call it (b4ce3b1)
• Creates an InMemoryMemoryService within the EvaluationGenerator (e4d54b6)
• Uncomment OTel tracing in base_llm_flow.py (9cfe433)

Improvements

• Added upper version bounds to dependencies in "pyproject.toml" (a74d334)
• Update python-version in .github/workflows/python-unit-tests.yml to ["3.9", "3.10", "3.11", "3.12", "3.13"] (ddf2e21)
• Update comment to reference "Streamable HTTP Client" (c52f956)
• Remove logging that contains full event data from DatabaseSessionService (bb3735c)
• Add the missing env variables in discussion_answering.yml (a09a5e6)
• Add Gemini API docs as a new datastore for the ADK Answering Agent (5fba196)
• Add the missing license header for some sample agents' files (7d2cb65)
• Add docstring to clarify the behavior of preload memory tool (88114d7)
• Add experimental messages for a2a related API (d0b3b5d)
• Fixes generate_image sample (d674178)
• Make all FastAPI endpoints async (7f12387)
• Group FastAPI endpoints with tags (c323de5)
• Allow implementations to skip defining a close method on Toolset (944e39e)
• Add sample agent to test support of output_schema and tools at the same time for gemini model (f2005a2)
• Add Github workflow config for uploading ADK docs to knowledge store (5900273)
• Update ADK Answering agent to reference doc site instead of adk-docs repo (b5a8bad)

Documentation

• Fixes tool_functions, which is a config-based sample for using tools (c5af44c)
• Add workflow_triage sample for multi-agent request orchestration (e295feb)
• Add examples for config agents (d87feb8)
• Adds pypi badge to README.md (dc26aad)
• Update StreamableHTTPConnectionParams docstring to remove SSE references (8f937b5)

1.10.0 (2025-08-07)

Features

• [Live] Implement Live Session Resumption (71fbc92)
• [Tool] Support parallel execution of parallel function calls (57cd41f)
• [Tool] Create enterprise_web_search_tool as a tool instance (0e28d64)
• [Models] Allow max tokens to be customizable in Claude (7556ebc)

Bug Fixes

• Fix shared default plugin manager and cost manager instances among multiple invocations (423542a)
• Correct the type annotation in anthropic_llm implementation (97318bc)
• Fix adk deploy cloud_run cli, which was broken in v1.9.0 (e41dbcc)
• Remove thoughts from contents in llm requests from history contents (d620bcb)
• Annotate response type as None for transfer_to_agent tool (86a4487)
• Fix incompatible a2a sdk changes (faadef1)
• Fix adk cli options and method parameters mismatching (8ef2177)

Improvements

• Add Github workflow config for the ADK Answering agent (8dc0c94)
• Import AGENT_CARD_WELL_KNOWN_PATH from adk instead of from a2a directly (37dae9b)
• Make LlmRequest.LiveConnectConfig field default to a factory (74589a1)
• Update the prompt to make the ADK Answering Agent more objective (2833030)
• Add sample agent for testing parallel functions execution (90b9193)
• Hide the ask_data_insights tool until the API is publicly available (bead607)
• Change LlmRequest.config's default value to be types.GenerateContentConfig() (041f04e)
• Prevent triggering of _load_from_yaml_config in AgentLoader (db975df)

Documentation

• Fix typos (16a15c8)

1.9.0 (2025-07-31)

Features

• [CLI] Add -v, --verbose flag to enable DEBUG logging as a shortcut for --log_level DEBUG (3be0882)
• [CLI] Add a CLI option to update an agent engine instance (206a132)
• [CLI] Modularize fast_api.py to allow simpler construction of API Server (bfc203a, dfc25c1, e176f03)
• [CLI] Refactor AgentLoader into base class and add InMemory impl alongside existing filesystem impl (bda3df2)
• [CLI] Respect the .ae_ignore file when deploying to agent engine (f29ab5d)
• [Core] Add new callbacks to handle tool and model errors (00afaaf)
• [Core] Add sample plugin for logging (20537e8)
• [Core] Expose Gemini RetryOptions to client (1639298)
• [Evals] Added an Fast API new endpoint to serve eval metric info (c69dcf8)
• [Evals] Refactored AgentEvaluator and updated it to use LocalEvalService (1355bd6)

Bug Fixes

• Add absolutize_imports option when deploying to agent engine (fbe6a7b)
• Add space to allow adk deploy cloud_run --a2a (70c4616)
• Copy the original function call args before passing it to callback or tools to avoid being modified (3432b22)
• Eval module not found exception string (7206e0a)
• Fix incorrect token count mapping in telemetry (c8f8b4a)
• Import cli's artifact dependencies directly (282d67f)
• Keep existing header values while merging tracking headers for llm_request.config.http_options in Gemini.generate_content_async (6191412)
• Merge tracking headers even when llm_request.config.http_options is not set in Gemini.generate_content_async (ec8dd57)
• Restore bigquery sample agent to runnable form (16e8419)
• Return session state in list_session API endpoint (314d6a4)
• Runner was expecting Event object instead of Content object when using early exist feature (bf72426)
• Unable to acquire impersonated credentials (9db5d9a)
• Update agent_card_builder to follow grammar rules (9c0721b), closes #2223
• Use correct type for actions parameter in ApplicationIntegrationToolset (ce7253f)

Documentation

• Update documents about the information of vibe coding (0c85587)

1.8.0 (2025-07-23)

Features

• [Core]Add agent card builder (18f5bea)
• [Core]Add an to_a2a util to convert adk agent to A2A ASGI application (a77d689)
• [Core]Add camel case converter for agents (0e173d7)
• [Evals]Use LocalEvalService to run all evals in cli and web (d1f182e)
• [Evals]Enable FinalResponseMatchV2 metric as an experiment (36e45cd)
• [Models]Add support for model-optimizer-* family of models in vertex (ffe2bdb)
• [Services]Added a sample for History Management (67284fc)
• [Services]Support passing fully qualified agent engine resource name when constructing session service and memory service ([2e77804](https://github.com/google/adk-python/commit/2e778049d0a675e458f4e 35fe4104ca1298dbfcf))
• [Tools]Add ComputerUseToolset (083dcb4)
• [Tools]Allow toolset to process llm_request before tools returned by it (3643b4a)
• [Tools]Support input/output schema by fully-qualified code reference (dfee06a)
• [Tools]Enhance LangchainTool to accept more forms of functions (0ec69d0)

Bug Fixes

• Attention: Logging level for some API requests and responses was moved from INFO to DEBUG (ff31f57)
  • Please set --log_level=DEBUG, if you are interested in having those API request and responses in logs.
• Add buffer to the write file option (f2caf2e)
• Allow current sub-agent to finish execution before exiting the loop agent due to a sub-agent's escalation. (2aab1cf)
• Check that mean_score is a valid float value (65cb6d6)
• Handle non-json-serializable values in the execute_sql tool (13ff009)
• Raise NotFoundError in list_eval_sets function when app_name doesn't exist (b17d8b6)
• Fixed serialization of tools with nested schema (53df35e)
• Set response schema for function tools that returns None (33ac838)
• Support path level parameters for open_api_spec_parser (6f01660)
• Use correct type for actions parameter in ApplicationIntegrationToolset (ce7253f)
• Use the same word extractor for query and event contents in InMemoryMemoryService (1c4c887)

Documentation

• Fix missing toolbox-core dependency and improve installation guide (2486349)

1.7.0 (2025-07-16)

Features

• Add ability to send state change with message 3f9f773
• [Eval] Support for persisting eval run results bab3be2
• Introduce [Plugin]: Plugin is simply a class that packages these individual callback functions together for a broader purpose162228d

Bug Fixes

• Create correct object for image and video content in litellm bf7745f
• Support project-based gemini model path for BuiltInCodeExecutor and all built-in tools a5d6f1e
• Add instruction in long running tool description to avoid being invoked again by model 62a6119
• [A2A] Import A2A well known path from A2A sdk a6716a5
• Fix the long running function response event merge logic 134ec0d
• [A2A] Return final task result in task artifact instead of status message a8fcc1b
• Make InMemoryMemoryService thread-safe 10197db

Improvements

• Improve partial event handling and streaming aggregation 584c8c6

Documentation

• Update agent transfer related doc string and comments b1fa383
• Update doc string for GcsArtifactService 498ce90

1.6.1 (2025-07-09)

Features

• Add A2A support as experimental features f0183a9

  • Install google-adk with a2a extra: pip install google-adk[a2a]
  • Users can serve agents as A2A agent with --a2a option for adk web and adk api_server
  • Users can run a remote A2A agent with RemoteA2AAgent class
  • Three A2A agent samples are added:
    • contributing/samples/a2a_basic
    • contributing/samples/a2a_auth
    • contributing/samples/a2a_human_in_loop

• Support agent hot reload.e545e5a Users can add --reload_agents flag to adk web and adk api_server command to reload agents automatically when new changes are detected.

• Eval features

  • Implement auto rater-based evaluator for responses 75699fb
  • Add Safety evaluator metric 0bd05df
  • Add BaseEvalService declaration and surrounding data models b0d88bf

• Minor features

  • Add custom_metadata to VertexAiSessionService when adding events a021222
  • Support protected write in BigQuery execute_sql tool dc43d51
  • Added clone() method to BaseAgent to allow users to create copies of an agent [d263afd] (https://github.com/google/adk-python/commit/d263afd91ba4a3444e5321c0e1801c499dec4c68)

Bug Fixes

• Support project-based gemini model path to use enterprise_web_search_tool e33161b
• Use inspect.signature() instead of typing.get_type_hints for examining function signatures4ca77bc
• Replace Event ID generation with UUID4 to prevent SQLite integrity constraint failures e437c7a
• Remove duplicate options from adk deploy 3fa2ea7
• Fix scenario where a user can access another users events given the same session id 362fb3f
• Handle unexpected 'parameters' argument in FunctionTool.run_async 0959b06
• Make sure each partial event has different timestamp 17d6042
• Avoid pydantic.ValidationError when the model stream returns empty final chunk 9b75e24
• Fix google_search_tool.py to support updated Gemini LIVE model naming 77b869f
• Adding detailed information on each metric evaluation 04de3e1
• Converts litellm generate config err 3901fad
• Save output in state via output_key only when the event is authored by current agent 20279d9
• Treat SQLite database update time as UTC for session's last update time 3f621ae
• Raise ValueError when sessionId and userId are incorrect combination(#1653) 4e765ae
• Support API-Key for MCP Tool authentication 045aea9
• Lock LangGraph version to <= 0.4.10 9029b8a
• Update the retry logic of create session polling 3d2f13c

Chores

• Extract mcp client creation logic to a separate method 45d60a1
• Add tests for live streaming configs bf39c00
• Update ResponseEvaluator to use newer version of Eval SDK 62c4a85
• Add util to build our llms.txt and llms-full.txt files a903c54
• Create an example for multi agent live streaming a58cc3d
• Refactor the ADK Triaging Agent to make the code easier to read b6c7b5b

Documentation

• Update the a2a exmaple link in README.md d0fdfb8
• Adds AGENTS.md to provide relevant project context for the Gemini CLI 37108be
• Update CONTRIBUTING.md ffa9b36
• Add adk project overview and architecture 28d0ea8
• Add docstring to clarify that inmemory service are not suitable for production dc414cb
• Update agents.md to include versioning strategy 6a39c85
• Add tenacity into project.toml df141db
• Updating CONTRIBUTING.md with missing extra e153d07

1.5.0 (2025-06-25)

Features

• Add a new option eval_storage_uri in adk web & adk eval to specify GCS bucket to store eval data (fa025d7)
• Add ADK examples for litellm with add_function_to_prompt (f33e090)
• Add implementation of VertexAiMemoryBankService and support in FastAPI endpoint (abc89d2)
• Add rouge_score library to ADK eval dependencies, and implement RougeEvaluator that is computes ROUGE-1 for "response_match_score" metric (9597a44)
• Add usage span attributes to telemetry (#356) (ea69c90)
• Add Vertex Express mode compatibility for VertexAiSessionService (00cc8cd)

Bug Fixes

• Include current turn context when include_contents='none' (9e473e0)
• Make LiteLLM streaming truly asynchronous (bd67e84)
• Make raw_auth_credential and exchanged_auth_credential optional given their default value is None (acbdca0)
• Minor typo fix in the agent instruction (ef3c745)
• Typo fix in sample agent instruction (ef3c745)
• Update contributing links (a1e1441)
• Use starred tuple unpacking on GCS artifact blob names (3b1d9a8)

Chore

• Do not send api request when session does not have events (88a4402)
• Leverage official uv action for install(09f1269)
• Update google-genai package and related deps to latest(ed7a21e)
• Add credential service backed by session state(29cd183)
• Clarify the behavior of Event.invocation_id(f033e40)
• Send user message to the agent that returned a corresponding function call if user message is a function response(7c670f6)
• Add request converter to convert a2a request to ADK request(fb13963)
• Support allow_origins in cloud_run deployment (2fd8feb)

1.4.2 (2025-06-20)

Bug Fixes

• Add type checking to handle different response type of genai API client (4d72d31)
  • This fixes the broken VertexAiSessionService
• Allow more credentials types for BigQuery tools (2f716ad)

1.4.1 (2025-06-18)

Features

• Add Authenticated Tool (Experimental) (dcea776)
• Add enable_affective_dialog and proactivity to run_config and llm_request (fe1d5aa)
• Add import session API in the fast API (233fd20)
• Add integration tests for litellm with and without turning on add_function_to_prompt (8e28587)
• Allow data_store_specs pass into ADK VAIS built-in tool (675faef)
• Enable MCP Tool Auth (Experimental) (157d9be)
• Implement GcsEvalSetResultsManager to handle storage of eval sets on GCS, and refactor eval set results manager (0a5cf45)
• Re-factor some eval sets manager logic, and implement GcsEvalSetsManager to handle storage of eval sets on GCS (1551bd4)
• Support real time input config (d22920b)
• Support refresh access token automatically for rest_api_tool (1779801)

Bug Fixes

• Fix Agent generate config err (#1305) (badbcbd)
• Fix Agent generate config error (#1450) (694b712)
• Fix liteLLM test failures (fef8778)
• Fix tracing for live (58e07ca)
• Merge custom http options with adk specific http options in model api request (4ccda99)
• Remove unnecessary double quote on Claude docstring (bbceb4f)
• Set explicit project in the BigQuery client (6d174eb)
• Support streaming in litellm + adk and add corresponding integration tests (aafa80b)
• Support project-based gemini model path to use google_search_tool (b2fc774)
• Update conversion between Celsius and Fahrenheit (1ae176a)

Chores

• Set agent_engine_id in the VertexAiSessionService constructor, also use the agent_engine_id field instead of overriding app_name in FastAPI endpoint (fc65873)

1.3.0 (2025-06-11)

Features

• Add memory_service option to CLI (416dc6f)
• Add support for display_name and description when deploying to agent engine (aaf1f9b)
• Dev UI: Trace View
  • New trace tab which contains all traces grouped by user messages
  • Click each row will open corresponding event details
  • Hover each row will highlight the corresponding message in dialog
• Dev UI: Evaluation
  • Evaluation Configuration: users can now configure custom threshold for the metrics used for each eval run (d1b0587)
  • Each eval case added can now be viewed and edited. Right now we only support edit of text.
  • Show the used metric in evaluation history (6ed6351)
• Tool enhancements:
  • Add url_context_tool (fe1de7b)
  • Support to customize timeout for mcpstdio connections (54367dc)
  • Introduce write protected mode to BigQuery tools (6c999ca)

Bug Fixes

• Agent Engine deployment:
  • Correct help text formatting for adk deploy agent_engine (13f98c3)
  • Handle project and location in the .env properly when deploying to Agent Engine (0c40542)
• Fix broken agent graphs (3b1f2ae)
• Forward __annotations__ to the fake func for FunctionTool inspection (9abb841)
• Handle the case when agent loading error doesn't have msg attribute in agent loader (c224626)
• Prevent agent_graph.py throwing when workflow agent is root agent (4b1c218)
• Remove display_name for non-Vertex file uploads (cf5d701)

Documentation

• Add DeepWiki badge to README (f38c08b)
• Update code example in tool declaration to reflect BigQuery artifact description (3ae6ce1)

1.2.1 (2025-06-04)

Bug Fixes

• Import deprecated from typing_extensions (068df04)

1.2.0 (2025-06-04)

Features

• Add agent engine as a deployment option to the ADK CLI (2409c3e)
• Add an option to use gcs artifact service in adk web. (8d36dbd)
• Add index tracking to handle parallel tool call using litellm (05f4834)
• Add sortByColumn functionality to List Operation (af95dd2)
• Add implementation for get_eval_case, update_eval_case and delete_eval_case for the local eval sets manager. (a7575e0)
• Expose more config of VertexAiSearchTool from latest Google GenAI SDK (2b5c89b)
• New Agent Visualization (da4bc0e)
• Set the max width and height of view image dialog to be 90% (98a635a)
• Support Langchain StructuredTool for Langchain tool (7e637d3)
• Support Langchain tools that has run_manager in _run args and don't have args_schema populated (3616bb5)
• Update for anthropic models (16f7d98)
• Use bigquery scope by default in bigquery credentials. (ba5b80d)
• Add jira_agent adk samples code which connect Jira cloud (8759a25)
• Render HTML artifact in chat window (5c2ad32)
• Add export to json button in the chat window (fc3e374)
• Add tooltip to the export session button (2735942)

Bug Fixes

• Add adk icon for UI (2623c71)
• Add cache_ok option to remove sa warning. (841e10a)
• Add support for running python main function in UnsafeLocalCodeExecutor when the code has an if _name_ == "_main_" statement. (95e33ba)
• Adk web not working on some env for windows, fixes https://github.com/google/adk-web/issues/34 (daac8ce)
• Assign empty inputSchema to MCP tool when converting an ADK tool that wraps a function which takes no parameters. (2a65c41)
• Call all tools in parallel calls during partial authentication (0e72efb)
• Continue fetching events if there are multiple pages. (6506302)
• Do not convert "false" value to dict (60ceea7)
• Enhance agent loader exception handler and expose precise error information (7b51ae9)
• Ensure function description is copied when ignoring parameters (7fdc6b4)
• Filter memory by app_name and user_id. (db4bc98)
• Fix filtering by user_id for vertex ai session service listing (9d4ca4e)
• fix parameter schema generation for gemini (5a67a94)
• Handle non-indexed function call chunks with incremental fallback index (b181cbc)
• Handles function tool parsing corner case where type hints are stored as strings. (a8a2074)
• Introduce PreciseTimestamp to fix mysql datetime precision issue. (841e10a)
• match arg case in errors (b226a06)
• ParallelAgent should only append to its immediate sub-agent, not transitive descendants (ec8bc73)
• Relax openapi spec to gemini schema conversion to tolerate more cases (b1a74d0)
• Remove labels from config when using API key from Google AI Studio to call model (5d29716)
• sample: Correct text artifact saving in artifact_save_text sample (5c6001d)
• Separate thinking from text parts in streaming mode (795605a)
• Simplify content for ollama provider (eaee49b)
• Timeout issues for mcpstdio server when mcp tools are incorrect. (45ef668)
• transfer_to_agent: update docstring for clarity and accuracy (854a544)
• Update unit test code for test_connection (b0403b2)
• Use inspect.cleandoc on function docstrings in generate_function_declaration. (f7cb666)
• Restore errors path (32c5ffa)
• Unused import for deprecated (ccd05e0)
• Prevent JSON parsing errors and preserve non-ascii characters in telemetry (d587270)
• Raise HTTPException when running evals in fast_api if google-adk[eval] is not installed (1de5c34)
• Fix typos in README for sample bigquery_agent and oauth_calendar_agent (9bdd813)
• Make tool_call one span for telemetry and renamed to execute_tool (999a7fe)
• Use media type in chat window. Remove isArtifactImage and isArtifactAudio reference (1452dac)
• Set output_schema correctly for LiteLllm (6157db7)
• Update pending event dialog style (1db601c)
• Remove the gap between event holder and image (63822c3)

Documentation

• Adds a sample agent to illustrate state usage via callbacks. (18fbe3c)
• Fix typos in documentation (7aaf811)
• Change eval_dataset to eval_dataset_file_path_or_dir (62d7bf5)
• Fix broken link to A2A example (0d66a78)
• Fix typo in envs.py (bd588bc)
• Updates CONTRIBUTING.md to refine setup process using uv. (04e07b4)
• Create and update project documentation including README.md and CONTRIBUTING.md (f180331)
• Rename the root agent in the example to match the example name (94c0aca)
• ADK: add section comment (349a414)

Chore

• Miscellaneous changes (0724a83, a9dcc58, ac52eab, a0714b8)
• Enable release-please workflow (57d99aa)
• Added unit test coverage for local_eval_sets_manager.py (174afb3)
• Extract common options for adk web and adk api_server (01965bd)

1.1.1

Features

• Add BigQuery first-party tools. See here for more details.

1.1.0

Features

• Extract agent loading logic from fast_api.py to a separate AgentLoader class and support more agent definition folder/file structure.
• Added audio play in web UI.
• Added input transcription support for live/streaming.
• Added support for storing eval run history locally in adk eval cli.
• Image artifacts can now be clicked directly in chat message to view.
• Left side panel can now be resized.

Bug Fixes

• Avoid duplicating log in stderr.
• Align event filtering and ordering logic.
• Add handling for None param.annotation.
• Fixed several minor bugs regarding eval tab in web UI.

Miscellaneous Chores

• Updates mypy config in pyproject.toml.
• Add google search agent in samples.
• Update filtered schema parameters for Gemini API.
• Adds autoformat.sh for formatting codebase.

1.0.0

⚠ BREAKING CHANGES

• Evaluation dataset schema is finalized with strong-type pydantic models. (previously saved eval file needs re-generation, for both adk eval cli and the eval tab in adk web UI).
• BuiltInCodeExecutor (in code_executors package) replaces BuiltInCodeExecutionTool (previously in tools package).
• All methods in services are now async, including session service, artifact service and memory service.
  • list_events and close_session methods are removed from session service.
• agent.py file structure with MCP tools are now easier and simpler (now vs before). Old format is not working anymore.
• Memory schema and MemoryService is redesigned.
• Mark various class attributes as private in the classes in the tools package.
• Disabled session state injection if instruction provider is used. (so that you can have {var_name} in the instruction, which is required for code snippets)
• Toolbox integration is revamped: tools/toolbox_tool.py → tools/toolbox_toolset.py.
• Removes the experimental remote_agent.py. We'll redesign it and bring it back.

Features

• Dev UI:
  • A brand new trace view for overall agent invocation.
  • A revamped evaluation tab and comparison view for checking eval results.
• Introduced BaseToolset to allow dynamically add/remove tools for agents.
  • Revamped MCPToolset with the new BaseToolset interface.
  • Revamped GoogleApiTool, GoogleApiToolset and ApplicationIntegrationToolset with the new BaseToolset interface.
  • Resigned agent.py file structure when needing MCPToolset.
  • Added ToolboxToolset.
• Redesigned strong-typed agent evaluation schema.
  • Allows users to create more cohesive eval sets.
  • Allows evals to be extended for non-text modality.
  • Allows for a structured interaction with the uber eval system.
• Redesigned Memory schema and MemoryService interfaces.
• Added token usage to LlmResponse.
• Allowed specifying --adk_version in adk deploy cloud_run cli. Default is the current version.

Bug Fixes

• Fixed adk deploy cloud_run failing bug.
• Fixed logs not being printed due to google-auth library.

Miscellaneous Chores

• Display full help text when adk cli receives invalid arguments.
• adk web now binds 127.0.0.1 by default, instead of 0.0.0.0.
• InMemoryRunner now takes BaseAgent in constructor.
• Various docstring improvements.
• Various UI tweaks.
• Various bug fixes.
• Update various contributing/samples for contributors to validate the implementation.

Full Changelog: https://github.com/google/adk-python/compare/v0.5.0...v1.0.0

0.5.0

⚠ BREAKING CHANGES

• Updated artifact and memory service interface to be async. Agents that interact with these services through callbacks or tools will now need to adjust their invocation methods to be async (using await), or ensure calls are wrapped in an asynchronous executor like asyncio.run(). Any service that extends the base interface must also be updated.

Features

• Introduced the ability to chain model callbacks.
• Added support for async agent and model callbacks.
• Added input transcription support for live/streaming.
• Captured all agent code error and display on UI.
• Set param required tag to False by default in openapi_tool.
• Updated evaluation functions to be asynchronous.

Bug Fixes

• Ensured a unique ID is generated for every event.
• Fixed the issue when openapi_specparser has parameter.required as None.
• Updated the 'type' value on the items/properties nested structures for Anthropic models to adhere to JSON schema.
• Fix litellm error issues.

Miscellaneous Chores

• Regenerated API docs.
• Created a contributing folder and added samples.
• Updated the contributing guide.
• Docstring improvements, typo fixings, GitHub action to enforce code styles on formatting and imports, etc.

0.4.0

⚠ BREAKING CHANGES

• Set the max size of strings in database columns. MySQL mandates that all VARCHAR-type fields must specify their lengths.
• Extract content encode/decode logic to a shared util, resolve issues with JSON serialization, and update key length for DB table to avoid key too long issue in mysql.
• Enhance FunctionTool to verify if the model is providing all the mandatory arguments.

Features

• Update ADK setup guide to improve onboarding experience.
• feat: add ordering to recent events in database session service.
• feat(llm_flows): support async before/after tool callbacks.
• feat: Added --replay and --resume options to adk run cli. Check adk run --help for more details.
• Created a new Integration Connector Tool (underlying of the ApplicationIntegrationToolSet) so that we do not force LLM to provide default value.

Bug Fixes

• Don't send content with empty text to LLM.
• Fix google search reading undefined for renderedContent.

Miscellaneous Chores

• Docstring improvements, typo fixings, github action to enfore code styles on formatting and imports, etc.

0.3.0

⚠ BREAKING CHANGES

• Auth: expose access_token and refresh_token at top level of auth credentails, instead of a dict (commit).

Features

• Added support for running agents with MCPToolset easily on adk web.
• Added custom_metadata field to LlmResponse, which can be used to tag LlmResponse via after_model_callback.
• Added --session_db_url to adk deploy cloud_run option.
• Many Dev UI improvements:
  • Better google search result rendering.
  • Show websocket close reason in Dev UI.
  • Better error message showing for audio/video.

Bug Fixes

• Fixed MCP tool json schema parsing issue.
• Fixed issues in DatabaseSessionService that leads to crash.
• Fixed functions.py.
• Fixed skip_summarization behavior in AgentTool.

Miscellaneous Chores

• README.md impprovements.
• Various code improvements.
• Various typo fixes.
• Bump min version of google-genai to 1.11.0.

New Contributors

• @RashRAJ made their first contribution in https://github.com/google/adk-python/pull/274
• @n1lanjan made their first contribution in https://github.com/google/adk-python/pull/272
• @vgnshiyer made their first contribution in https://github.com/google/adk-python/pull/324
• @wyf7107 made their first contribution in https://github.com/google/adk-python/pull/355

Full Changelog: https://github.com/google/adk-python/compare/v0.2.0...v0.3.0

⚠ BREAKING CHANGES

• Fix typo in method name in Event: has_trailing_code_exeuction_result --> has_trailing_code_execution_result.

Features

• adk CLI:
  • Introduce adk create cli tool to help creating agents.
  • Adds --verbosity option to adk deploy cloud_run to show detailed cloud run deploy logging.
• Improve the initialization error message for DatabaseSessionService.
• Lazy loading for Google 1P tools to minimize the initial latency.
• Support emitting state-change-only events from planners.
• Lots of Dev UI updates, including:
  • Show planner thoughts and actions in the Dev UI.
  • Support MCP tools in Dev UI. (NOTE: agent.py interface is temp solution and is subject to change)
  • Auto-select the only app if only one app is available.
  • Show grounding links generated by Google Search Tool.
• .env file is reloaded on every agent run.

Bug Fixes

• LiteLlm: arg parsing error and python 3.9 compatibility.
• DatabaseSessionService: adds the missing fields; fixes event with empty content not being persisted.
• Google API Discovery response parsing issue.
• load_memory_tool rendering issue in Dev UI.
• Markdown text overflows in Dev UI.

Miscellaneous Chores

• Adds unit tests in Github action.
• Improves test coverage.
• Various typo fixes.

Details:

• fix: Update README evaluate link by @kweinmeister in https://github.com/google/adk-python/pull/4
• chore: update evals.py by @eltociear in https://github.com/google/adk-python/pull/24
• Fix: typos reponse -> response by @Howe829 in https://github.com/google/adk-python/pull/22
• docs: update ToolboxTool docstring by @jackwotherspoon in https://github.com/google/adk-python/pull/7
• Moves unittests to root folder and adds github action to run unit tests. by @Jacksunwei in https://github.com/google/adk-python/pull/72
• Update issue templates by @hangfei in https://github.com/google/adk-python/pull/64
• Update README.md by @hangfei in https://github.com/google/adk-python/pull/104
• Fix typos in docstrings across multiple files by @fyhe8082 in https://github.com/google/adk-python/pull/101
• Update README.md by @hangfei in https://github.com/google/adk-python/pull/107
• Fixed typo in README.md : cooridnator -> coordinator by @kshitizz36 in https://github.com/google/adk-python/pull/112
• Add .gitignore file to exclude common Python, IDE, and environment files by @fangyh20 in https://github.com/google/adk-python/pull/109
• chore: Add subreddit README badge by @kweinmeister in https://github.com/google/adk-python/pull/122
• Fix typos in docstrings of evaluation_generator.py and event.py (#101) by @fangyh20 in https://github.com/google/adk-python/pull/121
• Fix empty list in content on tool calls causing ollama parse error by @selcukgun in https://github.com/google/adk-python/pull/102
• Update README.md by @hangfei in https://github.com/google/adk-python/pull/126
• fix bug in README.md by @palladius in https://github.com/google/adk-python/pull/185
• Rename 'ctx' parameter in documentation label to 'tool_context', for consistency by @gsarthakdev in https://github.com/google/adk-python/pull/162
• Add parallel tool call support for litellm by @selcukgun in https://github.com/google/adk-python/pull/172
• Update DatabaseSessionService db_engine construction by @DeanChensj in https://github.com/google/adk-python/pull/195
• Update README.md by @hangfei in https://github.com/google/adk-python/pull/193
• Update python-unit-tests.yml by @hangfei in https://github.com/google/adk-python/pull/257
• Update CHANGELOG.md by @hangfei in https://github.com/google/adk-python/pull/260
• fix typos in tools/ and tests/ by @trandangtrungduc in https://github.com/google/adk-python/pull/243

New Contributors

• @kweinmeister made their first contribution in https://github.com/google/adk-python/pull/4
• @eltociear made their first contribution in https://github.com/google/adk-python/pull/24
• @Howe829 made their first contribution in https://github.com/google/adk-python/pull/22
• @jackwotherspoon made their first contribution in https://github.com/google/adk-python/pull/7
• @Jacksunwei made their first contribution in https://github.com/google/adk-python/pull/72
• @hangfei made their first contribution in https://github.com/google/adk-python/pull/64
• @fyhe8082 made their first contribution in https://github.com/google/adk-python/pull/101
• @kshitizz36 made their first contribution in https://github.com/google/adk-python/pull/112
• @fangyh20 made their first contribution in https://github.com/google/adk-python/pull/109
• @selcukgun made their first contribution in https://github.com/google/adk-python/pull/102
• @palladius made their first contribution in https://github.com/google/adk-python/pull/185
• @gsarthakdev made their first contribution in https://github.com/google/adk-python/pull/162
• @DeanChensj made their first contribution in https://github.com/google/adk-python/pull/195
• @trandangtrungduc made their first contribution in https://github.com/google/adk-python/pull/243

Full Changelog: https://github.com/google/adk-python/compare/v0.1.0...v0.2.0

Initial release of the Agent Development Kit (ADK).

Features

• Multi-agent support
• Tool authentication support
• Rich tool support(including MCP)
• Rich callback support
• Built-in code execution capability
• Asynchronous runtime and execution
• (Experimental) Live(Bidi) agent support and Compositional Function Calling(CFC) support