Releases: docker/docker-agent
v1.54.0
This release introduces clickable terminal links, domain filtering for fetch operations, and enhanced toolset lifecycle management with configurable supervision profiles.
What's New
- Makes markdown links and URLs clickable in the terminal using OSC 8 hyperlink escape sequences
- Adds
allowed_domainsandblocked_domainsfilters to the fetch toolset for restricting network access - Adds
/toolsetscommand and supervisor-aware status surface in the TUI - Introduces
redact_secretsagent flag that scrubs credential patterns from tool calls and LLM messages - Adds per-toolset lifecycle configuration with profile presets for MCP and LSP servers
- Introduces
/toolset-restartslash command for hot-reload functionality
Improvements
- Defers OAuth elicitation outside interactive context to prevent premature prompts
- Reduces macOS keychain prompts by storing all MCP OAuth tokens in a single keychain item
- Makes every dialog close on ctrl+c, with twice exiting the application
- Filters LSP tools by server-advertised capabilities
- Detects secrets embedded inside larger tokens, not just word-bounded patterns
Bug Fixes
- Fixes MCP catalog reference in mcp-definitions.yaml from
docker:githubtodocker:github-official - Fixes Slack token responses and surfaces server errors in MCP OAuth handling
- Fixes config package names for v6 and v7 versions
- Fixes strip transform reading wrong model in alloy/per-tool override mode
- Suppresses spurious 'is now available' MCP toolset notice after OAuth completion
Technical Changes
- Separates toolset notices from warnings in agent handling
- Simplifies history package by replacing manual parsing with standard library functions
- Refactors skills package into focused files without changing behavior
- Extracts image-stripping into registered MessageTransform mechanism
- Unifies MCP/LSP toolset supervision with typed errors and state-machine architecture
- Isolates example loading in temporary directories for tests
What's Changed
- docs: update CHANGELOG.md for v1.53.0 by @docker-read-write[bot] in #2565
- Make the slack remote MCP server work by @dgageot in #2512
- Fix misleading UpdateMessage doc comment by @rumpl in #2570
- docs: bring hooks reference up to date with new events by @dgageot in #2569
- lint: add config-versioning robustness cops + fix v6/v7 package names by @dgageot in #2568
- Use the slices package to simplify slice operations by @dgageot in #2566
- test: stop example tests from writing SQLite files into examples/ by @dgageot in #2564
- Simplify the history package by @dgageot in #2567
- runtime: extract image-stripping into a registered MessageTransform by @dgageot in #2573
- refactor(skills): split package into focused files by @dgageot in #2571
- feat(fetch): add allowed_domains and blocked_domains filters by @dgageot in #2572
- defer oauth when elicitation bridge isn't wired up yet by @dgageot in #2574
- feat(tui): make markdown links and URLs clickable in the terminal by @silvin-lubecki in #2498
- stop hard-coding "root" as the default agent name by @dgageot in #2576
- fix(examples): correct MCP catalog ref in mcp-definitions.yaml by @aheritier in #2465
- refactor(sessiontitle): simplify Generator without changing behavior by @dgageot in #2575
- Add redact_secrets builtin hook + before_llm_call transform by @dgageot in #2577
- Suppress spurious 'is now available' MCP toolset notice by @dgageot in #2578
- reduce macOS keychain prompts for OAuth MCP servers by @dgageot in #2580
- docs: document redact_secrets agent flag by @dgageot in #2581
- detect secrets embedded inside larger tokens by @dgageot in #2582
- feat(lifecycle): unify MCP/LSP toolset supervision with configurable profiles + /toolsets UX by @dgageot in #2579
- test(mcp): test buildRemoteDescription directly to skip keychain by @dgageot in #2584
- make every dialog close on ctrl+c, twice exits by @dgageot in #2583
- Disable test that prompts for a password by @dgageot in #2585
Full Changelog: v1.53.0...v1.54.0
v1.53.0
This release adds OpenAI-compatible API server functionality, skill model overrides, and response caching, along with extensive refactoring to improve code organization and testability.
What's New
- Adds
docker agent serve chatcommand that exposes agents through an OpenAI-compatible HTTP server - Adds configurable response cache for agents to skip model calls for repeated questions
- Adds skill model override capability allowing fork skills to specify different models via
model:field in SKILL.md frontmatter - Adds g/G keybindings to scroll messages view (jump to top/bottom)
- Adds 10 new builtin hook events including lifecycle events, compaction events, and observability events
- Adds
type: modelhook handler for LLM-as-judge functionality
Improvements
- Switches Anthropic Opus 4.6/4.7 to adaptive thinking when token-based budgets are configured
- Improves file path handling for sub-agent sessions by propagating user-attached files and encouraging absolute paths
- Improves error messages for HTTP 400 failures with structured provider error details
Bug Fixes
- Fixes Copilot integration by adding required
Copilot-Integration-Idheader for github-copilot provider - Fixes crash when opening sessions with empty configuration files
- Fixes session_start hook output appearing as user messages in transcript
- Fixes TUI bottom slack clearing after thinking text fades out
- Fixes race conditions in skill model overrides and response cache handling
Technical Changes
- Extracts hooks builtins from runtime into separate package
- Extracts tool execution, compaction, and delegation logic into focused sub-packages
- Consolidates hook orchestration and simplifies executor caching
- Improves testability across runtime, session, provider, and TUI packages
- Replaces PersistentRuntime decorator with EventObserver pattern
- Updates multiple dependencies including Anthropic SDK, AWS Smithy, and various UI libraries
What's Changed
- docs: update CHANGELOG.md for v1.52.0 by @docker-read-write[bot] in #2520
- refactor(hooks): extract builtins from pkg/runtime into pkg/hooks/builtins by @dgageot in #2521
- refactor(hooks): simplify package while preserving features by @dgageot in #2522
- refactor(runtime): consolidate hook orchestration and cache executors by @dgageot in #2523
- Skills: allow fork skills to override the model by @dgageot in #2525
- refactor(skills): move fork-skill validation into SkillsToolset by @dgageot in #2524
- fix(skills): unbreak main after fork-skill refactor merge by @dgageot in #2527
- fix(openai): send Copilot-Integration-Id header for github-copilot by @dgageot in #2475
- refactor(hooks/builtins): one file per builtin + simplify registration by @dgageot in #2526
- feat(tui): add g/G keybindings to scroll messages view by @dgageot in #2528
- refactor(hooks/builtins): inline GetEnvironmentInfo + simplify package by @dgageot in #2529
- refactor(hooks/builtins): inline & simplify add_prompt_files by @dgageot in #2530
- refactor(hooks): simplify caching, dispatch flow, and notification helpers by @dgageot in #2531
- Inherit user-attached files in sub-agent sessions by @dgageot in #2532
- fix(runtime): don't persist session_start hook output as a session message by @dgageot in #2533
- refactor(hooks): drop runtime shadow types and tighten the executor by @dgageot in #2534
- feat: add
docker agent serve chatcommand (OpenAI-compatible API) by @dgageot in #2510 - feat(hooks): add 6 builtin hooks + widen post_tool_use / before_llm_call contract by @dgageot in #2538
- refactor(runtime): drop unused receiver from handleStream by @dgageot in #2539
- feat(hooks): add three observability events around runtime transitions by @dgageot in #2542
- fix(tui): clear bottom slack after thinking text fades out by @dgageot in #2543
- refactor(tui): simplify components, drop dead code, consolidate helpers by @dgageot in #2544
- refactor(provider): improve testability and split provider.go by @dgageot in #2547
- speed up PR image builds by @dgageot in #2553
- refactor(tui): reduce duplication across picker dialogs by @dgageot in #2556
- Add context to todo storage methods by @rumpl in #2560
- refactor(runtime): improve testability and simplify package structure by @dgageot in #2554
- docs: document all builtin hooks in schema and hooks page by @dgageot in #2555
- tui: improve testability and simplify code by @dgageot in #2551
- refactor(session): improve testability and simplify the session package by @dgageot in #2550
- feat(modelerrors): surface structured provider error details on non-2xx responses by @dgageot in #2549
- feat(hooks): lifecycle events, per-hook options, and event-spec refactor by @dgageot in #2540
- refactor(runtime): extract sub-session orchestration by @dgageot in #2535
- refactor(runtime): extract model-fallback chain into fallbackExecutor by @dgageot in #2541
- refactor(runtime): extract tool execution into pkg/runtime/toolexec by @dgageot in #2545
- log history init failure via slog instead of stderr by @dgageot in #2561
- feat(hooks): add before_compaction and after_compaction events by @dgageot in #2537
- Bump direct Go dependencies by @dgageot in #2562
- feat(agent): add a configurable response cache by @dgageot in #2536
- refactor(runtime): replace PersistentRuntime decorator with EventObserver by @dgageot in #2552
- feat(hooks): add 4 new hook events to match Claude Code / OpenCode / pi by @dgageot in #2548
- anthropic: switch opus 4.6/4.7 token thinking budgets to adaptive by @dgageot in #2563
- feat(hooks): add 'type: model' hook and integrate pre_tool_use into approval flow by @dgageot in #2546
Full Changelog: v1.52.0...v1.53.0
v1.52.0
This release adds file picker hotkeys, improves message handling consistency, and introduces an extensible hooks system with new lifecycle events.
What's New
- Adds Alt+H and Alt+I hotkeys in file picker to toggle hidden and ignored file visibility
- Adds extensible hooks system with 5 new lifecycle events and 3 builtin hooks
Improvements
- Makes user prompt elicitation dialog scrollable to prevent content overflow in terminal
Bug Fixes
- Fixes message trimming behavior to be consistent across all model providers
- Fixes steer message handling by appending newlines between queued messages to prevent word fragments from being concatenated
Technical Changes
- Refactors hooks architecture for better extensibility with pluggable registry system
- Centralizes whitespace-only message filtering in session.GetMessages
What's Changed
- docs: update CHANGELOG.md for v1.51.0 by @docker-read-write[bot] in #2514
- fix(tui): make user_prompt elicitation dialog scrollable by @dgageot in #2509
- hotkeys to toggle filepicker hidden/ignored files by @joshbarrington in #2501
- runtime: append newline to non-last steer messages on multi-drain by @simonferquel-clanker in #2518
- fix: normalize message trimming behavior across all model providers by @simonferquel-clanker in #2516
- feat(hooks): refactor for extensibility, add 5 events and 3 builtins by @dgageot in #2519
Full Changelog: v1.51.0...v1.52.0
v1.51.0
This release improves Anthropic model support on Vertex AI, enhances the model picker interface, and includes several bug fixes.
What's New
- Adds pricing and capabilities information to the /model picker interface with a detailed comparison table
Improvements
- Routes Anthropic models on Vertex AI through the native endpoint instead of OpenAI-compatible endpoint to fix compatibility issues
Bug Fixes
- Fixes race condition in session cleanup that could cause spurious "session busy" errors
- Fixes OTLP endpoint URL handling to properly support http/https schemes
Technical Changes
- Enables noctx linter and adds context threading through HTTP, SQL, exec and net APIs
What's Changed
- docs: update CHANGELOG.md for v1.50.0 by @docker-read-write[bot] in #2499
- ci: bump golangci-lint from v2.9 to v2.11 by @dgageot in #2489
- Route Anthropic models on Vertex AI through the native endpoint by @dgageot in #2476
- fix(otel): support http/https scheme in OTLP endpoint URL by @tdabasinskas in #2504
- fix(session): prevent race condition in session cleanup by @tdabasinskas in #2503
- feat(tui): show pricing & capabilities in /model picker by @dgageot in #2511
- lint: enable noctx and deduplicate touched code by @dgageot in #2508
Full Changelog: v1.50.0...v1.51.0
v1.50.0
This release fixes several runtime issues with message steering and sandbox argument handling, along with TUI improvements for user prompts and speech commands.
What's New
- Adds support for custom OAuth callback redirect URLs for remote MCP toolsets, allowing public-facing proxies for authentication
Improvements
- Adds custom component for user_prompt tool calls in TUI that shows only status and name without exposing internal details
Bug Fixes
- Fixes sandbox mode incorrectly interpreting agent file path as first chat message due to duplicate argument handling
- Fixes runtime race conditions where steer messages could be silently dropped during idle windows or first turns
- Fixes /speak slash command not dispatching immediately in TUI
Technical Changes
- Updates Go to version 1.26.2
- Refactors runtime steer message injection to remove system-reminder envelope
What's Changed
- docs: update CHANGELOG.md for v1.49.2 by @docker-read-write[bot] in #2486
- fix(sandbox): don't duplicate agent file and --config-dir args by @dgageot in #2487
- fix(runtime): drain steerQueue at top of RunStream loop to close idle-window race by @simonferquel-clanker in #2492
- feat(mcp): support custom OAuth callbackRedirectURL for remote toolsets by @dgageot in #2494
- chore: bump Go to 1.26.2 by @dgageot in #2488
- tui: add custom component for user_prompt tool calls by @dgageot in #2497
- fix(tui): make /speak slash command dispatch immediately by @dgageot in #2496
Full Changelog: v1.49.2...v1.50.0
v1.49.2
This release fixes an issue with the --pull-interval flag when using URL gordon references.
Bug Fixes
- Fixes blocking of --pull-interval flag when using URL gordon reference
Technical Changes
- Updates CHANGELOG.md for v1.49.1
What's Changed
- docs: update CHANGELOG.md for v1.49.1 by @docker-read-write[bot] in #2484
- Do not block --pull-interval flag when using URL gordon ref by @gtardif in #2485
Full Changelog: v1.49.1...v1.49.2
v1.49.1
This release improves the shell tool's command handling and fixes documentation inconsistencies.
Improvements
- Accepts "command" as an alias for "cmd" in shell tool calls to improve compatibility with different AI models
- Improves error messaging when shell commands are empty or blank
Bug Fixes
- Fixes documentation and code divergences reported in issue #2464 with 36 targeted corrections
- Prevents blank "cmd" parameters from interfering with "command" alias functionality
Technical Changes
- Updates configuration schema version to 8 in documentation
- Updates CHANGELOG.md for v1.49.0 release
What's Changed
- docs: update CHANGELOG.md for v1.49.0 by @docker-read-write[bot] in #2483
- shell: accept
commandas alias forcmdand improve empty-arg error by @trungutt in #2481 - docs: fix doc-code divergences reported in #2464 by @dgageot in #2479
Full Changelog: v1.49.0...v1.49.1
v1.49.0
This release improves DMR support, adds skill filtering capabilities, and includes several bug fixes for OpenTelemetry and security hardening.
What's New
- Adds support for filtering skills by name in agent YAML configuration
- Improves DMR support with better context size handling and structured configuration
Bug Fixes
- Fixes OpenTelemetry service resource schema alignment
- Fixes path traversal vulnerability and other security issues in artifact store, skills loader, hooks, shell and agent warnings
- Fixes OpenTelemetry import ordering in tests
Technical Changes
- Encodes agent source URL when using it as agent name and key for proper conversation handling in
serve api - Moves localhost helper comment in OpenTelemetry code
What's Changed
- docs: update CHANGELOG.md for v1.48.0 by @docker-read-write[bot] in #2470
- Improve DMR support by @krissetto in #2351
- fix(otel): align service resource schema by @pandego in #2442
- bump github.com/docker/cli from v29.4.0+incompatible to v29.4.1+incompatible by @dgageot in #2472
- Support filtering skills by name in agent YAML (#2404) by @dgageot in #2474
- Encode agent source URL when using it as agent name and key, so that it can be used properly in conversations when using
serve apiby @gtardif in #2473 - fix: harden artifact store, skills loader, hooks, shell and agent warnings by @dgageot in #2480
Full Changelog: v1.48.0...v1.49.0
v1.48.0
This release adds working directory configuration for MCP and LSP toolsets and improves toolset reliability with better retry handling.
What's New
- Adds optional
working_dirfield to MCP and LSP toolset configurations to launch processes from a specific directory
Bug Fixes
- Fixes retry behavior for MCP toolsets after tool calls within the same turn
- Stops retrying SQLITE_CANTOPEN (14) errors that cannot be resolved
- Fixes filepath handling to satisfy gocritic filepathJoin lint rule
- Returns explicit error when ref-based MCP resolves to remote server with working_dir
Technical Changes
- Documents working_dir field for MCP and LSP toolsets in configuration
What's Changed
- docs: update CHANGELOG.md for v1.47.0 by @docker-read-write[bot] in #2468
- feat: add optional working_dir to MCP and LSP toolset configs by @simonferquel-clanker in #2460
- Don't retry SQLITE_CANTOPEN (14) errors by @dgageot in #2466
- fix: retry LSP/MCP toolsets after tool calls, covering env-wrapped commands (fixes #2457) by @simonferquel-clanker in #2458
Full Changelog: v1.47.0...v1.48.0
v1.47.0
This release fixes several issues with AI model interactions, including title generation failures with reasoning models and shell command hangs.
Bug Fixes
- Fixes title generation failures with OpenAI reasoning models by using low reasoning effort instead of omitting it
- Fixes shell command hangs when a tool command backgrounds a child process
- Repairs malformed JSON in edit_file tool call arguments that was causing parsing failures
- Moves reasoning token budget floor to OpenAI provider for better token management
Improvements
- Increases title generation token budget for reasoning models to ensure adequate output space
- Adds thinking_display provider option for Anthropic models to control visibility of thinking blocks
Technical Changes
- Adds test assertion for non-empty title in end-to-end title generation tests
What's Changed
- docs: update CHANGELOG.md for v1.46.0 by @docker-read-write[bot] in #2455
- fix: title generation fails with OpenAI reasoning models by @trungutt in #2412
- fix: repair malformed JSON in edit_file tool call arguments by @trungutt in #2452
- Add thinking_display provider_opt for Anthropic models by @dgageot in #2451
- shell: fix hang when a tool command backgrounds a child process by @dgageot in #2462
- bump direct Go dependencies by @dgageot in #2463
Full Changelog: v1.46.0...v1.47.0