v1.12
PTY Stability, Browser Recovery, & Deferred Desktop Startup
May 3, 2026
v1.12 is a stability-focused release for sustained Agent Zero sessions. It closes PTY descriptor leaks, recovers cleanly from stale Browser contexts, routes Desktop URLs into the Browser, makes self-update backups resilient to broken symlinks, and starts the Desktop runtime only when it is needed.
🛠️ Runtime Reliability
- PTY descriptor leaks fixed — POSIX PTY master file descriptors are now closed when terminal sessions end, preventing
/dev/ptmxexhaustion during sustained code-execution workloads. - Safer PTY write recovery — Closed and exited PTY sessions are detected before writes. Failed writes can retry through recovery, and terminal shutdown is idempotent so reused descriptors are not double-closed.
- Self-update handles broken symlinks — Dangling symlinks under
/usr, including host-created virtualenv links, are logged and skipped during backup so self-update can continue instead of aborting.
🌐 Browser & Desktop
- Stale Browser contexts recover cleanly — Cached Playwright contexts are checked before reuse. When a context is already closed, stale pages, screencasts, and interaction state are cleared so Playwright can restart on the next browser action.
- Desktop URLs open in Browser — Clicking links in the Xfce Desktop now routes them into the Agent Zero Browser on the opposite canvas or modal surface. Floating Browser and Desktop modals also pass through outside clicks while preserving interaction inside the modal window.
- Deferred Desktop startup — The Desktop environment starts only when the Desktop surface is opened or an Office document is created or opened. A loading indicator now appears immediately while Xpra initializes.
- ARM64 Xpra package gaps are best-effort — Optional local Xpra GUI client packages are treated as best-effort on ARM64, avoiding misleading startup warnings when the browser-hosted Desktop is already usable.