google/adk-python v1.22.0

on GitHub

Features

• [Core]

  • Make LlmAgent.model optional with a default fallback (b287215).
  • Support regex for allowed origins (2ea6e51).
  • Enable PROGRESSIVE_SSE_STREAMING feature by default (0b1cff2).

• [Evals]

  • Add custom instructions support to LlmBackedUserSimulator (a364388).
  • Introduce a post-hoc, per-turn evaluator for user simulations (e515e0f).

• [Tools]

  • Expose mcps streamable http custom httpx factory parameter (bfed19c).
  • Add a handwritten tool for Cloud Pub/Sub (b6f6dcb).
  • Add token_endpoint_auth_method support to OAuth2 credentials (8782a69).

• [Services]

  • Introduce new JSON-based database schema for DatabaseSessionService, which will be used for newly-created databases. A migration command and script are provided.(7e6ef71 ba91fea ce64787).
  • Set log level when deploying to Agent Engine (1f546df).

• [A2A]

  • Update event_converter used in A2ARemote agent to use a2a_task.status.message only if parts are non-empty (e4ee9d7).

Bug Fixes

• Add checks for event content and parts before accessing (5912835).
• Validate app name in adk create command (742c926).
• Prevent .env files from overriding existing environment variables (0827d12).
• Prevent ContextFilterPlugin from creating orphaned function responses (e32f017).
• Update empty event check to include executable code and execution results (688f48f).
• Make the BigQuery analytics plugin work with agents that don't have instructions such as the LoopAgent (8bed01c).
• Label response as thought if task is immediately returned as working (4f3b733).
• Move and enhance the deprecation warning for the plugins argument in "_validate_runner_params" to the beginning of the function (43270bc).
• Oauth refresh not triggered on token expiry (69997cd).
• Fix double JSON encoding when saving eval set results (fc4e3d6).
• Allow string values for ToolTrajectoryCriterion.match_type (93d6e4c).
• Fix inconsistent method signatures for evaluate_invocations (0918b64).
• Honor the modalities parameter in adk api server for live API (19de45b).
• Filter out thought parts in lite_llm._get_content (1ace8fc).
• Rehydration of EventActions in StorageEvent.to_event (838530e).
• Heal missing tool results before LiteLLM requests (6b7386b).
• Refine Ollama content flattening and provider checks (c6f389d).
• Add MIME type inference and default for file URIs in LiteLLM (5c4bae7).
• Use mode='json' in model_dump to serialize bytes correctly when using telemetry (96c5db5).
• Avoid local .adk storage in Cloud Run/GKE (b30c2f4).
• Remove fallback to cached exchanged credential in _load_existing_credential (1ae0e16).
• Handle overriding of requirements when deploying to agent engine (38a30a4).
• Built-in agents (names starting with "__") now use in-memory session storage instead of creating .adk folders in the agents directory (e3bac1a).
• Change error_message column type to TEXT in DatabaseSessionService (8335f35).
• Add schema type sanitization to OpenAPI spec parser (6dce7f8).
• Prevent retry_on_errors from retrying asyncio.CancelledError (30d3411).
• Include back-ticks around the BQ asset names in the tools examples (8789ad8).
• Fix issue with MCP tools throwing an error (26e77e1).
• Exclude thought parts when merging agent output (07bb164).
• Prepend "https://" to the MCP server url only if it doesn't already have a scheme (71b3289).
• Split SSE events with both content and artifactDelta in ADK Web Server (084fcfa).
• Propagate RunConfig custom metadata to all events (e3db2d0).
• Harden YAML builder tmp save/cleanup(6f259f0).
• Ignore adk-bot administrative actions in stale agent (3ec7ae3).
• Only prepend "https://" to the MCP server url if it doesn't already have a scheme (71b3289).
• Check all content parts for emptiness in _contains_empty_content (f35d129).

Improvements

• Remove unnecessary event loop creation in LiveRequstQueue constructor (ecc9f18).
• Close database engines to avoid aiosqlite pytest hangs (4ddb2cb).
• Add override_feature_enabled to override the default feature enable states (a088506).
• Move SQLite migration script to migration/ folder (e8ab7da).
• Update latest Live Model names for sample agent (f1eb1c0).
• Update google-genai and google-cloud-aiplatform versions (d58ea58).
• Introduce MetricInfoProvider interface, and refactor metric evaluators to use this interface to provide MetricInfo (5b7c8c0).
• Update _flatten_ollama_content return type and add tests (fcea86f).
• Add disambiguation message to enterprise_search_tool (8329fec).
• Add x-goog-user-project header to http calls in API Registry (0088b0f).
• Set the default response modality to AUDIO only (a4b914b).