Release 1.6.1

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] (d263afd)

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

v1.5.0

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)

v1.4.2

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)

v1.4.1

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)

v1.3.0

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)

v1.2.1

1.2.1 (2025-06-04)

Bug Fixes

• Import deprecated from typing_extensions (068df04)

v1.2.0

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 google/adk-web#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](349a414120fbff0937966af95...

v1.1.1

1.1.1

Features

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

v1.1.0

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.

v1.0.0

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: v0.5.0...v1.0.0