agentgui 1.0.872 → 1.0.873

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.872",
+  "version": "1.0.873",
   "description": "Multi-agent ACP client with real-time communication",
   "type": "module",
   "main": "electron/main.js",