adk-python/CHANGELOG.md

Changelog

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.

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 developer 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 credentials, 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 improvements.
• Various code improvements.
• Various typo fixes.
• Bump min version of google-genai to 1.11.0.

0.2.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.

0.1.0

Features

• Initial release of the Agent Development Kit (ADK).
• Multi-agent, agent-as-workflow, and custom agent support
• Tool authentication support
• Rich tool support, e.g. built-in tools, google-cloud tools, third-party tools, and MCP tools
• Rich callback support
• Built-in code execution capability
• Asynchronous runtime and execution
• Session, and memory support
• Built-in evaluation support
• Development UI that makes local development easy
• Deploy to Google Cloud Run, Agent Engine
• (Experimental) Live(Bidi) audio/video agent support and Compositional Function Calling(CFC) support