agentgui 1.0.1116 → 1.0.1117

package/lib/ws-handlers-util.js

@@ -463,4 +463,67 @@ export function register(router, deps) {
     }
     return { subAgents: SUB_AGENT_MAP[p.id] || [] };
   });
+
+  // --- models.availability: composes agentgui's REAL model surface into the
+  // ModelsConfig component's shape (design SDK's ModelsConfig.js). agentgui
+  // has no freddie-style probed-availability matrix (no /v1/models round-trip
+  // per mode) - what it actually has is: discovered agent CLIs (registry,
+  // same data agents.list already exposes), each agent's model choices
+  // (agents.models' getModelsForAgent), and per-provider API-key presence
+  // (auth.configs' getProviderConfigs). This handler is a read-only
+  // composition of those three real sources, not a new probe and not fake
+  // data - "usable_in_any_mode" is derived from registry.isAvailable(agentId)
+  // (the CLI binary was actually found on this server), and "key_present"
+  // comes straight from getProviderConfigs' filesystem check.
+  router.handle('models.availability', async () => {
+    const agents = registry.list();
+    const providerConfigs = typeof getProviderConfigs === 'function' ? getProviderConfigs() : {};
+    const providers = [];
+    for (const a of agents) {
+      const available = registry.isAvailable(a.id);
+      let models = [];
+      if (a.id === 'claude-code') {
+        models = [
+          { id: 'sonnet', name: 'Claude Sonnet (latest)' },
+          { id: 'opus', name: 'Claude Opus (latest)' },
+          { id: 'haiku', name: 'Claude Haiku (latest)' },
+        ];
+      } else if (typeof getModelsForAgent === 'function') {
+        try {
+          const raw = await getModelsForAgent(a.id);
+          const list = Array.isArray(raw) ? raw : (raw?.models || []);
+          models = list.map((m) => ({ id: m.id, name: m.name || m.label || m.id }));
+        } catch { models = []; }
+      }
+      // Map onto agentgui's one real signal per model: is the agent CLI itself
+      // available on this server (registry.isAvailable). agentgui does not
+      // probe individual (model, mode) cells the way freddie's matrix does,
+      // so every model under an available agent reports the same single
+      // 'cli' mode rather than fabricating per-mode probe results.
+      providers.push({
+        id: a.id,
+        key_present: !!(providerConfigs[a.id] && providerConfigs[a.id].hasKey) || available,
+        discovery_error: available ? null : ((a.name || a.id) + ' CLI not found on this server'),
+        models: models.map((m) => ({
+          id: m.id,
+          name: m.name,
+          discovered_via: a.protocol || 'cli',
+          modes: { cli: { ok: !!available, skipped: !available, reason: available ? undefined : 'agent_not_installed' } },
+          usable_in_any_mode: !!available,
+        })),
+      });
+    }
+    const totalModels = providers.reduce((n, p) => n + p.models.length, 0);
+    const usableModels = providers.reduce((n, p) => n + p.models.filter((m) => m.usable_in_any_mode).length, 0);
+    return {
+      timestamp: new Date().toISOString(),
+      providers,
+      sampler: [],
+      summary: {
+        total_providers: providers.length,
+        total_models: totalModels,
+        usable_in_any_mode: usableModels,
+      },
+    };
+  });
 }

package/package.json

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

package/site/app/js/app.js

@@ -3,7 +3,7 @@ import * as B from './backend.js';
 
 installStyles().catch(() => {});
 
-const { AppShell, WorkspaceShell, WorkspaceRail, Topbar, Crumb, Side, Status, Chat, ChatComposer, AgentChat, ConversationList, SessionDashboard, Row, Panel, PageHeader, TextField, Select, Btn, Icon, IconButton, EventList, Spinner, Alert, FileGrid, FileSkeleton, sortFiles, FileToolbar, RootsPicker, BreadcrumbPath, EmptyState, FileViewer, FilePreviewPane, FilePreviewCode, FilePreviewText, FilePreviewMedia, ThemeToggle, ContextPane, PromptDialog, ConfirmDialog, DropZone, UploadProgress, FilterPills, SessionMeta, BulkBar, Checkbox, ShortcutList, FocusTrap, AgentListSkeleton, flashComposerNote, toast, withBusy, GitStatusPanel, GitDiffView, WorktreeSwitcher, Badge } = C;
+const { AppShell, WorkspaceShell, WorkspaceRail, Topbar, Crumb, Side, Status, Chat, ChatComposer, AgentChat, ConversationList, SessionDashboard, Row, Panel, PageHeader, TextField, Select, Btn, Icon, IconButton, EventList, Spinner, Alert, FileGrid, FileSkeleton, sortFiles, FileToolbar, RootsPicker, BreadcrumbPath, EmptyState, FileViewer, FilePreviewPane, FilePreviewCode, FilePreviewText, FilePreviewMedia, ThemeToggle, ContextPane, PromptDialog, ConfirmDialog, DropZone, UploadProgress, FilterPills, SessionMeta, BulkBar, Checkbox, ShortcutList, FocusTrap, AgentListSkeleton, flashComposerNote, toast, withBusy, GitStatusPanel, GitDiffView, WorktreeSwitcher, Badge, ModelsConfig, PluginsConfig } = C;
 
 // One duration/bytes vocabulary across every surface: prefer the kit's shared
 // formatters (exported alongside the components), fall back to the local
@@ -52,6 +52,13 @@ const state = {
   // One-time welcome banner naming what each tab is for. Shown until
   // dismissed once, ever - a returning user has already learned the tabs.
   showOnboarding: lsGet('agentgui.onboarded') !== '1',
+  // Models tab: composed agent/provider availability (models.availability WS
+  // handler), fed into the design SDK's ModelsConfig component.
+  models: { data: null, loading: false, error: null, selectedProviderId: null },
+  // Plugins tab: agentgui has no freddie-style plugin host - the closest real
+  // extensibility surface is the discovered agent-CLI registry (agents.list),
+  // adapted to PluginsConfig's {name,surfaces,requires,enabled,status} shape.
+  plugins: { selected: null },
 };
 
 // Two-step arm controls auto-reset after this delay so an accidental first click
@@ -331,6 +338,24 @@ function navTo(tab, { writeHash: doWriteHash = true, push = true } = {}) {
   // filesMain (which runs during render) - a render-time fetch is fragile under
   // a double-render and re-enters render() while building the tree.
   if (tab === 'files' && !state.files.path && !state.files.loading && !state.files.error) loadDir('');
+  // Chat's @-mention autocomplete (mentionFiles) reuses state.files.entries -
+  // seed it from the root listing on first chat visit so mentions work
+  // without requiring a prior Files-tab visit. Uses the same confined
+  // B.listDir the Files tab itself calls; failure is silent (mentionFiles
+  // just stays empty, same as never having visited Files).
+  if (tab === 'chat' && !state.files.entries.length && !state.files.loading && !state.files.error) {
+    B.listDir(state.backend, '').then((j) => {
+      if (!state.files.entries.length) state.files.entries = j.entries || [];
+      if (!state.files.roots.length) state.files.roots = j.roots || [];
+      render();
+    }).catch(() => {});
+  }
+  // Models tab: composed agent/provider availability, fetched on first visit
+  // (and via the ModelsConfig 'refresh' action thereafter).
+  if (tab === 'models' && !state.models.data && !state.models.loading && !state.models.error) loadModelsAvailability();
+  // Plugins tab reuses state.agents (agents.list) - same lazy load as chat's
+  // agent picker, so visiting Plugins directly (deep-link/reload) still works.
+  if (tab === 'plugins' && !state.agents.length && !state.agentsLoading && !state.agentsError) loadAgents();
   // popstate calls navTo with writeHash:false so it never replaceState-clobbers
   // the entry it popped; user-initiated navigation pushes so Back walks tabs.
   if (doWriteHash) writeHash({ push });
@@ -675,6 +700,10 @@ function view() {
   } else if (state.tab === 'settings') {
     // Same word as the rail item - location chrome must not fork vocabulary.
     crumbLeaf = 'settings';
+  } else if (state.tab === 'models') {
+    crumbLeaf = 'models';
+  } else if (state.tab === 'plugins') {
+    crumbLeaf = 'plugins';
   }
   const crumb = Crumb({ trail: crumbTrail, leaf: crumbLeaf, right: [dot] });
 
@@ -773,6 +802,8 @@ function workspaceRail() {
     { key: 'files', label: 'Files', icon: 'folder', active: state.tab === 'files', onClick: () => navTo('files') },
     { key: 'live', label: 'Live', icon: 'activity', active: state.tab === 'live', count: liveCount || null, rail: liveHasError ? 'flame' : undefined, onClick: () => navTo('live') },
     { key: 'git', label: 'Git', icon: 'branch', active: state.tab === 'git', onClick: () => navTo('git') },
+    { key: 'models', label: 'Models', icon: 'circle-dot', active: state.tab === 'models', onClick: () => navTo('models') },
+    { key: 'plugins', label: 'Plugins', icon: 'link', active: state.tab === 'plugins', onClick: () => navTo('plugins') },
     { key: 'settings', label: 'Settings', icon: 'settings', active: state.tab === 'settings', onClick: () => navTo('settings') },
   ];
   return WorkspaceRail({
@@ -977,6 +1008,8 @@ function mainContent() {
   if (state.tab === 'files')   return filesMain();
   if (state.tab === 'live')    return liveMain();
   if (state.tab === 'git')     return gitMain();
+  if (state.tab === 'models')  return modelsMain();
+  if (state.tab === 'plugins') return pluginsMain();
   return settingsMain();
 }
 
@@ -1080,6 +1113,61 @@ function gitMain() {
   ];
 }
 
+// Models tab: agentgui's real model surface composed by the models.availability
+// WS handler (agent-CLI registry availability + provider key presence), fed
+// into the design SDK's ModelsConfig component. Not freddie's probed per-mode
+// matrix - see lib/ws-handlers-util.js models.availability for the mapping.
+function modelsMain() {
+  const m = state.models;
+  return [
+    PageHeader({ compact: true, dense: true, title: 'Models', lede: 'Discovered agent CLIs, their models, and provider key presence on this server.' }),
+    ModelsConfig({
+      data: m.data,
+      loading: m.loading,
+      error: m.error,
+      selectedProviderId: m.selectedProviderId,
+      onSelectProvider: (id) => { state.models.selectedProviderId = id; render(); },
+      onRefresh: () => loadModelsAvailability(),
+    }),
+  ];
+}
+
+// Plugins tab: agentgui has no freddie-style plugin host (~150 discoverable
+// plugin.js files) - its actual extensibility surface is the discovered
+// agent-CLI registry (lib/agent-discovery.js + lib/claude-runner-agents.js
+// AgentRegistry, the same data agents.list already exposes to the chat
+// picker). Adapted onto PluginsConfig's shape: name=agent id, surfaces=
+// protocol (cli|acp), requires=[] (agents have no dependency graph), enabled=
+// available (the CLI was actually found on this server), status=install hint
+// when missing. There is no enable/disable action (agentgui does not gate
+// which agent CLIs are usable) so onToggle re-checks availability instead of
+// pretending to flip a setting that doesn't exist.
+function pluginsMain() {
+  const list = (state.agents || []).map((a) => ({
+    name: a.id,
+    version: undefined,
+    surfaces: a.protocol || 'cli',
+    requires: [],
+    source: a.npxPackage ? ('npx ' + a.npxPackage) : undefined,
+    enabled: a.available !== false,
+    status: a.available !== false ? 'loaded' : (a.npxInstallable ? 'installable via npx' : 'not found'),
+  }));
+  return [
+    PageHeader({ compact: true, dense: true, title: 'Plugins', lede: 'Discovered agent CLIs — agentgui\'s real extensibility surface (no freddie-style plugin host).' }),
+    PluginsConfig({
+      plugins: list,
+      selected: state.plugins.selected,
+      loading: !!state.agentsLoading,
+      error: state.agentsError,
+      onSelect: (name) => { state.plugins.selected = name; render(); },
+      // No real enable/disable exists - re-run discovery so a just-installed
+      // CLI's availability reflects immediately instead of a fake toggle.
+      onToggle: () => { withBusy(null, () => loadAgents(), 'checking…'); },
+      onReload: () => loadAgents(),
+    }),
+  ];
+}
+
 // --- files (folder browser) ---
 async function loadDir(dirPath, { fromHash = false } = {}) {
   state.files = state.files || {};
@@ -2508,6 +2596,16 @@ function chatMain() {
       messages: state.chat.messages,
       busy: state.chat.busy,
       draft: state.chat.draft,
+      // Scroll-position overview strip alongside the thread.
+      showMinimap: true,
+      // @-mention file autocomplete: reuse the Files tab's own data source
+      // (state.files.entries, populated by loadDir/listDir) rather than a new
+      // fetch. Scoped to whatever directory Files last listed - if the user
+      // hasn't opened Files yet this is empty and the composer simply shows
+      // no mention suggestions until they do (no fake/synthetic file list).
+      mentionFiles: (state.files.entries || [])
+        .filter((e) => e && e.path)
+        .map((e) => ({ path: e.path, isDir: e.type === 'dir' })),
       // Idle never reads 'resuming…' (nothing is in flight - the continuation
       // fact lives in the composer context line and banner); a remotely-stopped
       // turn reads 'stopped', not a normal finish.
@@ -4351,6 +4449,25 @@ async function loadAgents() {
   }
 }
 
+// Models tab data load: models.availability WS handler composes agent
+// registry + provider key presence into ModelsConfig's expected shape. See
+// lib/ws-handlers-util.js for exactly what each field means in agentgui (no
+// freddie-style per-mode probe matrix - one real 'cli' mode per model).
+async function loadModelsAvailability() {
+  state.models.loading = true;
+  state.models.error = null;
+  render();
+  try {
+    state.models.data = await B.getModelsAvailability(state.backend);
+    state.models.loading = false;
+    render();
+  } catch (e) {
+    state.models.loading = false;
+    state.models.error = errText(e) || 'failed to load model availability';
+    render();
+  }
+}
+
 // Boot-time automatic retries with backoff when the first agents fetch fails
 // (the server may still be warming up).
 async function retryLoadAgents() {

package/site/app/js/backend.js

@@ -435,6 +435,25 @@ export async function listAgentModels(base, agentId) {
   } catch { return []; }
 }
 
+// Composed model-availability view for the Models tab (ModelsConfig
+// component): per-agent CLI availability + models, in the shape ModelsConfig
+// expects ({timestamp, providers, sampler, summary}). See lib/ws-handlers-
+// util.js models.availability for what each field really means in agentgui
+// (no probed per-mode matrix like freddie - one real 'cli' mode per model).
+export async function getModelsAvailability(base) {
+  return wsCall(base, 'models.availability', {});
+}
+
+// Provider API-key configs (masked) for the Models tab's provider auth info -
+// backs the existing Settings 'keys' surface, reused here as-is.
+export async function getAuthConfigs(base) {
+  return wsCall(base, 'auth.configs', {});
+}
+
+export async function saveAuthConfig(base, providerId, apiKey, defaultModel) {
+  return wsCall(base, 'auth.save', { providerId, apiKey, defaultModel });
+}
+
 // ---------- Git / worktrees (WS) ----------
 
 export async function gitStatus(base, { cwd } = {}) {

package/.gm/browser-config.json

@@ -1 +0,0 @@
-{"headless": true, "chrome_ready_deadline_ms": 60000}

package/.gm/claim-audit-fired

@@ -1 +0,0 @@
-clean

package/.gm/disciplines/agentgui/mem-1779277005143-0-1352.json

@@ -1 +0,0 @@
-aicat kit polished + Select primitive (2026-05-20): anentrypoint-design v0.0.127 published. Changes: ChatComposer auto-grows up to 200px on input via taRef + autoGrow handlers; Chat + AICat threads auto-scroll to bottom via threadRef when user is within 240px of bottom (preserves manual scroll-back); ChatMessage avatar fallback uses first letter of `name` instead of bare '?'; EventList accepts both `items:`/`events:` aliases and `code:`/`rank:` aliases for backward-compat; new Select({label,value,options,onChange,placeholder,hint}) primitive exported from src/components/content.js + components.js barrel; mobile responsive breakpoint at 768px collapses chat-stack to 100% and shrinks avatars; empty chat.css placeholder removes build warning. agentgui site/app/js/app.js rewired: pin to 0.0.127, replaced raw <select> model picker with Select({}), replaced raw <a> stop/new + raw <button> save+reconnect with Btn({}), assistant turns now render kind:'md' with typing indicator on in-progress empty message. Browser-witnessed: selectCount=1, rawSelectInApp=0, rawButtonInApp=0, btnPrimary 'save + reconnect' rendered in settings. Zellous pins @latest so auto-picks new version; loads clean. Publish flow: push to main triggers .github/workflows/publish.yml which patch-bumps + npm-publishes + tags. My commit set 0.0.126 → CI bumped to 0.0.127.

package/.gm/disciplines/agentgui/memories/mem-c07fa3b0836edbe2-1352.md

@@ -1,8 +0,0 @@
----
-key: mem-c07fa3b0836edbe2-1352
-ns: agentgui
-created: 1783453880853
-updated: 1783453880853
----
-
-aicat kit polished + Select primitive (2026-05-20): anentrypoint-design v0.0.127 published. Changes: ChatComposer auto-grows up to 200px on input via taRef + autoGrow handlers; Chat + AICat threads auto-scroll to bottom via threadRef when user is within 240px of bottom (preserves manual scroll-back); ChatMessage avatar fallback uses first letter of `name` instead of bare '?'; EventList accepts both `items:`/`events:` aliases and `code:`/`rank:` aliases for backward-compat; new Select({label,value,options,onChange,placeholder,hint}) primitive exported from src/components/content.js + components.js barrel; mobile responsive breakpoint at 768px collapses chat-stack to 100% and shrinks avatars; empty chat.css placeholder removes build warning. agentgui site/app/js/app.js rewired: pin to 0.0.127, replaced raw <select> model picker with Select({}), replaced raw <a> stop/new + raw <button> save+reconnect with Btn({}), assistant turns now render kind:'md' with typing indicator on in-progress empty message. Browser-witnessed: selectCount=1, rawSelectInApp=0, rawButtonInApp=0, btnPrimary 'save + reconnect' rendered in settings. Zellous pins @latest so auto-picks new version; loads clean. Publish flow: push to main triggers .github/workflows/publish.yml which patch-bumps + npm-publishes + tags. My commit set 0.0.126 → CI bumped to 0.0.127.

package/.gm/memories/.flat-export-done

@@ -1 +0,0 @@
-{"digest":"14650fb0739d0383:n=0","total":0}

package/.gm/memories/mem-0131ff4869d86085-370.md

@@ -1,10 +0,0 @@
----
-key: mem-0131ff4869d86085-370
-ns: default
-created: 1781775262609
-updated: 1781775262609
----
-
-## Resolved mutable: index-style-full-extent
-
-/config/workspace/agentgui/site/app/index.html:26-265 is the full inline <style> block (--agentgui-* vars, .pill/.cwd-bar/.resume-banner/.history-empty/.health-chip/.settings-grid/.boot-splash/.chat-controls/.ds-event-list overrides+event-flash keyframe/responsive+print). app.js grep style: = 7 inline margin-utility props.

package/.gm/memories/mem-04049d11cb8c1661-2135.md

@@ -1,8 +0,0 @@
----
-key: mem-04049d11cb8c1661-2135
-ns: default
-created: 1781943736813
-updated: 1781943736813
----
-
-agentgui screen-real-estate layer (2026-06-12, fluid columns + drag-resize). Workflow .claude/workflows/gui-screen-realestate.js (6 density lenses space-efficiency/viewport-utilization/information-density/adaptive-layout/application-chrome/finish-pending). 50 agents -> 17 confirmed (PUNCHLIST-DENSITY.md). Kit pushed anentrypoint-design 97dc646. Verdict: maximize screen real-estate, SDK must read as a desktop app. Shell reclaims viewport: fixed --ws-rail-w 232/--ws-sessions-w 296/--ws-pane-w 320 (~848px chrome) became fluid clamps clamp(200px,16vw,260px) etc. Kit shell.js renders keyboard+pointer .ws-resizer separators (role=separator, ArrowLeft/Right 16px, pointer-drag) between each track writing clamped inline --ws-<col>-w persisted localStorage ds.ws.w.<col>, seeded on mount via ref seedWsWidths (no app wiring). Sessions desktop collapse toggle (.ws-sessions-toggle in crumb; .ws-desktop-toggle CSS = inverse of mobile drawer-toggle; toggleWs extended 'sessions'->ws-sessions-collapsed). .btn* moved off --r-pill to --r-1 (8/14 pad, 32 min-h, 44 coarse). .app-status thin 26px ellipsized strip (--app-status-h 26px). .chat-msg-flat centers at --measure (margin-inline auto) + density-scaled via --density token + 84ch ultrawide tier. .ds-dash-grid densified minmax 240/220 wide. CONCURRENT-WRITER RULE (load-bearing): while this run was in flight, concurrent writers shipped the ENTIRE Files multi-select+density-thumbnail+move on BOTH design/main and agentgui/main, so this run's parallel multi-select/move/F3 work was DROPPED and theirs adopted; only re-vendored kit dist + workflow + docs landed. Rule: when origin advances mid-run with the same feature, drop yours and adopt theirs, then re-apply only genuinely-distinct work onto their files; the agentgui /api/move-confined endpoint built this run was redundant with their /api/move and discarded. Kit ships 4 build lints (tokens/glyphs/null-children/classes) - all must pass. Witness localhost:3009/gm/ caveat: vendored bundle served fresh only after SERVER restart (pre-warms statics in memory) AND fresh browser context (persistent witness caches the ES module).

package/.gm/memories/mem-069ff10372ed1770-1375.md

@@ -1,8 +0,0 @@
----
-key: mem-069ff10372ed1770-1375
-ns: default
-created: 1780601438566
-updated: 1780601438566
----
-
-agentgui GUI-audit (2026-06-04) CLOSED. workflow wvf3xfw7x ran 64-agent fan-out -> 44 confirmed findings (AUDIT-PUNCHLIST.md, 38 deduped). All fixed+pushed across 3 surfaces. agentgui origin/main commits: cf710c6 (SSE unwrap, resume hygiene, security headers), eb1eab3 (vendored kit batch + CSP fonts + non-resume warn), 951404e (AGENTS.md doc). Kit anentrypoint-design origin/main bb776aa (streaming-md perf, Row aria-expanded, responsive @media + cwd clamp, CodeNode full-code key, 44x44 tap targets, head sub-line from status, glyph cleanup) -> publish.yml publishes npm->unpkg. KEY LEARNINGS: (1) ccsniff /v1/history/stream 'event' frame is {sid, payload:flattenedEvent} - app MUST unwrap data.payload (store.js:130); reading the wrapper gave undefined counters. (2) CSP hardening MUST allow fonts.googleapis.com (style-src) + fonts.gstatic.com (font-src) or the kit drops to system fonts. (3) DS Select (content.js:312) already promotes title->aria-label so title= gives a real accessible name (unlike SearchInput which needs label=). (4) index.html loads kit from LOCAL ./vendor/ now (not unpkg), so vendored 247420.{js,css} IS what the live GUI serves - witness against it directly. (5) kit publish: commit normal msg + push origin/main; publish.yml syncs version w/ npm + publishes (skips on [skip publish]/chore(release): msgs). PRD 339/339 resolved, phase COMPLETE.

package/.gm/memories/mem-08a4a9e050a4deff-3048.md

@@ -1,8 +0,0 @@
----
-key: mem-08a4a9e050a4deff-3048
-ns: default
-created: 1781796096862
-updated: 1781796096862
----
-
-agentgui 16th run (2026-06-18): design-maturity sweep + dead-code + secret-hardening, tracked by ONE Workflow-tool run gui-design-16 (wf_6479308b-24f, 12 lenses chat-thread/composer-input/files-browser/sessions-dashboard/shell-chrome/tokens-theme/a11y-motion/history-settings/marketing-site/glyph-residue/dead-code/server-security): 54 agents -> hunt -> adversarial verify -> 40 confirmed, ~2.7M tokens. Applied via a clean per-file subagent fan-out (one agent per physical file = zero edit conflicts). KIT fixes (/config/workspace/design): chat.js ToolCallNode gates args section on hasArgs (no more 'args {}' on result-only cards) + textarea binds disabled; agent-chat.js cwd aria-busy; content.js EventList forwards detail/actions/highlight/meta to Row (expanded history events were dropping toolInput detail+copy+highlight) + TextField full invalid/error state (.ds-field-error role=alert); interaction-primitives.js ShortcutList splits combos into discrete .ds-kbd caps (.ds-kbd-caps/.ds-kbd-sep + new app-shell.css rules); sessions.js rail filter migrated bespoke .ds-session-search -> shared SearchInput/.ds-search-input (one filter control); shell.js WsResizer aria-valuetext; voice.js x-glyph->Icon('x'), community.js ellipsis-glyph->'more'. chat.css cwd is-checking+aria-busy+r-1 radius, breakdown idle->--stale double-inset (was colliding amber w/ connecting disc), breakdown running shape-ring, ds-dash-clear hover/focus, chat-tool-copy focus-visible, errors-toggle AA. app-shell.css composer+ws reduced-motion guards, .ds-file-row.is-locked/.is-restricted+.ds-file-perm-tag chip, ws-drawer-toggle 44px, density-btn/filter-pill AA (color:var(--fg)). editor-primitives.css #000 dock shadow->var(--shadow-3) + #fff checkbox fallback dropped. app-surfaces.css @media print re-asserts paper signal tokens. community.css :focus-visible for ThreadPanel/Forum/Page+forum-search. marketing.css NEW .site-footer family (theme.mjs footers off the .app-status strip that suppressed content <=1100px)+site-cli baseline/card/tokens+100dvh embed. SERVER lib/http-handler.js: SECRET_RE now also on /api/upload-file+/api/mkdir+/api/rename (403 secret/dotfile target, was overwrite-secret hole) + /api/list filters secret dirents + /api/download RFC-5987 Content-Disposition (CJK/emoji name no longer throws ERR_INVALID_CHAR). DEAD-CODE: agentgui site/app/vendor/cdn/ (36 files, markdown stack fetches jsDelivr at runtime), scripts/harvest-fixtures.mjs, the 3 copy-vendor.js lines in .github/workflows/build-platforms.yml (script deleted 15th run, CI was broken); kit scripts/bundle-markdown.mjs. WITNESSED localhost:3009/gm/?token via gm browser verb: dark rgb(19,19,24), 3 resizers, hScroll 0, ds-search-input=1/ds-session-search=0, perm-tag/site-footer/kbd-caps rules resolve, 0 console errors. validate-mutations 26/26 PASS, test.js 10/0, kit 4 lints pass. RECURRING PATTERN: server start needs setsid bash -c 'exec bun server.js' with NO pkill afterward (pkill kills the fresh one); ss has no perms here, use curl /health (401 under PASSWORD = up).

package/.gm/memories/mem-09597ee0df9c9224-965.md

@@ -1,8 +0,0 @@
----
-key: mem-09597ee0df9c9224-965
-ns: default
-created: 1781197658408
-updated: 1781197658408
----
-
-agentgui env/witness caveats (2026-06-11, linux container): server runs PORT=3009 (3000 owned by another app); plugkit spool out/ keeps STALE responses from prior sessions - a Read racing the watcher write returns old bytes, re-read if content does not match the probe; plugkit browser sessions expire between dispatches (fresh session needs full goto with waitUntil commit); first git_status after heavy churn can report stat-cache false positives (an empty git_diff refreshes the index). Theme tokens: --flame/--amber/--code-* are LIGHT values at :root (#C53E00/#8A6512, AA on paper) with dark brights restored in BOTH dark blocks + the paper-island block; tool errors are routine in agent sessions (1-2% of events) so error UI derives from DENSITY (sessionErrorDense: errors>=3 AND >15%) or recency, never has-any-error. Destructive ACTION = warn red; flame = error STATUS only. /api/move shipped (dual realpath confinement); validate-mutations.mjs is 26 checks.

package/.gm/memories/mem-0993d156f571b619-1059.md

@@ -1,8 +0,0 @@
----
-key: mem-0993d156f571b619-1059
-ns: default
-created: 1782996727275
-updated: 1782996727275
----
-
-agentgui 3rd run (2026-06-05): GUI-predictability sweep closure. Fan-out reviewers (chat/history/settings/shell + perf/security/glyph/override) -> adversarial verify -> 19 PRD rows fixed+pushed. Headline theme: override-elimination - index.html's !important overrides converted to kit defaults (Topbar active-tab tinted+underline, PageHeader compact prop, Row cursor:pointer for role=button, kit Chat dropped decorative head dot). Also: kit ToolCallNode (no output) placeholder, kit safeUrl() rejects javascript:/data:/file: in inline renderer (bypasses DOMPurify), streaming chat text uses .chat-md container to avoid settle reflow. App fixes: distinct backend-status keys, per-sid running-dot key, stale-selectedSid clear, per-session live counter, toolLabel scalar fallback. gui-audit.js workflow gained overrides surface + KEPT-SET glyph guard (middot/ellipsis/em-dash are kept product typography, never flagged). Kit dist git add -f / rebase-rebuild caveat noted. index.html loads kit from LOCAL vendored copy (superseded/reconfirmed by many later runs).

package/.gm/memories/mem-0b681bf2340c8df1-3170.md

@@ -1,8 +0,0 @@
----
-key: mem-0b681bf2340c8df1-3170
-ns: default
-created: 1781105971140
-updated: 1781105971140
----
-
-agentgui GUI completion sweep (2026-06-10, 8th max-effort run) CLOSED. NEW workflow .claude/workflows/gui-completion.js (6 coverage lenses hunting what 7 prior sweeps scoped out: file-management-crud, routing-deeplinks, conversation-control, history-settings-depth, onboarding-recovery, crosscut-new-surface; 75 agents -> 46 confirmed gaps, PUNCHLIST-COMPLETION.md). PUSHED: agentgui 422361f, kit anentrypoint-design e603785. READ-ONLY FILES SCOPE CUT REVERSED: server lib/http-handler.js fsAllowRoots()+sanitizeEntryName() (rejects separators/traversal/ADS colon/reserved Windows names/trailing dot-space)+readBody(cap,413)+isAllowRoot(roots never mutation targets); POST /api/rename {path,newName}, POST /api/delete {path,recursive} (non-empty dir no-recursive -> 409), POST /api/mkdir, PUT /api/upload-file?dir&name&overwrite=1 (raw bytes 50MB no multipart dep), GET /api/stat (confined cwd validation); CSRF guard on POST/PUT/DELETE (reject cross-site Sec-Fetch-Site + simple-form CT + no auth header); /health gains projectsDir+allowRoots; scripts/validate-mutations.mjs = 17 live security checks (traversal/out-of-roots/root-refusal/reserved/ADS/CSRF/409s/round-trip) ALL PASS - rerun after touching the mutation surface. FULL HASH ROUTING: HASH_KEYS=[tab,sid,dir,file,q,project,section], buildHash reads all view state, writeHash({push}) user-nav pushes, popstate diffs full set via navTo(tab,{writeHash:false}) (no clobber), chat+sid names tab=chat explicitly, files dir/file deep-link in+out+Back WITNESSED live. CONVERSATION: editAndResend two-step confirm + CLEARS resumeSid on truncation (never --resume diverged tail; retry last-turn keeps it); draft persisted; followups derived from settled turn; exportActions copy-all/md/json; ContextPane session{turns,cost}. RESILIENCE: backend.js streamChat 12s grace on ws closed (reconnect re-subscribes, turn continues); health re-probe on ws drop + 10s poll while not-ok + reconnected announce; loadAgents backoff + agentsError banner + installHint (npx commands) when zero available; errText plain-copy map; cwd validated via /api/stat; warmup copy after 5s. HISTORY/SETTINGS: tool_use purple rail fixed (was always green); FilterPills event filter pre-slice; jump-to-first-error; Row actions copy-event; per-session JSON export; SessionMeta header; search highlight mark.ds-hl + windowed title; settings server/keyboard panels; ONE SHORTCUTS array feeds ?-overlay+settings; live/files prefs persisted (live selection Set deliberately NOT - stale sids); two-step stop-all confirms. KIT: FileRow{actions,busy}+perm-disabled, Row{highlight,actions}+Panel/PageHeader{id}+FilterPills, SessionMeta (.ds-session-meta-strip - .ds-session-meta was taken), dashboard onArmStop*, ConversationList loadingText, agent-chat installHint/exportActions/confirmEdit, context-pane session block. GOTCHAS: spool browser verb takes RAW playwright code (page.*), NOT {url,evaluate} JSON, 14s exec cap - split multi-nav witnesses; curl/bash JSON escaping on Windows mangles backslash paths - use a node fetch script for endpoint validation; kit remote advances with chore(release) commits - stash/rebase/rebuild before committing kit.

package/.gm/memories/mem-0c444abde86202f6-1681.md

@@ -1,8 +0,0 @@
----
-key: mem-0c444abde86202f6-1681
-ns: default
-created: 1783677428217
-updated: 1783677428217
----
-
-agentgui 31st run addendum (2026-07-10): confirming gm-continue pass caught that the gui-ux-craft workflow's light-theme-contrast lens had crashed mid-run (API connection error) and never actually produced findings - a real coverage gap, not a clean pass. Dedicated follow-up audit computed real WCAG contrast ratios (not eyeballed) and found 6 genuine light-theme failures the crashed lens would have caught: chat avatar initials using raw --mascot/--accent-ink on tinted backgrounds (2.03:1/3.65:1), tool-done status text using --success/--green-2 (3.18:1/2.88:1) instead of the text-safe --green, --amber measuring 4.26:1 on --bg-2 (narrowly failing AA on the background it actually renders on, despite being tuned for --paper), --danger measuring 4.25:1 on --bg-2 for the same reason (auth-error banner), raw --mascot as button/CLI text (3.11:1), and --sun being essentially unusable everywhere it's used (1.1-1.5:1 against every app background) - retired in favor of --amber. All fixed with the same pattern as the 22nd-run --accent->--accent-ink precedent: separate text-safe 'deep' tokens from fill/border tokens, and always check contrast against the ACTUAL background a token renders on (--bg-2 card surfaces, not just --paper) not just the token's own design-time tuning target. LESSON for gm-continue: when a workflow notification includes a `failures` array naming a lens that errored out, that lens's scope is unaudited work, not a null result - it belongs in the confirming PLAN pass as its own row, the same as any other unaudited surface. Kit pushed df04d69, agentgui pushed 03002cf, CI green (Test/Deploy GH Pages/Publish and Release/Auto-Declaudeify all success).

package/.gm/memories/mem-0d1408fa048b9923-1159.md

@@ -1,8 +0,0 @@
----
-key: mem-0d1408fa048b9923-1159
-ns: default
-created: 1782996219086
-updated: 1782996219086
----
-
-agentgui 11th run (2026-06-11): Files command surface + PASSWORD-boot fix. CRITICAL: PASSWORD-gated deploys couldn't boot the SPA - /gm/?token= served index.html but static subresources carried no token -> 401 -> blank page forever. Fixed via HttpOnly SameSite=Lax agentgui_token cookie set on any successful auth; WS keeps ?token=. Files became a command surface: kit FileGrid multi-select (marked Set, tri-state header checkbox, EACCES rows unmarkable, Ctrl/Cmd+A) + density modes (list/compact/thumb) + BulkBar export; app wired bulk-delete via ConfirmDialog + Promise.allSettled (failures stay selected). thumbUrl must use downloadUrl (fsAllowRoots) not imageUrl (narrower allowlist, 403s repo files). Shipped-jank fixes: .ds-file-open dead CSS from an earlier run, filesMain dropped permissions field, Crumb narrow-collapse keyed on wrong container class, webjsx null-attribute-toggle bug, elevation unification (panel=bg-2+hairline+r-2, no shadow). Env: validate-mutations.mjs made portable; plugkit chromium needs --no-sandbox; page.goto waits on hung CDN subresources use waitUntil:commit; witness body is shell-interpolated so avoid $(...)/backticks.

package/.gm/memories/mem-0dad5d82fec829ba-887.md

@@ -1,8 +0,0 @@
----
-key: mem-0dad5d82fec829ba-887
-ns: default
-created: 1784892479919
-updated: 1784892479919
----
-
-agentgui docstudio-port run (2026-07-24): added MenuButton (checkmarked select menu, overlay-primitives.js), ChatSuggestions (blank-thread composer-priming chips, chat.js), BatchProgressLabel/formatBatchOutcome (sequential batch progress + aggregate outcome toast, editor-primitives.js), InfoRow/InfoSection/DiagnosticsPanel (static debug readouts, editor-primitives.js) to the anentrypoint-design kit, all barrel-exported. Real webjsx crash found+fixed mid-verify: InfoSection's loading-to-loaded transition mixed key namespaces at the same diff slot -- reusing one key across a text-only render and an element-children render crashes applyDiff('reading key'); fixed by giving the two branches distinct keys (body-loading/body-rows). Standing lesson: a component switching between structurally-different children at the same slot needs each branch keyed distinctly, not just the parent.

package/.gm/memories/mem-10a776effb7ce3a6-935.md

@@ -1,8 +0,0 @@
----
-key: mem-10a776effb7ce3a6-935
-ns: default
-created: 1780044606446
-updated: 1780044606446
----
-
-agentgui composer (DS ChatComposer in c:/dev/anentrypoint-design/src/components/chat.js): the message textarea is controlled (value prop). Re-applying value on every parent render resets the caret and drops fast keystrokes. FIX (in the kit, then rebuild+vendor): send() reads the LIVE textarea value via a captured taEl ref (not the lagging value prop); taRef syncs el.value to the prop ONLY when they differ. Paired app.js change: composer onInput re-renders only on empty<->non-empty draft transition (the only change that toggles the send button disabled state), not per keystroke. Verified live: GUI chat round-trip GUIOK/REBUILT streamed end-to-end (compose->WS chat.sendMessage->claude-code->streaming_progress->transcript). Playwright .type() still only lands 1 char (synthetic per-char typing races the controlled re-render) but native-setter/paste/IME and human typing work — that is a test-harness artifact, not a user bug.

package/.gm/memories/mem-10d264b4f8e66fb4-1492.md

@@ -1,8 +0,0 @@
----
-key: mem-10d264b4f8e66fb4-1492
-ns: default
-created: 1781174463909
-updated: 1781174463909
----
-
-agentgui GUI Claude-Code-web parity sweep (2026-06-11, 10th run) CLOSED. workflow .claude/workflows/gui-claude-code-parity.js (6 design-language lenses vs claude.ai/code; 66 agents -> 37 gaps, PUNCHLIST-PARITY.md). PUSHED kit anentrypoint-design 28387c3 + agentgui 0a93fc6. KIT: AgentChat flat:true+aicat:false -> .chat-msg-flat full-width avatar-less turns + .chat-role label + faint assistant bg (bubble layout kept only for messenger demo); composer one bordered rounded-rect shell (textarea borderless, inline --r-1 send, was --r-pill+50% circle); .chat-tool bordered status-toned card (bundle had ZERO before); .chat-code-lang lang tab; ::selection accent-tint not mascot; WorkspaceShell mainFlush + .ws-main gutter + .ws-crumb min-height:48; SessionDashboard status-bucket groups + header breakdown + .ds-dash-stream-disc heartbeat + tri-state select-all + is-armed pulse; SessionCard cost/isNew/icon-actions/is-stale amber bar; TYPE_ICON.dir=folder + file-image/link icons; ConversationList skeleton; FilePreviewCode Prism highlight + gutter; motion easing reduced-motion-guarded. LOAD-BEARING webjsx FIX: filter(Boolean) EVERY children array (SessionCard passed raw nulls positionally; applyDiff crashes reading key on ANY null among VElements, pre-existing latent bug). GOTCHA port 3000 owned by another app -> witness on PORT=3009; first /gm/ hit = 30-90s ccsniff walk. DEFERRED (rows pending): Files multi-select+density, /api/move-confined, up-button+grid-shortcuts, F3 elevation.

package/.gm/memories/mem-118c35ac67541d98-2909.md

@@ -1,8 +0,0 @@
----
-key: mem-118c35ac67541d98-2909
-ns: default
-created: 1783690602154
-updated: 1783690602154
----
-
-agentgui 34th run (2026-07-10): user re-requested max gui usability/practicality/predictable/negative-space via wfgy-method critique (identical ask to 31st/32nd/33rd runs). Ran gui-ux-craft workflow wf_919164f1-648 (34 agents, all completed, 0 errors) plus a parallel live-browser negative-space audit agent. Negative-space audit came back CLEAN (no new dead-void/contrast/overlap regressions across chat/history/settings/files at 1280/900/420px) - three consecutive clean passes (31st/33rd/34th) on that specific dimension, recommend future sweeps shift focus to interaction-level polish instead. Main workflow confirmed findings across typography-rhythm/copy-tone/perceived-perf/kit-dx/interaction-density lenses. Kit fixes (design repo): editor-primitives.css shadow font tokens --fs-2/--fs-0 didn't exist anywhere in the real scale, remapped to --fs-lg/--fs-tiny (4 spots); stale --lh-base fallback 1.4 fixed to 1.55 (matches live token, 4 spots); app-shell.css .glyph/.ds-field-count/.ds-row-detail hardcoded literals tokenized; ~29 hardcoded outline:2px solid var(--accent-ink) focus rules across chat.css/editor-primitives.css converted to var(--focus-w) solid var(--focus-color) with negative-offset calc() handling for inset rows; .chat-tool-copy added to the coarse-pointer touch-affordance media block (was the one tool-action button missing 44px floor); .ds-select gained a base min-height:32px floor (previously only per-scope overrides had it); Btn's className prop renamed to class to match Panel/Heading convention (2 call sites in sessions.js updated); AgentControls/AgentChat gained an agentsLoading prop mirroring the existing modelsLoading disabled-select pattern; COMPONENT_API.md gained Btn variant-precedence and PageHeader compact/dense/id docs. App fixes (agentgui): History no longer falls back to the raw session id when a session has no title/project - falls back to cwd then 'Untitled conversation'; ACP provider-error copy truncated+prefixed 'connection failed, try restart:'; Settings/Live copy-tone fixes ('chat'->'conversation', 'cwd'->'folder' in placeholders); ConversationList loading skeleton no longer gated to the history tab; new-chat confirm dialog copy aligned ('Clear conversation?'->'Start a new chat?'). Kit build 0 errors, re-vendored dist/247420.{js,css} (css 454635->456041 bytes, js 392679->393309 bytes) into site/app/vendor/anentrypoint-design/. Browser-witnessed live (0 pageErrors, .ds-select min-height computed 32px in the live DOM confirming the vendored bundle carries the fix). Kit pushed to origin/main after a rebase (a release commit had landed concurrently, ee518e8/f808233 -> 3b1080c). agentgui pushed 9c8094b, all 4 CI checks (Deploy GH Pages, Publish and Release, Auto-Declaudeify, Test) green. Standing gotcha reused again: PASSWORD env value '123,slam,123,slam' must be treated as one literal token (contains commas) for ?token= browser auth.

package/.gm/memories/mem-119cf70dd19aa0a5-2225.md

@@ -1,8 +0,0 @@
----
-key: mem-119cf70dd19aa0a5-2225
-ns: default
-created: 1781109622887
-updated: 1781109622887
----
-
-agentgui GUI logic+predictability sweep (2026-06-10, 9th max-effort run) CLOSED. NEW workflow .claude/workflows/gui-logic-predictability.js (6 lenses: interaction-lifecycle, cross-surface-consistency, information-architecture, realtime-truth, input-ergonomics, scale-robustness; 78 agents -> 67 confirmed findings, PUNCHLIST-LOGIC.md). KIT (anentrypoint-design): ConfirmDialog/PromptDialog {error,busy,busyLabel} + DOCUMENT-LEVEL Escape listener + focus-restore only on genuine close (queueMicrotask remount guard - webjsx refs re-fire null->el on every render, naive teardown re-steals focus); SessionCard {stopping,title,elapsedMs,external} + fmtDuration export; ChatComposer {onPasteFiles,onDropFiles} + IME guard + Esc-cancels-while-busy + hint line + per-bit context onClick; AgentChat {shownMessages,onShowEarlier} MESSAGE_CAP=100 + 20k-streaming tail window + {cwdError,cwdChecking}; UploadProgress {actions,onDismiss}; hasSelectionInside + autoscroll pause; markdown loader 30s retry never latches degraded; fmtBytes=fmtFileSize 0 B. APP: realSid=claudeSessionId||sessionId dashboard join; error-from-recency not cumulative; per-sid toolRunning stale derivation; ev.i maxI SSE dedup; max(index,tally) counters; persistChat debounce+100msg cap+4KB tool-payload trim+quota banner+cross-tab storage ts-guard; Escape ladder overlay>file-dialog>confirms>stop-generation; window dragover/drop preventDefault outside dropzones; Mod+Shift+L; stopping Set + awaited bulk stops; upload drain queue + 409 replace; settings reorder; '/' on files/live. SERVER: chat.active rows carry claudeSessionId; streaming_cancelled broadcast (aborted never completes); 60s terminal-frame replay on re-subscribe (replayedTerminal) fixes ws-drop busy-hang; chat_active_changed hints; /v1/history events ?limit shim in server.js (ccsniff has none). GOTCHAS: parallel kit/app agents drift on prop contracts - this run caught app onPasteImage vs kit onPasteFiles AND backend missing streaming_cancelled type; ALWAYS grep the joints after parallel batches. Browser witness caught Escape dead with focus on H1 (kit listener was backdrop-scoped) - fixed document-level + app ladder fallback. Witnessed 0 errors all tabs, 420px no h-scroll, glyphs 0.

package/.gm/memories/mem-15a07cd761b337c4-4320.md

@@ -1,8 +0,0 @@
----
-key: mem-15a07cd761b337c4-4320
-ns: default
-created: 1783687056884
-updated: 1783687056884
----
-
-{"key":"agentgui-33rd-run-ux-craft-sweep","value":"agentgui 33rd run (2026-07-10): user re-requested max gui usability/practicality/predictable/negative-space via wfgy-method critique (identical ask to 31st/32nd runs). Ran gui-ux-craft workflow wf_7f1a513c-2a3 (34 agents, 33 completed, 21 confirmed, 1 lens (kit-dx) crashed mid-run) plus a parallel live-browser negative-space audit (found 2 new issues: Settings health-chip 'connected' text used raw --accent lime rgb(182,255,27) on near-invisible near-paper bg - fixed to --accent-ink on tinted bg; History empty-state had fixed min-height:50vh centered void leaving 300px+ dead space at 1280px and >50% viewport blank at 420px - fixed to natural top-aligned height with a new .history-empty-hints ShortcutList filling the reclaimed space). Kit fixes (chat.css/app-shell.css/editor-primitives.css/community.css/colors_and_type.css/agent-chat.js/context-pane.js/sessions.js/components.js): --tr-caps/--lh-long/--space-2 token adoption for 4 hardcoded typography values, cwd-fact font-family made consistently mono across composer/context-pane/dashboard, agent-name font-family made consistently sans, panel margin-bottom rhythm aligned to files-stack gap, brightness(1.08) lightening hover bugs on send-button/rail-action/editor-dialog-buttons fixed to brightness(0.92) darkening (AA-safe pattern from 32nd run), --green-2 text contrast fix in community.css, light-theme ::selection contrast raised to 46% (dark theme's 24% explicitly preserved), --accent-tint light-theme value switched to blend --accent-ink instead of raw --accent (dark theme value explicitly pinned), CwdBar save/cancel button order fixed to match ConfirmDialog convention, 30 hardcoded focus-ring outline instances (not just the 11 originally cited - same mechanical bug repeated) routed to --focus-w/--focus-color/--focus-offset tokens, chip/badge tone-success/tone-error/tone-neutral families consolidated (all legacy class aliases preserved), icon-btn-primary hover color fixed to match btn-primary's two-tone-flip, new AgentListSkeleton component (shimmer-row loading state matching FileSkeleton pattern, had to also add it to src/components.js barrel export - a component only exists to consumers if re-exported there, sessions.js alone isn't enough), UploadProgress gained an indeterminate/marquee CSS state for in-flight transfers with no percent yet. App fixes (app.js): session-vs-conversation vocabulary unified (Live tab copy, stopAllActive messages, Alert title), duplicated folder-drop announce string hoisted to one const, 'allowed root(s)' internal-jargon replaced with 'accessible folder(s)' at 6 user-facing sites (internal fsAllowRoots fn name/comments untouched), boot render no longer gated behind the health-probe await (state.health='unknown' + synchronous render() before the probe), agents-loading branch now uses AgentListSkeleton instead of bare spinner+text, upload rows pass indeterminate:true for in-flight zero-percent state. kit-dx lens re-run separately found 3 real doc gaps (voice.js/theme-toggle.js/data-density.js entirely undocumented, SessionMeta undocumented next to documented SessionCard, 6 utility exports undocumented) all fixed in COMPONENT_API.md. Used 4-6 parallel subagents to implement disjoint file sets concurrently (kit CSS agent, app.js agent, upload-progress agent, kit-dx audit agent, then a docs agent) - worked well since file ownership was cleanly split, though one subagent's rebuild step raced another's and both had to re-run node scripts/build.mjs at the end to reconcile before final vendor copy. LESSON: a new kit component isn't actually consumable until it's re-exported through src/components.js's barrel - adding it only to the component file itself (e.g. sessions.js) leaves it invisible to the bundle even after a successful build with 0 lint errors; always grep the built dist for the new export name to confirm before wiring app.js against it. Kit pushed 4105bd1, agentgui pushed 3bac0fe then a94bf92 (PRD-state-only commit), all CI green both repos (Test/Auto-Declaudeify/Deploy GH Pages/Publish and Release on agentgui; Deploy GH Pages/Publish 247420 to npm on design), browser-witnessed live via agent-browser (0 console errors) at localhost with PASSWORD=comma-containing token treated as one literal string throughout."}

package/.gm/memories/mem-15c73aca528535cb-2183.md

@@ -1,8 +0,0 @@
----
-key: mem-15c73aca528535cb-2183
-ns: default
-created: 1784299879288
-updated: 1784299879288
----
-
-agentgui 46th run (2026-07-17): fourth docstudio design-cue pass, same directive repeated. Fresh Explore-agent survey of /config/docstudio (told what runs 42-45 already shipped) found only 1 genuinely new candidate after exhausting low-hanging fruit: chat.js's two role=log chat-thread containers (chat.js:533,581) and agent-chat.js's one (agent-chat.js:476) gained aria-live=polite aria-relevant=additions, matching docstudio chat-tabs.js:62-65, so new messages announce to screen readers without spamming on streamed tokens - verified via source that aria-relevant=additions only fires on new keyed-sibling insertion (agent-chat.js:582's per-message keyed map), not in-place text mutation during streaming, so no live-dispatch witness was needed for that corner case. A second candidate (self-retry dropdown trigger, docstudio chat-model-selector.js) was explicitly skipped since no async-populated dropdown exists in the kit yet to wire it to - avoided speculative unused plumbing. Also fixed an unrelated hygiene bug surfaced mid-rebase: kit test.js's lint-tokens.mjs spacing-report regex only matched the old "[lint-spacing] REPORT — N raw" format; upstream v0.0.349's ratcheted-spacing-lint change reformatted stdout to "PASS — N <= baseline N", silently breaking the regression check - widened regex to match both formats. Kit rebased cleanly onto v0.0.348/v0.0.349 (one dist-only conflict, resolved by rebuilding dist/247420.js fresh). Kit pushed 8436f0a->f81f93d, all 3 kit CI checks green. agentgui re-vendored, browser-witnessed live on localhost:3009/gm/ (bodyLen:19429, hasAgentgui:true, 0 console errors, .agentchat-thread confirmed via page.evaluate to carry role=log aria-live=polite aria-relevant=additions), pushed e84cf26->639b78e->fef8222, all 4 CI checks green each push. Standing observation: the Test workflow's bun-install step sometimes takes ~13 minutes (likely npm registry propagation delay for a freshly-published kit version) before completing green - not a hang, just slow; worth waiting rather than treating as stuck if the job's own step-by-step status (via gh api repos/.../actions/jobs/<id>) shows genuine progression rather than a frozen step.

package/.gm/memories/mem-166f52796185e0e7-1487.md

@@ -1,8 +0,0 @@
----
-key: mem-166f52796185e0e7-1487
-ns: default
-created: 1783891644525
-updated: 1783891644525
----
-
-{"key":"agentgui-27th-run-negative-space-attention-detail","value":"agentgui 27th run (2026-07-03): negative-space + attention sweep, scoped to the specific ask (not a full agent fan-out) - a live-browser review (screenshots + DOM measurement at 1280px and 420px) across chat/files/settings. Chat/settings visual balance was already reasonable from the prior 26 runs; found and fixed 2 real issues. (1) Files filter placeholder 'Filter files in this directory' clipped against its intentionally-compact 220px input (no ellipsis, last character cut off at the box edge) - shortened to 'Filter files', which fits without widening the control (the kit's own comment already states the compact width is deliberate: a full-width filter 'reads as a search page and costs fold height'). (2) Settings SERVER panel rendered 4 short facts (version/uptime/connected clients/projects folder) each as its own .lede div - .lede is the fs-xl/tall-line-height INTRO-PARAGRAPH style, not a metadata style, so 4 short facts read as 4 oversized paragraphs with real dead vertical space between them, and inconsistent density vs the allowed-roots rows directly below (already using the compact SessionMeta strip). Folded all 4 facts into one SessionMeta call alongside the roots - same information, denser, one consistent style for every fact in the panel. Browser-witnessed at both viewport widths, no wrap/overlap regression. No kit changes needed (both fixes were app-only copy/wiring). Pushed b0b38fb."}

package/.gm/memories/mem-1a148cf9c3126df5-3963.md

@@ -1,8 +0,0 @@
----
-key: mem-1a148cf9c3126df5-3963
-ns: default
-created: 1784278257475
-updated: 1784278257475
----
-
-{"key":"agentgui-42nd-run-gui-practicality-sweep","value":"agentgui 42nd run (2026-07-17): user-driven cwd-practicality complaint plus a mid-run docstudio design-cue directive. cwd practicality: added an inline browse popover (reuses existing confined /api/list into an independent state.cwdBrowse), always-visible allowed-roots chips (prefetched on editor open), a small localStorage recent-cwd MRU (capped 6), relative-subpath resolution against the current cwd, and fixed a real bug where Escape did nothing to close the cwd editor (global keydown typing-guard blurred+returned before the Escape ladder - added a targeted exception + nested browse-then-editor ladder). History's directory fact gained a one-click 'use as chat cwd' action (kit SessionMeta gained generic onAction/actionLabel). REAL INFRASTRUCTURE BUG found+fixed: the cwd browse popover inherited a previously-undiscovered production bug where this env's nginx proxy_pass URI normalization silently collapses an encoded %2F path-segment slash back to a literal / before forwarding, 403ing any /api/list/<abs-path>-shaped request - this ALSO meant the pre-existing Files tab drill-down navigation had been broken in production the whole time. Fixed by switching /api/list,/api/stat,/api/file,/api/download,/api/image to ?dir=/?path= query params (immune to that normalization) via a new resolveConfinedPath() helper; validate-mutations.mjs confirmed byte-identical confinement semantics. gui-completion workflow (wf_bcf46a89-739, 29 agents, 17 confirmed): rename/mkdir 409 suggested-alternate-name prefill; bulk-move roots picker (kit PromptDialog gained roots/onPickRoot); DELETE IS NOW SOFT - moves into a confined per-root .agentgui-trash/ (10min retention, purge-on-delete + 200-entry eviction cap) with a real undo toast via new POST /api/restore, not just confirm-before; search-hit event anchors now carried in the URL hash (ets=); Settings gained a scroll-position scrollspy; truncation banners state actual turn count+cost; cross-tab reload banner warns about+confirms discarding an unsent draft; History gained persistent next/prev error nav; session header shows agent/model (sess.model, not the nonexistent sess.agent - caught a wrong-field bug mid-implementation); backend.js's onSessionExpired() was exported but NEVER subscribed - a mid-session 401 failed every fetch completely silently, now shows a persistent reload banner; offline banner gained a manual retry-now button; search-term highlighting now extends into expanded event bodies; History search results gained a JSON export button; Settings gained navigator.storage.estimate(). REAL KIT CRASH found+fixed mid-implementation: passing a VElement/extra prop through ConversationList's caption prop (which is separately used as aria-label:caption||'Conversations', requiring a plain string) caused an intermittent webjsx 'reading key' crash - confirmed via 3 before/after browser runs, re-implemented as a fully separate sibling element outside ConversationList entirely, re-verified crash-free across 3 more runs. Standing lesson: when extending what a caller passes through an existing kit prop, grep every OTHER use site of that prop inside the component first - a prop's contract can be narrower than it looks from the one call site you're touching. docstudio design-cue pass: a subagent found docstudio (vanilla-ESM Material/Gemini-styled) architecturally LESS mature than the kit in every systemic dimension; only 1 of 6 candidate cues was a real gap (session-group eyebrow labels used the generic --tr-caps token instead of the canonical --tr-label token .t-label/.t-micro already establish) - fixed. Two upstream-diverged kit rebases handled cleanly (one single-conflict, one 35-commits-diverged) by rebuilding dist/ fresh from merged sources, never hand-merging generated code. Kit pushed 7c27e9c->fb11176->acd5fd2, agentgui pushed 71d7352->56b865f->2fecd75->a1a394a->5496ec8, all CI green throughout both repos."}

package/.gm/memories/mem-1a459001058f618e-567.md

@@ -1,8 +0,0 @@
----
-key: mem-1a459001058f618e-567
-ns: default
-created: 1784892511617
-updated: 1784892511617
----
-
-agentgui docstudio-port run (2026-07-24): added MenuButton, ChatSuggestions, BatchProgressLabel/formatBatchOutcome, InfoRow/InfoSection/DiagnosticsPanel to the anentrypoint-design kit, all barrel-exported. Real webjsx crash found+fixed mid-verify: InfoSection loading-to-loaded transition mixed key namespaces at the same diff slot, crashing applyDiff reading key; fixed by giving the two branches distinct keys body-loading/body-rows. Standing lesson: a component switching between structurally-different children at the same slot needs each branch keyed distinctly.

package/.gm/memories/mem-1af3e13f7618e668-2146.md

@@ -1,8 +0,0 @@
----
-key: mem-1af3e13f7618e668-2146
-ns: default
-created: 1781952326763
-updated: 1781952326763
----
-
-agentgui 20th run iter5 (2026-06-20): ROOT FIX of the cli-wrapper id-mismatch bug class (pushed 80d4b7c). lib/agent-discovery.js discoverAgents() used to REPLACE each found ACP agent (opencode, protocol acp, has path) with a CLI_WRAPPERS entry (id cli-opencode, protocol cli-wrapper, acpId opencode). This cli-* id scheme existed ONLY in discoveredAgents - the registry (claude-runner-agents.js), the WS client picker, and acp-sdk-manager ACP_TOOLS all use plain ids (opencode/gemini/kilo/codex). So every code path that cross-referenced discoveredAgents by the client/registry id broke: (1) getModelsForAgent returned [] for all ACP agents [iter3 4454082]; (2) external-ACP sub-agent discovery dead [iter4 c7de4f5]; (3) agent-descriptors.js:22 'agent.id===opencode' never matched cli-opencode -> opencode/gemini got the generic description + lost the model input spec; (4) process-message.js carried a dead wrapper-resolution branch. The cli-wrapper getModelsForAgent branch did EXACTLY what the plain acp branch does, so the wrapper was pure indirection+bugs. FIX: removed CLI_WRAPPERS const + the wrapper loop/filter in discoverAgents (return plain found agents), the cli-wrapper branch in server-utils getModelsForAgent, the dead wrapper-resolution + now-unused discoveredAgents param in process-message.js; retargeted the iter3 regression test to a protocol:'acp' discoveredAgent. BINARIES already had opencode/gemini/kilo/codex protocol:'acp'+npxPackage so removal is behavior-preserving (improving for descriptors). No client/persisted cli-* ids ever existed (picker always used registry ids). WITNESSED: startup 'Agent IDs: claude-code, opencode, gemini, kilo, codex'; agents.models probe -> [ACP-SDK] kilo started; getAgentDescriptor('opencode') real description + hasModelSpec:true; tests 47/47. NOTE: agent-descriptors module is production-dead (getAgentDescriptor/getAllDescriptors only called by test.js) - candidate for removal IF descriptor-serving is confirmed unwanted (ambiguous intent - ACP capability advertisement). discoveredAgents itself is now near-redundant with registry; full dual-registry consolidation still possible.

package/.gm/memories/mem-1fd31d6873e9c164-794.md

@@ -1,8 +0,0 @@
----
-key: mem-1fd31d6873e9c164-794
-ns: default
-created: 1780041284686
-updated: 1780041284686
----
-
-agentgui agent availability: WS agents.list uses registry.isAvailable(id) (lib/ws-handlers-util.js:29) which runs where/which on the command. On hosts where an agent binary is installed outside the system PATH (e.g. claude.exe in ~/.local/bin not on Windows PATH), where fails and the picker shows "(not installed)". Fix pattern: give the registry entry an npxPackage so isAvailable falls back to checking bun/npx presence (returns available-via-npx) instead of false. claude-code now has npxPackage @anthropic-ai/claude-code in lib/claude-runner-agents.js, matching the discovery fallback. The GUI agent picker (site/app/js/app.js) sorts the 4 flagship orchestration targets first: PRIMARY_AGENTS=[claude-code,opencode,kilo,agy], then other-available, then npx-installable, then not-installed.

package/.gm/memories/mem-21f551be092fd77d-2340.md

@@ -1,8 +0,0 @@
----
-key: mem-21f551be092fd77d-2340
-ns: default
-created: 1781870430413
-updated: 1781870430413
----
-
-agentgui 19th run (2026-06-19): maximum-effort quality sweep. Workflow wf_8183560b-e3d (132 agents, 12 lenses, 93 confirmed). APPLIED: resume-transcript-load (loadResumeTranscript() on resumeSid, historical:true messages, loading spinner); acp-force-restart (restart Btn on unhealthy ACP agents, wsCall acp.restart -> ws-handlers-util.js -> acp-sdk-manager.restart()); chat thinking settled state; retry on non-last message; streaming-active badge on chat rail tab; AT: followup-chips aria-live guard, cwd focus restore, shortcuts overlay role=dialog; composer disabled visual state (.is-disabled opacity .55); files-modals focus trap re-query on every Tab, stable modal aria-labelledby (random suffix not seq); sessions.js ConversationList role=listbox + aria-selected; a11y-07 fixed. History: tool_use/tool_result rail=purple; load-older announce(); session cost in meta strip. perf: sortedAgents memoized in state._sortedAgentsCache, files filter 150ms debounced, _seen Set capped 5000->trim 2500, chatFollowups memoized _followupsCache, sessionGroups memoized _sessionGroupsCache, upload DOM <input> cleanup, pathBasename util (4 dedup sites), humanizeMs->fmtDuration. Dead code: historySide() removed (~100 lines), getAvailableAgents export removed. Constants: ARM_RESET_MS=4000. refreshHistory _historyFetching guard. backend.js: SSRF guard localhost+127.0.0.1 allowed, ws-drop message 'Connection lost - please reconnect', stream 500 error sanitized (<300 chars non-JSON), auth-token 401 onSessionExpired hook. http-handler.js: IPv4-mapped IPv6 normalization for rate-limit, image route streaming+20MB cap (was sync readFileSync), IS_WINDOWS module-level. Security: files-plugin confineToRoots(browse+mkdir), acp-plugin shell-injection fix, plugin-routes CSRF fix (server-startup2.js), workflow-plugin unconfined file read fix, asset-server JS injection fix (PASSWD-JS-INJECTION). Code: getAvailableAgents export removed from claude-runner-run.js. Kit rebuilt (design): thinking settled text, retry non-last-msg, aria-modal on all dialogs (already there), combobox role on CommandPalette (already there), tab ArrowLeft/Right (already there), files-modals focus trap, sessions listbox, chat disabled .is-disabled. validate-mutations and test.js not re-run (rate-limited). Pushed agentgui 9de566e; kit vendor re-built from design HEAD.