agentgui 1.0.995 → 1.0.997

package/AGENTS.md

@@ -116,8 +116,7 @@ When `PASSWORD` env var is set, every HTTP route is gated by `lib/http-handler.j
 - `site/app/js/app.js` — webjsx view + state; renders the `AgentChat` kit (from `anentrypoint-design`) for the chat surface and wires agentgui's WS/ccsniff state as kit callbacks; history/settings remain agentgui-local. Exposes `window.__agentgui`
 
 The chat GUI lives in the design kit, not in agentgui. The reusable multi-agent chat surface is the `AgentChat` component in `anentrypoint-design` (`src/components/agent-chat.js`); agentgui keeps only the transport glue (WS `backend.js`, ccsniff history wiring, agent orchestration) and passes state + callbacks into the kit. To change chat UI, edit the kit and push it (CI publishes to npm -> unpkg `@latest`), not agentgui.
-- `server.js` — boots ACP/agents/websocket plugins, mounts `createHistoryRouter()` from `ccsniff` at `/`, serves `site/app/` as static root
-- Plugins kept (lib/plugins/): acp, agents, database, files, stream, websocket, workflow
+- `server.js` — initializes the ACP-SDK manager + agent registry, registers WS handlers (`ws-handlers-util.js`), mounts `createHistoryRouter()` from `ccsniff` at `/`, serves `site/app/` as static root. The `lib/plugins/` system was removed (2026-06-20, 20th run) — it was dead scaffolding (routes 404, wsHandlers never wired, api unconsumed); all server logic lives directly in `server.js` + `lib/ws-handlers-util.js` + `lib/http-handler.js` + `lib/routes-upload.js` + `database.js`.
 
 Dependencies:
 - `ccsniff` (>=1.1.0) — exports `createHistoryRouter({projectsDir})` mountable on Express; serves `/v1/history/{sessions,sessions/:sid/events,search,snapshot,reindex,stream}`. Reads `~/.claude/projects` (override via `CLAUDE_PROJECTS_DIR`).
@@ -157,15 +156,9 @@ Why it works: `process.execPath` becomes bun, so the spawned child server also r
 
 Rule: any CI step that spawns the agentgui server (directly or via a script that inherits `process.execPath`) must invoke it with `bun`.
 
-## Plugin Dependencies
+## Plugin system removed (2026-06-20 — 20th run)
 
-**`lib/plugins/stream-plugin.js` must not import packages missing from package.json.**
-
-The plugin loader runs at startup and logs failures silently if a plugin import fails. If stream plugin fails to load due to missing dependency (e.g., `uuid`), the error cascades: `agents` and `websocket` plugins both declare `stream` as a dependency and fail with "Plugin stream not found in registry", cascading to boot failure.
-
-Fix for uuid: replaced `import { v4 as uuidv4 } from 'uuid'` with `import { randomUUID as uuidv4 } from 'crypto'` (Node.js built-in, zero deps).
-
-Pattern: all imports in lib/plugins/* must be either built-in (crypto, fs, path, etc.) or already in package.json. No new npm packages should be added to plugins without adding them to dependencies.
+The entire `lib/plugins/` system + `plugin-loader.js` was deleted as dead scaffolding (commits up to e73ed0e): plugin routes were unreachable (http-handler forwarded only a few prefixes -> 404), plugin `wsHandlers` were never wired (the real WS handlers come from `registerWsHandlers` in `ws-handlers-util.js`), plugin `api` objects were never consumed, and the inits were no-ops or managed local Maps nobody read. Removed across 7 commits (acp, files, agents, then database/stream/workflow/websocket + loader). The general lesson survives: any import under `lib/` must be a built-in (crypto, fs, path) or already in package.json — a missing dep crashes boot.
 
 ## Plugin Tool Provisioning on Windows
 

package/README.md

@@ -133,14 +133,12 @@ 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 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)
+lib/ws-handlers-util.js WS RPC handler registration (agents.list, chat.sendMessage, ...)
+lib/http-handler.js    Static serving + /api/* routes + auth gate + path confinement
+lib/routes-upload.js   Express app for multipart upload + fsbrowse file serving
+site/app/index.html    SPA shell; imports the anentrypoint-design kit
+site/app/js/app.js     webjsx view + state; renders the AgentChat kit, wires WS callbacks
+site/app/js/backend.js Same-origin WS/HTTP client (transport glue)
 ```
 
 ### Key Details
@@ -148,7 +146,7 @@ static/js/*.machine.js           XState v5 state machines (ws, conv, tool-instal
 - Agent discovery scans PATH for known CLI binaries at startup
 - Database lives at `~/.gmgui/data.db` (WAL mode for concurrent access)
 - WebSocket endpoint at `/gm/sync` for real-time updates
-- ACP tools (OpenCode, Kilo) auto-launch as HTTP servers on startup with health checks
+- ACP tools (OpenCode, Kilo, Codex) start on demand as HTTP servers with health checks + restart backoff
 
 ## Use Cases
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentgui",
-  "version": "1.0.995",
+  "version": "1.0.997",
   "description": "Multi-agent ACP client with real-time communication",
   "type": "module",
   "main": "electron/main.js",
@@ -24,7 +24,6 @@
     "electron:dev": "PORT=3000 electron electron/main.js"
   },
   "dependencies": {
-    "@agentclientprotocol/sdk": "^0.4.1",
     "@anthropic-ai/claude-code": "^2.1.37",
     "@google/gemini-cli": "latest",
     "@kilocode/cli": "latest",
@@ -33,19 +32,15 @@
     "busboy": "^1.6.0",
     "ccfollow": "^1.0.7",
     "ccsniff": "github:AnEntrypoint/ccsniff#main",
-    "execa": "^9.6.1",
     "express": "^5.2.1",
-    "form-data": "^4.0.5",
     "fsbrowse": "latest",
     "lru-cache": "^11.2.7",
     "opencode-ai": "^1.2.15",
-    "p-retry": "^7.1.1",
     "puppeteer-core": "^24.37.5",
     "webjsx": "^0.0.73",
     "webtalk": "^1.0.31",
     "ws": "^8.14.2",
-    "xstate": "^5.32.0",
-    "zod": "^4.3.6"
+    "xstate": "^5.32.0"
   },
   "devDependencies": {
     "electron": "^35.0.0",