@dadado/agent-kit-cli 6.3.0 → 6.5.0

package/dashboard/dashboard-data.mjs

@@ -7,11 +7,13 @@
 import { execFileSync } from "node:child_process";
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
+import { collectChats } from "./lib/chat-sessions.mjs";
 import { collectGateExitTickets } from "./lib/gate-exit-tickets.mjs";
 import {
   allowlistConfig,
   MAX_STRING,
   parseGitStatusShort,
+  resolveBroadcastAuth,
   resolveSnapshotRepoRoot,
   truncateStr,
 } from "./lib/guards.mjs";
@@ -133,7 +135,7 @@ function redactTerminalOutput(text) {
 
 const SNAPSHOT = {
   _schema: {
-    version: "1.6.0",
+    version: "1.7.0",
     description: "Mission Control dashboard data model",
     fields: {
       generatedAt: "ISO-8601 timestamp of snapshot generation",
@@ -154,6 +156,8 @@ const SNAPSHOT = {
         "Newest headless agent-kit run / tick logs from <state root>/loop-logs (AGENT_KIT_STATE_ROOT: .cursor by default, or .agent-kit; no ~/.cursor dependency): format, session id, capped last agent text, result, LOOP_TICK_RESULT line, HITL gate ids and reply stamps (1.5.0)",
       gateExit:
         "Pending operator tickets (read-only, never fetches): {marker: absent|ok|invalid, base, tickets[] (stamp, headline, askId, labels, trigger, openedAt, url, branch, branchState unmerged|merged|none, inMarker), skipped[] (latest launcher skip records), truncated} from .cursor/context/gate-exit.json and gate-exit/<stamp> branches; same contract as agent-kit ground-control status (1.6.0)",
+      chats:
+        "Saved agent chats of this workspace: {withheld, vendors[]} with one envelope per vendor {vendor: claude|codex|cursor, status: ok|unsupported|none, projectDir, sessions[] ({id, title, titleSource: custom|ai|first-prompt|none, modified unix ms, sizeBytes}, newest first, capped at 200), total}; same contract as agent-kit sessions --json. withheld is true (vendors empty) in broadcast mode: chat titles never leave the machine (1.7.0)",
       processes:
         "Running process snapshots (node, serve.mjs, git operations) with elapsed time and a generated narration per process",
       skills: "Available skills discovered in .cursor/skills/",
@@ -162,7 +166,7 @@ const SNAPSHOT = {
     },
   },
   generatedAt: new Date().toISOString(),
-  dashboardDataVersion: "1.6.0",
+  dashboardDataVersion: "1.7.0",
   plans: [],
   system: {
     repoRoot: ROOT,
@@ -175,6 +179,7 @@ const SNAPSHOT = {
   terminals: [],
   runLogs: [],
   gateExit: { marker: "absent", base: "staging", tickets: [], skipped: [], truncated: false },
+  chats: { withheld: false, vendors: [] },
   processes: [],
   skills: [],
   health: { status: "ok", checks: [] },
@@ -789,6 +794,13 @@ if (withinSnapshotBudget(200)) {
   SNAPSHOT.gateExit = collectGateExitTickets(ROOT, { redact: redactTerminalOutput });
 }
 
+// 7d. Saved agent chats (~/.claude/projects/<slug>/<uuid>.jsonl), read-only. Titles are private:
+// a broadcast (non-loopback, token-gated) server never gets them (serve.mjs strips them too).
+SNAPSHOT.chats = collectChats({
+  cwd: ROOT,
+  withhold: resolveBroadcastAuth(process.env).broadcast !== false,
+});
+
 // 8. Config
 const configPath = join(ROOT, ".cursor", "context", "config.json");
 if (existsSync(configPath)) {

package/dashboard/dashboard.html

@@ -5,19 +5,25 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Mission Control</title>
-<link rel="icon" type="image/svg+xml" id="favicon" href="/logo.svg">
+<link rel="icon" type="image/svg+xml" id="favicon" href="/logo-bare-metal.svg">
 <script>
-/* Restore dashboard skin before first paint (namespaced local preference). */
+/* Restore dashboard skin before first paint (namespaced local preference).
+   Default Bare Metal; a stored 'cursor' (the pre-rename id) is rewritten to
+   'bare-metal'. Keep in sync with normalizeDashboardSkin below. */
 (function () {
   var key = 'agent-kit:dashboard-skin';
-  var skin = 'legacy';
+  var skin = 'bare-metal';
   try {
     var stored = localStorage.getItem(key);
-    if (stored === 'cursor' || stored === 'legacy') skin = stored;
+    if (stored === 'cursor') {
+      localStorage.setItem(key, 'bare-metal');
+    } else if (stored === 'bare-metal' || stored === 'legacy') {
+      skin = stored;
+    }
   } catch (e) { /* private mode / blocked storage */ }
   document.documentElement.setAttribute('data-dashboard-skin', skin);
   var fav = document.getElementById('favicon');
-  if (fav) fav.setAttribute('href', skin === 'cursor' ? '/logo-cursor.svg' : '/logo.svg');
+  if (fav) fav.setAttribute('href', skin === 'legacy' ? '/logo.svg' : '/logo-bare-metal.svg');
 })();
 /* Restore Crew Monitor row density before first paint; auto-pick by viewport
    when the operator has no stored preference. Same namespaced-key + blocked-
@@ -38,18 +44,10 @@
 <style>
 /* ===== Reset & Base ===== */
 *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
-/* Legacy skin (default): current Mission Control palette. */
-:root,
-html[data-dashboard-skin="legacy"] {
-  --bg-primary: #0b0e14;
-  --bg-secondary: #111620;
-  --bg-card: #161c2a;
-  --bg-card-hover: #1b2335;
-  --border: #1e2a3a;
-  --border-active: #2a3a5a;
-  --text-primary: #e2e8f0;
-  --text-secondary: #8899aa;
-  --text-muted: #6d8094; /* landing uses #7f93a8 (AA over marketing gradient); see docs/design-system.md */
+/* Shared tokens (both Interface Skins): semantic colors and structure.
+   A skin overrides only the 9 surface variables below; the token sets are
+   published in docs/contracts/mission-control-skins.json. */
+:root {
   --green: #22c55e;
   --green-bg: rgba(34,197,94,0.12);
   --yellow: #eab308;
@@ -112,8 +110,9 @@ html[data-dashboard-skin="legacy"] {
   /* Shared status / badge circles (#statusDot and .dot base). */
   --mc-status-dot-size: 7px;
 }
-/* Cursor skin: Cursor-like base chrome only; keep Agent Kit semantic highlights. */
-html[data-dashboard-skin="cursor"] {
+/* Bare Metal skin (default): neutral dark surfaces. */
+:root,
+html[data-dashboard-skin="bare-metal"] {
   --bg-primary: #141414;
   --bg-secondary: #181818;
   --bg-card: #1c1c1c;
@@ -122,7 +121,19 @@ html[data-dashboard-skin="cursor"] {
   --border-active: #3a3a3a;
   --text-primary: #e4e4e4;
   --text-secondary: #a0a0a0;
-  --text-muted: #6e6e6e;
+  --text-muted: #8b8b8b; /* >= 4.5:1 (WCAG AA) on every bg-* surface incl. hover; see docs/design-system.md */
+}
+/* Legacy skin: the original blue-slate Mission Control surfaces. */
+html[data-dashboard-skin="legacy"] {
+  --bg-primary: #0b0e14;
+  --bg-secondary: #111620;
+  --bg-card: #161c2a;
+  --bg-card-hover: #1b2335;
+  --border: #1e2a3a;
+  --border-active: #2a3a5a;
+  --text-primary: #e2e8f0;
+  --text-secondary: #8899aa;
+  --text-muted: #7f93a8; /* same as the landing; >= 4.5:1 (WCAG AA) on every bg-* surface incl. hover; see docs/design-system.md */
 }
 html, body {
   height: 100%;
@@ -934,6 +945,31 @@ body.mc-fullscreen .top-tabs-row {
 }
 .terminal-item:hover { background: var(--bg-card-hover); }
 
+/* ===== Chats (saved agent sessions) ===== */
+.chat-list { display: flex; flex-direction: column; gap: 4px; }
+.chat-item {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 6px 10px;
+  border-radius: 6px;
+  font-size: 12px;
+  color: var(--text-secondary);
+}
+.chat-item:hover { background: var(--bg-card-hover); }
+.chat-title {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--text-primary);
+}
+.chat-title[data-untitled="true"] { color: var(--text-muted); font-style: italic; }
+.chat-age,
+.chat-id { color: var(--text-muted); font-family: var(--mc-font-mono); white-space: nowrap; }
+.chat-note { font-size: 12px; color: var(--text-muted); margin: 8px 10px 0; }
+
 /* ===== Healthcenter ===== */
 .healthcenter {
   display: flex;
@@ -1230,7 +1266,7 @@ body.mc-fullscreen .top-tabs-row {
 .git-hygiene-paths {
   font-family: var(--mc-font-mono);
   font-size: 11px;
-  color: var(--text-muted);
+  color: var(--text-secondary); /* muted fails AA on the --yellow-bg tint */
   margin-top: 4px;
   word-break: break-all;
 }
@@ -3649,7 +3685,7 @@ html[data-monitor-density="comfortable"] .live-activity-feed .monitor-row .monit
 <!-- Header: identity + one transport/freshness signal + refresh -->
 <div class="header">
   <button type="button" class="header-brand" id="headerBrand" onclick="return goHome()" aria-label="Home, Overview" title="Home, Overview">
-    <img class="logo" id="headerLogo" src="/logo.svg" width="28" height="28" alt="" aria-hidden="true"> Mission Control
+    <img class="logo" id="headerLogo" src="/logo-bare-metal.svg" width="28" height="28" alt="" aria-hidden="true"> Mission Control
     <span class="header-workspace" id="headerWorkspace" hidden></span>
   </button>
   <span class="header-version" id="version" hidden>v—</span>
@@ -3711,6 +3747,10 @@ html[data-monitor-density="comfortable"] .live-activity-feed .monitor-row .monit
           Terminals
           <span class="top-tab-badge" id="navTerminalsBadge">0</span>
         </a>
+        <a class="top-tab nav-more-item" role="menuitem" href="#" data-section="chats" tabindex="0" onclick="return showSection('chats')" aria-label="Chats section">
+          Chats
+          <span class="top-tab-badge" id="navChatsBadge">0</span>
+        </a>
         <a class="top-tab nav-more-item" role="menuitem" href="#" data-section="processes" tabindex="0" onclick="return showSection('processes')" aria-label="Processes section">
           Processes
           <span class="top-tab-badge" id="navProcessesBadge">0</span>
@@ -3721,11 +3761,11 @@ html[data-monitor-density="comfortable"] .live-activity-feed .monitor-row .monit
         <div class="nav-more-separator" role="separator"></div>
         <div class="nav-more-group" role="group" aria-labelledby="navSkinsLabel">
           <div class="nav-more-group-label" id="navSkinsLabel" data-icon="skins">Skins</div>
-          <button type="button" class="nav-more-item" role="menuitemradio" aria-checked="true" data-dashboard-skin-option="legacy" tabindex="0" onclick="return setDashboardSkin('legacy')">
-            Legacy
+          <button type="button" class="nav-more-item" role="menuitemradio" aria-checked="true" data-dashboard-skin-option="bare-metal" tabindex="0" onclick="return setDashboardSkin('bare-metal')">
+            Bare Metal
           </button>
-          <button type="button" class="nav-more-item" role="menuitemradio" aria-checked="false" data-dashboard-skin-option="cursor" tabindex="0" onclick="return setDashboardSkin('cursor')">
-            Cursor
+          <button type="button" class="nav-more-item" role="menuitemradio" aria-checked="false" data-dashboard-skin-option="legacy" tabindex="0" onclick="return setDashboardSkin('legacy')">
+            Legacy
           </button>
         </div>
       </div>
@@ -3882,6 +3922,7 @@ const SECTION_IDS = [
   'devops',
   'memory',
   'terminals',
+  'chats',
   'processes',
   'config',
 ];
@@ -4061,17 +4102,29 @@ function goCockpitAnchor(anchorId) {
 
 // ===== Dashboard visual skins (More menu; local preference only) =====
 const DASHBOARD_SKIN_KEY = 'agent-kit:dashboard-skin';
-const DASHBOARD_SKINS = ['legacy', 'cursor'];
+const DASHBOARD_SKINS = ['bare-metal', 'legacy'];
+const DASHBOARD_SKIN_DEFAULT = 'bare-metal';
+/** Pre-rename ids still found in browser storage. */
+const DASHBOARD_SKIN_ALIASES = { cursor: 'bare-metal' };
 
 function normalizeDashboardSkin(skin) {
-  return DASHBOARD_SKINS.includes(skin) ? skin : 'legacy';
+  if (Object.prototype.hasOwnProperty.call(DASHBOARD_SKIN_ALIASES, skin)) {
+    return DASHBOARD_SKIN_ALIASES[skin];
+  }
+  return DASHBOARD_SKINS.includes(skin) ? skin : DASHBOARD_SKIN_DEFAULT;
 }
 
 function getStoredDashboardSkin() {
   try {
-    return normalizeDashboardSkin(localStorage.getItem(DASHBOARD_SKIN_KEY));
+    const stored = localStorage.getItem(DASHBOARD_SKIN_KEY);
+    const skin = normalizeDashboardSkin(stored);
+    // Rewrite an aliased value (e.g. 'cursor') so storage holds the current id.
+    if (stored !== null && stored !== skin && Object.prototype.hasOwnProperty.call(DASHBOARD_SKIN_ALIASES, stored)) {
+      localStorage.setItem(DASHBOARD_SKIN_KEY, skin);
+    }
+    return skin;
   } catch (e) {
-    return 'legacy';
+    return DASHBOARD_SKIN_DEFAULT;
   }
 }
 
@@ -4084,7 +4137,7 @@ function applyDashboardSkin(skin, opts) {
     el.setAttribute('aria-checked', selected ? 'true' : 'false');
     el.classList.toggle('active', selected);
   });
-  const logoSrc = next === 'cursor' ? '/logo-cursor.svg' : '/logo.svg';
+  const logoSrc = next === 'legacy' ? '/logo.svg' : '/logo-bare-metal.svg';
   const headerLogo = document.getElementById('headerLogo');
   if (headerLogo) headerLogo.setAttribute('src', logoSrc);
   const favicon = document.getElementById('favicon');
@@ -6321,6 +6374,98 @@ function showTerminalPopup(content, title) {
   document.body.appendChild(overlay);
 }
 
+/**
+ * POSIX single-quote for a pasted shell command.
+ * Mirror of `shellQuote` in dashboard/lib/chat-sessions.mjs (inline HTML cannot import it).
+ */
+function chatShellQuote(value) {
+  const s = String(value ?? '');
+  if (/^[A-Za-z0-9_./-]+$/.test(s)) return s;
+  return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+
+/** Mirror of `claudeResumeCommand` in dashboard/lib/chat-sessions.mjs. */
+function chatResumeCommand(workspace, id) {
+  return `cd ${chatShellQuote(workspace)} && claude --resume ${chatShellQuote(id)}`;
+}
+
+/** Claude Code envelope of the snapshot `chats` field (null when absent or withheld). */
+function claudeChatsEnvelope(d) {
+  const vendors = Array.isArray(d?.chats?.vendors) ? d.chats.vendors : [];
+  return vendors.find((v) => v && v.vendor === 'claude') || null;
+}
+
+function chatsTotal(d) {
+  const claude = claudeChatsEnvelope(d);
+  return claude && claude.status === 'ok' && Number.isFinite(claude.total) ? claude.total : 0;
+}
+
+/** Chats section body. Titles are user content: escapeHtml / escapeAttr only. */
+function renderChatsSection(d) {
+  const chats = d?.chats || null;
+  const workspace = d?.system?.repoRoot || '';
+  const claude = claudeChatsEnvelope(d);
+  const sessions = claude && claude.status === 'ok' && Array.isArray(claude.sessions) ? claude.sessions : [];
+  const total = chatsTotal(d);
+  const unsupported = (Array.isArray(chats?.vendors) ? chats.vendors : [])
+    .filter((v) => v && v.status === 'unsupported')
+    .map((v) => ({ codex: 'Codex', cursor: 'Cursor' }[v.vendor] || String(v.vendor || '')));
+  let subtitle = `${total} saved`;
+  if (sessions.length < total) subtitle = `${sessions.length} newest of ${total}`;
+  let body;
+  if (chats?.withheld === true) {
+    subtitle = 'hidden';
+    body = renderEmptyStateCta({
+      iconKind: 'chats',
+      headline: 'Chats stay private',
+      support: 'This Mission Control is broadcast on the network, so saved chat titles are left out. Open it on this machine to see them.',
+    });
+  } else if (sessions.length === 0) {
+    body = renderEmptyStateCta({
+      iconKind: 'chats',
+      headline: 'No saved chats',
+      support: 'The agent CLI saves each session per folder. Start claude in this workspace folder and it shows up here, ready to resume.',
+    });
+  } else {
+    body = `<div class="chat-list">${sessions.map((s) => {
+      const id = String(s.id || '');
+      const untitled = !s.title;
+      const title = untitled ? 'Untitled chat' : String(s.title);
+      const modifiedIso = Number.isFinite(s.modified) ? new Date(s.modified).toISOString() : '';
+      const cmd = chatResumeCommand(workspace, id);
+      return `
+        <div class="chat-item">
+          <span class="chat-title"${untitled ? ' data-untitled="true"' : ''} title="${escapeAttr(title)}">${escapeHtml(title)}</span>
+          <span class="chat-age" title="${escapeAttr(modifiedIso)}">${escapeHtml(relativeTime(modifiedIso))}</span>
+          <span class="chat-id" title="${escapeAttr(id)}">${escapeHtml(id.slice(0, 8))}</span>
+          <button type="button" class="process-copy-btn chat-resume-btn" data-chat-resume="${escapeAttr(cmd)}" aria-label="${escapeAttr(`Copy the resume command for chat ${title}`)}" title="${escapeAttr(copyActionTitle('resume command', 'terminal'))}">Copy resume</button>
+        </div>`;
+    }).join('')}</div>`;
+  }
+  const note = unsupported.length
+    ? `<p class="chat-note">${escapeHtml(unsupported.map((name) => `${name}: not supported yet`).join(' \u00b7 '))}</p>`
+    : '';
+  return `
+    <div class="content-section" id="section-chats">
+      <div class="section-title">
+        Chats
+        <span class="section-subtitle">${escapeHtml(subtitle)}</span>
+      </div>
+      ${body}
+      ${note}
+    </div>
+  `;
+}
+
+function wireChatResumeButtons() {
+  document.querySelectorAll('.chat-resume-btn[data-chat-resume]').forEach((btn) => {
+    btn.addEventListener('click', (e) => {
+      e.stopPropagation();
+      copyForPaste(btn.dataset.chatResume, 'resume command', 'terminal');
+    });
+  });
+}
+
 function wireTerminalExpandButtons() {
   document.querySelectorAll('.terminal-expand-btn[data-terminal-id]').forEach((btn) => {
     btn.addEventListener('click', (e) => {
@@ -7107,7 +7252,7 @@ function nowMetaIconSvg(kind, opts) {
  * features >= 1 unit. Detail that cannot meet the floor is drawn filled
  * (fill="currentColor" stroke="none"), never as a sub-stroke stroked shape.
  * Static path markup only; never concatenate untrusted text into the SVG.
- * @param {'current-mission'|'monitor'|'field-report'|'checklist'|'more-sections'|'overview'|'plans'|'activity'|'agents'|'skills'|'skins'|'commands'|'health'|'git'|'devops'|'memory'|'terminals'|'processes'|'config'} kind
+ * @param {'current-mission'|'monitor'|'field-report'|'checklist'|'more-sections'|'overview'|'plans'|'activity'|'agents'|'skills'|'skins'|'commands'|'health'|'git'|'devops'|'memory'|'terminals'|'chats'|'processes'|'config'} kind
  * @param {{ decorative?: boolean }} [opts] decorative true (default): aria-hidden next to a visible label.
  *   decorative false: role=img + aria-label + title for icon-only controls (e.g. more-sections).
  */
@@ -7132,6 +7277,7 @@ function spaceIconSvg(kind, opts) {
     devops: 'DevOps',
     memory: 'Memory',
     terminals: 'Terminals',
+    chats: 'Chats',
     processes: 'Processes',
     config: 'Config',
   };
@@ -7212,6 +7358,9 @@ function spaceIconSvg(kind, opts) {
     terminals:
       '<path d="M1.5 3.5h13a1 1 0 011 1v7a1 1 0 01-1 1H1.5a1 1 0 01-1-1v-7a1 1 0 011-1z"/>' +
       '<path d="M5.5 12.5v2M10.5 12.5v2M4 14.5h8"/>',
+    // Speech bubble (chats) — Feather message-square on the 16 grid
+    chats:
+      '<path d="M14 10a1.5 1.5 0 01-1.5 1.5H5L2 14.5v-11A1.5 1.5 0 013.5 2h9A1.5 1.5 0 0114 3.5z"/>',
     // Layers (processes)
     processes:
       '<path d="M8 2.5l6 3-6 3-6-3 6-3z"/>' +
@@ -8158,6 +8307,11 @@ function renderUnsafe() {
   const navTerminalsBadge = document.getElementById('navTerminalsBadge');
   navTerminalsBadge.textContent = d.terminals.length;
   navTerminalsBadge.className = 'top-tab-badge';
+  const navChatsBadge = document.getElementById('navChatsBadge');
+  if (navChatsBadge) {
+    navChatsBadge.textContent = chatsTotal(d);
+    navChatsBadge.className = 'top-tab-badge';
+  }
   const navProcessesBadge = document.getElementById('navProcessesBadge');
   navProcessesBadge.textContent = d.processes.length;
   navProcessesBadge.className = 'top-tab-badge';
@@ -8732,6 +8886,9 @@ function renderUnsafe() {
     </div>
   `);
 
+  // ===== Chats =====
+  parts.push(renderChatsSection(d));
+
   // ===== Processes =====
   const processes = d.processes || [];
   // Detached audit-session visibility (phase3): host-wide agent-kit-audit-* PTYs.
@@ -8894,6 +9051,7 @@ function renderUnsafe() {
   contentEl.innerHTML = parts.join('');
 
   wireTerminalExpandButtons();
+  wireChatResumeButtons();
 
   updateTransportChrome();
 

package/dashboard/lib/chat-sessions.d.mts

@@ -0,0 +1,63 @@
+export const CHAT_SESSIONS_CAP: number;
+export const CHAT_TITLE_MAX: number;
+export const CHAT_NAMED_TITLE_MAX: number;
+export const CHAT_FULL_SCAN_MAX_BYTES: number;
+export const CHAT_HEAD_BYTES: number;
+export const CHAT_TAIL_BYTES: number;
+export const CHAT_SCAN_BUDGET_BYTES: number;
+export const CHAT_VENDORS: readonly ["claude", "codex", "cursor"];
+
+export type ChatVendor = "claude" | "codex" | "cursor";
+export type ChatTitleSource = "custom" | "ai" | "first-prompt" | "none";
+
+export interface ChatSession {
+  id: string;
+  title: string | null;
+  titleSource: ChatTitleSource;
+  /** Last write, unix milliseconds. */
+  modified: number;
+  sizeBytes: number;
+}
+
+export interface ChatSessionsEnvelope {
+  vendor: ChatVendor;
+  status: "ok" | "unsupported" | "none";
+  projectDir: string | null;
+  sessions: ChatSession[];
+  total: number;
+}
+
+export interface ChatsSnapshot {
+  withheld: boolean;
+  vendors: ChatSessionsEnvelope[];
+}
+
+export interface ChatTitle {
+  title: string | null;
+  titleSource: ChatTitleSource;
+}
+
+export interface ListChatSessionsOptions {
+  cwd: string;
+  home?: string | null;
+  cap?: number;
+  /** Bytes read in full before older transcripts fall back to a small head + tail window. */
+  scanBudgetBytes?: number;
+  cache?: Map<string, ChatTitle>;
+}
+
+export function claudeProjectSlug(cwd: string): string;
+export function claudeProjectDir(cwd: string, opts?: { home?: string | null }): string | null;
+export function cleanChatTitle(value: unknown, max?: number): string;
+export function readChatTitle(
+  filePath: string,
+  window?: { fullScanMaxBytes?: number; headBytes?: number; tailBytes?: number },
+): ChatTitle;
+export function listClaudeSessions(opts: ListChatSessionsOptions): ChatSessionsEnvelope;
+export function listChatSessions(opts: ListChatSessionsOptions): ChatSessionsEnvelope[];
+export function collectChats(opts: ListChatSessionsOptions & { withhold?: boolean }): ChatsSnapshot;
+export function withholdChats<T extends Record<string, unknown>>(snapshot: T): T;
+export function withholdChatsFromPayload(payload: string): string;
+export function shellQuote(value: string): string;
+export function claudeResumeCommand(workspace: string, id: string): string;
+export function formatChatAge(modifiedMs: number, nowMs?: number): string;