agentgui 1.0.737 → 1.0.739

package/CLAUDE.md

@@ -16,15 +16,30 @@ Server starts on `http://localhost:3000`, redirects to `/gm/`.
 ```
 server.js              HTTP server + WebSocket + all API routes (raw http.createServer)
 database.js            SQLite setup (WAL mode), schema, query functions
+acp-queries.js         ACP query helpers (UUID, timestamp, JSON utilities)
+bin/gmgui.cjs          CLI entry point (npx agentgui / bun x agentgui)
+
 lib/claude-runner.js   Agent framework - AgentRunner/AgentRegistry classes, direct protocol execution
 lib/acp-runner.js      ACP JSON-RPC session lifecycle (init, session/new, prompt, drain)
 lib/acp-protocol.js    ACP session/update message normalization (shared by all ACP agents)
-lib/agent-registry-configs.js  Agent registration configs (Claude Code, OpenCode, Gemini, 10+ ACP agents)
-lib/agent-descriptors.js  Data-driven ACP agent descriptor builder
 lib/acp-sdk-manager.js ACP tool lifecycle - on-demand start opencode/kilo/codex, health checks, idle timeout
 lib/acp-server-machine.js  XState v5 machine per ACP tool: stopped/starting/running/crashed/restarting states
+lib/agent-registry-configs.js  Agent registration configs (Claude Code, OpenCode, Gemini, 10+ ACP agents)
+lib/agent-descriptors.js  Data-driven ACP agent descriptor builder
+lib/checkpoint-manager.js  Session recovery - load checkpoints, inject into resume flow, idempotency
+lib/codec.js           msgpack encode/decode (pack/unpack wrappers)
 lib/execution-machine.js   XState v5 machine per conversation: idle/streaming/draining/rate_limited states
+lib/gm-agent-configs.js    GM agent configuration and spawning
+lib/jsonl-watcher.js   Watches ~/.claude/projects for JSONL file changes
+lib/plugin-interface.js  Plugin interface contract definition
+lib/plugin-loader.js   Plugin discovery and loading (EventEmitter-based)
+lib/pm2-manager.js     PM2 process management wrapper
 lib/tool-install-machine.js  XState v5 machine per tool: unchecked/checking/idle/installing/installed/updating/needs_update/failed states
+lib/tool-manager.js    Tool facade - re-exports from tool-version, tool-spawner, tool-provisioner
+lib/tool-version.js    Version detection for CLI tools and plugins (data-driven framework paths)
+lib/tool-spawner.js    npm/bun install/update spawn with timeout and heartbeat
+lib/tool-provisioner.js  Auto-provisioning and periodic update checking
+lib/speech.js          Speech-to-text and text-to-speech via @huggingface/transformers
 lib/ws-protocol.js     WebSocket RPC router (WsRouter class)
 lib/ws-optimizer.js    Per-client priority queue for WS event batching
 lib/ws-handlers-conv.js  Conversation CRUD, chunks, cancel, steer, inject RPC handlers
@@ -35,27 +50,33 @@ lib/ws-handlers-run.js  Thread/run RPC handlers
 lib/ws-handlers-util.js  Utility RPC handlers (speech, auth, git, tools, voice)
 lib/ws-handlers-oauth.js  Gemini + Codex OAuth WS RPC handlers
 lib/ws-handlers-scripts.js  npm script run/stop WS RPC handlers
-lib/tool-manager.js    Tool facade - re-exports from tool-version, tool-spawner, tool-provisioner
-lib/tool-version.js    Version detection for CLI tools and plugins (data-driven framework paths)
-lib/tool-spawner.js    npm/bun install/update spawn with timeout and heartbeat
-lib/tool-provisioner.js  Auto-provisioning and periodic update checking
-lib/speech.js          Speech-to-text and text-to-speech via @huggingface/transformers
-bin/gmgui.cjs          CLI entry point (npx agentgui / bun x agentgui)
+lib/plugins/           Server plugins (acp, agents, auth, database, files, git, speech, stream, tools, websocket, workflow)
+
 static/index.html      Main HTML shell
 static/app.js          App initialization
 static/theme.js        Theme switching
+static/css/tools-popup.css       Tool popup styles
 static/js/client.js    Main client logic
 static/js/conversations.js       Conversation management
-static/js/streaming-renderer.js  Renders Claude streaming events as HTML
+static/js/streaming-renderer.js  Renders agent streaming events as HTML
 static/js/event-processor.js     Processes incoming events
 static/js/event-filter.js        Filters events by type
 static/js/websocket-manager.js   WebSocket connection handling
+static/js/ws-client.js           WsClient RPC wrapper over WebSocketManager
 static/js/ui-components.js       UI component helpers
 static/js/syntax-highlighter.js  Code syntax highlighting
 static/js/voice.js               Voice input/output
+static/js/stt-handler.js         Speech-to-text recording and upload
 static/js/features.js            View toggle, drag-drop upload, model progress indicator
 static/js/tools-manager.js       Tool install/update UI orchestrator
-static/js/tools-manager-ui.js    Tool card rendering + voice selector helpers (split from tools-manager.js)
+static/js/tools-manager-ui.js    Tool card rendering + voice selector helpers
+static/js/agent-auth.js          Agent authentication UI (OAuth flows)
+static/js/dialogs.js             Modal dialog system
+static/js/image-loader.js        Lazy image loading for agent file read events
+static/js/pm2-monitor.js         PM2 process monitor UI
+static/js/script-runner.js       npm script runner UI
+static/js/state-barrier.js       Atomic state machine for conversation management
+static/js/terminal.js            xterm.js terminal integration
 static/js/ws-machine.js          XState v5 WS connection machine: disconnected/connecting/connected/reconnecting
 static/js/conv-machine.js        XState v5 per-conversation UI machine: idle/streaming/queued
 static/js/tool-install-machine.js  XState v5 per-tool UI install machine: idle/installing/installed/updating/needs_update/failed
@@ -63,7 +84,9 @@ static/js/voice-machine.js       XState v5 voice/TTS machine: idle/queued/speaki
 static/js/conv-list-machine.js   XState v5 conversation list machine: unloaded/loading/loaded/error
 static/js/prompt-machine.js      XState v5 prompt area machine: ready/loading/streaming/queued/disabled
 static/lib/xstate.umd.min.js     XState v5 browser bundle (UMD, served locally from node_modules)
-static/templates/                 31 HTML template fragments for event rendering
+static/lib/msgpackr.min.js       msgpack browser bundle
+static/lib/webjsx.js             WebJSX library
+static/vendor/                   Third-party assets (highlight.js, Prism, RippleUI, xterm.js)
 ```
 
 ## XState State Machines
@@ -112,7 +135,7 @@ On startup, agentgui auto-launches bundled ACP tools (opencode, kilo) as HTTP se
 - OpenCode: port 18100 (`opencode acp --port 18100`)
 - Kilo: port 18101 (`kilo acp --port 18101`)
 
-Managed by `lib/acp-manager.js`. Features: crash restart with exponential backoff (max 10 in 5min), health checks every 30s via `GET /provider`, clean shutdown on SIGTERM. The `acpPort` field on discovered agents is set automatically once healthy. Models are queried from the running ACP HTTP servers via their `/provider` endpoint.
+Managed by `lib/acp-sdk-manager.js`. Features: crash restart with exponential backoff (max 10 in 5min), health checks every 30s via `GET /provider`, clean shutdown on SIGTERM. The `acpPort` field on discovered agents is set automatically once healthy. Models are queried from the running ACP HTTP servers via their `/provider` endpoint.
 
 ## REST API
 
@@ -348,7 +371,7 @@ OpenAI Codex CLI uses PKCE authorization code flow against `https://auth.openai.
 - **`all_conversations_deleted`** must be in `BROADCAST_TYPES` set in server.js or it won't fan-out to all clients.
 - **`streaming_start` and `message_created`** are high-priority in WSOptimizer — they flush immediately, not batched.
 - **Sidebar animation:** `transition: none !important` in index.html CSS — sidebar snaps instantly on toggle by design.
-- **Claude Code always runs with `--dangerously-skip-permissions`** (plugins disabled by design).
+- **Claude Code runs with plugins enabled** — `--dangerously-skip-permissions` was removed to allow gm plugin enforcement.
 - **Tool status race on startup:** `autoProvision()` broadcasts `tool_status_update` for already-installed tools so the UI shows correct state before the first manual fetch.
 - **Thinking blocks** are transient (not in DB), rendered only via `handleStreamingProgress()` in client.js. The `renderEvent` switch case for `thinking_block` is disabled to prevent double-render.
 - **Terminal output** is base64-encoded (`encoding: 'base64'` field on message). Client decodes with `decodeURIComponent(escape(atob(data)))` pattern for multibyte safety.

package/README.md

@@ -87,17 +87,24 @@ Server starts on `http://localhost:3000/gm/`
 ## Architecture
 
 ```
-server.js              HTTP server + WebSocket + all API routes
+server.js              HTTP server + WebSocket + all API routes (raw http.createServer)
 database.js            SQLite setup (WAL mode), schema, query functions
-lib/claude-runner.js   Agent framework - spawns CLI processes, parses stream-json output
-lib/acp-manager.js     ACP tool lifecycle - auto-starts HTTP servers, restart on crash
+lib/claude-runner.js   Agent framework - AgentRunner/AgentRegistry classes
+lib/acp-runner.js      ACP JSON-RPC session lifecycle
+lib/acp-sdk-manager.js ACP tool lifecycle - auto-starts HTTP servers, health checks, restart
+lib/ws-protocol.js     WebSocket RPC router (WsRouter class)
+lib/ws-optimizer.js    Per-client priority queue for WS event batching
+lib/ws-handlers-*.js   WebSocket RPC handlers (conv, msg, queue, session, run, util, oauth, scripts)
 lib/speech.js          Speech-to-text and text-to-speech via @huggingface/transformers
+lib/tool-manager.js    Tool detection, install, update facade
+lib/plugins/           Server plugins (acp, agents, auth, database, files, git, speech, stream, tools, websocket, workflow)
 static/index.html      Main HTML shell
 static/app.js          App initialization
 static/js/client.js    Main client logic
 static/js/conversations.js       Conversation management
-static/js/streaming-renderer.js  Renders Claude streaming events as HTML
+static/js/streaming-renderer.js  Renders agent streaming events as HTML
 static/js/websocket-manager.js   WebSocket connection handling
+static/js/*.machine.js           XState v5 state machines (ws, conv, tool-install, voice, conv-list, prompt)
 ```
 
 ### Key Details

package/package.json

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

package/static/index.html

@@ -3307,7 +3307,6 @@
     var _escHtmlRe = /[&<>"']/g;
     window._escHtml = function(t) { return t.replace(_escHtmlRe, function(c) { return _escHtmlMap[c]; }); };
   </script>
-  <script defer src="/gm/js/conversations.js"></script>
   <script defer src="/gm/js/event-processor.js"></script>
   <script defer src="/gm/js/streaming-renderer.js"></script>
   <script defer src="/gm/js/image-loader.js"></script>
@@ -3319,6 +3318,7 @@
   <script defer src="/gm/js/voice-machine.js"></script>
   <script defer src="/gm/js/conv-list-machine.js"></script>
   <script defer src="/gm/js/prompt-machine.js"></script>
+  <script defer src="/gm/js/conversations.js"></script>
   <script defer src="/gm/lib/msgpackr.min.js"></script>
   <script defer src="/gm/js/websocket-manager.js"></script>
   <script defer src="/gm/js/ws-client.js"></script>