openzoo 0.49.4 → 0.49.6

package/lib/grokui.mjs

@@ -24,6 +24,13 @@ import {
   prepareChildDir, finishChildDir, lockWorktree, unlockWorktree,
   parsePrRef, fetchSpecsForOrigin, agentSlug,
 } from './worktree.mjs';
+import {
+  filesForCorpus as collectFilesForCorpus,
+  readFilesForCorpus,
+  looksLikeFileView,
+  extractBashPaths,
+} from './spill.js';
+import { BIND_MIN_CHARS } from './hrr.js';
 
 const PORT = Number(process.env.OZ_GROKUI_PORT || 4173);
 // BIND HOST. Default 127.0.0.1 so the desktop app never exposes a shell-capable
@@ -391,8 +398,9 @@ comes back with content:null and finish_reason:"length" (confirmed live) if you
 to append to the same bound context, rather than one giant request that silently fails partway.
 
 COST ACCOUNTING — do NOT compute this yourself from token counts. Every response carries an
-"x402" object; read the numbers off it: x402.billedUsd (what the user paid), x402.cogsUsd
-(our upstream cost), x402.directUsd (what answering WITHOUT the zoo would have cost), and
+"x402" object; read the numbers off it: x402.billedUsd (what the user paid — OpenRouter price, plus 33% of savings vs
+direct when any), x402.cogsUsd (our upstream cost), x402.directUsd (what answering
+WITHOUT the zoo would have cost), x402.savedUsd (dollars saved), and
 x402.savesVsDirect (the multiple). Summing usage.cost or usage.prompt_tokens and comparing
 that to a provider's list price is WRONG and understates the saving enormously: against a
 bound context, prompt_tokens counts only the small slice leCore recalled, NOT the corpus
@@ -401,7 +409,7 @@ the zoo "cost more". MEASURED: a real 21-question run reported 202,238 prompt to
 each attach call stood in for a 5,356,546-token corpus — a 556x understatement, and that
 corpus is ~42x larger than the model's own context window, so the "direct" comparison it
 was measured against was not merely pricier but IMPOSSIBLE. When the user asks what they
-saved, quote x402.directUsd and x402.savesVsDirect. If savesVsDirect is below 1x, say so
+saved, quote x402.billedUsd, x402.directUsd and x402.savedUsd. If savedUsd is 0 / savesVsDirect is below 1x, say so
 plainly — that happens on small inputs, where the corpus is too small to save anything.
 For normal questions just answer directly — do not use any of these unless the request
 actually calls for delegation or file work.`;
@@ -431,6 +439,7 @@ function loadThreads() {
       if (t.status === 'thinking') {
         t.status = 'idle';
         t.liveStatus = '';
+        t.liveRace = null;
       }
       if (Array.isArray(t.history)) {
         for (const h of t.history) {
@@ -617,7 +626,7 @@ this is roleplay, and never fabricate command output or receipts. A real failure
 as real output and an exit code, not as silence.
 
 COST ACCOUNTING — read it off the response's "x402" object (billedUsd, cogsUsd, directUsd,
-savesVsDirect). Never derive it by summing usage.cost or usage.prompt_tokens against a
+savedUsd, savesVsDirect). Never derive it by summing usage.cost or usage.prompt_tokens against a
 provider's list price: on a bound context prompt_tokens counts only the slice leCore
 recalled, not the corpus it stands in for, so that math prices the discount against itself
 and wrongly concludes the zoo cost more.
@@ -1058,6 +1067,7 @@ const SLASH_COMMANDS = [
   { name: '/models', args: '[filter]', help: 'search the ~435 served models' },
   { name: '/tier', args: 'cheap|medium|expensive|grok 4.6', help: 'how much to spend per turn when no model is pinned' },
   { name: '/race', args: '<n> | <k> <n>', help: 'launch n models; judge the first k back (k=1 = fastest wins)' },
+  { name: '/sitrep', args: '', help: 'session sitrep (drawer)' },
   { name: '/compact', args: '', help: 'summarise history to shrink context' },
   { name: '/clear', args: '', help: 'wipe this thread’s history' },
   { name: '/undo', args: '', help: 'drop the last exchange' },
@@ -1121,6 +1131,159 @@ function condense(label, text) {
   return `${label}\n${head}\n\n…[${s.length - head.length - tail.length} chars elided from THIS message — the full output is bound to this thread's holographic memory. It is not lost: mention what you need in your next message and the relevant part is retrieved automatically. Do not invent a command to fetch it.]…\n\n${tail}`;
 }
 
+// Files the grokui agent READ/WRITE/EDIT/MULTIEDIT/NOTEBOOK'd (and RUN
+// cat/head/type) must land in the HRR corpus as path-prefixed file parts —
+// not as unlabeled chat text via bindThread, and not as the ~3k condense()
+// stub the next completion sends. Sidecar maybeCacheCorpus only sees that
+// stub; bindThread never labels them as files. filesForCorpus (spill.js)
+// already dedups path:mtime and caps at KEEP_MAX (400KB). We reuse it.
+const boundFiles = new Set();
+
+function pathToReadMsgs(paths) {
+  return (Array.isArray(paths) ? paths : [paths]).filter(Boolean).map((file_path) => ({
+    role: 'assistant',
+    tool_calls: [{
+      function: { name: 'Read', arguments: JSON.stringify({ file_path }) },
+    }],
+  }));
+}
+
+function commandToBashMsgs(command) {
+  return [{
+    role: 'assistant',
+    tool_calls: [{
+      function: { name: 'Bash', arguments: JSON.stringify({ command }) },
+    }],
+  }];
+}
+
+/**
+ * Collect grokui file reads/writes for the HRR corpus.
+ *
+ * Accepts an absolute/relative path, a list of paths, or already-shaped
+ * chat messages (OpenAI tool_calls / Anthropic tool_use). Dedup and the
+ * 400KB cap live in spill.js — this is the grokui entry point so READ
+ * records the same way Claude Code Read does.
+ */
+function filesForCorpus(target, opts = {}) {
+  const keys = opts.boundFiles || boundFiles;
+  const cwd = opts.cwd || process.cwd();
+  const cap = opts.cap ?? KEEP_MAX;
+  let msgs = target;
+  if (typeof target === 'string') msgs = pathToReadMsgs(target);
+  else if (Array.isArray(target) && (target.length === 0 || typeof target[0] === 'string')) {
+    msgs = pathToReadMsgs(target);
+  }
+  return collectFilesForCorpus(msgs, { ...opts, boundFiles: keys, cwd, cap });
+}
+
+function filesForCorpusKeys() {
+  return boundFiles;
+}
+
+function resetFilesForCorpus() {
+  boundFiles.clear();
+}
+
+function inFlightChars(t) {
+  if (!t) return 0;
+  if (Array.isArray(t.messages)) {
+    let n = 0;
+    for (const m of t.messages) {
+      const c = m?.content;
+      if (typeof c === 'string') n += c.length;
+      else if (c != null) n += JSON.stringify(c).length;
+    }
+    return n;
+  }
+  let n = 0;
+  for (const h of t.history || []) n += String(h?.text || '').length;
+  return n;
+}
+
+/**
+ * POST file bytes to ${PROXY}/hrr/bind, appending to the project context.
+ * Always fire-and-forget so a READ does not wait on the bind round-trip.
+ * When the in-flight corpus/messages are below BIND_MIN_CHARS the bind
+ * still happens — reuse only "wins" on a big body, but the file must be
+ * recallable next turn. Completions keep omitting x-hrr-context.
+ */
+function scheduleFilesForCorpus(t, collected, opts = {}) {
+  if (!collected?.pending?.length) return null;
+  const root = t ? (threads.get(rootOf(t).rootId) || t) : null;
+  const ctx = opts.contextId || root?.contextId || t?.contextId || null;
+  const chars = opts.sentChars ?? inFlightChars(t);
+  const background = chars < BIND_MIN_CHARS;
+  const fetchImpl = opts.fetchImpl || fetch;
+  const run = () => {
+    let read;
+    try { read = readFilesForCorpus(collected, { boundFiles: opts.boundFiles || boundFiles, cap: opts.cap ?? KEEP_MAX }); }
+    catch { return Promise.resolve(null); }
+    if (!read?.text) return Promise.resolve(null);
+    const payload = ctx ? { corpus: read.text, context_id: ctx } : { corpus: read.text };
+    return fetchImpl(`${PROXY}/hrr/bind`, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify(payload),
+    }).then(async (r) => {
+      const j = await r.json().catch(() => ({}));
+      if (j?.context_id && t) {
+        const live = threads.get(rootOf(t).rootId) || t;
+        live.contextId = j.context_id;
+        t.contextId = j.context_id;
+        if (Number(j.bound)) live.boundItems = (live.boundItems || 0) + Number(j.bound);
+      }
+      return j;
+    }).catch(() => null);
+  };
+  const job = { pending: collected.pending, background, append: Boolean(ctx), run };
+  const kick = () => { job.promise = run(); };
+  if (opts.defer === false) kick();
+  else setImmediate(kick);
+  return job;
+}
+
+function noteFileForCorpus(originId, relOrAbs, extra = {}) {
+  const t = extra.thread || (originId ? threads.get(originId) : null);
+  const cwd = extra.cwd || (originId ? dirFor(originId) : process.cwd());
+  let abs = relOrAbs;
+  if (typeof abs === 'string' && !path.isAbsolute(abs)) {
+    try { abs = originId ? safeResolveIn(cwd, abs) : path.resolve(cwd, abs); }
+    catch { abs = path.resolve(cwd, abs); }
+  }
+  const collected = filesForCorpus(abs, {
+    cwd,
+    boundFiles: extra.boundFiles || boundFiles,
+    cap: extra.cap ?? KEEP_MAX,
+    ...(extra.collectOpts || {}),
+  });
+  return scheduleFilesForCorpus(t, collected, extra);
+}
+
+function noteRunForCorpus(originId, command, extra = {}) {
+  if (!looksLikeFileView(command)) return null;
+  const t = extra.thread || (originId ? threads.get(originId) : null);
+  const cwd = extra.cwd || (originId ? dirFor(originId) : process.cwd());
+  const collected = filesForCorpus(commandToBashMsgs(command), {
+    cwd,
+    boundFiles: extra.boundFiles || boundFiles,
+    cap: extra.cap ?? KEEP_MAX,
+  });
+  if (!collected.pending.length) {
+    const { paths } = extractBashPaths(command, cwd);
+    const abs = paths.map((p) => {
+      const raw = p?.raw;
+      if (!raw) return null;
+      if (path.isAbsolute(raw)) return raw;
+      try { return originId ? safeResolveIn(p.cwd || cwd, raw) : path.resolve(p.cwd || cwd, raw); }
+      catch { return path.resolve(p.cwd || cwd, raw); }
+    }).filter(Boolean);
+    if (!abs.length) return null;
+    return noteFileForCorpus(originId, abs, extra);
+  }
+  return scheduleFilesForCorpus(t, collected, extra);
+}
+
 // threadId -> open SSE responses. A Set because the same thread can be open in
 // two tabs, and both should see the same tokens.
 const streamListeners = new Map();
@@ -1150,6 +1313,7 @@ async function handleSlash(task, t) {
   const cmd = m[1].toLowerCase();
   const arg = m[2].trim();
 
+  if (cmd === 'sitrep') return null; // drawer-only — never a transcript line
   if (cmd === 'help') {
     return 'Commands:\n'
       + SLASH_COMMANDS.map((c) => `  ${(c.name + ' ' + c.args).padEnd(26)} ${c.help}`).join('\n')
@@ -1448,6 +1612,7 @@ setInterval(() => {
     } else {
       t.status = 'idle';
       t.liveStatus = '';
+      t.liveRace = null;
       unlockWorktree(t);
     }
     dirty = true;
@@ -2091,6 +2256,7 @@ async function tryDirective(reply, originId, onEvent) {
       const full = safeResolveIn(dirFor(originId), rel);
       mkdirSync(path.dirname(full), { recursive: true });
       writeFileSync(full, content);
+      noteFileForCorpus(originId, full);
       return `Wrote ${rel} (${Buffer.byteLength(content)} bytes) to ${dirFor(originId)}.${await previewAck(originId, rel)}`;
     } catch (e) { return `Couldn't write ${rel}: ${e.message}`; }
   }
@@ -2098,7 +2264,9 @@ async function tryDirective(reply, originId, onEvent) {
   if (readD) {
     const rel = readD[1].trim();
     try {
-      const data = readFileSync(safeResolveIn(dirFor(originId), rel), 'utf8');
+      const full = safeResolveIn(dirFor(originId), rel);
+      const data = readFileSync(full, 'utf8');
+      noteFileForCorpus(originId, full);
       return `${rel}:\n${keepWhole(data)}`;
     } catch (e) { return `Couldn't read ${rel}: ${e.message}`; }
   }
@@ -2117,6 +2285,7 @@ async function tryDirective(reply, originId, onEvent) {
       if (hits === 0) return `EDIT ${rel}: that exact text isn't in the file — READ it first, the copy must match byte for byte.`;
       if (hits > 1) return `EDIT ${rel}: that text appears ${hits} times — include more surrounding context so it matches exactly once.`;
       writeFileSync(full, before.replace(oldStr, newStr));
+      noteFileForCorpus(originId, full);
       return `Edited ${rel} (${before.length} -> ${before.replace(oldStr, newStr).length} bytes).${await previewAck(originId, rel)}`;
     } catch (e) { return `Couldn't edit ${rel}: ${e.message}`; }
   }
@@ -2143,6 +2312,7 @@ async function tryDirective(reply, originId, onEvent) {
         applied.push(o.slice(0, 40));
       }
       writeFileSync(full, next);
+      noteFileForCorpus(originId, full);
       return `MULTIEDIT ${rel}: ${applied.length} edit(s) applied (${before.length} -> ${next.length} bytes).${await previewAck(originId, rel)}`;
     } catch (e) { return `Couldn't multiedit ${rel}: ${e.message}`; }
   }
@@ -2163,6 +2333,7 @@ async function tryDirective(reply, originId, onEvent) {
       // Stale outputs next to new code are worse than none.
       if (doc.cells[idx].cell_type === 'code') { doc.cells[idx].outputs = []; doc.cells[idx].execution_count = null; }
       writeFileSync(full, JSON.stringify(doc, null, 1));
+      noteFileForCorpus(originId, full);
       return `NOTEBOOK ${rel}: replaced cell ${idx} (${doc.cells[idx].cell_type}); outputs cleared.`;
     } catch (e) { return `Couldn't edit ${rel}: ${e.message}`; }
   }
@@ -2448,11 +2619,12 @@ async function mcpDirective(url, tool, args) {
 
 // onEvent (optional) gets live progress for whoever's actually watching this
 // call: {type:'start',name,color} when a bot begins its turn, {type:'status',
-// detail} while paying / waiting / racing / walking tools, {type:'delta',name,
-// color,delta} per streamed token (replace:true swaps the bubble once),
-// {type:'final',name,color,text} once its full reply (or directive ack) is
-// settled. Background turns go through kickTurn → emitToThread, which is a
-// no-op if nobody has the thread open.
+// detail} while paying / waiting / racing / walking tools, {type:'race',race}
+// for the spectator grid (one cell per launched model + a judging beat),
+// {type:'delta',name,color,delta} per streamed token (replace:true swaps the
+// bubble once), {type:'final',name,color,text} once its full reply (or
+// directive ack) is settled. Background turns go through kickTurn →
+// emitToThread, which is a no-op if nobody has the thread open.
 async function runTurn(threadId, userText, onEvent, images) {
   const t = threads.get(threadId);
   if (!t) return;
@@ -2469,7 +2641,8 @@ async function runTurn(threadId, userText, onEvent, images) {
   const paint = (ev) => {
     if (!stillMine()) return;
     if (ev.type === 'status' && ev.detail && t.status === 'thinking') t.liveStatus = ev.detail;
-    if (ev.type === 'delta' || ev.type === 'status' || ev.type === 'start') t.lastDeltaAt = Date.now();
+    if (ev.type === 'race' && ev.race && t.status === 'thinking') t.liveRace = ev.race;
+    if (ev.type === 'delta' || ev.type === 'status' || ev.type === 'start' || ev.type === 'race') t.lastDeltaAt = Date.now();
     onEvent?.(ev);
   };
   t.history.push(images && images.length ? { who: 'user', text: userText, images } : { who: 'user', text: userText });
@@ -2483,6 +2656,7 @@ async function runTurn(threadId, userText, onEvent, images) {
   lockWorktree(t);
   const raceN = Math.min(Number(t.race) || 0, 4);
   const raceNeed = Math.min(Math.max(Number(t.raceNeed) || 1, 1), raceN || 1);
+  t.liveRace = null;
   t.liveStatus = (!t.model && raceN >= 2) ? formatRaceStatus(0, raceNeed) : 'waiting on model…';
   let chained = false;
   let parked = false;
@@ -2513,6 +2687,7 @@ async function runTurn(threadId, userText, onEvent, images) {
         if (t.runMode === 'auto') {
           emitLiveStatus(t.id, paint, peekDirectiveStatus('', command));
           const output = await execCommand(command, dirFor(t.id));
+          noteRunForCorpus(t.id, command, { cwd: dirFor(t.id) });
           const shown = `$ ${command}\n${output}`;
           t.history.push({ who: 'bot', text: shown, name: m.name, color: m.color });
           paint({ type: 'final', name: m.name, color: m.color, text: shown });
@@ -2604,6 +2779,7 @@ async function runTurn(threadId, userText, onEvent, images) {
       return (await brainRace(callMsgs, emit, t.contextId, models, need, undefined, emitStatus, {
         signal: turnAbort.signal,
         onArrivals: (arr) => { t.lastRaceFail = summarizeRaceFailures(arr); },
+        onRace: (snap) => paint({ type: 'race', name: t.name, color: t.color, race: snap }),
         tier: t.tier || 'medium',
       })).trim();
     }
@@ -2655,6 +2831,7 @@ async function runTurn(threadId, userText, onEvent, images) {
     if (t.runMode === 'auto') {
       emitLiveStatus(t.id, paint, peekDirectiveStatus('', command));
       const output = await execCommand(command, dirFor(t.id));
+      noteRunForCorpus(t.id, command, { cwd: dirFor(t.id) });
       if (!stillMine()) return;
       const shown = `$ ${command}\n${output}`;
       t.history.push({ who: 'bot', text: shown });
@@ -2757,6 +2934,7 @@ async function runTurn(threadId, userText, onEvent, images) {
       } else if (!t.pendingRun) {
         t.status = 'idle';
         t.liveStatus = '';
+        t.liveRace = null;
         unlockWorktree(t);
       }
     }
@@ -3031,12 +3209,20 @@ const APP_HTML = `<!doctype html>
      whose entire premise is that the box pays for itself. Click-to-copy is a
      shortcut; the address is selectable so Cmd/Ctrl+C still works if copy
      fails. */
-  #walletOverlay { position: fixed; inset: 0; background: rgba(0,0,0,.66); z-index: 1200;
+  #walletOverlay, #sitrepOverlay { position: fixed; inset: 0; background: rgba(0,0,0,.66); z-index: 1200;
                    display: none; align-items: center; justify-content: center; padding: 24px; }
-  #walletOverlay.show { display: flex; }
-  #walletBox { width: 100%; max-width: 560px; max-height: 82vh; overflow-y: auto; background: #111113;
+  #walletOverlay.show, #sitrepOverlay.show { display: flex; }
+  #walletBox, #sitrepBox { width: 100%; max-width: 560px; max-height: 82vh; overflow-y: auto; background: #111113;
                border: 1px solid #2c2c2e; border-radius: 16px; padding: 20px 22px; }
-  #walletBox h3 { margin: 0 0 2px; font-size: 15px; font-weight: 600; }
+  #walletBox h3, #sitrepBox h3 { margin: 0 0 2px; font-size: 15px; font-weight: 600; }
+  #sitrepBox { max-width: 420px; }
+  .srow { display: flex; justify-content: space-between; align-items: baseline; gap: 14px;
+          padding: 8px 0; border-bottom: 1px solid #1c1c1e; }
+  .srow:last-child { border-bottom: 0; }
+  .slab { color: #6f7080; font-size: 11px; letter-spacing: .06em; text-transform: uppercase; flex: 0 0 auto; }
+  .sval { color: #ececec; font-size: 13px; text-align: right; word-break: break-word; min-width: 0; }
+  .sval.hlime { color: #b8f240; }
+  .sval.hember { color: #f28c4d; }
   .wsub { color: #8e8e93; font-size: 12px; margin-bottom: 16px; }
   .wrow { border: 1px solid #1c1c1e; border-radius: 12px; padding: 10px 12px; margin-bottom: 10px;
           display: flex; align-items: center; gap: 10px; cursor: pointer; }
@@ -3121,7 +3307,7 @@ const APP_HTML = `<!doctype html>
                 color: #f0c9a8; font-size: 10.5px; line-height: 1.45; }
   #hud .hhint.show { display: block; }
   #hud .hhint b { color: #f28c4d; font-weight: 600; }
-  #sidebar, #main, #walletOverlay, #composeOverlay,
+  #sidebar, #main, #walletOverlay, #sitrepOverlay, #composeOverlay,
   #inp, #search, #composeInp, .bubble, .md-pre, .runoutput, .runcmd {
     -webkit-app-region: no-drag; }
   #log { flex: 1; min-width: 0; overflow-y: auto; overflow-x: hidden; padding: 20px 24px 12px;
@@ -3223,6 +3409,46 @@ const APP_HTML = `<!doctype html>
   @keyframes blink { 0%, 80%, 100% { opacity: .25; } 40% { opacity: 1; } }
   .tstatus { color: #8e8e93; font-size: 13px; margin-left: 6px; }
   .ttrail { display: block; color: #8e8e93; font-size: 12.5px; margin-top: 8px; }
+  /* Race spectator board. Lives in the transcript, never over the header
+     dials / wallet / cost HUD. 2×2 for four, a row for two, wrap otherwise. */
+  .row.bot:has(.raceboard) { max-width: 92%; }
+  .bubble.raceboard { padding: 10px 11px; background: #1a1a1d; }
+  .racewrap { display: flex; flex-direction: column; gap: 8px; min-width: 0; }
+  .racecaption { color: #6f7080; font-size: 11px; letter-spacing: .04em; text-transform: uppercase; }
+  .racegrid { display: grid; gap: 7px; grid-template-columns: 1fr 1fr; }
+  .racegrid.n1 { grid-template-columns: 1fr; }
+  .racegrid.n2 { grid-template-columns: 1fr 1fr; }
+  .racegrid.n3 { grid-template-columns: 1fr 1fr; }
+  @media (min-width: 720px) { .racegrid.n3 { grid-template-columns: 1fr 1fr 1fr; } }
+  .racecell { border: 1px solid #2c2c32; border-radius: 12px; padding: 8px 9px 7px;
+              background: #141416; min-width: 0; min-height: 0; transition: opacity .18s ease, border-color .18s ease; }
+  .racecell.streaming { border-color: #3d3d4a; }
+  .racecell.back { border-color: #2a3a18; }
+  .racecell.failed { border-color: #3a2424; }
+  .racecell.abandoned { opacity: .42; }
+  .racecell.winner { border-color: #b8f240; box-shadow: 0 0 0 1px rgba(184,242,64,.28); }
+  .racehead { display: flex; align-items: center; gap: 6px; margin-bottom: 6px; min-width: 0; }
+  .racename { font-size: 12px; font-weight: 600; color: #ececec; white-space: nowrap;
+              overflow: hidden; text-overflow: ellipsis; min-width: 0; }
+  .racechip { flex: 0 0 auto; font-size: 10px; letter-spacing: .03em; color: #8e8e93;
+              border: 1px solid #2c2c32; border-radius: 999px; padding: 1px 7px; }
+  .racecell.streaming .racechip { color: #b8f240; border-color: #3a4a18; }
+  .racecell.back .racechip { color: #b8f240; border-color: #2a3a18; }
+  .racecell.failed .racechip { color: #f28c4d; border-color: #5a3020; }
+  .racecell.abandoned .racechip { color: #6f7080; }
+  .racecell.winner .racechip { color: #0b0b0d; background: #b8f240; border-color: #b8f240; }
+  .raceprev { font: 11.5px/1.35 ui-monospace, SFMono-Regular, Menlo, monospace; color: #9a9aa6;
+              white-space: pre-wrap; word-break: break-word; max-height: 8.2em; overflow: hidden; }
+  .racefail { display: inline-block; margin-top: 2px; font-size: 11px; color: #f28c4d; letter-spacing: .03em; }
+  .racejudge { border: 1px dashed #3a4a18; border-radius: 12px; padding: 9px 11px;
+               background: rgba(184,242,64,.05); color: #c8c8b8; }
+  .racejudge.won { border-style: solid; border-color: #b8f240; }
+  .racejudge-lab { font-size: 10px; letter-spacing: .06em; text-transform: uppercase; color: #b8f240;
+                   margin-bottom: 3px; }
+  .racejudge-msg { font-size: 13px; color: #ececec; }
+  @media (prefers-reduced-motion: reduce) {
+    .racecell { transition: none; }
+  }
   #bar { padding: 10px 16px 18px; position: relative; }
   #row-input { display: flex; align-items: center; gap: 8px; }
   #plusMenu { position: absolute; bottom: 62px; left: 16px; background: #1c1c1e; border-radius: 14px;
@@ -3354,6 +3580,13 @@ const APP_HTML = `<!doctype html>
       </div>
     </div>
   </div>
+  <div id="sitrepOverlay" data-component="sitrep-drawer">
+    <div id="sitrepBox">
+      <h3>Sitrep</h3>
+      <div class="wsub">This thread and this session. No keys.</div>
+      <div id="sitrepBody">loading…</div>
+    </div>
+  </div>
   <div id="main">
     <div id="chatHeader">
       <div id="chatHeaderId"></div>
@@ -3373,17 +3606,17 @@ const APP_HTML = `<!doctype html>
       </select>
       <select class="dial" id="raceSel" data-component="model-race" aria-label="Race models"
               title="Ask N models from the tier at once, drawn at random — fastest real answer wins. You pay for every entrant.">
-        <option value="0" selected>1 model</option>
+        <option value="0" selected>1 model  0%</option>
         <optgroup label="first back wins">
-          <option value="2">race 2</option>
-          <option value="3">race 3</option>
-          <option value="4">race 4</option>
+          <option value="2">race 2  −50%</option>
+          <option value="3">race 3  −67%</option>
+          <option value="4">race 4  −75%</option>
         </optgroup>
         <optgroup label="judge the first k back">
-          <option value="2 3">best 2 of 3</option>
-          <option value="2 4">best 2 of 4</option>
-          <option value="3 4">best 3 of 4</option>
-          <option value="4 4">best 4 of 4</option>
+          <option value="2 3">best 2 of 3  −67%</option>
+          <option value="2 4">best 2 of 4  −75%</option>
+          <option value="3 4">best 3 of 4  −75%</option>
+          <option value="4 4">best 4 of 4  −75%</option>
         </optgroup>
       </select>
       <button class="dial" id="walletBtn" data-component="wallet-open"
@@ -3411,6 +3644,10 @@ const APP_HTML = `<!doctype html>
           <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21.44 11.05l-9.19 9.19a5 5 0 0 1-7.07-7.07l9.19-9.19a3.5 3.5 0 0 1 4.95 4.95l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48"/></svg>
           <span>Attach files</span>
         </div>
+        <div class="pop-item" id="sitrepBtn">
+          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="5" y="3" width="14" height="18" rx="2"/><line x1="8" y1="8" x2="16" y2="8"/><line x1="8" y1="12" x2="16" y2="12"/><line x1="8" y1="16" x2="13" y2="16"/></svg>
+          <span>Sitrep</span>
+        </div>
       </div>
       <input id="fileInp" type="file" multiple style="position:absolute;width:1px;height:1px;opacity:0;pointer-events:none;">
       <div id="attachChips"></div>
@@ -4068,8 +4305,73 @@ const APP_HTML = `<!doctype html>
   walletOverlay.addEventListener('click', (e) => {
     if (e.target === walletOverlay) walletOverlay.classList.remove('show');
   });
+  const sitrepOverlay = document.getElementById('sitrepOverlay');
+  const sitrepBody = document.getElementById('sitrepBody');
+  function raceCutPct(y) {
+    const n = Math.max(1, Number(y) || 1);
+    return Math.round((1 - 1 / n) * 100);
+  }
+  function raceChoiceLabel(y, need) {
+    const n = Math.max(1, Number(y) || 1);
+    const k = Math.max(1, Math.min(Number(need) || 1, n));
+    const cut = raceCutPct(n);
+    const cutTxt = cut === 0 ? '0%' : ('−' + cut + '%');
+    if (n < 2) return '1 model  ' + cutTxt;
+    if (k > 1) return 'best ' + k + ' of ' + n + '  ' + cutTxt;
+    return 'race ' + n + '  ' + cutTxt;
+  }
+  function sitrepRow(lab, val, cls) {
+    return '<div class="srow"><span class="slab">' + escapeHtml(lab) + '</span><span class="sval'
+      + (cls ? (' ' + cls) : '') + '">' + escapeHtml(val) + '</span></div>';
+  }
+  async function openSitrep() {
+    sitrepOverlay.classList.add('show');
+    sitrepBody.textContent = 'loading…';
+    const t = knownThreads.find((x) => x.id === activeId) || {};
+    let full = null;
+    try { if (activeId) full = await (await fetch(API + '/threads/' + activeId)).json(); } catch (e) { full = null; }
+    let you = {};
+    try { you = await (await fetch(API + '/hud-summary')).json(); } catch (e) { you = {}; }
+    const y = Number(t.race) || 0;
+    const need = Number(t.raceNeed) || 1;
+    const raceY = y >= 2 ? y : 1;
+    const spent = Number(you.spentUsd) || 0;
+    const cogs = Number(you.cogsUsd) || 0;
+    const direct = Number(you.directUsd) || 0;
+    const mult = spent > 0 ? direct / spent : null;
+    const saved = mult == null ? '—'
+      : ((mult >= 100 ? Math.round(mult) : mult.toFixed(mult >= 10 ? 1 : 2)) + 'x');
+    const savedCls = mult == null ? '' : (mult >= 1 ? 'hlime' : 'hember');
+    const thinking = (full && full.status === 'thinking') || t.status === 'thinking';
+    const race = (full && full.liveRace) || null;
+    let flight = 'idle';
+    if (thinking && race && race.phase === 'judging') flight = 'classifier judging';
+    else if (thinking && race && race.phase === 'winner') flight = 'winner';
+    else if (thinking && (full && full.liveStatus)) flight = full.liveStatus;
+    else if (thinking && t.liveStatus) flight = t.liveStatus;
+    else if (thinking) flight = 'in flight';
+    const cwd = (full && full.dir) || t.dir || '—';
+    sitrepBody.innerHTML =
+      sitrepRow('race', raceChoiceLabel(raceY, need))
+      + sitrepRow('band', t.tier || 'medium')
+      + sitrepRow('mode', t.runMode || 'ask')
+      + sitrepRow('cwd', cwd)
+      + sitrepRow('in flight', flight)
+      + '<div class="wlanetitle" style="margin-top:16px">this session</div>'
+      + sitrepRow('paid', '$' + (spent >= 0.01 || spent === 0 ? spent.toFixed(2) : spent.toFixed(5)))
+      + sitrepRow('cogs', '$' + (cogs >= 0.01 || cogs === 0 ? cogs.toFixed(2) : cogs.toFixed(5)))
+      + sitrepRow('direct', '$' + (direct >= 0.01 || direct === 0 ? direct.toFixed(2) : direct.toFixed(5)))
+      + sitrepRow('saved vs naked', saved, savedCls)
+      + sitrepRow('paid calls', String(you.paidCalls || 0))
+      + sitrepRow('prepaid', (Number(you.creditUsd) > 0) ? 'yes' : 'no');
+  }
+  function closeSitrep() { sitrepOverlay.classList.remove('show'); }
+  sitrepOverlay.addEventListener('click', (e) => {
+    if (e.target === sitrepOverlay) closeSitrep();
+  });
   document.addEventListener('keydown', (e) => {
     if (e.key === 'Escape' && walletOverlay.classList.contains('show')) walletOverlay.classList.remove('show');
+    if (e.key === 'Escape' && sitrepOverlay.classList.contains('show')) closeSitrep();
   });
 
   document.getElementById('tierSel').addEventListener('change', (e) => setDial('tier', e.target.value));
@@ -4611,6 +4913,12 @@ const APP_HTML = `<!doctype html>
     }
     if (full.status === 'thinking') {
       if (full.liveStatus) streamStatus = full.liveStatus;
+      if (full.liveRace && full.liveRace.racers && full.liveRace.racers.length >= 2) {
+        streamRace = full.liveRace;
+        streamRaceId = full.id;
+      } else if (streamRaceId !== full.id) {
+        streamRace = null;
+      }
       addRow('bot', streamBuf || '…', t.color, t.name);
       // Tag the live bubble so deltas can repaint just this node instead of
       // re-rendering (and re-fetching) the whole thread on every token.
@@ -4625,8 +4933,60 @@ const APP_HTML = `<!doctype html>
   // so a turn showed "…" for its whole duration and then arrived in one lump.
   let streamBuf = '';
   let streamStatus = '';
+  let streamRace = null;
+  let streamRaceId = '';
+  let raceHandoff = 0;
   let es = null, esId = null;
+  function raceIsLive(r) {
+    return !!(r && r.racers && r.racers.length >= 2 && streamRaceId === activeId);
+  }
+  function shortRaceName(id) {
+    const s = String(id || '');
+    const i = s.lastIndexOf('/');
+    return (i >= 0 ? s.slice(i + 1) : s) || 'model';
+  }
+  function raceGridHtml(race) {
+    const racers = race.racers || [];
+    const n = racers.length;
+    const need = Math.max(1, Number(race.need) || 1);
+    const caption = (need > 1 ? ('first ' + need + ' of ' + n) : (n + ' launched'))
+      + (race.recut ? ' · recut' : '');
+    let cells = '';
+    for (let i = 0; i < racers.length; i++) {
+      const r = racers[i];
+      const win = race.phase === 'winner' && race.winner && r.model === race.winner;
+      const cls = 'racecell ' + (r.status || 'waiting') + (win ? ' winner' : '');
+      const chip = win ? 'winner' : (r.status || 'waiting');
+      let body = '';
+      if (r.status === 'failed') {
+        body = '<span class="racefail">' + escapeHtml(r.fail ? ('fail · ' + r.fail) : 'fail') + '</span>';
+      } else if (r.preview) {
+        body = '<div class="raceprev">' + escapeHtml(r.preview) + '</div>';
+      } else if (r.status === 'abandoned') {
+        body = '<div class="raceprev">abandoned</div>';
+      } else {
+        body = '<div class="raceprev"></div>';
+      }
+      cells += '<div class="' + cls + '"><div class="racehead"><span class="racename">'
+        + escapeHtml(r.short || shortRaceName(r.model)) + '</span><span class="racechip">'
+        + escapeHtml(chip) + '</span></div>' + body + '</div>';
+    }
+    let judge = '';
+    if (need > 1 && (race.phase === 'judging' || race.phase === 'winner')) {
+      const won = race.phase === 'winner' && race.winner;
+      const msg = won
+        ? ('goes to ' + shortRaceName(race.winner))
+        : ('looking at the ' + need + ' that made it back');
+      judge = '<div class="racejudge' + (won ? ' won' : '') + '"><div class="racejudge-lab">classifier</div>'
+        + '<div class="racejudge-msg">' + escapeHtml(msg)
+        + (won ? '' : ' <span class="dots"><span></span><span></span><span></span></span>')
+        + '</div></div>';
+    }
+    return '<div class="racewrap"><div class="racecaption">' + escapeHtml(caption) + '</div>'
+      + '<div class="racegrid n' + n + '">' + cells + '</div>' + judge + '</div>';
+  }
   function liveBubbleHtml() {
+    if (raceIsLive(streamRace)) return raceGridHtml(streamRace);
     if (streamBuf) {
       const trail = streamStatus && /^(RUN|READ|WRITE|EDIT|SPAWN|SEND|GLOB|GREP|MCP|FETCH|TODO|SERVE|PING|PEEK|MULTIEDIT|NOTEBOOK):/i.test(streamStatus)
         ? '<span class="ttrail">' + escapeHtml(streamStatus) + '</span>' : '';
@@ -4639,6 +4999,13 @@ const APP_HTML = `<!doctype html>
   function paintStream() {
     const b = document.getElementById('streamBubble');
     if (!b) { render(); return; }
+    if (raceIsLive(streamRace)) {
+      b.classList.add('raceboard');
+      b.innerHTML = liveBubbleHtml();
+      if (log.scrollHeight - log.scrollTop - log.clientHeight < 140) log.scrollTop = log.scrollHeight;
+      return;
+    }
+    b.classList.remove('raceboard');
     // Deltas stay as text; a silent wait paints dots + one mutating status
     // line so a 20–40s pay/model wait is obviously alive.
     if (streamBuf && !(streamStatus && /^(RUN|READ|WRITE|EDIT|SPAWN|SEND|GLOB|GREP|MCP|FETCH|TODO|SERVE|PING|PEEK|MULTIEDIT|NOTEBOOK):/i.test(streamStatus))) {
@@ -4654,17 +5021,50 @@ const APP_HTML = `<!doctype html>
     esId = id;
     streamBuf = '';
     streamStatus = '';
+    streamRace = null;
+    streamRaceId = id;
+    raceHandoff += 1;
     es = new EventSource('/stream/' + id);   // EventSource reconnects on its own
     es.onmessage = (e) => {
       let ev;
       try { ev = JSON.parse(e.data); } catch { return; }
-      if (ev.type === 'start') { streamBuf = ''; streamStatus = ev.detail || 'waiting on model…'; paintStream(); }
+      if (ev.type === 'start') {
+        streamBuf = '';
+        streamStatus = ev.detail || 'waiting on model…';
+        streamRace = null;
+        streamRaceId = id;
+        paintStream();
+      }
       else if (ev.type === 'status') { streamStatus = ev.detail || streamStatus; paintStream(); }
+      else if (ev.type === 'race') {
+        if (ev.race && ev.race.racers && ev.race.racers.length >= 2) {
+          streamRace = ev.race;
+          streamRaceId = id;
+        }
+        paintStream();
+      }
       else if (ev.type === 'delta') {
         streamBuf = ev.replace ? (ev.delta || '') : streamBuf + (ev.delta || '');
         paintStream();
       }
-      else if (ev.type === 'final' || ev.type === 'run-pending') { streamBuf = ''; streamStatus = ''; render(); }
+      else if (ev.type === 'final' || ev.type === 'run-pending') {
+        if (ev.type === 'final' && raceIsLive(streamRace)) {
+          paintStream();
+          const token = ++raceHandoff;
+          setTimeout(function () {
+            if (token !== raceHandoff) return;
+            streamBuf = '';
+            streamStatus = '';
+            streamRace = null;
+            render();
+          }, 420);
+          return;
+        }
+        streamBuf = '';
+        streamStatus = '';
+        streamRace = null;
+        render();
+      }
     };
     es.onerror = () => { /* EventSource retries; the 1.2s poll is the backstop */ };
   }
@@ -4721,6 +5121,12 @@ const APP_HTML = `<!doctype html>
 
   async function submit() {
     const task = inp.value.trim();
+    if (/^\/sitrep\b/i.test(task)) {
+      inp.value = '';
+      send.classList.remove('show');
+      openSitrep();
+      return;
+    }
     if ((!task && !pendingFiles.length && !pendingImages.length) || !activeId) return;
     inp.value = '';
     send.classList.remove('show');
@@ -4775,6 +5181,12 @@ const APP_HTML = `<!doctype html>
   function slashAccept(i) {
     const c = slashHits[i];
     if (!c) return;
+    if (c.name === '/sitrep') {
+      inp.value = '';
+      slashMenu.classList.remove('show');
+      openSitrep();
+      return;
+    }
     // Commands that take arguments keep the caret going; ones that don't are
     // ready to send, so don't make the user delete a trailing space.
     inp.value = c.name + (c.args ? ' ' : '');
@@ -4807,6 +5219,11 @@ const APP_HTML = `<!doctype html>
   plusBtn.addEventListener('click', (e) => { e.stopPropagation(); plusMenu.classList.toggle('show'); });
   document.addEventListener('click', () => plusMenu.classList.remove('show'));
   document.getElementById('attachBtn').addEventListener('click', (e) => { e.stopPropagation(); plusMenu.classList.remove('show'); fileInp.click(); });
+  document.getElementById('sitrepBtn').addEventListener('click', (e) => {
+    e.stopPropagation();
+    plusMenu.classList.remove('show');
+    openSitrep();
+  });
   fileInp.addEventListener('change', async () => {
     for (const f of Array.from(fileInp.files)) {
       const looksText = /^text\\//.test(f.type) || /\\.(txt|md|js|mjs|ts|tsx|jsx|py|json|css|html|csv|log|ya?ml|sh)$/i.test(f.name);
@@ -5325,6 +5742,7 @@ const server = http.createServer((req, res) => {
     res.end(t ? JSON.stringify({
       id: t.id, history: t.history, status: t.status,
       liveStatus: t.status === 'thinking' ? (t.liveStatus || '') : '',
+      liveRace: t.status === 'thinking' ? (t.liveRace || null) : null,
       lastRaceFail: t.lastRaceFail || null,
       workspacePort: workspacePort || 0, dir: t.dir || WORKSPACE_DIR,
     }) : '{}');
@@ -5365,6 +5783,7 @@ const server = http.createServer((req, res) => {
       res.writeHead(200, { 'content-type': 'application/json' });
       res.end('{"ok":true}');
       execCommand(command, cwd).then((output) => {
+        noteRunForCorpus(t.id, command, { cwd });
         entry.runStatus = 'done';
         entry.runOutput = output;
         saveThreads();
@@ -5417,6 +5836,8 @@ const server = http.createServer((req, res) => {
       // checking your spend or clearing a thread never costs anything.
       // /dir and /mode keep their own handlers below, untouched.
       if (t && /^\//.test(task.trim())) {
+        // Drawer-only. Never dump sitrep into the transcript.
+        if (/^\/sitrep\b/i.test(task.trim())) return;
         const handled = await handleSlash(task.trim(), t).catch((e) => `error: ${e.message}`);
         if (handled !== null && handled !== undefined) {
           t.history.push({ who: 'bot', text: handled });
@@ -5471,4 +5892,6 @@ export {
   isDoneReply, isTransientModelFail, isEmptyToolResult, enqueueAutoHop, childKickoff, findByName,
   attachChildDir, finishChildDir,
   lockWorktree, unlockWorktree, parsePrRef, fetchSpecsForOrigin, agentSlug,
+  filesForCorpus, noteFileForCorpus, noteRunForCorpus, resetFilesForCorpus,
+  filesForCorpusKeys, scheduleFilesForCorpus, inFlightChars, BIND_MIN_CHARS, KEEP_MAX,
 };