adk_litertlm

🚀 What's New in v2026.8.17

🌟 Core Framework & Upstream Sync (ADK v2.7.0 & JS v1.6.0 Parity)

• LlmCapabilities (lib/src/models/capabilities.dart): Added standardized capability negotiation system (outputSchemaAndTools, etc.) across BaseLlm and Gemini.
• GetUserChoiceTool (lib/src/tools/get_user_choice_tool.dart): Added user choice interruption and multi-turn waiting helper (getUserChoice).
• FunctionTool Parameter Feedback: Return self-correcting parameter error guidance for missing mandatory args to prompt the LLM to provide required parameters.
• Multimodal Tool Results Extraction: Automatic separation of inline binary parts into FunctionResponse.parts to prevent JSON serialization issues.
• Orphaned FunctionResponse Pruning: Automatic pruning in contents.dart to prevent Gemini 400 Bad Request errors when function calls are compacted/removed.
• Memory Namespace Isolation: Tuple record keys (appName, userId) in InMemoryMemoryService to prevent delimiter collisions when identifiers contain slashes.
• Streaming Thought Signature Preservation: Seamless thoughtSignature preservation across streaming text chunks.
• StaleSessionError (lib/src/errors/stale_session_error.dart): Optimistic concurrency exception handling in SQLite & database session services.
• adk-web & Telemetry Endpoint: Full synchronization of compiled UI bundle assets (lib/src/cli/browser/) + CSRF-protected /config/telemetry endpoint.

📱 flutter_adk & Sub-packages

• flutter_adk (v2026.8.17): Exported Web-safe parity symbols (LlmCapabilities, GetUserChoiceTool, StaleSessionError, SessionNotFoundError, ReflectAndRetryModelPlugin, ReflectAndRetryToolPlugin) + upgraded web: ^1.1.1 and plugin_platform_interface: ^2.1.8.
• adk_litertlm (v2026.8.17): Upgraded litertlm: ^0.0.13 and aligned runtime interface with new conversation methods.
• adk_mcp (v2026.8.17): Synchronized client protocol primitives and upgraded dependencies.
• adk (v2026.8.17): Package alias updated to 2026.8.17.

📦 Published Packages on pub.dev

• adk_dart 2026.8.17
• adk 2026.8.17
• adk_mcp 2026.8.17
• flutter_adk 2026.8.17
• adk_litertlm 2026.8.17

• Synced latest core features & bug fixes from adk-python v2.7.0, adk-js v1.6.0, adk-go v2.2.0, and adk-kotlin v0.7.0:
  • Added LlmCapabilities (lib/src/models/capabilities.dart) model feature capability reporting system and updated BaseLlm.capabilities & Gemini.capabilities.
  • Added GetUserChoiceTool (lib/src/tools/get_user_choice_tool.dart) with getUserChoice callable helper for user choice prompts.
  • Enhanced FunctionTool with self-correction feedback returned to the model when mandatory required parameters are missing.
  • Added 20MB file size guard (maxArtifactSizeBytes = 20 * 1024 * 1024) to SaveFilesAsArtifactsPlugin to protect against oversized artifact payloads.
  • Supported multimodal media extraction (FunctionResponse.parts) from tool execution results in functions.dart.
  • Added automatic orphaned function_response pruning (_dropOrphanedFunctionResponses) in ContentsLlmRequestProcessor (contents.dart).
  • Improved InMemoryMemoryService with tuple record keys ((appName, userId)) to prevent delimiter collisions when identifiers contain slashes.
  • Enhanced StreamingResponseAggregator to preserve thoughtSignature across streamed text chunk runs without premature buffer flushing.
  • Aligned Gemini EAP model detection regex in model_name_utils.dart (r'^gemini-(?:[a-z0-9_]+(?:-[a-z0-9_]+)*-)?early-exp\d*$').
  • Added StaleSessionError (lib/src/errors/stale_session_error.dart) for optimistic concurrency write conflicts in database and SQLite session services.
  • Implemented Live API Voice Activity Detection (VAD) with VoiceActivity, VoiceActivityType, and explicitVadSignal in RunConfig and LiveConnectConfig.
  • Added FunctionResponseScheduling (whenIdle, silent, interrupt) and non-blocking background tool execution dispatching (activeNonBlockingToolTasks) in Live mode.
  • Implemented Workflow as Tool (WorkflowTool and Workflow.asTool()) allowing workflows to be invoked directly via function calling.
  • Added EventarcToolset and publishEventarcMessage for publishing structured CloudEvents 1.0 to Google Cloud Eventarc Advanced message buses.
  • Added DaytonaEnvironment execution environment for remote isolated cloud workspace sandboxes.
  • Implemented LlmAudioUserSimulator for multimodal speech/TTS conversation simulation and evaluation.
  • Added DatabaseSessionService.prepareTables() and BaseSessionService.prepareTables() for proactive table creation and migration.
  • Added create_data_agent tool in DataAgentToolset.
  • Added memory_id and allowed_topics support in VertexAiMemoryBankService.
  • Added Gemma 4 regex pattern matching (gemma-(3|4).*) in GemmaLlm.supportedModels().
  • Added comprehensive parity unit test suite in test/recent_upstream_parity_features_test.dart (1,517 total tests passing).

• Bumped package version to 2026.8.17 and dependency adk_dart: ^2026.8.17.
• Upgraded litertlm dependency to ^0.0.13 and collection to ^1.19.1.
• Aligned runtime interface with litertlm 0.0.13 conversation methods.

• Full Decoupling & Migration of packages/adk CLI Toolchain:
  • Physically migrated all CLI submodules (lib/src/cli/, lib/src/dev/, lib/src/cli/browser/, Angular Web UI static bundle) and 19 CLI/Dev test suites into packages/adk.
  • Fully purged all CLI/Dev/WebServer code and executables from adk_dart, establishing adk_dart as a 100% pure Core SDK library package.
  • Configured packages/adk as a standalone binary package publishable to pub.dev with direct dependency declarations.
• 100% CLI Parity with adk-python:
  • Created official parity matrix documentation in docs/architecture/cli_parity_matrix.md.
  • Implemented adk telemetry (enable, disable, status) subcommands for telemetry preference management.
  • Implemented adk test [folder] for executing agent test suites.
  • Added Dart-ecosystem diagnostic command adk doctor / adk diag displaying system, SDK, architecture, and path diagnostics.
• Examples Modernization & gemini-3.7-flash Upgrade:
  • Upgraded all 18 examples in adk_dart/examples and CLI starter templates to use gemini-3.7-flash by default.
  • Applied Dart 3.8+ dot-shorthands (.userText(...), .modelText(...), .user, .text(...)) across all example entrypoints.
• Quality Assurance:
  • 100% test pass rate across all workspace packages: 1,369 tests in adk_dart, 159 tests in packages/adk, 11 tests in flutter_adk, 12 tests in adk_mcp, 5 tests in adk_litertlm (1,556 tests total).
  • 0 analyzer warnings / errors across packages/adk, packages/flutter_adk, packages/adk_mcp, packages/adk_litertlm, and examples.

• Bumped package version to 2026.8.17+1 and dependency adk_dart: ^2026.8.17.
• Synced release with adk_dart 2026.8.17+1 rollout.

• Updated all README installation and dependency configuration sections across all ecosystem packages to 2026.8.17+2.

• Added Installation section to README with dart pub add and pubspec.yaml dependency specifications.

2026.7.30

• Bumped package release versions to 2026.7.30 for adk_dart, adk, adk_mcp, flutter_adk, and adk_litertlm.
• Added ReflectAndRetryModelPlugin for framework-level LLM error recovery, self-healing reflection tool calls (adkHandleModelError), and retry tracking.
• Added FunctionTool declaration caching (_cachedDeclaration) to eliminate redundant parameter schema rebuilds during agent turns.
• Standardized SessionNotFoundError handling across session services, agent runners, and dev web server.
• Updated MCP protocol support to official specification version 2026-07-28 (mcpLatestProtocolVersion = 2026-07-28).
• Added elicitationCallback support (elicitation/create and notifications/elicitation/complete) to McpToolset and McpSessionManager for client-side user input & OAuth challenge handling.
• Added AdkAgentMcpServer to expose any ADK BaseAgent as a compliant MCP server over tool interfaces.
• Implemented LoadWebPageTool and EnterpriseWebSearchTool (ported from adk-js) for web scraping with SSRF prevention and Vertex AI search grounding.

• Bumped package release versions to 2026.7.30 for adk_dart, adk, adk_mcp, flutter_adk, and adk_litertlm.
• Added ReflectAndRetryModelPlugin (lib/src/plugins/reflect_retry_model_plugin.dart) for framework-level LLM error recovery, self-healing reflection tool calls (adkHandleModelError), and retry tracking.
• Added FunctionTool declaration caching (_cachedDeclaration) to eliminate redundant parameter schema rebuilds during agent turns.
• Standardized SessionNotFoundError handling across session services, agent runners, and dev web server.
• Updated MCP protocol support to official specification version 2026-07-28 (mcpLatestProtocolVersion = '2026-07-28').
• Added elicitationCallback support (elicitation/create and notifications/elicitation/complete) to McpToolset and McpSessionManager for client-side user input & OAuth challenge handling.
• Added AdkAgentMcpServer (lib/src/tools/mcp_tool/agent_to_mcp.dart) to expose any ADK BaseAgent as a compliant MCP server over tool interfaces.
• Implemented LoadWebPageTool and EnterpriseWebSearchTool (ported from adk-js) for web scraping with SSRF prevention and Vertex AI search grounding.

• Bumped package version to 2026.7.30 and dependency adk_dart: ^2026.7.30.

• Bumped package release versions to 2026.7.24 for adk_dart, adk, adk_mcp, flutter_adk, and adk_litertlm.
• Synced latest core features & bug fixes from adk-python (be5828f3..07455ee6):
  • Added user labels (labels) support in RunConfig and automatic merging in BasicLlmRequestProcessor to propagate Vertex AI billing/attribution labels.
  • Guarded resumable invocation replay in BaseLlmFlow against partial streaming function-call SSE events to prevent replay loops.
  • Expanded AnthropicLlm finishReason mapping to support pause_turn (STOP) and refusal (SAFETY).
  • Fixed VertexAiSessionService.getSession to apply afterTimestamp server-side filtering alongside numRecentEvents.
  • Added opt-in finalResponseToolNames to BigQueryAgentAnalyticsPlugin to log final answer tool call payloads as AGENT_RESPONSE events.
• Added comprehensive unit test suite in test/python_upstream_updates_test.dart (1,105 total unit tests passing).
• Fixed nested workflow resume by yielding resolved outputs of resumed request-input nodes on resume instead of skipping them.
• Fixed AgentNode.run event loop to not misclassify endOfAgent and agentState checkpoint events as finalEvent.
• Enhanced LoadArtifactsTool with Gemini unsupported inline MIME type blocklist (SVG/XML image variants) to deliver them as text.
• Rebuilt and updated the bundled Web UI assets (adk-web) to the latest version to support nested navigation breadcrumbs, bidi streaming restarts, and usage token counts.
• Renamed the example folder to examples and reorganized all code examples into self-contained, user-friendly Dart project templates with individual README.md and dependency setup files in 4 languages (KO, EN, JA, ZH).
• Implemented a default HTTP completions invoker inside LiteLlm supporting streaming (SSE) and non-streaming requests to connect out-of-the-box with Ollama and LiteLLM servers.
• Added new local model examples: 08_local_llm_ollama_litellm (Ollama/LiteLLM integration via LiteLlm client) and 09_local_llm_litert (on-device Gemma inference via adk_litertlm sub-package).

• Bumped package version to 2026.7.24.
• Updated dependency alignment to adk_dart: ^2026.7.24.
• Synced release with adk_dart 2026.7.24 rollout.

What's New in 2026.7.11

• ADK 2.0 Workflows & Managed Agent (Interactions): Full support for the new ADK 2.0 features:
  • v2 Workflows: Declarative node graph scheduling, fan-out edges, state delta merging, and conditional routing via Workflow, BaseNode, JoinNode, etc.
  • Managed Agents: Integration with the GCP Managed Agents API (interactions.create endpoint) using ManagedAgent and RemoteMcpServer to leverage server-side execution.
• Header Propagation: Support for request-time header propagation and tracking headers across all operations.
• Static Analysis & Stability: Resolved static analysis warnings and improved streaming mode robustness in the interactions stream parser.

• Bumped package release versions to 2026.7.11 for adk_dart, adk, adk_mcp, flutter_adk, and adk_litertlm.
• Added ADK 2.0 Managed Agent support: ManagedAgent and RemoteMcpServer for server-side tool execution via the GCP Interactions API.
• Added environmentId propagation across LlmResponse, Event, session persistence, and telemetry tracing.
• Added isManagedAgent toggle to LlmRequest for grounding tool check bypass in managed workflows.
• Updated InteractionsProcessor.findPreviousInteractionState to return both previousInteractionId and environmentId for turn-to-turn chaining.
• Added isEnterpriseModeEnabled helper in env_utils.dart.
• Added ADK 2.0 Workflow & Managed Agent documentation to README (EN/KO).
• All 1,365 tests passing.

• Bumped package version to 2026.7.11.
• Updated dependency alignment to adk_dart: ^2026.7.11.
• Synced release with adk_dart 2026.7.11, including ADK 2.0 Managed Agent support and Interactions API integration.