v0.0.5

AgentMux v0.0.5

Worker-side terminal state, Web Control mobile polish, and release packaging updates.

Highlights

• Added worker-side terminal control capabilities.
  • Workers advertise render modes for worker-state xterm and live attach xterm.
  • terminal.snapshot can carry ANSI screen data plus optional cells-v1 state.
  • terminal.diff supports conservative row-level state updates after a snapshot boundary.
  • terminal.history.request and terminal.history.page expose worker-side history pages.
  • terminal.state.reset, size sync, size reset, and mouse events are part of the protocol surface.
• Improved Web Control terminal behavior.
  • Web Control requests terminal snapshot, history, state reset, and size-control capabilities.
  • Worker-side state and history can be opened from the terminal toolbar for diagnostics.
  • Worker history no longer opens automatically on initial remote session attach.
  • Remote terminal size can be synced to the browser viewport or reset to the worker default.
  • Mobile terminal chrome keeps the tmux prefix action visible and folds secondary actions into a compact menu.
• Improved mobile Web Control navigation.
  • Overview metrics are more compact on small screens.
  • Worker cards expose primary state first and fold operational actions into an Ops menu.
  • Session/window/pane navigation now has better target summaries, collapsible rows, and local favorites for quick access.
  • When a session has exactly one window and one pane after target inspection, Web Control opens it directly.
• Improved session target and terminal state documentation.
  • Added docs/TERMINAL_STATE_OPTIMIZATION.md.
  • Updated API, usage, architecture, roadmap, and update strategy docs for terminal state and release behavior.
• Expanded release packaging.
  • Release builds include Worker, Control, TUI, and Hub assets for Linux and macOS.
  • Hub assets also include Windows amd64.
  • Release workflows and local Makefile targets now generate role-specific tarballs and checksums.

Terminal State

This release moves AgentMux closer to a worker-owned terminal state model. The
browser can attach with a current screen snapshot instead of relying only on
fresh raw output from a newly attached terminal stream. Worker-side history pages
are kept separate from xterm scrollback so diagnostics and reconnect behavior can
improve without polluting the active terminal buffer.

The production terminal view still uses xterm.js. cells-v1 is currently useful
for diagnostics and validation of worker-side state, not as the primary
long-term renderer.

Web Control Mobile Notes

The mobile surface is now more conservative about always-visible controls:

• tmux prefix stays visible in active terminal panes;
• debug, state, history, sync, reset, split, and close actions move behind a
  compact overflow menu on narrow screens;
• overview cards use a denser layout;
• Worker operational controls are grouped under Ops;
• session/window/pane target rows are easier to expand, collapse, and revisit.

Favorites for sessions and panes are stored in browser local storage in this
release. Server-side user preferences are still a future persistence task.

Compatibility Notes

• Protocol version remains 1.
• Existing Direct Token limits from v0.0.4 still apply.
• Existing Worker and Control credentials continue to work.
• Worker-side terminal state requires a Worker that advertises the new terminal
  capabilities. Older Workers fall back to the live attach behavior.
• Windows release assets are Hub-only. Worker and terminal Control remain
  Linux/macOS-oriented because they rely on Unix terminal semantics.