Repository navigation
Agent Zero Release Notes
Highlights
This release hardens Time Travel with snapshot expiry enabled by default, introduces A0Cleaner for automatic bulk cleanup of caches and temporary files, adds scheduled-task catch-up after downtime, strengthens secret handling and OAuth proxy security, restores full Telegram scoping, and delivers a broad set of stability and performance improvements across the backend and WebUI.
New Features
- A0Cleaner — Automatic bulk cleanup of aged download caches, installer leftovers, retired browser profiles, inactive-chat screenshots, temporary captures, and unused Chromium versions. Runs on a weekly maintenance schedule by default with per-area opt-outs. Embedding caches and custom folders require manual selection and confirmation. Accessible through plugin settings and cleanup notifications.
- Scheduled task catch-up after downtime — Recurring tasks that were missed while the system was offline now run exactly once on the next tick, coalescing missed occurrences. Disabled tasks remain untouched. Schedule anchors persist across restarts and serialization formats. Cron delays respect task timezones across daylight-saving changes.
- Plugin maintenance tasks — Plugins can now own scheduled tasks that execute through the A0 task scheduler without creating an agent chat or calling a model.
- Time Travel snapshot expiry enabled by default — New installations and legacy configurations without the key now keep up to 500 recent snapshots within 30 days, plus current-state and boundary checkpoints. Explicit opt-outs are preserved.
- Time Travel retention and capture controls — Workspace-relative exclusions, optional file-size limits, skipped-file reporting, and configurable history storage. Snapshot expiry retains recent snapshots and checkpoint boundaries, replaces refs atomically, and reclaims expired objects under the workspace lock.
- Idle browser resource release — The shared Chromium, Xvfb, and Xpra runtime now suspends after one hour of inactivity, preserving saved tab URLs and the shared sign-in profile. A manual "Stop internal browser" control is available in Browser Settings. Running agents, active downloads, and connected viewers are protected.
- Host workspace tree settings — New controls under Agent Settings → Workdir allow independent or inherited tree limits for host workspaces. Effective remote tree configuration is included in connector handshakes so CLI and Launcher sessions refresh without reconnecting.
- Welcome composer guidance — New users without API credentials now see "Ask anything to set up your models, or click Settings" in the welcome composer.
- What's New cards — Existing users see showcase cards for A0Cleaner and scheduled-task catch-up on their next visit.
- Response limit in agent settings — The unusable response limit is now surfaced directly below the default agent profile in the UI.
Telegram
- Restored secure Telegram scopes — Global, project, profile, and project/profile configuration with one bot identity per saved scope. Inherited configuration is preserved; conflicting legacy bot identities are paused without discarding their settings. Existing configuration is automatically backed up before upgrade, and secure webhook secrets are provisioned where legacy settings require them.
- Telegram documentation — New practical guide covering BotFather setup, private polling, access and administrator lists, commands, attachments, project/profile ownership, groups, webhooks, and upgrade recovery. Linked from the main README and documentation index.
Bug Fixes
- Text editor append on unterminated files — Appending past the last line of a file without a trailing newline no longer merges content onto the existing last line.
- DirtyJson surrogate pair decoding — Escaped emoji surrogate pairs (e.g.
\ud83c\udf78) are now correctly joined instead of producing lone surrogates that crash UTF-8 encoding in code execution and other tools. - Chat loading with malformed code execution arguments — Non-string code arguments no longer abort streamed rendering or saved-chat replay.
- Welcome send visibility — The first chat history snapshot no longer clears the optimistic user bubble after a Welcome send.
- Scheduler editor modal — The task detail modal now fully closes before opening the editor, preventing an uncloseable overlay.
- A0Cleaner toast dismissal — Opening cleanup from the notification toast now correctly dismisses and marks it as read.
- Backup restore path traversal — Archive targets are normalized and validated to prevent path traversal escapes beyond the restore root.
Secrets & Security
- Secret prompt aliases — Only non-empty effective definitions are listed, honoring case-insensitive last-definition precedence across stores.
- Secret value preservation — Secrets are preserved across edits and transient read failures using proper dotenv parsing and disk-value resolution instead of stale snapshots.
- Provider key pool masking — Full provider key lists and each selected member are masked in both normal and streaming output, including legacy key names.
- Credential cache refresh — Registered secrets managers are invalidated after every successful dotenv write so substitution and masking see current values.
- A2A ambient token forwarding stopped — The process-wide A2A token is no longer automatically attached to model-selected destinations. Explicitly supplied connection credentials continue to work.
- OAuth proxy authentication required — Loopback trust is replaced with an internal process credential for local account-model calls. Tokenless requests are denied from every source address. No saved credential or configuration migration is required.
Time Travel
- Capture and restore safety — Git paths are treated literally to prevent filename expansion. Restores that would change excluded paths, nested Git workspaces, or files through directory symlinks are rejected. Complete workspace operations are serialized with reentrant cross-process locks.
- History loading without staging — Saved commits are paged directly with batched metadata. Current changes are inspected in a disposable read-only repository, keeping the saved repository unmodified. Git work is offloaded from API event loops.
Performance
- WebUI asset bundle builds — Reuses scandir metadata and resolved extension paths, reducing bundle preparation time significantly (profiled drop from ~40s to ~18s on Windows-hosted WSL Docker mounts).
- Backend startup — Filesystem watch subscriptions are reused for unchanged covering roots instead of being torn down on every registration. Instrumented startup fell from ~96s to ~46s on the profiled environment.
Documentation
- A0Cleaner workflows guide with framed screenshots
- Scheduled Tasks guide covering UI and chat creation paths
- Telegram setup, scopes, and upgrade recovery guide
- Clarified default remote input access in tool prompts and policy documentation
Breaking Changes
- OAuth model proxies now require authentication — External clients that previously relied on tokenless loopback trust for OAuth provider proxies must now supply credentials. No changes are needed for normal Agent Zero usage; only custom external integrations calling the local proxy directly are affected.
- A2A ambient token no longer forwarded — Model-selected A2A destinations no longer receive the process-wide token automatically. Explicitly supplied tokens and token-bearing Agent Zero connection URLs continue to work as before.