google/adk-python v1.19.0

1.19.0

on GitHub

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)