agentgui 1.0.871 → 1.0.873

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [Unreleased] - GUI a11y pass
+
+- index.html: remove `maximum-scale=1.0` and `user-scalable=no` from viewport (WCAG 1.4.4 — low-vision users need pinch-zoom)
+- index.html: add `theme-color` meta with light/dark media queries (native tab/chrome tinting on mobile)
+- index.html: add skip-to-conversation link as first body child for keyboard users
+- main.css: add `:focus-visible` outline for keyboard nav (previously no default visible focus ring)
+- main.css: add `@media (prefers-reduced-motion: reduce)` to collapse animations/transitions for users with vestibular disorders or motion-sensitivity OS setting
+- main.css: `.skip-link` styles (off-screen until focused)
+
 ## [Unreleased] - GUI observability + workflow-plugin fix
 
 - Fix regression from prior commit: workflow-plugin.js declared `dependencies: ['git','database']` but git plugin was deleted; plugin init failed with "Plugin git not found in registry". Removed unused git dep and stale binding.

package/CLAUDE.md

@@ -362,7 +362,7 @@ The README.md uses shields.io badges with a consistent pattern:
 - **Terminal output** is base64-encoded (`encoding: 'base64'` field on message). Client decodes with `decodeURIComponent(escape(atob(data)))` pattern for multibyte safety.
 - **HTML cache** (`_htmlCache`) is only populated when client accepts gzip. In watch mode it's never cached (always fresh).
 - **`app.js` and `app-shortcuts.js` script loading:** Both are `<script defer>` tags loaded AFTER `agent-auth.js` in index.html. They depend on `window.wsClient`, `window.conversationManager`, and `window._escHtml` being initialized first. Defer order is guaranteed by source order — adding new defer scripts that depend on these modules requires careful ordering.
-- **`window.__debug.getSyncState()`:** Debug API in client.js exposes internal state machine snapshots: `convMachineStates`, `toolInstallMachineStates`, `voiceMachineState`, `convListMachineState`, `promptMachineState`, `wsConnectionState`, `rendererEventQueueLength`, `rendererEventHistoryLength`. All XState v5 machines have no parallel ad-hoc state — this API is the only way to inspect full machine state at once.
+- **`window.__debug` registry:** Structured sub-keys via live getters — `machines` (conv/toolInstall/voice/convList/prompt/recording/terminal/ws), `ws` (state/latency/url), `auth`, `perf`, `config`, `renderer`, `conv`. Legacy methods preserved: `getState()`, `getSyncState()`, `getMessageState()`. Uninitialized machines return `'uninitialized'` rather than crashing. All XState v5 machines have no parallel ad-hoc state.
 - **`isJsonlBacked` flag:** Only `claude-code` (protocol: `direct`) writes JSONL files. All other agents use `stream-event-handler.js` for broadcasting. `isJsonlBacked = resolvedAgentId === 'claude-code'` — guards in `stream-event-handler.js` prevent double-broadcast for claude-code, and gates ACP streaming for non-JSONL agents.
 - **`toolIds` in `server-startup.js` must match `TOOLS` in `tool-manager.js`:** `initializeToolInstallations` runs for each toolId, creating the `tool_installations` row. `tool_install_history` has a FK to `tool_installations(tool_id)`. Any tool omitted from toolIds will cause a FOREIGN KEY constraint failure when the periodic update checker writes history for it.
 - **`JsonlWatcher._read(fp)` override:** Captures `this._currentFp` before calling `super._read(fp)`, making the file path available to `_line()` callbacks for project-directory decoding in `_conv()`. JSONL project dirs are encoded (e.g., `-config-workspace-agentgui`) — decoded via `'/' + dirName.slice(1).replace(/-/g, '/')`.

package/README.md

@@ -181,13 +181,16 @@ When `DEBUG=1` is set, internal state inspection endpoints become available:
 - `GET /api/debug/ws-stats` - WebSocket connection metrics and lag distribution
 
 **Browser Console** (`window.__debug`):
-- `window.__debug.convMachineStates` - Per-conversation UI state machines
-- `window.__debug.toolInstallMachineStates` - Tool installation state
-- `window.__debug.voiceMachineState` - TTS playback state
-- `window.__debug.convListMachineState` - Conversation list machine
-- `window.__debug.promptMachineState` - Prompt area state
-- `window.__debug.wsConnectionState` - WebSocket connection status
-- `window.__debug.getSyncState()` - Full snapshot of all machines at once
+- `window.__debug.machines` - All XState machines (conv, toolInstall, voice, convList, prompt, recording, terminal, ws)
+- `window.__debug.ws` - WebSocket state, latency EMA, latency trend, URL
+- `window.__debug.auth` - Agent auth and OAuth state
+- `window.__debug.perf` - Conversation perf metrics
+- `window.__debug.config` - Base URL and server config
+- `window.__debug.renderer` - Streaming renderer event queue / history lengths
+- `window.__debug.conv` - Current conversation and streaming set
+- `window.__debug.getState()` - WS latency snapshot
+- `window.__debug.getSyncState()` - Flat snapshot of all machines (legacy shape)
+- `window.__debug.getMessageState()` - Message/queue DOM counts
 
 See [CLAUDE.md](CLAUDE.md) for complete XState v5 machine documentation and internal architecture details.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentgui",
-  "version": "1.0.871",
+  "version": "1.0.873",
   "description": "Multi-agent ACP client with real-time communication",
   "type": "module",
   "main": "electron/main.js",

package/static/css/main.css

@@ -3248,4 +3248,37 @@
       color: var(--color-text);
       max-width: 120px;
     }
-
+
+
+.skip-link {
+  position: absolute;
+  top: -40px;
+  left: 0;
+  background: var(--color-primary, #3b82f6);
+  color: #fff;
+  padding: 8px 16px;
+  z-index: 10000;
+  text-decoration: none;
+  border-radius: 0 0 4px 0;
+  font-weight: 600;
+}
+.skip-link:focus {
+  top: 0;
+}
+
+:focus-visible {
+  outline: 2px solid var(--color-primary, #3b82f6);
+  outline-offset: 2px;
+  border-radius: 2px;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}

package/static/index.html

@@ -43,6 +43,8 @@
   <link rel="stylesheet" href="/gm/css/tools-popup.css" media="print" onload="this.media='all'">
 </head>
 <body>
+  <a href="#app" class="skip-link">Skip to conversation</a>
+
   <!-- Sidebar overlay (mobile) -->
   <div class="sidebar-overlay" data-sidebar-overlay></div>