@jhizzard/termdeck 0.18.0 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.18.0",
+  "version": "1.0.0",
   "description": "Browser-based terminal multiplexer with metadata overlays, panel flashback memory recall, and AI-aware session management",
   "bin": {
     "termdeck": "./packages/cli/src/index.js"

package/packages/client/public/app.js

@@ -53,6 +53,20 @@
         }
       } catch (_) { /* keep bootstrap fallback */ }
 
+      // Sprint 50 T3 — adapter-driven launcher buttons. Render one button
+      // per registered agent in the topbar quick-launch and the empty-state
+      // tile group. Replaces the pre-Sprint-50 hardcoded `claude` button
+      // that left Codex/Gemini/Grok with no one-click launcher (forcing
+      // free-form `codex`/`gemini`/`grok` typing in the prompt bar — a v1.0.0
+      // gate-blocker UX gap surfaced during the Sprint 49 mixed-agent
+      // dogfood). Static `shell` + `python` entries stay (non-adapter
+      // built-ins). HTML fallback shapes are preserved if rendering fails.
+      try {
+        renderQuickLaunchers();
+      } catch (err) {
+        console.warn('[client] launcher render failed, keeping HTML fallback:', err);
+      }
+
       // Populate project dropdown
       const sel = document.getElementById('promptProject');
       for (const name of Object.keys(state.config.projects || {})) {
@@ -1586,6 +1600,98 @@
       launchTerminal();
     }
 
+    // ===== Adapter-driven launcher buttons (Sprint 50 T3) =====
+    //
+    // Built-in non-adapter entries that flank the adapter list. `shell` is
+    // the always-on fallback panel; `python` is the HTTP-server convenience
+    // launcher that long predates the multi-agent registry.
+    const BUILTIN_LAUNCHERS = {
+      pre: [
+        { command: 'zsh', label: 'shell', title: 'Open a zsh shell' },
+      ],
+      post: [
+        {
+          command: 'python3 -m http.server 8080',
+          label: 'python',
+          title: 'Open a Python HTTP server on :8080',
+        },
+      ],
+    };
+
+    // One launcher button. Reuses the same `quickLaunch(cmd)` path the
+    // hardcoded HTML buttons used so command resolution (LauncherResolver
+    // + /api/sessions) is unchanged.
+    function makeLauncherButton(cmd, label, title, className) {
+      const btn = document.createElement('button');
+      btn.type = 'button';
+      btn.className = className;
+      btn.textContent = label;
+      if (title) btn.title = title;
+      btn.dataset.command = cmd;
+      btn.addEventListener('click', () => quickLaunch(cmd));
+      return btn;
+    }
+
+    function adapterLauncherEntries() {
+      const adapters = Array.isArray(state.agentAdapters) ? state.agentAdapters : [];
+      return adapters.map((a) => ({
+        command: a.binary || a.name,
+        label: (a.displayName || a.name || a.binary || '').toLowerCase(),
+        // Title text gets the canonical displayName so the tooltip preserves
+        // the proper-cased "Claude Code" / "Codex CLI" form even when the
+        // button face renders lowercase to match TermDeck's chrome style.
+        title: `Open ${a.displayName || a.name || a.binary}`,
+      }));
+    }
+
+    function renderQuickLaunchers() {
+      const adapters = adapterLauncherEntries();
+      const ordered = [
+        ...BUILTIN_LAUNCHERS.pre,
+        ...adapters,
+        ...BUILTIN_LAUNCHERS.post,
+      ];
+
+      // Topbar — compact buttons.
+      const topbar = document.getElementById('topbarQuickLaunch');
+      if (topbar) {
+        topbar.replaceChildren();
+        for (const entry of ordered) {
+          topbar.appendChild(
+            makeLauncherButton(entry.command, entry.label, entry.title, 'topbar-ql-btn'),
+          );
+        }
+      }
+
+      // Empty state — taller tiles with the raw command rendered as a
+      // secondary line. Mirrors the pre-Sprint-50 markup so existing CSS
+      // classes (`quick-launch-btn`, `ql-cmd`, `ql-desc`) keep their styling.
+      const emptyGroup = document.querySelector('#emptyState .quick-launch-group');
+      if (emptyGroup) {
+        emptyGroup.replaceChildren();
+        for (const entry of ordered) {
+          const btn = document.createElement('button');
+          btn.type = 'button';
+          btn.className = 'quick-launch-btn';
+          btn.title = entry.title;
+          btn.dataset.command = entry.command;
+
+          const cmd = document.createElement('span');
+          cmd.className = 'ql-cmd';
+          cmd.textContent = entry.command;
+
+          const desc = document.createElement('span');
+          desc.className = 'ql-desc';
+          desc.textContent = entry.title;
+
+          btn.appendChild(cmd);
+          btn.appendChild(desc);
+          btn.addEventListener('click', () => quickLaunch(entry.command));
+          emptyGroup.appendChild(btn);
+        }
+      }
+    }
+
     // ===== Add Project modal =====
     function rebuildProjectDropdown(selectName) {
       const sel = document.getElementById('promptProject');
@@ -2571,10 +2677,23 @@
     }
 
     function getTypeLabel(type) {
+      // Sprint 50 T3 — adapter-driven panel header labels. Consult
+      // state.agentAdapters first so a freshly-launched Codex/Gemini/Grok
+      // panel reads its agent's displayName (rather than the raw
+      // sessionType string or — worse — falling through to "Shell" when
+      // the type label map didn't have an entry). Adding a new agent now
+      // requires only an adapter file with `displayName`; no client-side
+      // edit. Built-in non-adapter types (shell / python-server / etc.)
+      // keep their static labels.
+      const adapters = Array.isArray(state.agentAdapters) ? state.agentAdapters : [];
+      const adapter = adapters.find((a) => a && a.sessionType === type);
+      if (adapter && adapter.displayName) return adapter.displayName;
       const labels = {
         'shell': 'Shell',
         'claude-code': 'Claude Code',
+        'codex': 'Codex CLI',
         'gemini': 'Gemini CLI',
+        'grok': 'Grok CLI',
         'python-server': 'Python Server',
         'one-shot': 'One-shot'
       };
@@ -2624,7 +2743,18 @@
 
       if (dot) {
         dot.style.background = getStatusColor(meta.status);
-        dot.classList.toggle('pulsing', meta.status === 'thinking');
+        // Sprint 50 T3 — pulse the status dot for ALL in-flight states
+        // (thinking, editing, active), not just thinking. Pre-Sprint-50 the
+        // dot only pulsed on `thinking`; during a long agent task the
+        // status fluctuated through editing/active as different regex
+        // patterns matched the live PTY stream, removing the pulsing class
+        // each time and making the visual cue feel "frozen" between thinking
+        // hits. Pulsing across all work-in-progress states keeps the
+        // animation alive end-to-end. Idle / exited / errored stay solid.
+        const inflight = meta.status === 'thinking'
+          || meta.status === 'editing'
+          || meta.status === 'active';
+        dot.classList.toggle('pulsing', inflight);
       }
       if (status) status.textContent = meta.statusDetail || meta.status;
       if (metaLast && meta.lastCommands?.length) {

package/packages/server/src/agent-adapters/claude.js

@@ -75,6 +75,52 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1 (10th adapter field).
+//
+// Claude Code stores per-session JSONL transcripts at
+//   ~/.claude/projects/<dir-hash>/<claude-session-uuid>.jsonl
+// where <dir-hash> is `cwd` with `/` replaced by `-`. The inner UUID is
+// Claude's own session id — distinct from TermDeck's `session.id` — so we
+// can't compute the path; we list the directory and pick the most recently
+// modified .jsonl whose mtime is at-or-after `session.meta.createdAt`.
+//
+// IMPORTANT: server-side `onPanelClose` SKIPS claude-typed sessions so
+// Claude's existing SessionEnd hook (registered in ~/.claude/settings.json)
+// remains the sole writer for Claude rows — no double-writes. This
+// implementation exists for contract uniformity + the unit-test surface +
+// future tooling that may want to look up Claude transcripts directly.
+// ──────────────────────────────────────────────────────────────────────────
+
+async function resolveTranscriptPath(session) {
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const dirHash = session.meta.cwd.replace(/\//g, '-');
+  const projectsDir = path.join(os.homedir(), '.claude', 'projects', dirHash);
+  let entries;
+  try { entries = fs.readdirSync(projectsDir); }
+  catch (_) { return null; }
+  const createdAtMs = session.meta.createdAt
+    ? Date.parse(session.meta.createdAt)
+    : 0;
+  let bestPath = null;
+  let bestMtime = -Infinity;
+  for (const name of entries) {
+    if (!name.endsWith('.jsonl')) continue;
+    const full = path.join(projectsDir, name);
+    let st;
+    try { st = fs.statSync(full); } catch (_) { continue; }
+    if (createdAtMs && st.mtimeMs < createdAtMs) continue;
+    if (st.mtimeMs > bestMtime) {
+      bestMtime = st.mtimeMs;
+      bestPath = full;
+    }
+  }
+  return bestPath;
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Claude Code JSONL format, lifted from
 // packages/stack-installer/assets/hooks/memory-session-end.js:88-102.
@@ -137,6 +183,12 @@ function bootPromptTemplate(lane = {}, sprint = {}) {
 const claudeAdapter = {
   name: 'claude',
   sessionType: 'claude-code',
+  // Sprint 50 T3 — human-readable label for launcher buttons + panel headers.
+  // Drives /api/agents projection and getTypeLabel() in the dashboard so a
+  // freshly-launched Codex/Gemini/Grok panel header reads its agent name
+  // (not the previous "Shell" fallback). Single source of truth — adding a
+  // new adapter no longer requires touching the client's hardcoded label map.
+  displayName: 'Claude Code',
   matches: (cmd) => typeof cmd === 'string' && /claude/i.test(cmd),
   spawn: {
     binary: 'claude',
@@ -156,6 +208,9 @@ const claudeAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. See header for skip-claude rule
+  // (onPanelClose ignores claude-typed sessions).
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'pay-per-token',
   // Sprint 47 T3 — Claude Code's input box accepts bracketed-paste cleanly.

package/packages/server/src/agent-adapters/codex.js

@@ -101,6 +101,83 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1.
+//
+// Codex stores chat-shape JSONL rollouts at
+//   ~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl
+// (verified 2026-05-02 substrate probe — first line is
+// `{type:'session_meta', payload:{cwd, ...}}`). `~/.codex/history.jsonl` at
+// the top level is a flat command-history shape, NOT chat — Sprint 49
+// close-out tried that and got `session-too-short: 0 messages
+// (parser=codex)` from the bundled hook against a real lane session.
+//
+// Attribution strategy: we don't know Codex's internal session UUID at
+// spawn time, so we walk today's + yesterday's rollout directories in
+// newest-mtime order, parse each file's first line, and return the first
+// match where `session_meta.payload.cwd === session.meta.cwd` AND
+// `mtime >= session.meta.createdAt`. Returns null when no rollout exists
+// (e.g., Codex panel was opened but never sent a turn) — onPanelClose
+// no-ops cleanly.
+// ──────────────────────────────────────────────────────────────────────────
+
+function _codexCandidateDirs(homedir, now) {
+  const path = require('path');
+  const day = new Date(now);
+  const yesterday = new Date(now - 24 * 60 * 60 * 1000);
+  const fmt = (d) => ({
+    Y: String(d.getUTCFullYear()),
+    M: String(d.getUTCMonth() + 1).padStart(2, '0'),
+    D: String(d.getUTCDate()).padStart(2, '0'),
+  });
+  const out = [];
+  for (const d of [day, yesterday]) {
+    const { Y, M, D } = fmt(d);
+    out.push(path.join(homedir, '.codex', 'sessions', Y, M, D));
+  }
+  return out;
+}
+
+async function resolveTranscriptPath(session) {
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const cwd = session.meta.cwd;
+  const createdAtMs = session.meta.createdAt
+    ? Date.parse(session.meta.createdAt)
+    : 0;
+  const candidates = [];
+  for (const dir of _codexCandidateDirs(os.homedir(), Date.now())) {
+    let entries;
+    try { entries = fs.readdirSync(dir); }
+    catch (_) { continue; }
+    for (const name of entries) {
+      if (!name.startsWith('rollout-') || !name.endsWith('.jsonl')) continue;
+      const full = path.join(dir, name);
+      let st;
+      try { st = fs.statSync(full); } catch (_) { continue; }
+      if (createdAtMs && st.mtimeMs < createdAtMs) continue;
+      candidates.push({ full, mtime: st.mtimeMs });
+    }
+  }
+  candidates.sort((a, b) => b.mtime - a.mtime);
+  for (const { full } of candidates) {
+    let firstLine;
+    try {
+      const buf = fs.readFileSync(full, 'utf8');
+      const nl = buf.indexOf('\n');
+      firstLine = nl >= 0 ? buf.slice(0, nl) : buf;
+    } catch (_) { continue; }
+    let meta;
+    try { meta = JSON.parse(firstLine); } catch (_) { continue; }
+    if (!meta || meta.type !== 'session_meta') continue;
+    if (!meta.payload || meta.payload.cwd !== cwd) continue;
+    return full;
+  }
+  return null;
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Codex JSONL format.
 //
@@ -173,6 +250,8 @@ function bootPromptTemplate(lane = {}, sprint = {}) {
 const codexAdapter = {
   name: 'codex',
   sessionType: 'codex',
+  // Sprint 50 T3 — see claude.js for rationale.
+  displayName: 'Codex CLI',
   matches: (cmd) => typeof cmd === 'string' && /\bcodex\b/i.test(cmd),
   spawn: {
     binary: 'codex',
@@ -192,6 +271,9 @@ const codexAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. See header above for substrate
+  // findings + attribution strategy.
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'pay-per-token',
   // Sprint 47 T3 — Codex's Ratatui TUI accepts bracketed-paste per the

package/packages/server/src/agent-adapters/gemini.js

@@ -46,6 +46,59 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1.
+//
+// Gemini CLI persists chats at
+//   ~/.gemini/tmp/<basename(cwd)>/chats/session-<ISO-ts>-<short-id>.json
+// (single-JSON-object shape that matches parseGeminiJson, verified
+// 2026-05-02 substrate probe). Pick the most recently modified file whose
+// mtime is at-or-after `session.meta.createdAt`. Falls back to walking
+// every project directory under `~/.gemini/tmp/*/chats/` if the basename
+// heuristic produces no candidate (e.g., Gemini renormalized the project
+// name to deduplicate against an existing one).
+// ──────────────────────────────────────────────────────────────────────────
+
+async function resolveTranscriptPath(session) {
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const createdAtMs = session.meta.createdAt
+    ? Date.parse(session.meta.createdAt)
+    : 0;
+  const tmpRoot = path.join(os.homedir(), '.gemini', 'tmp');
+  const cwdBase = path.basename(session.meta.cwd);
+  const primary = path.join(tmpRoot, cwdBase, 'chats');
+  const extras = [];
+  try {
+    for (const proj of fs.readdirSync(tmpRoot)) {
+      const candidate = path.join(tmpRoot, proj, 'chats');
+      if (candidate !== primary) extras.push(candidate);
+    }
+  } catch (_) { /* tmp root absent */ }
+  let bestPath = null;
+  let bestMtime = -Infinity;
+  const scan = (dir) => {
+    let entries;
+    try { entries = fs.readdirSync(dir); } catch (_) { return; }
+    for (const name of entries) {
+      if (!name.startsWith('session-') || !name.endsWith('.json')) continue;
+      const full = path.join(dir, name);
+      let st;
+      try { st = fs.statSync(full); } catch (_) { continue; }
+      if (createdAtMs && st.mtimeMs < createdAtMs) continue;
+      if (st.mtimeMs > bestMtime) {
+        bestMtime = st.mtimeMs;
+        bestPath = full;
+      }
+    }
+  };
+  scan(primary);
+  if (!bestPath) for (const dir of extras) scan(dir);
+  return bestPath;
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Gemini CLI session JSON format (NOT JSONL).
 //
@@ -177,6 +230,8 @@ function buildMnestraBlock({ secrets } = {}) {
 const geminiAdapter = {
   name: 'gemini',
   sessionType: 'gemini',
+  // Sprint 50 T3 — see claude.js for rationale.
+  displayName: 'Gemini CLI',
   matches: (cmd) => typeof cmd === 'string' && /gemini/i.test(cmd),
   spawn: {
     binary: 'gemini',
@@ -199,6 +254,8 @@ const geminiAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. Walks ~/.gemini/tmp/<proj>/chats.
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'pay-per-token',
   // Sprint 47 T3 — Gemini's CLI is paste-friendly per the single-JSON-object

package/packages/server/src/agent-adapters/grok.js

@@ -121,6 +121,83 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1.
+//
+// Grok stores messages in `~/.grok/grok.db` (SQLite, STRICT schema requiring
+// SQLite ≥3.37 — macOS system sqlite3 3.36 cannot read it; better-sqlite3
+// bundles a recent build). The bundled hook (vendored to ~/.claude/hooks/)
+// can't `require('better-sqlite3')` because that path is outside TermDeck's
+// node_modules tree. So `resolveTranscriptPath` does the SQLite extraction
+// in-process here (the server has better-sqlite3 as a top-level dep), writes
+// the messages as a JSON envelope to `os.tmpdir()/termdeck-grok-<id>.json`,
+// and returns the tempfile path. The hook then reads that path with
+// `parseGrokJson` (a flat JSON-array parser — no SQLite needed downstream).
+//
+// Workspace mapping: grok.db's `workspaces.canonical_path` is the agent's
+// cwd-at-startup. We match against `session.meta.cwd` to find the
+// workspace_id, then pick the most recent session in that workspace whose
+// `created_at >= session.meta.createdAt` (allowing a small clock-skew
+// epsilon). Returns null gracefully if better-sqlite3 isn't loadable, the
+// DB doesn't open, the workspace isn't found, or no session matches.
+// ──────────────────────────────────────────────────────────────────────────
+
+const _GROK_RESOLVE_EPSILON_MS = 5_000;
+
+async function resolveTranscriptPath(session) {
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  let Database;
+  try { Database = require('better-sqlite3'); }
+  catch (_) { return null; }  // dep missing → no-op
+  const dbPath = path.join(os.homedir(), '.grok', 'grok.db');
+  if (!fs.existsSync(dbPath)) return null;
+  let db;
+  try {
+    db = new Database(dbPath, { readonly: true, fileMustExist: true });
+  } catch (_) { return null; }
+  try {
+    const ws = db.prepare(
+      'SELECT id FROM workspaces WHERE canonical_path = ? LIMIT 1'
+    ).get(session.meta.cwd);
+    if (!ws) return null;
+    const createdAtMs = session.meta.createdAt
+      ? Date.parse(session.meta.createdAt) - _GROK_RESOLVE_EPSILON_MS
+      : 0;
+    const grokSession = db.prepare(
+      'SELECT id, created_at FROM sessions WHERE workspace_id = ? ORDER BY created_at DESC LIMIT 1'
+    ).get(ws.id);
+    if (!grokSession) return null;
+    if (createdAtMs && Date.parse(grokSession.created_at) < createdAtMs) {
+      return null;  // most recent grok session predates this panel — no match
+    }
+    const rows = db.prepare(
+      'SELECT message_json FROM messages WHERE session_id = ? ORDER BY seq ASC'
+    ).all(grokSession.id);
+    if (!rows || rows.length === 0) return null;
+    const envelope = [];
+    for (const row of rows) {
+      let parsed;
+      try { parsed = JSON.parse(row.message_json); } catch (_) { continue; }
+      if (!parsed || typeof parsed !== 'object') continue;
+      const role = parsed.role;
+      if (role !== 'user' && role !== 'assistant') continue;
+      envelope.push({ role, content: parsed.content });
+    }
+    if (envelope.length === 0) return null;
+    const safeId = String(session.id || `unknown-${Date.now()}`).replace(/[^a-zA-Z0-9._-]/g, '_');
+    const tmpfile = path.join(os.tmpdir(), `termdeck-grok-${safeId}.json`);
+    fs.writeFileSync(tmpfile, JSON.stringify(envelope), 'utf8');
+    return tmpfile;
+  } catch (_) {
+    return null;
+  } finally {
+    try { db.close(); } catch (_) { /* fail-soft */ }
+  }
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Grok stores messages in SQLite (~/.grok/grok.db), not
 // in a JSONL file. The adapter contract is `(raw: string) => Memory[]`, so
@@ -360,6 +437,8 @@ function _mergeMnestraIntoGrokSettings(rawText, { secrets } = {}) {
 const grokAdapter = {
   name: 'grok',
   sessionType: 'grok',
+  // Sprint 50 T3 — see claude.js for rationale.
+  displayName: 'Grok CLI',
   matches: (cmd) => typeof cmd === 'string' && /(?:^|\s|\/)grok(?:\b|$)/i.test(cmd),
   spawn: {
     binary: 'grok',
@@ -382,6 +461,9 @@ const grokAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. SQLite extraction → tempfile JSON
+  // envelope (see header above for rationale + workspace mapping).
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'subscription',
   // Sprint 47 T3 — Grok's Bun+OpenTUI input box hasn't been empirically

package/packages/server/src/index.js

@@ -9,6 +9,7 @@ const path = require('path');
 const os = require('os');
 const fs = require('fs');
 const dns = require('dns');
+const { spawn: spawnChild } = require('child_process');
 const { v4: uuidv4 } = require('uuid');
 const { createCachedLookup, createFailureLogger } = require('./rumen-pool-resilience');
 
@@ -128,6 +129,97 @@ function readTermdeckSecretsForPty() {
 // Test hook — clear the cache between tests that mutate the on-disk file.
 function _resetTermdeckSecretsCache() { _termdeckSecretsCache = null; }
 
+// Sprint 50 T1 — Per-agent SessionEnd hook trigger.
+//
+// `_spawnSessionEndHookImpl` is the production spawn path; tests swap it
+// out via `_setSpawnSessionEndHookImplForTesting` to capture the
+// payload + arguments deterministically. The reason this indirection
+// exists rather than mocking `child_process.spawn`: `node:test` doesn't
+// run detached + stdio:['pipe','ignore','ignore'] children inside the
+// test runner (verified — direct spawn with the same options fails to
+// even invoke the script's first line). Mocking `child_process` would
+// require module-level mocking which the runner doesn't support out of
+// the box. A single-function injection keeps the surface tiny.
+function _defaultSpawnSessionEndHookImpl(hookPath, payload, env) {
+  const child = spawnChild('node', [hookPath], {
+    stdio: ['pipe', 'ignore', 'ignore'],
+    detached: true,
+    env,
+  });
+  child.on('error', (err) => {
+    console.error('[onPanelClose] hook spawn error:', err && err.message ? err.message : err);
+  });
+  try {
+    child.stdin.write(JSON.stringify(payload));
+    child.stdin.end();
+  } catch (err) {
+    console.error('[onPanelClose] hook stdin write failed:', err && err.message ? err.message : err);
+  }
+  child.unref();
+  return child;
+}
+let _spawnSessionEndHookImpl = _defaultSpawnSessionEndHookImpl;
+function _setSpawnSessionEndHookImplForTesting(fn) {
+  _spawnSessionEndHookImpl = typeof fn === 'function' ? fn : _defaultSpawnSessionEndHookImpl;
+}
+
+// Fires when a panel's PTY exits. Routes through the adapter registry's
+// new `resolveTranscriptPath` field (10th adapter field, Sprint 50) and
+// invokes the bundled `~/.claude/hooks/memory-session-end.js` with the
+// right payload so Codex / Gemini / Grok panels write a `session_summary`
+// row the same way Claude Code already does.
+//
+// Skip rules (in order):
+//   1. Claude — its own SessionEnd hook (registered in
+//      ~/.claude/settings.json) ingests Claude rows. Double-firing here
+//      would either insert two rows per session or race the Claude hook.
+//   2. Adapters without `resolveTranscriptPath` — older adapters or types
+//      not in the registry (shell, python-server, one-shot). No-op.
+//   3. `resolveTranscriptPath` returns null — adapter declares no
+//      transcript exists for this session (panel never sent a turn).
+//   4. ~/.claude/hooks/memory-session-end.js missing — user hasn't
+//      installed the TermDeck stack hook. No-op.
+//
+// Fail-soft contract: any error logs to stderr and exits cleanly. Never
+// blocks panel teardown — the spawn is fire-and-forget (detached + unref).
+//
+// `source_agent` is included in the payload (T2 consumes it via the new
+// `memory_items.source_agent` column). T1 just passes the value; if T2
+// hasn't migrated the column yet at the moment of first fire, Supabase
+// rejects the row and the hook logs `supabase-insert-failed: HTTP 4xx`.
+async function onPanelClose(session) {
+  try {
+    if (!session || !session.meta) return;
+    const adapter = AGENT_ADAPTERS[session.meta.type]
+      || Object.values(AGENT_ADAPTERS).find((a) => a.sessionType === session.meta.type);
+    if (!adapter) return;
+    if (adapter.sessionType === 'claude-code') return;
+    if (typeof adapter.resolveTranscriptPath !== 'function') return;
+
+    const transcriptPath = await adapter.resolveTranscriptPath(session);
+    if (!transcriptPath) return;
+
+    const hookPath = path.join(os.homedir(), '.claude', 'hooks', 'memory-session-end.js');
+    if (!fs.existsSync(hookPath)) return;
+
+    const payload = {
+      transcript_path: transcriptPath,
+      cwd: session.meta.cwd,
+      session_id: session.id,
+      sessionType: adapter.sessionType,
+      // Sprint 50 — T2 consumes this via the new memory_items.source_agent column.
+      source_agent: adapter.name,
+    };
+
+    _spawnSessionEndHookImpl(hookPath, payload, {
+      ...process.env,
+      ...readTermdeckSecretsForPty(),
+    });
+  } catch (err) {
+    console.error('[onPanelClose] error:', err && err.message ? err.message : err);
+  }
+}
+
 // Sprint 37 T3 — lazy resolution of T2's CLI modules. The orchestration-preview
 // helper is decoupled from T2's templates.js / init-project.js; we resolve
 // them here and pass them into the helper. If a module is missing (e.g.
@@ -926,6 +1018,15 @@ function createServer(config) {
 
           // Fire-and-forget session log (T2.5)
           writeSessionLog({ session, config, db, getSessionHistory });
+
+          // Sprint 50 T1 — fire the bundled SessionEnd hook for non-Claude
+          // panels so Codex / Gemini / Grok /exits write to Mnestra the way
+          // Claude Code already does. onPanelClose handles dispatch +
+          // skip-claude + skip-when-no-transcript. Fire-and-forget; any
+          // error logs and never blocks teardown.
+          onPanelClose(session).catch((err) => {
+            console.error('[onPanelClose] async error:', err && err.message ? err.message : err);
+          });
         });
 
         // Wire command logging to SQLite + RAG
@@ -1324,6 +1425,9 @@ function createServer(config) {
   //   • binary      — canonical command name; client matches `^binary\b` (i)
   //   • costBand    — 'free' | 'pay-per-token' | 'subscription' (Sprint 46
   //                   surfaces this in PLANNING.md cost annotations)
+  //   • displayName — Sprint 50 T3: human-readable label for launcher buttons
+  //                   and panel headers. Backwards-compat: existing clients
+  //                   that ignore the field continue to work unchanged.
   // Functions / RegExps are NOT serialized — match logic lives client-side
   // and uses the binary as the prefix anchor. Adapter-specific shorthand
   // (e.g. `cc` → `claude`) is normalized in app.js before this lookup.
@@ -1333,6 +1437,29 @@ function createServer(config) {
       sessionType: a.sessionType,
       binary: a.spawn && a.spawn.binary,
       costBand: a.costBand,
+      displayName: a.displayName || a.name,
+    }));
+    res.json(list);
+  });
+
+  // GET /api/agents - Sprint 50 T3: richer adapter projection used by the
+  // dashboard launcher to render one button per registered agent and by the
+  // mixed-agent dogfood inject script to discover available agents. Adds
+  // the full spawn descriptor (binary + defaultArgs) so callers don't need
+  // to re-derive it from the binary alone. Coexists with /api/agent-adapters
+  // (kept stable for the launcher-resolver client contract).
+  app.get('/api/agents', (req, res) => {
+    const list = Object.values(AGENT_ADAPTERS).map((a) => ({
+      name: a.name,
+      sessionType: a.sessionType,
+      displayName: a.displayName || a.name,
+      spawn: {
+        binary: (a.spawn && a.spawn.binary) || a.name,
+        defaultArgs: (a.spawn && Array.isArray(a.spawn.defaultArgs))
+          ? a.spawn.defaultArgs.slice()
+          : [],
+      },
+      costBand: a.costBand,
     }));
     res.json(list);
   });
@@ -2228,4 +2355,9 @@ module.exports = {
   // Sprint 48 T4 — exported for unit testing the secrets.env → PTY env merge.
   readTermdeckSecretsForPty,
   _resetTermdeckSecretsCache,
+  // Sprint 50 T1 — exported for unit testing the per-agent SessionEnd
+  // hook trigger (skip-claude, no-transcript, no-hook-installed,
+  // payload shape, fire-and-forget).
+  onPanelClose,
+  _setSpawnSessionEndHookImplForTesting,
 };