agentgui 1.0.946 → 1.0.948

package/AGENTS.md

@@ -10,7 +10,7 @@ When `PASSWORD` env var is set, every HTTP route is gated by `lib/http-handler.j
 - `site/app/js/backend.js` — same-origin WS/HTTP client (`DEFAULT_BACKEND = ''`); the transport glue that wires the kit; `?backend=` query override for cross-origin debugging
 - `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.
+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
 
@@ -60,19 +60,13 @@ Pattern: all imports in lib/plugins/* must be either built-in (crypto, fs, path,
 
 ## Plugin Tool Provisioning on Windows
 
-**`lib/tool-spawner.js` must iterate bun → npx fallback and match cross-platform command-not-found errors.**
-
-On Windows hosts without bun installed, the auto-provisioner on startup and 6h periodic update checker failed silently when spawnBunxProc tried `bun.cmd` directly. The missing command error came via process stderr+close, not the 'error' event, so simple ENOENT detection was insufficient. Additionally, the error message format differs by OS: Windows shows "'bun.cmd' is not recognized as an internal or external command", Linux/Mac show "command not found" or "cannot find".
-
-Fix: `BUNX_RUNNERS` array iterates `['bun', 'npx']` and tries each in sequence. Error detection regex `isMissingCmdError` matches `/not recognized|ENOENT|command not found|cannot find/i` on both `error.message` and captured stdout+stderr. Only falls through to next runner when the `missing` flag is set.
-
-Pattern: When a binary might not exist on all platforms, use a runner fallback strategy. Always capture and check both error.message and process output streams. Cross-platform error detection requires regex alternation on common message patterns.
+**`lib/tool-spawner.js` iterates `BUNX_RUNNERS=['bun','npx']` and detects missing-command via regex on both error.message and stdout+stderr.** Full detail in rs-learn (recall "agentgui windows tool-spawner bunx fallback").
 
 ## GM Plugin Autonomy Blocker
 
 **gm plugin's pre-tool-use-hook.js enforces "must invoke gm:gm first" gate, blocking multi-tool autonomy. Hook content is NOT sourced from gm-starter/hooks/ files — it is templated from somewhere else.**
 
-The gm plugin enforces a gate via `.gm/needs-gm` marker that requires invoking `gm:gm` before any other tool use, which fragments multi-tool autonomous sessions in agentgui. A bypass patch was committed to c:/dev/gm (commit e300acf7, origin/main) in gm-starter/hooks/{pre-tool-use,prompt-submit}-hook.js to skip the gate when `.gm/prd.yml` exists, but it did NOT propagate after `/plugin update gm` (cache hash changed 495e36843d77 → 075e64d58498 but hook content unchanged).
+The gm plugin enforces a gate via `.gm/needs-gm` marker that requires invoking `gm:gm` before any other tool use, which fragments multi-tool autonomous sessions in agentgui. A bypass patch was committed to c:/dev/gm (commit e300acf7, origin/main) in gm-starter/hooks/{pre-tool-use,prompt-submit}-hook.js to skip the gate when `.gm/prd.yml` exists, but it did NOT propagate after `/plugin update gm` (cache hash changed 495e36843d77 -> 075e64d58498 but hook content unchanged).
 
 The actual hook content is generated/templated from c:/dev/gm, likely from `lib/cli-adapter.js` or `platforms/cli-config-shared.js` or `lib/template-builder.js`, not from gm-starter/hooks/. Next session must:
 1. Locate the real hook generator in the gm codebase
@@ -97,35 +91,19 @@ The function previously returned "Model: X." when agentId was 'claude-code' and
 
 ## WebSocket Sync Endpoint Testing
 
-**WebSocket `/sync` endpoint — message ordering requires registering handler BEFORE sending.**
-
-Server sends `sync_connected` with `clientId` on connect. Legacy handler (`lib/ws-legacy-handlers.js`) handles `ping→pong`, `subscribe→subscription_confirmed`, `get_subscriptions→subscriptions`, `unsubscribe`, `latency_report`. All responses use codec encode/decode (`lib/codec.js`). Pattern: queue outbound messages and use a waiters array + sequential promises to avoid race between send and handler registration. Test structure: `const queued = []; let waiting; ws.on('message', ...); queued.forEach(msg => ws.send(msg)); waiting.resolve(...)` ensures the handler is live before messages flow.
-
-## better-sqlite3 & Node v24 Startup (2026-05-03)
+**`/sync` sends `sync_connected`+clientId on connect; legacy handler in `lib/ws-legacy-handlers.js` (ping/subscribe/get_subscriptions/unsubscribe/latency_report) via codec; tests must register the message handler before sending.** Full detail in rs-learn (recall "agentgui websocket /sync testing handler ordering").
 
-**Node v24 has no prebuilt binary for better-sqlite3 (module version 137); npm rebuild silently fails.**
+## better-sqlite3 & Node v24 Startup
 
-When npm install runs on Node v24, the postinstall hook for better-sqlite3 silently fails because no prebuilt `.node` binary exists for that module version. The server then fails to require better-sqlite3 and crashes. npm rebuild also silently fails.
-
-Fix: compile from source in postinstall:
-```json
-"postinstall": "node scripts/patch-fsbrowse.js && node scripts/copy-vendor.js && (cd node_modules/better-sqlite3 && node-gyp rebuild 2>/dev/null) || true"
-```
-
-Paired changes:
-- `package.json` `start` script: `"bun server.js || node server.js"` (prefer bun, fall back to node)
-- `bin/gmgui.cjs` runtime detection: `spawnSync('bun', ['--version'], { shell: true })` to auto-detect bun availability, fallback to node (lines 46-47)
-- better-sqlite3 bumped ^12.6.2 → ^12.9.0
-
-bun start was already working (bun has native sqlite support via `bun:sqlite`). The node path was broken due to the missing native binding. Only compile from source fixes the node path.
+Node v24 lacks a prebuilt better-sqlite3 binary; the node path needs a from-source `postinstall` compile, and `start` is `bun server.js || node server.js`. `database.js` tries `bun:sqlite` first. Detail (postinstall command, paired package.json/bin changes, CI must-run-under-bun) in rs-learn (recall "agentgui startup better-sqlite3 node v24 bun").
 
 ## webjsx applyDiff Array Keying (2026-05-04)
 
 **Children arrays that mix keyed VElements with raw text/numbers crash in `vendor/webjsx/applyDiff.js`.**
 
-`webjsx` requires all siblings in an array prop (children, right, left, breadcrumbs, etc.) to either ALL be VElements with keys or ALL be non-keyed. Passing `Crumb({ right: [h('span', { key: 'a' }, 'A'), h('span', { key: 'b' }, 'B'), '● connected'] })` crashes on render with `TypeError: Cannot read properties of undefined (reading 'key')` at line 247420.js when the render loop tries to read `.key` on the bare string.
+`webjsx` requires all siblings in an array prop (children, right, left, breadcrumbs, etc.) to either ALL be VElements with keys or ALL be non-keyed. Passing `Crumb({ right: [h('span', { key: 'a' }, 'A'), h('span', { key: 'b' }, 'B'), 'connected'] })` crashes on render with `TypeError: Cannot read properties of undefined (reading 'key')` at line 247420.js when the render loop tries to read `.key` on the bare string.
 
-Fix: wrap any bare strings as keyed VElements: `h('span', { key: 'dot' }, '● connected')`. Rule: if ANY sibling in an array has a key, ALL siblings must be VElements (no raw strings or numbers).
+Fix: wrap any bare strings as keyed VElements: `h('span', { key: 'dot' }, 'connected')`. Rule: if ANY sibling in an array has a key, ALL siblings must be VElements (no raw strings or numbers).
 
 Surfaced 2026-05-04 while validating the chat surface in `site/app/`. Fix applied to crumbRight construction in `site/app/js/app.js` view().
 
@@ -143,7 +121,7 @@ Event dispatch loop:
 
 Throttle renders via `requestAnimationFrame` to avoid event storm during burst loads.
 
-**First request to `/v1/history/*` triggers loadOnce() that walks all JSONL files under ~/.claude/projects** (env default; override with `CLAUDE_PROJECTS_DIR`). In our test env: 299 files, 80MB, 69k events → 30-90s startup latency. Health check timeouts during this window are normal and expected. Subsequent requests are fast (cached index).
+**First request to `/v1/history/*` triggers loadOnce() that walks all JSONL files under ~/.claude/projects** (env default; override with `CLAUDE_PROJECTS_DIR`). In our test env: 299 files, 80MB, 69k events -> 30-90s startup latency. Health check timeouts during this window are normal and expected. Subsequent requests are fast (cached index).
 
 The endpoints are served by ccsniff's Express router mounted in-process from `server.js`. No external proxy.
 
@@ -153,10 +131,30 @@ The GUI loads `anentrypoint-design` from `https://unpkg.com/anentrypoint-design@
 
 ## Agent/model/session management (2026-05-28)
 
-- `agents.list` (WS) returns `available` + `npxInstallable` per agent; `agents.models` returns model choices (claude-code → sonnet/opus/haiku). The chat picker is **agent-then-model**, not a flat model list. Unavailable agents are disabled/gated.
+- `agents.list` (WS) returns `available` + `npxInstallable` per agent; `agents.models` returns model choices (claude-code -> sonnet/opus/haiku). The chat picker is **agent-then-model**, not a flat model list. Unavailable agents are disabled/gated.
 - `chat.sendMessage` accepts `cwd` (defaults to STARTUP_CWD) and `model`/`agentId` separately. `chat.active` (WS) lists in-flight chats with agentId/model/cwd/startedAt/pid; the history tab polls it (3s) and shows a running panel with per-session stop.
 - Client (`app.js`): chat transcript persists to `localStorage[agentgui.chat]` and restores on load; tool_use/result events render as chat parts; keyboard shortcuts (g+c/h/s, n, /, ?); settings has an agents-status panel from `health.acp[]`.
 
+## Kit Row rail + rank contract
+
+The design-kit `Row` (`anentrypoint-design` `src/components/content.js`) renders a leading status **rail** from a `rail` prop (`green` | `purple` | `flame`, via a `.row.rail-<tone>::before` bar) and accepts `rank` as an alias for the leading `code` index. A `state: 'disabled'` Row is inert — no `onClick`/`role=button`/tab-stop, `aria-disabled=true`. agentgui's history sessions, search results, and agents panel pass `rail` + `rank` and rely on this; the rendering reaches the live GUI only after the kit publishes to npm -> unpkg `@latest`. agentgui keeps the rail semantics consistent everywhere: **green = selected/ok, purple = subagent, flame = error/unavailable**.
+
+## GUI glyph policy
+
+GUI source keeps typographic product characters — the middot separator `·`, the ellipsis `…`, and em/en dashes in prose — as established design (AGENTS.md itself uses `·`). It carries **no** decorative tells: arrows, box-drawing, bullets, status dots, checks. Status is words + the CSS-drawn `.status-dot-disc`. Convert any arrow/box-drawing/bullet glyph to ASCII on sight (`->`, `// --- x ---`, `-`/`*`).
+
 ## DS CSS cascade — overriding component styles (2026-05-28)
 
 **`installStyles()` injects DS CSS into a runtime `<style>` after the head `<style>`, so local overrides need `!important` or higher specificity than the DS's `.ds-247420`-prefixed rules.** Full detail (font vars `--ff-display`/`--ff-mono`, the `.chat-head .sub` "00 msgs" quirk, EventList `.row[role=button]`, `[data-prog-focus]` focus suppression, `projectLabel()` for cwd slugs) is in rs-learn (recall "agentgui GUI styling DS cascade installStyles").
+
+## No decorative glyphs — ASCII-only GUI (2026-06-04)
+
+**The GUI carries no decorative tell-tale glyphs; remaining non-ASCII is the deliberate typographic separator set.** The de-jank sweep removed every tell-tale (status dots `[CHAR]`, arrows, box-drawing dividers, checks) in favor of ASCII words + the CSS-drawn status disc. The middot separator `·` is kept as established product design (it reads as a real meta-separator, used consistently across rows/subs); ellipsis `…` and em/en dashes were converted to `...` / `-` on sight. Verified live on buildesk: `document.body.innerText` matches no decorative-glyph regex (excluding the kept middot) across chat/history/settings. The DS Alert dismiss control renders its own close glyph only on a dismissible alert (intentional DS icon affordance, exempt).
+
+## DS SearchInput accessible name comes from `label`, not `aria-label` (2026-06-04)
+
+**`anentrypoint-design`'s `SearchInput` (internal `De`) sets `aria-label = label || placeholder`; it ignores any `aria-label` prop you pass.** To give the search box a real accessible name, pass `label:` (and a matching `placeholder:` for the visible hint). Passing only `aria-label` leaves AT announcing the placeholder. A post-render `setAttribute` race-loses against the DS re-render, so the prop is the only durable fix.
+
+## DS load moved to unpkg @latest — offline regression, re-vendor follow-up (2026-06-04)
+
+**`index.html` currently loads the DS kit (`247420.css` + `247420.js`) from `https://unpkg.com/anentrypoint-design@latest` at runtime, NOT the local `vendor/` copy.** Commit `947086e` made this deliberate trade ("always-latest" over offline) because the GUI's chat surface now renders via the kit's **load-bearing `AgentChat` component**, which exists in `@latest` (0.0.186) but NOT in the older locally-vendored bundle (`vendor/anentrypoint-design/247420.js`). Consequences: the GUI requires network, the shipped UI shifts when the upstream package publishes, and the local vendoring (gzip-Ha CSS blob, font/CDN-const localization) is bypassed. The separate jsdelivr imports inside the vendored bundle (`si`=marked@15, `ri`=dompurify@3, `_s`=prismjs@1.30.0/components) are therefore moot while on unpkg. **Follow-up to restore offline + predictability:** re-vendor 0.0.186+ locally (it has AgentChat), re-apply the offline localization (recall "DS bundle gzip Ha vendoring") AND rewire its `si`/`ri`/`_s` markdown-stack consts to the local `vendor/cdn/{marked.js,dompurify.js,prismjs/components/}` copies, then point `index.html` back at `./vendor/`. Witnessed live (browser `page.on('request')`): on `@latest` the page fetches `unpkg.com/anentrypoint-design@latest/dist/247420.{css,js}` at load.

package/docs/demo.html

@@ -3,13 +3,13 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>AgentGUI — Live Demo Preview</title>
-  <meta name="description" content="See what AgentGUI looks like on your machine — a non-interactive preview of the Gmail-inspired multi-agent interface.">
+  <title>AgentGUI - Live Demo Preview</title>
+  <meta name="description" content="See what AgentGUI looks like on your machine - a non-interactive preview of the Gmail-inspired multi-agent interface.">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Archivo+Black&family=JetBrains+Mono:wght@400;500;600&family=Google+Sans:wght@300;400;500;700&display=swap">
   <style>
-    /* ── Page chrome ─────────────────────────────────────── */
+    /* ---- Page chrome ---- */
     :root {
       --paper: #EFE9DD; --ink: #0B0B09; --green: #247420; --green-2: #92CEAC;
       --panel-0: var(--paper); --panel-1: #f6f1e7; --panel-2: #ece5d8; --panel-3: #ddd4c3;
@@ -37,7 +37,7 @@
       -webkit-font-smoothing: antialiased;
     }
 
-    /* ── Page layout ─────────────────────────────────────── */
+    /* ---- Page layout ---- */
     .page { display: flex; flex-direction: column; min-height: 100vh; }
 
     .topbar {
@@ -66,7 +66,7 @@
     .hero p { color: var(--panel-text-2); font-size: 13px; margin: 0 0 8px; }
     .hero .sub { font-size: 12px; color: var(--panel-text-3); }
 
-    /* ── Browser mockup ──────────────────────────────────── */
+    /* ---- Browser mockup ---- */
     .mockup-wrap {
       margin: 0 auto;
       max-width: 1200px;
@@ -112,7 +112,7 @@
       .browser-viewport { background: #202124; }
     }
 
-    /* ── Gmail-skin app shell (inside viewport) ──────────── */
+    /* ---- Gmail-skin app shell (inside viewport) ---- */
     .app-shell {
       display: grid;
       grid-template-columns: 72px 280px 1fr;
@@ -452,7 +452,7 @@
     }
     .send-btn svg { width: 16px; height: 16px; }
 
-    /* ── Below-fold sections ─────────────────────────────── */
+    /* ---- Below-fold sections ---- */
     .features { margin-top: 64px; }
     .features h2 {
       font-family: var(--ff-display); font-size: 24px; text-transform: lowercase;
@@ -484,7 +484,7 @@
     }
     .install-note { font-size: 12px; color: var(--panel-text-3); margin-top: 8px; }
 
-    /* ── Footer ──────────────────────────────────────────── */
+    /* ---- Footer ---- */
     .footer {
       height: 24px; background: var(--panel-accent); color: var(--panel-accent-fg);
       display: flex; align-items: center; padding: 0 14px; gap: 14px;
@@ -503,7 +503,7 @@
 <body>
 <div class="page">
 
-  <!-- ── Top bar ── -->
+  <!-- ---- Top bar ---- -->
   <header class="topbar">
     <span class="brand">247420<span class="slash">/</span>agentgui</span>
     <nav>
@@ -514,7 +514,7 @@
     </nav>
   </header>
 
-  <!-- ── Main content ── -->
+  <!-- ---- Main content ---- -->
   <main class="content">
 
     <section class="hero">
@@ -523,7 +523,7 @@
       <p class="sub">Gmail-inspired layout · Claude Code · real project · real output</p>
     </section>
 
-    <!-- ── Browser mockup ── -->
+    <!-- ---- Browser mockup ---- -->
     <div class="mockup-wrap">
 
       <!-- Browser chrome -->
@@ -661,7 +661,7 @@
                     <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
                     <span class="tool-name">Read</span>
                     <span style="flex:1;font-size:11px;color:#9aa0a6">static/css/main.css</span>
-                    <span class="tool-ok">✓ ok</span>
+                    <span class="tool-ok">[ok] ok</span>
                   </div>
                   <div class="tool-body">read 620 lines · sidebar · main-panel · conversation-item · input-card</div>
                 </div>
@@ -671,7 +671,7 @@
                     <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
                     <span class="tool-name">Read</span>
                     <span style="flex:1;font-size:11px;color:#9aa0a6">static/css/brand-bible.css</span>
-                    <span class="tool-ok">✓ ok</span>
+                    <span class="tool-ok">[ok] ok</span>
                   </div>
                   <div class="tool-body">read 449 lines · design tokens · panel vars · typography</div>
                 </div>
@@ -681,7 +681,7 @@
                     <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
                     <span class="tool-name">Write</span>
                     <span style="flex:1;font-size:11px;color:#9aa0a6">static/css/gmail-skin.css</span>
-                    <span class="tool-ok">✓ written</span>
+                    <span class="tool-ok">[ok] written</span>
                   </div>
                   <div class="tool-body">363 lines · grid layout · nav-rail · gm-* tokens · pill rows · search bar</div>
                 </div>
@@ -691,7 +691,7 @@
                     <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
                     <span class="tool-name">Edit</span>
                     <span style="flex:1;font-size:11px;color:#9aa0a6">static/index.html</span>
-                    <span class="tool-ok">✓ updated</span>
+                    <span class="tool-ok">[ok] updated</span>
                   </div>
                   <div class="tool-body">added .nav-rail · .header-search-wrap · loaded gmail-skin.css</div>
                 </div>
@@ -703,12 +703,12 @@
                   </div>
                   <div class="msg-body">
                     Done. Here's what changed:<br><br>
-                    • <strong>Three-column grid</strong> — icon nav rail (72px) → conversation list (280px) → main panel<br>
-                    • <strong>Nav rail</strong> with Compose FAB + Chats / Archived / Tools icons, pill hover/active states<br>
-                    • <strong>Header search bar</strong> — prominent pill input spanning the header, syncs to sidebar search<br>
-                    • <strong>Conversation rows</strong> — bold title, muted meta + timestamp, pill hover highlight in Google blue<br>
-                    • <strong>Input card</strong> — rounded corners, elevation shadow, Google-blue send pill<br>
-                    • <strong>Soft borders</strong> — <code>#e0e0e0</code> hairlines + drop shadows instead of brand-bible outlines
+                    - <strong>Three-column grid</strong> - icon nav rail (72px) -> conversation list (280px) -> main panel<br>
+                    - <strong>Nav rail</strong> with Compose FAB + Chats / Archived / Tools icons, pill hover/active states<br>
+                    - <strong>Header search bar</strong> - prominent pill input spanning the header, syncs to sidebar search<br>
+                    - <strong>Conversation rows</strong> - bold title, muted meta + timestamp, pill hover highlight in Google blue<br>
+                    - <strong>Input card</strong> - rounded corners, elevation shadow, Google-blue send pill<br>
+                    - <strong>Soft borders</strong> - <code>#e0e0e0</code> hairlines + drop shadows instead of brand-bible outlines
                   </div>
                   <div class="msg-ts">10:43 AM</div>
                 </div>
@@ -757,7 +757,7 @@
       </div><!-- /viewport -->
     </div><!-- /mockup-wrap -->
 
-    <!-- ── Features section ── -->
+    <!-- ---- Features section ---- -->
     <section class="features">
       <h2>what you get</h2>
       <div class="feat-grid">
@@ -784,7 +784,7 @@
         <div class="feat-card">
           <div class="feat-icon">🔄</div>
           <div class="feat-title">Queue &amp; steer</div>
-          <div class="feat-desc">Queue messages while the agent is running. Steer mid-session with a single click — no need to wait.</div>
+          <div class="feat-desc">Queue messages while the agent is running. Steer mid-session with a single click - no need to wait.</div>
         </div>
         <div class="feat-card">
           <div class="feat-icon">🧩</div>
@@ -794,21 +794,21 @@
       </div>
     </section>
 
-    <!-- ── Install section ── -->
+    <!-- ---- Install section ---- -->
     <section class="install-section">
       <h2>get started</h2>
       <div class="install-cmd">$ npx agentgui</div>
-      <p class="install-note">Requires Node.js 18+. Opens on http://localhost:3000/gm/ — no account, no cloud, runs entirely local.</p>
+      <p class="install-note">Requires Node.js 18+. Opens on http://localhost:3000/gm/ - no account, no cloud, runs entirely local.</p>
     </section>
 
   </main>
 
   <footer class="footer">
     <span>main</span>
-    <span>• agentgui</span>
+    <span>- agentgui</span>
     <span class="spread"></span>
     <a href="https://github.com/AnEntrypoint/agentgui">github</a>
-    <span>• 247420 / mmxxvi</span>
+    <span>- 247420 / mmxxvi</span>
   </footer>
 
 </div>

package/lib/codec.js

@@ -1,4 +1,4 @@
-// agentgui WS wire codec — plain JSON (UTF-8 text frames).
+// agentgui WS wire codec - plain JSON (UTF-8 text frames).
 // Browser-compatible (no msgpackr). encode() returns a string the ws library
 // sends as a text frame; decode() handles both Buffer/Uint8Array (Node) and
 // string (browser) inputs.

package/lib/http-handler.js

@@ -40,7 +40,7 @@ export function createHttpHandler({ BASE_URL, expressApp, queries, sendJSON, ser
       } else if (_auth.startsWith('Bearer ')) {
         _ok = _checkToken(_auth.slice(7));
       }
-      // EventSource and same-origin links can't set headers — accept ?token= as fallback.
+      // EventSource and same-origin links can't set headers - accept ?token= as fallback.
       if (!_ok) {
         try {
           const _qsTok = new URL(req.url, 'http://localhost').searchParams.get('token');
@@ -86,7 +86,7 @@ export function createHttpHandler({ BASE_URL, expressApp, queries, sendJSON, ser
         return;
       }
 
-      // Terminal sessions — gated by the Basic-auth check at the top of this handler.
+      // Terminal sessions - gated by the Basic-auth check at the top of this handler.
       // Never expose these routes without PASSWORD set.
       if (pathOnly === '/api/terminal/sessions' && req.method === 'GET') {
         sendJSON(req, res, 200, term.listSessions()); return;

package/lib/process-message.js

@@ -29,7 +29,7 @@ export function createProcessMessage({ queries, activeExecutions, rateLimitState
     queries.updateSession(sessionId, { status: 'active' });
     const cwd = conv?.workingDirectory || STARTUP_CWD;
     // Resolve agent before building stateRef so isJsonlBacked can be set correctly.
-    // claude-code (protocol: direct) writes JSONL → JsonlParser owns event broadcasting.
+    // claude-code (protocol: direct) writes JSONL -> JsonlParser owns event broadcasting.
     // All other agents (protocol: acp) rely solely on onEvent for streaming.
     let resolvedAgentId = agentId || 'claude-code';
     const wrapperAgent = discoveredAgents.find(a => a.id === resolvedAgentId && a.protocol === 'cli-wrapper' && a.acpId);

package/lib/stream-event-handler.js

@@ -4,8 +4,8 @@
  * For claude-code (isJsonlBacked=true):
  *   JsonlParser owns all event broadcasting via the JSONL file watcher.
  *   This handler only needs to:
- *     1. Extract session_id → setClaudeSessionId + registerSession
- *     2. Detect inline rate-limit messages → scheduleRetry
+ *     1. Extract session_id -> setClaudeSessionId + registerSession
+ *     2. Detect inline rate-limit messages -> scheduleRetry
  *
  * For ACP agents (isJsonlBacked=false):
  *   No JSONL file is written. This handler broadcasts streaming_start,
@@ -18,7 +18,7 @@ export function createEventHandler({ queries, activeExecutions, broadcastSync, r
     if (entry) entry.lastActivity = Date.now();
 
     // Register session with file watcher as soon as we see the session_id.
-    // This pre-maps claudeSessionId → (convId, dbSessionId) in JsonlParser before
+    // This pre-maps claudeSessionId -> (convId, dbSessionId) in JsonlParser before
     // the 16ms file-watcher debounce fires, preventing duplicate conversation creation.
     if (parsed.session_id) {
       if (!batcherRef.resumeSessionId || batcherRef.resumeSessionId !== parsed.session_id) {

package/lib/terminal.js

@@ -1,6 +1,6 @@
 // WebSocket terminal sessions. Ported from acptoapi 2026-05-21.
 // Auth: callers MUST gate /api/terminal/* + the WS upgrade behind agentgui's
-// PASSWORD Basic-auth check. This module does no auth on its own — never
+// PASSWORD Basic-auth check. This module does no auth on its own - never
 // expose without the gate.
 
 import os from 'os';

package/lib/ws-setup.js

@@ -24,7 +24,7 @@ export function createWsSetup(server, { BASE_URL, watch, staticDir, _assetCache,
       hotReloadClients.push(ws);
       ws.on('close', () => { const i = hotReloadClients.indexOf(ws); if (i > -1) hotReloadClients.splice(i, 1); });
     } else if (wsRoute.startsWith('/api/terminal/sessions/')) {
-      // Terminal session WS — auth was already enforced by wss-level PASSWORD
+      // Terminal session WS - auth was already enforced by wss-level PASSWORD
       // check at the top of this connection callback. attach to existing session.
       const m = wsRoute.match(/^\/api\/terminal\/sessions\/([0-9a-f]+)$/);
       if (!m) { ws.close(4400, 'bad-terminal-path'); return; }

package/package.json

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

package/scripts/build-rippleui.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 // One-time build: produces static/vendor/rippleui.css from the rippleui npm package.
-// Buildless at runtime — commit the output so `npm install` is enough to serve.
+// Buildless at runtime - commit the output so `npm install` is enough to serve.
 //
 // Source files (from node_modules/rippleui/dist/css/):
 //   base.css        - Tailwind preflight/reset         (~2KB)
 //   components.css  - RippleUI components (.btn etc.)  (~143KB)
 //   utilities.css   - RippleUI extra utilities         (~0.05KB)
-//   styles.css      - full TW + RippleUI monolith      (~4.7MB) — we only mine token defs
+//   styles.css      - full TW + RippleUI monolith      (~4.7MB) - we only mine token defs
 //
 // Output: static/vendor/rippleui.css containing
 //   1. :root / html.dark token blocks extracted from styles.css (so components.css works)
@@ -47,12 +47,12 @@ while ((m = blockRe.exec(styles))) {
 }
 
 if (tokenBlocks.length === 0) {
-    console.error('Could not find token blocks in styles.css — rippleui shape changed?');
+    console.error('Could not find token blocks in styles.css - rippleui shape changed?');
     process.exit(1);
 }
 
-const header = `/* RippleUI v${readPkgVersion()} — localized for AgentGUI.\n` +
-    ` * Generated by scripts/build-rippleui.mjs — do not edit by hand.\n` +
+const header = `/* RippleUI v${readPkgVersion()} - localized for AgentGUI.\n` +
+    ` * Generated by scripts/build-rippleui.mjs - do not edit by hand.\n` +
     ` * Regenerate: bun run scripts/build-rippleui.mjs\n` +
     ` */\n`;
 

package/scripts/capture-screenshots.mjs

@@ -33,7 +33,7 @@ function pickChrome() {
         // macOS
         '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
         '/Applications/Chromium.app/Contents/MacOS/Chromium',
-        // Windows — program files variants
+        // Windows - program files variants
         'C:/Program Files/Google/Chrome/Application/chrome.exe',
         'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
         path.join(home, 'AppData/Local/Google/Chrome/Application/chrome.exe'),
@@ -72,7 +72,7 @@ async function waitForHealthy(url, timeoutMs = 20000) {
 async function main() {
     fs.mkdirSync(OUT, { recursive: true });
     if (!fs.existsSync(FIXTURES)) {
-        console.warn(`[capture] fixture dir does not exist: ${FIXTURES} — using empty data dir`);
+        console.warn(`[capture] fixture dir does not exist: ${FIXTURES} - using empty data dir`);
         fs.mkdirSync(FIXTURES, { recursive: true });
     }
 
@@ -112,7 +112,7 @@ async function main() {
     try {
         await waitForHealthy(`${BASE}/api/health`);
         if (serverExitCode !== null) throw new Error(`Server exited with code ${serverExitCode} before becoming healthy`);
-        console.log('[capture] server healthy — launching browser');
+        console.log('[capture] server healthy - launching browser');
 
         const { default: puppeteer } = await import('puppeteer-core');
         const browser = await puppeteer.launch({

package/scripts/copy-vendor.js

@@ -46,5 +46,5 @@ if (fs.existsSync(webjsxDist)) {
   fs.writeFileSync(dest, iife);
   console.log('[copy-vendor] built webjsx IIFE ->', 'static/lib/webjsx.js', `(${iife.split('\n').length} lines)`);
 } else {
-  console.warn('[copy-vendor] webjsx not found in node_modules — run npm install');
+  console.warn('[copy-vendor] webjsx not found in node_modules - run npm install');
 }

package/scripts/harvest-fixtures.mjs

@@ -66,7 +66,7 @@ function det(prefix, ...seeds) {
     return `${prefix}-${h.slice(0, 16)}`;
 }
 
-// Anonymise — returns cleaned text
+// Anonymise - returns cleaned text
 function scrub(text) {
     if (typeof text !== 'string') return text;
     return text
@@ -87,8 +87,8 @@ function synthAssistant(title) {
             `\`lib/db-queries.js\` to use the new column and patch the associated tests.\n\n` +
             `The fix is a one-line change to the INSERT statement. All 19 tests pass now.`,
         'Refactor auth middleware':
-            `The current auth middleware has three responsibilities — rate limiting, basic-auth check, ` +
-            `and CORS — packed into a single 80-line function. I'll split them into three small ` +
+            `The current auth middleware has three responsibilities - rate limiting, basic-auth check, ` +
+            `and CORS - packed into a single 80-line function. I'll split them into three small ` +
             `middlewares in \`lib/http-middlewares/\` and compose them in \`http-handler.js\`. ` +
             `No behaviour change, just readability.`,
         'Add dark mode toggle':
@@ -109,13 +109,13 @@ function synthAssistant(title) {
             `markdown doc grouped by module. Output goes to \`docs/api.md\`. I'll add a JSDoc-style comment ` +
             `parser so handler descriptions can live inline with the route.`,
     };
-    return lookup[title] || 'Done — see the diff for details.';
+    return lookup[title] || 'Done - see the diff for details.';
 }
 
 function synthUser(title) {
     const lookup = {
         'Fix failing tests in db-queries':
-            'Hey — the test suite has been flaky since yesterday. Can you figure out which specs are failing and fix them? Start with `bun test` and work from there.',
+            'Hey - the test suite has been flaky since yesterday. Can you figure out which specs are failing and fix them? Start with `bun test` and work from there.',
         'Refactor auth middleware':
             `The auth middleware in lib/http-handler.js has grown into a monster. Please split it into single-responsibility pieces.`,
         'Add dark mode toggle':
@@ -123,7 +123,7 @@ function synthUser(title) {
         'Write migration for user schema':
             `Add last_login_at and a preferences JSON column to the users table. Include a backfill for existing rows.`,
         'Debug WebSocket reconnect loop':
-            `Clients are getting stuck in a reconnect loop — the network tab shows two sockets opening before one closes. Can you trace it in ws-machine and fix?`,
+            `Clients are getting stuck in a reconnect loop - the network tab shows two sockets opening before one closes. Can you trace it in ws-machine and fix?`,
         'Generate API docs from handlers':
             `We need API docs. Generate them from the route handler declarations and dump to docs/api.md.`,
     };
@@ -171,7 +171,7 @@ function build() {
 
     const db = openDb(OUT_DB);
 
-    // Use the real schema pipeline — same as database.js — so fixture DB always matches production.
+    // Use the real schema pipeline - same as database.js - so fixture DB always matches production.
     initSchema(db);
     migrateFromJson(db, path.join(OUT_DIR, 'nonexistent.json'));
     migrateToACP(db);

package/scripts/seed-large-conversation.js

@@ -61,7 +61,7 @@ console.error(`[seed] inserting conversation ${convId} with ${turns} turns, ${ch
 db.run(
   `INSERT INTO conversations (id, agentId, title, created_at, updated_at, status, agentType, workingDirectory, model)
    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-  [convId, 'cli-claude', `Profiling Seed — ${turns} turns`, startTime, now, 'active', 'claude', '/home/user', 'claude-opus-4-6']
+  [convId, 'cli-claude', `Profiling Seed - ${turns} turns`, startTime, now, 'active', 'claude', '/home/user', 'claude-opus-4-6']
 );
 
 const insertMsg = db.prepare(
@@ -155,5 +155,5 @@ for (let i = 0; i < turns; i += BATCH) {
 
 db.close();
 process.stderr.write('\n');
-console.error(`[seed] complete — ${totalChunks} total chunks for conv ${convId}`);
+console.error(`[seed] complete - ${totalChunks} total chunks for conv ${convId}`);
 console.log(convId);

package/scripts/smoke-ws-chat.mjs

@@ -1,5 +1,5 @@
 // Smoke-test the WS chat protocol added in this session.
-// Boots no server — assumes one is already running at ws://localhost:$PORT/sync.
+// Boots no server - assumes one is already running at ws://localhost:$PORT/sync.
 //
 // Usage: PORT=3990 node scripts/smoke-ws-chat.mjs
 //
@@ -43,7 +43,7 @@ ws.on('message', async (data) => {
       console.log('sync_connected, clientId =', m.clientId);
       try {
         const r1 = await call('agents.list');
-        console.log('agents.list OK, count =', r1.agents.length, '— first =', r1.agents[0]?.id);
+        console.log('agents.list OK, count =', r1.agents.length, '- first =', r1.agents[0]?.id);
         const r2 = await call('conversation.subscribe', { sessionId: 'smoke-test-sid' });
         console.log('conversation.subscribe OK =', r2);
         console.log('PASS');

package/server.js

@@ -179,7 +179,7 @@ server.on('error', (err) => {
   if (err.code === 'EADDRINUSE') {
     _portRetries++;
     if (_portRetries > MAX_PORT_RETRIES) {
-      // Bail instead of retrying forever — an unbounded retry loop leaks a
+      // Bail instead of retrying forever - an unbounded retry loop leaks a
       // live process that holds no useful port and accumulates on each launch.
       console.error(`Port ${PORT} still in use after ${MAX_PORT_RETRIES} retries; exiting. Free the port or set PORT to a different value.`);
       process.exit(1);

package/site/app/index.html

@@ -4,11 +4,13 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
   <title>agentgui</title>
-  <meta name="description" content="agentgui — multi-agent client with same-origin server, in-process ccsniff history, and ACP chat.">
+  <meta name="description" content="agentgui - multi-agent client with same-origin server, in-process ccsniff history, and ACP chat.">
   <!-- The GUI lives in the anentrypoint-design kit and is loaded from unpkg at
        its latest published version, so agentgui always tracks the kit without a
        hand-maintained vendored copy. (This trades the prior offline guarantee for
-       always-latest, per project decision; a network connection is required.) -->
+       always-latest, per project decision; a network connection is required.)
+       NOTE: re-vendoring 0.0.186+ locally (it adds the load-bearing AgentChat
+       component) would restore offline + predictability -- tracked in AGENTS.md. -->
   <link rel="stylesheet" href="https://unpkg.com/anentrypoint-design@latest/dist/247420.css">
   <script type="importmap">
     { "imports": { "anentrypoint-design": "https://unpkg.com/anentrypoint-design@latest/dist/247420.js" } }
@@ -44,7 +46,7 @@
     #app { height: 100vh; height: 100dvh; }
     #app > * { height: 100%; }
 
-    /* Themed thin scrollbars — the native chrome scrollbar is chunky/light and
+    /* Themed thin scrollbars - the native chrome scrollbar is chunky/light and
        clashes with the dark theme on the history sidebar and settings column. */
     * {
       scrollbar-width: thin;
@@ -79,7 +81,7 @@
     }
     .skip-link:focus { left: 8px; top: 8px; outline: 2px solid #fff; outline-offset: 2px; }
 
-    /* status connection dot — a CSS-drawn disc (real UI affordance, not a text
+    /* status connection dot - a CSS-drawn disc (real UI affordance, not a text
        glyph). The .status-dot-disc child is always present; the parent's state
        class colours it, and only is-live pulses. */
     .status-dot { display: inline-flex; align-items: center; gap: .4em; white-space: nowrap; }
@@ -180,7 +182,7 @@
 
     /* Topbar nav: the DS renders the active tab as a large filled green pill that
        sits taller than the inactive text links and reads as misaligned. Make all
-       tabs consistent — equal padding, the active one a subtle tinted underline-pill
+       tabs consistent - equal padding, the active one a subtle tinted underline-pill
        rather than an oversized oval. */
     /* Prefix with .ds-247420 (the <html> class) to match the DS selector's
        specificity; source order then lets these win. */
@@ -249,7 +251,7 @@
     .agentgui-main-settings .settings-grid { margin-top: 0; }
 
     /* The DS Chat head computes its own zero-padded count ("00 msgs") and ignores
-       our sub prop; it reads as a bug. Hide the DS sub — streaming state shows via
+       our sub prop; it reads as a bug. Hide the DS sub - streaming state shows via
        the title and the busy banner. Also hide the DS's empty decorative head dot. */
     .chat-head .sub { display: none; }
     .chat-head .dot { display: none; }

package/site/app/js/app.js

@@ -11,10 +11,10 @@ const state = {
   health: { status: 'unknown' },
   tab: 'chat',
   agents: [],
-  selectedAgent: localStorage.getItem('agentgui.agent') || '',
+  selectedAgent: lsGet('agentgui.agent') || '',
   agentModels: [],
-  selectedModel: localStorage.getItem('agentgui.model') || '',
-  chatCwd: localStorage.getItem('agentgui.cwd') || '',
+  selectedModel: lsGet('agentgui.model') || '',
+  chatCwd: lsGet('agentgui.cwd') || '',
   chat: { messages: [], busy: false, abort: null, draft: '', resumeSid: null },
   sessions: [],
   selectedSid: null,
@@ -75,13 +75,14 @@ function isNarrow() { return typeof window !== 'undefined' && window.innerWidth
 function truncate(str, mobileLen, desktopLen) {
   const s = String(str ?? '');
   const max = isNarrow() ? mobileLen : desktopLen;
-  return s.length > max ? s.slice(0, max) + '…' : s;
+  return s.length > max ? s.slice(0, max) + '...' : s;
 }
 function debounce(fn, ms) {
   let t;
   return (...args) => { clearTimeout(t); t = setTimeout(() => fn(...args), ms); };
 }
 
+function lsGet(k) { try { return localStorage.getItem(k); } catch { return null; } }
 function lsSet(k, v) { try { localStorage.setItem(k, v); } catch {} }
 function lsRemove(k) { try { localStorage.removeItem(k); } catch {} }
 
@@ -132,10 +133,10 @@ function timeNow() {
 
 async function selectAgent(id) {
   // Re-selecting the same agent would needlessly refetch models and reset the
-  // current model selection — no-op early.
+  // current model selection - no-op early.
   if (id === state.selectedAgent && state.agentModels.length) return;
   state.selectedAgent = id;
-  localStorage.setItem('agentgui.agent', id);
+  lsSet('agentgui.agent', id);
   state.agentModels = [];
   state.selectedModel = '';
   state.modelsLoading = true;
@@ -144,7 +145,7 @@ async function selectAgent(id) {
   if (state.selectedAgent !== id) return; // changed while loading
   state.modelsLoading = false;
   state.agentModels = models;
-  const saved = localStorage.getItem('agentgui.model');
+  const saved = lsGet('agentgui.model');
   // Only restore a saved model that the NEW agent actually offers; otherwise
   // fall back to its first model (never carry a stale model from a prior agent).
   state.selectedModel = (saved && models.some(m => m.id === saved)) ? saved : (models[0]?.id || '');
@@ -153,7 +154,7 @@ async function selectAgent(id) {
 
 function selectModel(id) {
   state.selectedModel = id;
-  localStorage.setItem('agentgui.model', id);
+  lsSet('agentgui.model', id);
   render();
 }
 
@@ -161,7 +162,7 @@ function agentById(id) { return state.agents.find(a => a.id === id); }
 function agentAvailable(id) { const a = agentById(id); return !a || a.available !== false; }
 
 // The four flagship orchestration targets surface first, then other available
-// agents, then npx-installable, then not-installed — so the agents the GUI
+// agents, then npx-installable, then not-installed - so the agents the GUI
 // exists to drive are reachable without scanning a flat 17-item list. This
 // ordering is agentgui's orchestration priority, so it stays in the host and is
 // passed pre-sorted to the (app-agnostic) AgentChat kit.
@@ -206,7 +207,7 @@ function navTo(tab) {
     const heading = region.querySelector('h1, h2');
     const target = heading || region;
     if (!target.hasAttribute('tabindex')) target.setAttribute('tabindex', '-1');
-    // Mark as programmatically focused so CSS can suppress the focus ring — we
+    // Mark as programmatically focused so CSS can suppress the focus ring - we
     // move focus here for AT, but a visible green outline box around the heading
     // reads as an accidental border to sighted users.
     target.setAttribute('data-prog-focus', '');
@@ -277,7 +278,7 @@ function openLiveStream() {
           if (data.isError) sess.errors = (sess.errors || 0) + 1;
         } else {
           // Unknown session: a burst of events for a new session would trigger
-          // a full session-list refetch per event — debounce it into one.
+          // a full session-list refetch per event - debounce it into one.
           debouncedRefreshHistory();
           return;
         }
@@ -316,10 +317,10 @@ function view() {
   const dotLabel = state.tab === 'history'
     ? (state.live.error
         ? state.live.error + (state.live.reconnects ? ' · ' + state.live.reconnects + ' reconnects' : '')
-        : (liveActive ? 'live · ' + state.live.eventCount : (state.live.connected ? 'live' : 'connecting…')))
+        : (liveActive ? 'live · ' + state.live.eventCount : (state.live.connected ? 'live' : 'connecting...')))
     : (ok ? (state.health.ws === 'reconnecting' ? 'ws reconnecting' : 'connected') : 'offline');
   const dotLive = state.tab === 'history' ? (liveActive || state.live.connected) : ok;
-  // The status dot is drawn entirely by CSS (.status-dot::before) — a small
+  // The status dot is drawn entirely by CSS (.status-dot::before) - a small
   // colored disc, real product design, not a text glyph. State drives its colour
   // via the modifier class; the label carries only words so AT reads "live", and
   // there are no literal status-glyph characters in the DOM.
@@ -379,7 +380,7 @@ function view() {
     : 'min-height:0';
   const shortcutsHint = state.showShortcuts
     ? Alert({ key: 'sc', kind: 'info', title: 'Keyboard shortcuts',
-        children: 'g then c/h/s — chat/history/settings · n — new chat · / — focus search/composer · ? — toggle this · Esc — blur field' })
+        children: 'g then c/h/s - chat/history/settings · n - new chat · / - focus search/composer · ? - toggle this · Esc - blur field' })
     : null;
   const main = h('div', { id: 'agentgui-main', role: 'main', 'data-chat-scroll': '', class: 'agentgui-main agentgui-main-' + state.tab, style: mainStyle }, [shortcutsHint, ...mainContent()].filter(Boolean));
   // narrow drives the DS main-column class; the history sidebar itself collapses
@@ -436,8 +437,8 @@ function chatMain() {
     // than as a separate stacked Alert, so resume context reads as one block.
     banners.push(h('div', { key: 'rb', class: 'resume-banner', role: 'status' },
       h('span', { key: 'rbtxt', class: 'lede' },
-        'resuming session ' + state.chat.resumeSid.slice(0, 8) + '… via --resume'
-        + (state.chat.resumeNote ? ' — ' + state.chat.resumeNote : '')),
+        'resuming session ' + state.chat.resumeSid.slice(0, 8) + '... via --resume'
+        + (state.chat.resumeNote ? ' - ' + state.chat.resumeNote : '')),
       Btn({ key: 'rclr', onClick: () => { state.chat.resumeSid = null; state.chat.resumeNote = null; render(); }, children: 'clear' })));
   }
   if (state.selectedAgent && !agentAvailable(state.selectedAgent)) {
@@ -465,7 +466,7 @@ function chatMain() {
 
   const placeholder = !state.selectedAgent
     ? 'choose an agent first'
-    : (!agentAvailable(state.selectedAgent) ? agentName + ' is not installed' : 'message…');
+    : (!agentAvailable(state.selectedAgent) ? agentName + ' is not installed' : 'message...');
 
   // The reusable AgentChat kit owns the agent/model picker, cwd bar, transcript
   // (with AICat-style auto-scroll + thinking), and the caret-stable composer.
@@ -482,8 +483,8 @@ function chatMain() {
       busy: state.chat.busy,
       draft: state.chat.draft,
       status: state.chat.busy
-        ? (state.health.ws === 'reconnecting' ? 'reconnecting…' : 'streaming…')
-        : (state.modelsLoading ? 'loading models…' : (state.chat.resumeSid ? 'resume' : 'ready')),
+        ? (state.health.ws === 'reconnecting' ? 'reconnecting...' : 'streaming...')
+        : (state.modelsLoading ? 'loading models...' : (state.chat.resumeSid ? 'resume' : 'ready')),
       agentName,
       placeholder,
       canSend: canSend(),
@@ -509,8 +510,8 @@ function chatMain() {
       onCwdSave: () => {
         const path = (state.cwdDraft ?? '').trim();
         // A relative cwd would resolve against the server process dir, not what
-        // the user means — require an absolute path (POSIX /…, UNC \\…, or
-        // Windows drive X:\…). Blank is valid (server default).
+        // the user means - require an absolute path (POSIX /..., UNC \\..., or
+        // Windows drive X:\...). Blank is valid (server default).
         if (path && !/^([/\\]|[A-Za-z]:[/\\])/.test(path)) {
           state.cwdError = 'enter an absolute path (e.g. /home/you/proj or C:\\proj) or leave blank';
           render();
@@ -545,7 +546,7 @@ function newChat() {
   state.confirmingNewChat = false;
   state.chat.abort?.abort();
   state.chat = { messages: [], busy: false, abort: null, draft: '', resumeSid: null };
-  try { localStorage.removeItem(CHAT_KEY); } catch {}
+  lsRemove(CHAT_KEY);
   render();
 }
 
@@ -560,13 +561,13 @@ const CHAT_KEY = 'agentgui.chat';
 function persistChat() {
   try {
     const msgs = state.chat.messages.map(m => ({ id: m.id, role: m.role, content: m.content, time: m.time, parts: m.parts }));
-    if (!msgs.length) { localStorage.removeItem(CHAT_KEY); return; }
-    localStorage.setItem(CHAT_KEY, JSON.stringify({ messages: msgs, resumeSid: state.chat.resumeSid, agent: state.selectedAgent, model: state.selectedModel }));
+    if (!msgs.length) { lsRemove(CHAT_KEY); return; }
+    lsSet(CHAT_KEY, JSON.stringify({ messages: msgs, resumeSid: state.chat.resumeSid, agent: state.selectedAgent, model: state.selectedModel }));
   } catch {}
 }
 function restoreChat() {
   try {
-    const raw = localStorage.getItem(CHAT_KEY);
+    const raw = lsGet(CHAT_KEY);
     if (!raw) return;
     const saved = JSON.parse(raw);
     if (Array.isArray(saved.messages) && saved.messages.length) {
@@ -603,7 +604,7 @@ async function sendChat() {
       if (ev.type === 'text')  { cur.content += ev.text; render(); scrollChatToBottom(); }
       else if (ev.type === 'tool') { cur.parts.push(toolSummary(ev.block)); render(); scrollChatToBottom(); }
       else if (ev.type === 'tool_result') { cur.parts.push('-> ' + toolResultSummary(ev.block)); render(); scrollChatToBottom(); }
-      else if (ev.type === 'result') { /* terminal usage/summary block — already reflected via text */ }
+      else if (ev.type === 'result') { /* terminal usage/summary block - already reflected via text */ }
       else if (ev.type === 'error') { cur.error = errText(ev.error); render(); }
     }
   } catch (e) {
@@ -624,7 +625,7 @@ function reconnectAlert() {
     key: 'liveerr',
     kind: 'error',
     title: 'Live stream disconnected',
-    children: [h('span', { key: 'lemsg' }, state.live.error + ' — '), Btn({ key: 'reco', onClick: openLiveStream, children: 'reconnect', title: 'Reconnect to history stream' })],
+    children: [h('span', { key: 'lemsg' }, state.live.error + ' - '), Btn({ key: 'reco', onClick: openLiveStream, children: 'reconnect', title: 'Reconnect to history stream' })],
   });
 }
 
@@ -635,7 +636,7 @@ function historyMain() {
       reconnectAlert(),
       PageHeader({
         title: 'history',
-        lede: 'pick a session from the sidebar — events stream live from ccsniff /v1/history.',
+        lede: 'pick a session from the sidebar - events stream live from ccsniff /v1/history.',
       }),
       h('div', { key: 'histempty', class: 'history-empty', role: 'status' },
         h('p', { key: 'gt', class: 'history-empty-title' },
@@ -643,7 +644,7 @@ function historyMain() {
         h('p', { key: 'gs', class: 'lede history-empty-sub' },
           count
             ? count + ' session' + (count === 1 ? '' : 's') + ' available · use the search box or press / to filter'
-            : 'Start a chat or run a local coding agent — its session will appear here live.')),
+            : 'Start a chat or run a local coding agent - its session will appear here live.')),
     ].filter(Boolean);
   }
 
@@ -667,9 +668,9 @@ function historyMain() {
     // doesn't spin forever.
     const body = state.eventsLoaded
       ? h('div', { key: 'noev', class: 'lede empty-state', role: 'status' },
-          h('span', { key: 'noevtxt' }, 'no events in this session — '),
+          h('span', { key: 'noevtxt' }, 'no events in this session - '),
           Btn({ key: 'reload', onClick: () => loadSession(state.selectedSid), children: 'reload' }))
-      : h('div', { key: 'loading', class: 'lede empty-state', role: 'status', 'aria-live': 'polite' }, Spinner({ key: 'spin', size: 'sm' }), 'loading events…');
+      : h('div', { key: 'loading', class: 'lede empty-state', role: 'status', 'aria-live': 'polite' }, Spinner({ key: 'spin', size: 'sm' }), 'loading events...');
     return [reconnectAlert(), head, actions, Panel({ title: 'events', children: body })].filter(Boolean);
   }
 
@@ -746,7 +747,7 @@ function resumeInChat(sess) {
   // Only claude-code supports --resume by sid; warn if we have to switch the
   // user's selected agent rather than silently discarding it.
   if (state.selectedAgent && state.selectedAgent !== 'claude-code') {
-    state.chat.resumeNote = 'Switched to Claude Code — only it supports resuming a session by id.';
+    state.chat.resumeNote = 'Switched to Claude Code - only it supports resuming a session by id.';
   } else {
     state.chat.resumeNote = null;
   }
@@ -843,13 +844,16 @@ function historySide() {
       children: [
         SearchInput({
           key: 'searchInput',
-          placeholder: 'search event text…',
+          // The DS SearchInput reads `label` (not aria-label) for the accessible
+          // name, falling back to placeholder; pass label so AT announces it.
+          placeholder: 'Search event text across sessions',
+          label: 'Search event text across sessions',
           'aria-label': 'Search event text across sessions',
           value: state.searchQ,
           onInput: (v) => { state.searchQ = v; debouncedSearch(); },
         }),
         state.searchBusy
-          ? h('div', { key: 'searchbusy', class: 'lede empty-state', role: 'status' }, Spinner({ key: 'ss', size: 'sm' }), 'searching…')
+          ? h('div', { key: 'searchbusy', class: 'lede empty-state', role: 'status' }, Spinner({ key: 'ss', size: 'sm' }), 'searching...')
           : null,
         searching && state.searchHits.error
           ? Alert({ key: 'searcherr', kind: 'error', title: 'Search failed', children: state.searchHits.error })
@@ -883,7 +887,7 @@ function historySide() {
         // Search is server-capped at 60 hits; there is no deeper page, so tell
         // the user the result set is truncated rather than silently hiding it.
         searching && truncatedBy > 0
-          ? h('p', { key: 'searchmore', class: 'lede empty-state' }, 'showing first 60 matches (' + truncatedBy + ' more — refine your search)')
+          ? h('p', { key: 'searchmore', class: 'lede empty-state' }, 'showing first 60 matches (' + truncatedBy + ' more - refine your search)')
           : null,
       ],
     }),
@@ -935,7 +939,7 @@ function settingsMain() {
   return [
     PageHeader({
       title: 'settings',
-      lede: 'point agentgui at any backend. blank = same-origin (ccsniff in-process). ?backend=… or the field below persists via localStorage.',
+      lede: 'point agentgui at any backend. blank = same-origin (ccsniff in-process). ?backend=... or the field below persists via localStorage.',
     }),
     h('div', { key: 'settings-grid', class: 'settings-grid' }, [
     Panel({
@@ -955,10 +959,10 @@ function settingsMain() {
           onInput: (v) => { state.backendDraft = v; render(); },
         }),
         !isValid ? h('p', { key: 'err', id: 'backend-url-error', class: 'lede field-error', role: 'alert' }, 'Invalid URL format') : null,
-        state.backendStatus === 'connecting' ? h('p', { key: 'bst', class: 'lede', role: 'status' }, 'connecting…') : null,
+        state.backendStatus === 'connecting' ? h('p', { key: 'bst', class: 'lede', role: 'status' }, 'connecting...') : null,
         state.backendStatus === 'ok' ? h('p', { key: 'bst', class: 'lede', role: 'status' }, 'connected') : null,
-        state.backendStatus === 'failed' ? h('p', { key: 'bst', class: 'lede field-error', role: 'alert' }, 'connection failed — check the URL') : null,
-        state.confirmingBackend ? h('p', { key: 'bcw', class: 'lede field-error', role: 'alert' }, 'changing backend discards this browser\'s chat transcript — press save again to confirm') : null,
+        state.backendStatus === 'failed' ? h('p', { key: 'bst', class: 'lede field-error', role: 'alert' }, 'connection failed - check the URL') : null,
+        state.confirmingBackend ? h('p', { key: 'bcw', class: 'lede field-error', role: 'alert' }, 'changing backend discards this browser\'s chat transcript - press save again to confirm') : null,
         healthSummary(),
         Btn({
           key: 'savebtn',
@@ -966,7 +970,7 @@ function settingsMain() {
           primary: true,
           disabled: !isValid || state.backendDraft === state.backend || state.backendStatus === 'connecting',
           onClick: (e) => { e.preventDefault(); saveBackend(); },
-          children: state.backendStatus === 'connecting' ? 'connecting…' : 'save + reconnect',
+          children: state.backendStatus === 'connecting' ? 'connecting...' : 'save + reconnect',
           title: isValid ? 'Save backend URL and reconnect' : 'Fix URL format first',
         }),
       ]),
@@ -994,7 +998,7 @@ function preferencesPanel() {
     children: [
       h('div', { key: 'ver', class: 'lede' }, 'server ' + (hh.version ? 'v' + hh.version : 'version unknown') + (window.__SERVER_VERSION ? ' · build ' + window.__SERVER_VERSION : '')),
       h('div', { key: 'sc', class: 'lede', style: 'margin:.5em 0' },
-        'keyboard: g then c/h/s — switch tabs · n — new chat · / — focus search/composer · ? — toggle hint · Esc — blur field'),
+        'keyboard: g then c/h/s - switch tabs · n - new chat · / - focus search/composer · ? - toggle hint · Esc - blur field'),
       state.confirmingClearData
         ? Alert({ key: 'cld', kind: 'warn', title: 'Clear all local data?',
             children: [
@@ -1096,7 +1100,7 @@ async function loadSession(sid) {
       ts: Date.now(),
       role: 'error',
       type: 'fetch',
-      text: 'Failed to load session: ' + e.message + ' — retry via sidebar',
+      text: 'Failed to load session: ' + e.message + ' - retry via sidebar',
     }];
     state.eventsLoaded = true;
     render();

package/site/app/js/backend.js

@@ -88,8 +88,8 @@ const SYNC_PATH = '/sync';
 let _ws = null;
 let _wsReady = null;       // Promise that resolves when ws is OPEN
 let _nextReqId = 1;
-const _pending = new Map();          // requestId → { resolve, reject }
-const _sessionListeners = new Map(); // sessionId → Set<(event)=>void>
+const _pending = new Map();          // requestId -> { resolve, reject }
+const _sessionListeners = new Map(); // sessionId -> Set<(event)=>void>
 const _statusListeners = new Set();  // fn(state) where state in 'open'|'closed'|'error'|'reconnecting'
 let _reconnectAttempts = 0;
 let _reconnectTimer = null;
@@ -172,7 +172,7 @@ function ensureWs(base) {
         else p.resolve(msg.d);
         return;
       }
-      // Unsolicited broadcast — route by sessionId to subscribers.
+      // Unsolicited broadcast - route by sessionId to subscribers.
       // Server may send a single event or a batch (array) per ws-optimizer.
       const items = Array.isArray(msg) ? msg : [msg];
       for (const item of items) {
@@ -231,9 +231,9 @@ export async function listAgentModels(base, agentId) {
 // ---------- Streaming chat (WS) ----------
 //
 // Yields events of shape:
-//   { type: 'text',  text: '...' }    — assistant text deltas
-//   { type: 'tool',  block: {...} }   — tool_use blocks
-//   { type: 'result', block: {...} }  — terminal result block
+//   { type: 'text',  text: '...' }    - assistant text deltas
+//   { type: 'tool',  block: {...} }   - tool_use blocks
+//   { type: 'result', block: {...} }  - terminal result block
 //   { type: 'error', error: '...' }
 //
 // Caller signature kept compatible with the previous HTTP/SSE impl.
@@ -282,12 +282,12 @@ export async function* streamChat(base, { model, messages, signal, agentId, resu
     }
   });
 
-  // If the websocket drops mid-stream, streaming_complete will never arrive —
+  // If the websocket drops mid-stream, streaming_complete will never arrive -
   // surface an error and end the iterator instead of hanging forever.
   const onWs = (s) => { if ((s === 'closed' || s === 'error') && !done) { errored = errored || 'connection lost during stream'; finish(); } };
   const unsubWs = onWsStatus ? onWsStatus(onWs) : null;
 
-  // Wire AbortSignal to chat.cancel — and end the iterator immediately so the
+  // Wire AbortSignal to chat.cancel - and end the iterator immediately so the
   // caller's busy state clears even if the server never emits a final event.
   const onAbort = () => { wsCall(base, 'chat.cancel', { sessionId }).catch(() => {}); finish(); };
   if (signal) {

package/site/theme.mjs

@@ -137,7 +137,7 @@ const renderHtml = ({ site, nav, page, clientScript }) => `<!DOCTYPE html>
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>${escapeHtml(page.title || site.title)}${site.tagline ? ' — ' + escapeHtml(site.tagline) : ''}</title>
+  <title>${escapeHtml(page.title || site.title)}${site.tagline ? ' - ' + escapeHtml(site.tagline) : ''}</title>
   <meta name="description" content="${escapeHtml(page.description || site.description || site.tagline || site.title)}" />
   <script type="importmap">{"imports":{"anentrypoint-design":"${SDK_URL}"}}</script>
   <style>html,body{margin:0;padding:0}body{background:var(--app-bg,#FBF6EB);color:var(--ink,#1F1B16);font-family:var(--ff-ui,'Nunito',system-ui,sans-serif)}</style>

package/test.js

@@ -3,7 +3,6 @@ import { createRequire } from 'module';
 import { initSchema } from './database-schema.js';
 import { migrateConversationColumns } from './database-migrations.js';
 import { migrateACPSchema } from './database-migrations-acp.js';
-import { createQueries } from './lib/db-queries.js';
 import { encode, decode } from './lib/codec.js';
 import { WsRouter } from './lib/ws-protocol.js';
 import { WSOptimizer } from './lib/ws-optimizer.js';
@@ -13,8 +12,16 @@ import { maskKey, buildSystemPrompt } from './lib/provider-config.js';
 import { initializeDescriptors, getAgentDescriptor } from './lib/agent-descriptors.js';
 import { createACPProtocolHandler } from './lib/acp-protocol.js';
 import { sendJSON, compressAndSend, acceptsEncoding } from './lib/http-utils.js';
-import { JsonlParser } from './lib/jsonl-parser.js';
 const require = createRequire(import.meta.url);
+// lib/jsonl-parser.js was also removed in the pivot (ccsniff owns JSONL parsing
+// now). Load it dynamically so its test skips rather than crashing the suite.
+let JsonlParser = null;
+try { ({ JsonlParser } = await import('./lib/jsonl-parser.js')); } catch { JsonlParser = null; }
+// lib/db-queries.js was removed in the 2026-05-19 single-surface pivot (history
+// now flows through ccsniff, not the local query layer). Import it dynamically
+// so its absence skips only the db-queries tests instead of crashing the suite.
+let createQueries = null;
+try { ({ createQueries } = await import('./lib/db-queries.js')); } catch { createQueries = null; }
 let Database, dbAvailable = false;
 try {
   try { Database = (await import('bun:sqlite')).default; }
@@ -22,11 +29,14 @@ try {
   new Database(':memory:');
   dbAvailable = true;
 } catch { dbAvailable = false; }
-let passed = 0, failed = 0;
+let passed = 0, failed = 0, skipped = 0;
 const ok = (name, fn) => Promise.resolve().then(fn).then(
-  () => { console.log(`ok — ${name}`); passed++; },
-  (err) => { console.error(`FAIL — ${name}: ${err.message}`); failed++; });
-const okDb = (name, fn) => dbAvailable ? ok(name, fn) : (console.log(`skip (no sqlite) — ${name}`), passed++, Promise.resolve());
+  () => { console.log(`ok - ${name}`); passed++; },
+  (err) => { console.error(`FAIL - ${name}: ${err.message}`); failed++; });
+// Skip a test when sqlite is unavailable OR when it needs the removed db-queries layer.
+const okDb = (name, fn) => (dbAvailable && createQueries)
+  ? ok(name, fn)
+  : (console.log(`skip (${dbAvailable ? 'no db-queries' : 'no sqlite'}) - ${name}`), skipped++, Promise.resolve());
 function inMemDb() {
   const db = new Database(':memory:');
   if (db.pragma) db.pragma('foreign_keys = ON'); else db.run('PRAGMA foreign_keys = ON');
@@ -43,11 +53,17 @@ function mockRes() {
   return r;
 }
 const run = async () => {
-await ok('codec: roundtrip + binary', () => {
+await ok('codec: json roundtrip + wire-byte decode', () => {
+  // The codec is a plain-JSON text codec (encode = JSON.stringify); it does not
+  // preserve binary payloads (a Buffer is not JSON-native), so we assert the
+  // JSON-value contract plus decode()'s ability to read a Uint8Array wire frame.
   assert.deepEqual(decode(encode({ a: 1, b: 'str', c: [1, 2, 3], d: { nested: true } })), { a: 1, b: 'str', c: [1, 2, 3], d: { nested: true } });
-  assert.deepEqual(Array.from(decode(encode({ bin: Buffer.from([1, 2, 3, 4]) })).bin), [1, 2, 3, 4]);
+  // decode() must accept an incoming Uint8Array/Buffer wire frame and parse it.
+  const wire = new TextEncoder().encode(encode({ ok: true, n: 5 }));
+  assert.deepEqual(decode(wire), { ok: true, n: 5 });
+  assert.deepEqual(decode(Buffer.from(encode({ z: 'y' }))), { z: 'y' });
 });
-await okDb('db: init schema creates conversations table', () => {
+await (dbAvailable ? ok : (n) => (console.log(`skip (no sqlite) - ${n}`), skipped++, Promise.resolve()))('db: init schema creates conversations table', () => {
   assert.ok(inMemDb().db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='conversations'").get());
 });
 await okDb('db-queries: createConversation round-trip', () => {
@@ -157,7 +173,7 @@ await ok('http-utils: sendJSON + compressAndSend size threshold', () => {
   const big = mockRes(); compressAndSend(req, big, 200, 'text/plain', 'x'.repeat(2000)); assert.equal(big.headers['Content-Encoding'], 'gzip');
   const ng = mockRes(); compressAndSend({ headers: {} }, ng, 200, 'text/html', 'y'.repeat(2000)); assert.equal(ng.headers['Cache-Control'], 'no-store');
 });
-await ok('jsonl-parser: register + remove + clear', () => {
+await (JsonlParser ? ok : (n) => (console.log(`skip (no jsonl-parser) - ${n}`), skipped++, Promise.resolve()))('jsonl-parser: register + remove + clear', () => {
   const p = new JsonlParser({ broadcastSync: () => {}, queries: { getConversationByClaudeSessionId: () => null } });
   p.registerSession('s1', 'c1', 'd1'); assert.equal(p._convMap.get('s1'), 'c1');
   p.removeSid('s1'); assert.equal(p._convMap.has('s1'), false);
@@ -195,6 +211,6 @@ await okDb('conv-routes+thread-routes+auth-config+util-routes', async () => {
   const vr = mr(); await uR['GET /api/version'](null, vr); assert.equal(vr.statusCode, 200);
   const fr = mr(); await uR['POST /api/folders']({ _b: { path: process.cwd() } }, fr); assert.equal(fr.statusCode, 200); assert.ok(Array.isArray(JSON.parse(fr.body).folders));
 });
-console.log(`\n${passed} passed, ${failed} failed`);
+console.log(`\n${passed} passed, ${failed} failed, ${skipped} skipped`);
 process.exit(failed === 0 ? 0 : 1);
 }; run();