Skip to content

agent-zero

v2.2 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent ai assistant autonomous linux zero

Summary

AI summary

Updates Web UI, Onboarding & Model Setup, and LLM Transport & Streaming across a mixed release.

Full changelog

Release Notes

Onboarding & Model Setup

  • Introduced a deferred first-send model gate: missing-model setup now happens in-thread instead of on the welcome screen, preserving the pending prompt across refresh and auto-dispatching once a model is configured.
  • Unified the onboarding provider selection into a single step covering Cloud, Account, and Local choices, replacing the previous separate illustrated paths.
  • Utility model selection is now explicit — no longer silently synced to the main model — and defaults to each provider's utility model when available.
  • OAuth account connections no longer auto-populate Main and Utility models; users are routed to model configuration to make an explicit choice.
  • Fixed stale OAuth model provider appearing selected when the stored model slot points at a non-connected provider.
  • Updated default main model to anthropic/claude-sonnet-5 across bundled config, Balance preset, and onboarding defaults.
  • Refreshed Codex OAuth defaults: removed stale model metadata so connected accounts use upstream /models responses instead of the retired gpt-5.2-codex default; fallback model updated to gpt-5.5.

LLM Transport & Streaming

  • Stabilized LiteLLM provider fallback: Responses endpoint failures now fall back to Chat Completions before any output is emitted, including when the Responses mock encounters real SSE streams.
  • Streamed Chat Completions tool-call deltas are now preserved as structured function-call items, so fallback providers can still drive tools.
  • Fixed streamed parallel tool extraction so nested tool_calls objects no longer prematurely end the stream before the parallel wrapper closes.

Chat & Memory

  • Pruned deleted saved chats from sidebar state so stale in-memory contexts disappear after their chat files are removed.
  • Normalized memory_load threshold and limit values from model calls before vector search, preventing numeric strings from reaching FAISS unchanged.
  • Users are now notified when automatic chat renaming cannot reach the Utility Model, while the rename task remains best-effort.

Web UI

  • Chat composer now supports Markdown-backed code blocks: typing a triple-backtick fence and pressing Enter creates a visual code block, serialized back to fenced Markdown on send.
  • File browser action menus now render outside the scroll container with fixed positioning, fixing dropdown clipping.
  • Message action button chrome is now non-selectable so copy/paste captures message text without toolbar labels.
  • Settings secrets render as masked text inputs instead of browser password fields, avoiding password-manager prompts.
  • What's New cards are disabled until new content is added; manual access remains available with an empty state.

Documentation

  • Refreshed onboarding screenshots and first-run docs for the new welcome screen, in-chat model gate, and provider paths.
  • Documented Docker host-gateway addressing for local model servers where container localhost does not reach host loopback.
  • Clarified that the memory plugin is optional and removed memory-plugin assumptions from non-plugin documentation.
  • Updated A0 Launcher download links to v1.1.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track agent-zero

Get notified when new releases ship.

Sign up free

About agent-zero

Agent Zero AI framework

All releases →

Related context

Earlier breaking changes

  • v2.5 Legacy filesystem logs in /a0/logs are deleted on startup.
  • v2.5 Launcher host access controls removed from Core WebUI.
  • v2.5 Model presets become global; project-scoped definitions removed.
  • v1.16 Legacy speech settings and APIs removed; use _kokoro_tts and _whisper_stt plugins instead.
  • v1.14 Multi-action tools standardized around tool_args.action with backward compatibility

Beta — feedback welcome: [email protected]