@songsid/agend 2.3.3 → 2.3.4-beta.10

package/dist/ui/shared/view-history.js

@@ -0,0 +1,438 @@
+// Claude history in the View (the user, hmsg-a8947a2c / hmsg-b4c7ccdf; leader cid-claude-history-build). Claude Code
+// draws on the alternate screen, so tmux keeps nothing above it: scrolling up in its View shows the conversation's
+// earlier part from its transcript (GET /api/pane/<name>?transcript=1, view-history.ts), drawn like Claude's own
+// Ctrl+O view — "❯" prompts on their band, "●" replies and tool calls, "⎿" results, diffs, long output folded — directly
+// above the live screen, under a faint divider.
+//
+// The look is sampled from the live screen the View already shows (samplePalette): the prompt band, the bullet and
+// result glyphs, the tool and diff colours, as this Claude version draws them; Claude 2.1.318's own values when the
+// screen has none of them. A glyph the page's fonts lack falls back (⏺ → ●, ⎿ → └, ❯ → >).
+//
+// Loaded on first use by panel-view.js (a lazy module of its own). A tab opened before an upgrade runs it with the old
+// shell, so it imports nothing but app-i18n.js's register/t (in every shell since #1408), registers its own words and
+// links its own stylesheet (/assets/view-history.css): nothing it needs lives in a long-lived module. A server without
+// the history (an older one answers the pane's text) makes `first()` say `unsupported`: the View stays as it was.
+import { register, t } from "./app-i18n.js";
+
+register("viewHistory", {
+  en: {
+    divider: "History above",
+    more: "… +{0} lines (click to expand)",
+    moreFailed: "Could not load the full text.",
+    cut: "… {0} more characters not shown",
+    capped: "Only the latest {0} steps are shown here.",
+  },
+  "zh-TW": {
+    divider: "以上是對話紀錄",
+    more: "… 還有 {0} 行（點一下展開）",
+    moreFailed: "無法載入完整內容。",
+    cut: "… 還有 {0} 個字元未顯示",
+    capped: "這裡只顯示最近 {0} 則紀錄。",
+  },
+});
+const w = (key, ...values) => t(`viewHistory.${key}`, ...values);
+
+/** About this many steps are kept on the page; older pages are not read past it. */
+export const HISTORY_STEP_CAP = 1000;
+
+// ── The palette, sampled from the live screen ──
+const BASE = ["#000000", "#cd3131", "#0dbc79", "#e5e510", "#2472c8", "#bc3fbc", "#11a8cd", "#e5e5e5"];
+const BRIGHT = ["#666666", "#f14c4c", "#23d18b", "#f5f543", "#3b8eea", "#d670d6", "#29b8db", "#ffffff"];
+function xterm256(n) {
+  if (n < 8) return BASE[n];
+  if (n < 16) return BRIGHT[n - 8];
+  if (n < 232) { n -= 16; const r = Math.floor(n / 36), g = Math.floor((n % 36) / 6), b = n % 6; const v = (x) => (x ? x * 40 + 55 : 0); return `rgb(${v(r)},${v(g)},${v(b)})`; }
+  const l = (n - 232) * 10 + 8; return `rgb(${l},${l},${l})`;
+}
+/** Claude Code 2.1.318's own look (captured from a real pane, dark theme): what is used when the screen shows none. */
+export const DEFAULT_PALETTE = Object.freeze({
+  promptGlyph: "❯", promptBand: xterm256(237), promptFg: xterm256(246), promptText: xterm256(231),
+  bullet: "●", replyFg: xterm256(231), toolFg: xterm256(114), failedFg: xterm256(203), runningFg: xterm256(246),
+  resultGlyph: "⎿", resultFg: xterm256(246),
+  delFg: xterm256(167), delBg: xterm256(52), addFg: xterm256(77), addBg: xterm256(22), errorFg: xterm256(203),
+});
+
+/** The screen's text as lines of runs: { text, fg, bg, bold } (colours as CSS, null when unset). */
+export function ansiRuns(text) {
+  const lines = [[]];
+  let fg = null, bg = null, bold = false, reverse = false;
+  const push = (chunk) => {
+    const parts = chunk.split("\n");
+    parts.forEach((part, i) => {
+      if (i > 0) lines.push([]);
+      if (!part) return;
+      let f = typeof fg === "number" ? (bold && fg < 8 ? BRIGHT[fg] : BASE[fg]) : fg;
+      let b = typeof bg === "number" ? BASE[bg] : bg;
+      if (reverse) [f, b] = [b, f];
+      lines[lines.length - 1].push({ text: part, fg: f, bg: b, bold });
+    });
+  };
+  const re = /\x1b\[([0-9;]*)m/g;
+  let last = 0, m;
+  while ((m = re.exec(text)) !== null) {
+    push(text.slice(last, m.index));
+    last = re.lastIndex;
+    const codes = m[1].split(";").filter((x) => x !== "").map(Number);
+    if (codes.length === 0) codes.push(0);
+    for (let i = 0; i < codes.length; i++) {
+      const c = codes[i];
+      if (c === 0) { fg = bg = null; bold = reverse = false; }
+      else if (c === 1) bold = true;
+      else if (c === 22) bold = false;
+      else if (c === 7) reverse = true;
+      else if (c === 27) reverse = false;
+      else if (c === 39) fg = null;
+      else if (c === 49) bg = null;
+      else if (c >= 30 && c <= 37) fg = c - 30;
+      else if (c >= 90 && c <= 97) fg = BRIGHT[c - 90];
+      else if (c >= 40 && c <= 47) bg = c - 40;
+      else if (c >= 100 && c <= 107) bg = BRIGHT[c - 100];
+      else if (c === 38 || c === 48) {
+        let col = null;
+        if (codes[i + 1] === 5) { col = xterm256(codes[i + 2]); i += 2; }
+        else if (codes[i + 1] === 2) { col = `rgb(${codes[i + 2] || 0},${codes[i + 3] || 0},${codes[i + 4] || 0})`; i += 4; }
+        if (c === 38) fg = col; else bg = col;
+      }
+    }
+  }
+  push(text.slice(last));
+  return lines;
+}
+
+const PROMPT_GLYPHS = "❯>›";
+const BULLETS = "●⏺";
+const RESULT_GLYPHS = "⎿└";
+/**
+ * How this Claude draws its conversation, read off the live screen (ANSI, as the View fetched it): each value found
+ * replaces the default; the most frequent wins where a screen shows several (a failed tool's red bullet among green).
+ */
+export function samplePalette(screen) { return sampleScreen(screen).palette; }
+/** samplePalette, and which of its values the screen gave (the rest are the defaults) — for the version audit. */
+export function sampleScreen(screen) {
+  const p = { ...DEFAULT_PALETTE };
+  const found = new Set();
+  const set = (k, v) => { if (v) { p[k] = v; found.add(k); } };
+  if (typeof screen !== "string" || !screen) return { palette: p, found: [] };
+  const tally = { toolFg: new Map(), replyFg: new Map() };
+  const count = (map, v) => { if (v) map.set(v, (map.get(v) || 0) + 1); };
+  let banded = false, glyphSeen = false;
+  for (const runs of ansiRuns(screen)) {
+    const textOf = runs.map((r) => r.text).join("");
+    const lead = textOf.length - textOf.trimStart().length;
+    // Find the run holding column `col` (and the offset in it).
+    const at = (col) => { let n = 0; for (const r of runs) { if (col < n + r.text.length) return r; n += r.text.length; } return null; };
+    const first = textOf.charAt(lead);
+    // A prompt: its glyph then a space, on a band (a past prompt) — or bare (the composer: the glyph only).
+    if (PROMPT_GLYPHS.includes(first) && textOf.charAt(lead + 1) === " " && !banded) {
+      const g = at(lead);
+      if (g && g.bg) {
+        banded = true; glyphSeen = true;
+        set("promptGlyph", first); set("promptBand", g.bg); set("promptFg", g.fg);
+        const rest = runs.slice(runs.indexOf(g) + 1).find((r) => r.text.trim());
+        if (rest) set("promptText", rest.fg);
+      } else if (!glyphSeen) { glyphSeen = true; set("promptGlyph", first); }
+      continue;
+    }
+    // A bullet at the line's start: a tool call ("● Name(" with the name bold) or a reply.
+    if (lead === 0 && BULLETS.includes(first) && textOf.charAt(1) === " ") {
+      set("bullet", first);
+      const g = at(0), next = at(2);
+      const tool = !!(next && next.bold) && /^. [^(]+\(/.test(textOf);
+      count(tool ? tally.toolFg : tally.replyFg, g && g.fg);
+      continue;
+    }
+    // A result: two spaces, its glyph.
+    if (lead === 2 && RESULT_GLYPHS.includes(first)) {
+      set("resultGlyph", first);
+      const g = at(2); if (g) set("resultFg", g.fg);
+      continue;
+    }
+    // A diff row: a line number then - or +, on a coloured background.
+    const row = /^\s+\d+\s?([-+])/.exec(textOf);
+    if (row) {
+      const g = at(textOf.indexOf(row[1], lead));
+      if (g && g.bg) { if (row[1] === "-") { set("delBg", g.bg); set("delFg", g.fg); } else { set("addBg", g.bg); set("addFg", g.fg); } }
+    }
+  }
+  const top = (map) => { let best = null, n = 0; for (const [k, v] of map) if (v > n) { best = k; n = v; } return best; };
+  set("toolFg", top(tally.toolFg));
+  set("replyFg", top(tally.replyFg));
+  return { palette: p, found: [...found] };
+}
+
+// ── Glyphs the page's fonts lack ──
+const FALLBACK = { "⏺": "●", "●": "*", "⎿": "└", "└": "|", "❯": ">", "›": ">" };
+const glyphCache = new Map();
+/**
+ * Whether `ch` draws as itself in `font` (a CSS font-family list): drawn next to a code point no font has, the two must
+ * differ. No canvas (a test page): assumed drawn.
+ */
+export function hasGlyph(ch, font, doc = typeof document !== "undefined" ? document : null) {
+  const key = `${ch}\u0000${font}`;
+  if (glyphCache.has(key)) return glyphCache.get(key);
+  let ok = true;
+  try {
+    const canvas = doc && doc.createElement ? doc.createElement("canvas") : null;
+    const ctx = canvas && typeof canvas.getContext === "function" ? canvas.getContext("2d") : null;
+    if (ctx && typeof ctx.getImageData === "function") {
+      canvas.width = 40; canvas.height = 40;
+      const draw = (c) => { ctx.clearRect(0, 0, 40, 40); ctx.font = `32px ${font}`; ctx.fillStyle = "#000"; ctx.textBaseline = "top"; ctx.fillText(c, 2, 2); return ctx.getImageData(0, 0, 40, 40).data; };
+      const a = draw(ch), none = draw("\u{10FFFD}");
+      ok = false;
+      for (let i = 3; i < a.length; i += 4) if (a[i] !== none[i]) { ok = true; break; }
+    }
+  } catch { ok = true; }
+  glyphCache.set(key, ok);
+  return ok;
+}
+/** The glyph as drawn on this page: itself, or its fallback when the fonts lack it. */
+export function drawable(ch, font, doc) {
+  let g = ch;
+  for (let i = 0; i < 3 && g && !hasGlyph(g, font, doc); i++) g = FALLBACK[g] || g;
+  return g;
+}
+
+// ── Which steps the live screen already shows ──
+// Text a needle is compared by: no whitespace (a wrap moves it) and no markdown marks (Claude draws them away).
+const squash = (s) => String(s).replace(/\x1b\[[0-9;]*m/g, "").replace(/[\s*_`#>│]/g, "");
+/**
+ * What of a prompt or a reply is looked for on the screen: its WHOLE text, normalised (#3069 review r3, Prism P2-2 — a
+ * fixed prefix, however long, is no proof: it can occur inside another message). None for a tool: Claude may draw it
+ * summarised.
+ */
+function needle(step) {
+  if (step.kind !== "user" && step.kind !== "assistant") return null;
+  const s = squash(step.body || "");
+  return s.length >= 4 ? s : null;
+}
+/**
+ * The steps before the live screen, matched conservatively (#3069 review, Prism P2-2): walking back from the newest,
+ * each prompt and reply must be found WHOLE on the screen, BEFORE the place the newer one was found — one occurrence
+ * never proves two messages, and a shared opening is never taken for the same message. The first one not found that
+ * way (a message only partly shown included), and everything older, is history. Tool calls go with their neighbours. Unsure means shown again: a
+ * step the screen shows may come twice — never one it does not show not at all.
+ */
+export function beforeScreen(steps, screen) {
+  const text = squash(screen || "");
+  let cut = steps.length, limit = text.length;
+  for (let i = steps.length - 1; i >= 0; i--) {
+    const n = needle(steps[i]);
+    if (n === null) continue;
+    const at = limit - n.length >= 0 ? text.lastIndexOf(n, limit - n.length) : -1;
+    if (at < 0) break;
+    limit = at;
+    cut = i;
+  }
+  return steps.slice(0, cut);
+}
+
+// ── Drawing ──
+const TOOL_WORDS = { Edit: "Update", MultiEdit: "Update", Grep: "Search", Glob: "Search", WebFetch: "Fetch", WebSearch: "Web Search", TodoWrite: "Update Todos", Agent: "Task", NotebookEdit: "Edit Notebook" };
+/** Claude's word for a tool, as its screen shows it ("Update" for Edit; "server - tool (MCP)" for an MCP tool). */
+export function toolWord(tool) {
+  const mcp = /^mcp__(.+?)__(.+)$/.exec(tool || "");
+  if (mcp) return `${mcp[1]} - ${mcp[2]} (MCP)`;
+  return TOOL_WORDS[tool] || tool || "?";
+}
+
+function el(doc, tag, cls, text) {
+  const e = doc.createElement(tag);
+  if (cls) e.className = cls;
+  if (text != null) e.textContent = text;
+  return e;
+}
+function span(doc, text, color, extra) {
+  const s = el(doc, "span", extra || null, text);
+  if (color) s.style.color = color;                     // CSSOM, never a style attribute (#1300)
+  return s;
+}
+/** A Read result's "12\tcode" lines as the terminal shows them ("  12  code"). */
+const unTab = (text, tool) => (tool === "Read" ? text.replace(/^(\d+)\t/gm, (_, n) => `${n.padStart(4)}  `) : text.replace(/\t/g, "  "));
+
+/** One step's block. `onMore`: the folded step, clicked. */
+export function drawStep(doc, step, pal, glyphs, onMore) {
+  const box = el(doc, "div", "vh-step");
+  box.dataset.step = step.id;
+  const line = (cls) => box.appendChild(el(doc, "div", `vh-line${cls ? ` ${cls}` : ""}`));
+  if (step.kind === "user") {
+    (step.body || "").split("\n").forEach((text, i) => {
+      const l = line("vh-prompt");
+      l.style.background = pal.promptBand;
+      l.appendChild(span(doc, i === 0 ? `${glyphs.prompt} ` : "  ", pal.promptFg));
+      l.appendChild(span(doc, text || " ", pal.promptText));
+    });
+    if (step.cut) line("vh-dim").textContent = `  ${w("cut", step.cut)}`;
+    return box;
+  }
+  if (step.kind === "assistant") {
+    (step.body || "").split("\n").forEach((text, i) => {
+      const l = line();
+      l.appendChild(i === 0 ? span(doc, `${glyphs.bullet} `, pal.replyFg) : span(doc, "  "));
+      l.appendChild(span(doc, text || " "));
+    });
+    if (step.cut) line("vh-dim").textContent = `  ${w("cut", step.cut)}`;
+    return box;
+  }
+  if (step.kind === "tool") {
+    const head = line();
+    const fg = step.status === "failed" ? pal.failedFg : step.status === "running" || step.status === "interrupted" ? pal.runningFg : pal.toolFg;
+    head.appendChild(span(doc, `${glyphs.bullet} `, fg));
+    head.appendChild(span(doc, toolWord(step.tool), null, "vh-b"));
+    head.appendChild(span(doc, step.subject ? `(${step.subject})` : ""));
+  }
+  // The result: "  ⎿  " then its first line; the rest under it — or the edit's diff rows.
+  const resultColor = step.kind === "error" || step.status === "failed" ? pal.errorFg : null;
+  let firstRow = true;
+  const mark = () => { const s = firstRow ? span(doc, `  ${glyphs.result}  `, pal.resultFg) : span(doc, "     "); firstRow = false; return s; };
+  if (step.diff) {
+    for (const h of step.diff) {
+      for (const [rows, sign, bg, fg] of [[h.del, "-", pal.delBg, pal.delFg], [h.add, "+", pal.addBg, pal.addFg]]) {
+        for (const text of rows) {
+          const l = line("vh-res");
+          l.appendChild(mark());
+          const row = span(doc, `${sign} ${text}`, fg, "vh-diff");
+          row.style.background = bg;
+          l.appendChild(row);
+        }
+      }
+    }
+  } else if (step.body != null && step.body !== "") {
+    for (const text of unTab(step.body, step.tool).split("\n")) {
+      const l = line("vh-res");
+      l.appendChild(mark());
+      l.appendChild(span(doc, text || " ", resultColor));
+    }
+  }
+  if (step.more) {
+    const l = line("vh-res");
+    l.appendChild(span(doc, "     "));
+    const b = el(doc, "button", "vh-more", w("more", step.more));
+    b.type = "button";
+    b.style.color = pal.resultFg;
+    b.addEventListener("click", () => onMore && onMore(step, box, b));
+    l.appendChild(b);
+  } else if (step.cut) line("vh-res vh-dim").textContent = `     ${w("cut", step.cut)}`;
+  return box;
+}
+
+/**
+ * The history above one agent's live screen. `fetch(url)` reads under the View's lease; `alive()` is false once the
+ * View moved on (nothing is drawn then). `root` is the block panel-view.js puts above the screen it shows.
+ */
+export function createHistory({ name, fetch, alive = () => true, doc = document, font = "monospace", cols = 0 }) {
+  ensureStylesheet(doc);
+  const root = el(doc, "div", "vh");
+  root.setAttribute("data-trust", "panel-content");
+  if (cols > 0) root.style.width = `${cols}ch`;
+  const pages = el(doc, "div", "vh-pages");
+  const capNote = el(doc, "div", "vh-cap");
+  const divider = el(doc, "div", "vh-divider", w("divider"));
+  divider.setAttribute("role", "separator");
+  root.append(pages, divider);
+  let pal = DEFAULT_PALETTE, glyphs = null;
+  let key = null, before = null, shown = 0, busy = false;
+  const base = `/api/pane/${encodeURIComponent(name)}?transcript=1`;
+  const read = async (query) => {
+    const r = await fetch(`${base}${query}`);
+    // An older server answers the pane's text here: not this history.
+    const type = r.headers && typeof r.headers.get === "function" ? String(r.headers.get("Content-Type") || "") : "";
+    if (!r.ok) return { failed: true, status: r.status };
+    if (!type.includes("application/json")) return { unsupported: true };
+    const body = await r.json();
+    if (!body || body.view_history !== 1) return { unsupported: true };
+    return body;
+  };
+  const block = (steps, end) => {
+    const frag = doc.createDocumentFragment();
+    for (const s of steps) {
+      const b = drawStep(doc, s, pal, glyphs, more);
+      b.dataset.end = String(end);
+      frag.appendChild(b);
+    }
+    return frag;
+  };
+  async function more(step, box, button) {
+    if (button.disabled) return;
+    button.disabled = true;
+    try {
+      const body = await read(`&step=${encodeURIComponent(step.id)}&end=${encodeURIComponent(box.dataset.end)}&key=${encodeURIComponent(key || "")}`);
+      if (!alive()) return;
+      if (!body.supported || !body.step) throw new Error("gone");
+      const whole = drawStep(doc, body.step, pal, glyphs, more);
+      whole.dataset.end = box.dataset.end;
+      box.replaceWith(whole);
+    } catch {
+      if (!alive()) return;
+      button.disabled = false;
+      if (!box.querySelector(".vh-more-failed")) button.parentNode.insertBefore(span(doc, `  ${w("moreFailed")}`, pal.errorFg, "vh-more-failed"), button.nextSibling);
+    }
+  }
+  return {
+    root,
+    /** Older steps exist and the cap is not reached. */
+    hasOlder: () => before !== null && shown < HISTORY_STEP_CAP,
+    /**
+     * The newest page, minus what the live `screen` (ANSI) shows. "ok" | "empty" (nothing before the screen) |
+     * "unsupported" (no history here) | "failed" (with `status`).
+     */
+    async first(screen) {
+      pal = samplePalette(screen);
+      glyphs = { prompt: drawable(pal.promptGlyph, font, doc), bullet: drawable(pal.bullet, font, doc), result: drawable(pal.resultGlyph, font, doc) };
+      let body;
+      try { body = await read(""); } catch { return { kind: "failed", status: 0 }; }
+      if (body.failed) return { kind: "failed", status: body.status };
+      if (body.unsupported) return { kind: "unsupported" };
+      // No history here at all (not Claude, or no reader) — or none YET (a session that has written nothing so far):
+      // that one is only nothing earlier, asked again next time.
+      if (!body.supported) return { kind: body.reason === "unsupported" || body.reason === "unavailable" ? "unsupported" : "empty" };
+      key = body.key; before = body.before;
+      let steps = beforeScreen(body.steps || [], screen);
+      let end = body.end;
+      // Everything in the newest page is on the screen: the page before it is the history.
+      if (!steps.length && before !== null) {
+        let older;
+        try { older = await read(`&before=${before}&key=${encodeURIComponent(key)}`); } catch { older = { failed: true, status: 0 }; }
+        if (!older.failed && older.supported && !older.reset) { steps = older.steps || []; before = older.before; end = older.end; }
+      }
+      if (!alive()) return { kind: "failed", status: 0 };
+      if (!steps.length) return { kind: "empty" };
+      pages.replaceChildren(block(steps, end));
+      shown = steps.length;
+      return { kind: "ok" };
+    },
+    /** The page before what is shown, drawn above it. "ok" | "none" | "capped" | "failed". */
+    async older() {
+      if (busy) return { kind: "none" };
+      if (before === null) return { kind: "none" };
+      if (shown >= HISTORY_STEP_CAP) {
+        if (!capNote.isConnected) { capNote.textContent = w("capped", HISTORY_STEP_CAP); root.prepend(capNote); }
+        return { kind: "capped" };
+      }
+      busy = true;
+      try {
+        const body = await read(`&before=${before}&key=${encodeURIComponent(key || "")}`);
+        if (!alive()) return { kind: "failed" };
+        if (body.failed || body.unsupported || !body.supported) return { kind: "failed" };
+        // Another transcript now (a new session): what is shown stays; nothing older of it.
+        if (body.reset) { before = null; return { kind: "none" }; }
+        before = body.before;
+        const steps = body.steps || [];
+        if (steps.length) { pages.prepend(block(steps, body.end)); shown += steps.length; }
+        return { kind: "ok" };
+      } catch { return { kind: "failed" }; }
+      finally { busy = false; }
+    },
+  };
+}
+
+/** This module's own stylesheet, linked once (a tab opened before an upgrade has an app.css without these rules). */
+function ensureStylesheet(doc) {
+  try {
+    if (!doc.head || doc.querySelector('link[data-vh="1"]')) return;
+    const link = doc.createElement("link");
+    link.setAttribute("rel", "stylesheet");
+    link.setAttribute("href", "/assets/view-history.css");
+    link.setAttribute("data-vh", "1");
+    doc.head.appendChild(link);
+  } catch { /* the history still reads without it */ }
+}

package/dist/ui/shared/view-strings.js

@@ -154,6 +154,14 @@ register("view", {
   "usage.stale.transient": "not updated · cached at {0}",
   "usage.stale.error": "couldn't read · cached at {0}",
   "usage.metric.reset_since": "reset since {0}",
+  "usage.capacity.line": "100% ≈ {0} ({1}–{2}) · ≈ {3} tokens · from {4} weeks",
+  "usage.capacity.line_tokens": "100% ≈ {0} tokens ({1}–{2}) · from {3} weeks",
+  "usage.capacity.not_enough": "Not enough usage yet to measure 100% (Δ {0}% of 10%)",
+  "usage.capacity.only_agend": "Counts only this fleet's agents; use of the same account elsewhere makes this low.",
+  "usage.capacity.mixed": "Bases disagree — possibly used outside this fleet",
+  "usage.capacity.best_fit_api": "API-equivalent fits best: ±{0}% across {1} weeks",
+  "usage.capacity.best_fit_output": "Output tokens fit best: ±{0}% across {1} weeks",
+  "usage.capacity.best_fit_all": "All tokens fit best: ±{0}% across {1} weeks",
   "usage.error.http": "Usage request failed (HTTP {0}).",
   "usage.error.billing_http": "Billing request failed (HTTP {0}).",
   "usage.error.invalid_response": "Invalid response from usage endpoint.",
@@ -215,6 +223,20 @@ register("view", {
   "guestNeedsTrustedHint": "Your host gave you chat access to this agent. Ask them to make you Trusted in Settings → Guests.",
   "noInstances": "No instances yet",
   "paneUnavailable": "This instance's terminal is not available (is it stopped?)",
+  // M-2262: the terminal's scrollback.
+  "earlier": "Earlier output",
+  "earlierHint": "Scroll up to read what has scrolled off. Live output keeps coming in below.",
+  "loadingEarlier": "Loading earlier output…",
+  "earlierFailed": "Could not load earlier output.",
+  "noEarlier": "This CLI redraws its whole screen, so the terminal keeps no earlier output to scroll back to.",
+  "nothingEarlier": "Nothing has scrolled off the screen yet.",
+  // The words' mark (panel-view.js VIEW_REV, the same in both languages): a tab with older words reads these again.
+  "rev": "2",
+  "earlierInLog": "Earlier output is in the Log tab",
+  "logTabOff": "Earlier output: the Log tab is off. Turn it on in Settings",
+  "readingEarlier": "Reading earlier output. Live output continues; scroll to the bottom to follow it again.",
+  "jumpLatest": "Jump to latest",
+  "newBelow": "New output below",
   "rosterFailedShort": "The instance list could not be loaded.",
   "collapseGroup": "Fold {group}",
   "expandGroup": "Open {group}",
@@ -400,6 +422,14 @@ register("view", {
   "usage.stale.transient": "暫時無法更新 · 快取於 {0}",
   "usage.stale.error": "讀取失敗 · 快取於 {0}",
   "usage.metric.reset_since": "已於 {0} 重置",
+  "usage.capacity.line": "100% ≈ {0}（{1}–{2}）· 約 {3} token · 依 {4} 週",
+  "usage.capacity.line_tokens": "100% ≈ {0} token（{1}–{2}）· 依 {3} 週",
+  "usage.capacity.not_enough": "用量還不夠估算 100%（已用 Δ {0}%，需 10%）",
+  "usage.capacity.only_agend": "只計算這個 fleet 的 agent；同一帳號在別處的使用會讓這個值偏低。",
+  "usage.capacity.mixed": "各換算方式不一致——可能有 fleet 以外的使用",
+  "usage.capacity.best_fit_api": "「API 等值」最吻合：{1} 週內 ±{0}%",
+  "usage.capacity.best_fit_output": "「輸出 token」最吻合：{1} 週內 ±{0}%",
+  "usage.capacity.best_fit_all": "「全部 token」最吻合：{1} 週內 ±{0}%",
   "usage.error.http": "用量請求失敗（HTTP {0}）。",
   "usage.error.billing_http": "計費請求失敗（HTTP {0}）。",
   "usage.error.invalid_response": "用量端點回傳了無效資料。",
@@ -461,6 +491,18 @@ register("view", {
   "guestNeedsTrustedHint": "主人給你的是這個 agent 的聊天權限。請他在設定 → 訪客把你改成「信任」。",
   "noInstances": "還沒有 instance",
   "paneUnavailable": "無法取得這個 instance 的終端畫面（它是否已停止？）",
+  "earlier": "較早的輸出",
+  "earlierHint": "往上捲動可以看到已經捲走的內容，新的輸出會繼續出現在下方。",
+  "loadingEarlier": "正在載入較早的輸出…",
+  "earlierFailed": "無法載入較早的輸出。",
+  "noEarlier": "這個 CLI 會重繪整個畫面，終端沒有保留可以往上捲動的較早輸出。",
+  "nothingEarlier": "還沒有內容捲出畫面。",
+  "rev": "2",
+  "earlierInLog": "較早的輸出在「紀錄」分頁",
+  "logTabOff": "較早的輸出：「紀錄」分頁目前關閉，請到設定開啟",
+  "readingEarlier": "正在看較早的輸出。新的輸出仍會繼續；捲到最下面即可再次跟著最新內容。",
+  "jumpLatest": "跳到最新",
+  "newBelow": "下方有新的輸出",
   "rosterFailedShort": "無法載入 instance 清單。",
   "collapseGroup": "收合 {group}",
   "expandGroup": "展開 {group}",

package/dist/ui/shared/web-authorize.js

@@ -15,6 +15,7 @@ register("webauth", {
     reason_disabled: "Web authority is turned off.",
     reason_loopback_only: "Only this computer can authorize, and this browser is not on it.",
     reason_no_account: "This browser was not signed in as an account (agend web): sign in with /web to authorize.",
+    reason_host_sign_in: "To speak as this computer's admin, sign in again on this computer with agend web --code.",
     reason_not_admin: "Your account is not a fleet admin here.",
     reason_not_admin_session: "Guests can't authorize.",
     reason_token_rotated: "The dashboard's token changed: sign in again.",
@@ -43,6 +44,7 @@ register("webauth", {
     reason_disabled: "網頁授權已關閉。",
     reason_loopback_only: "只有這台電腦可以授權，而這個瀏覽器不在這台電腦上。",
     reason_no_account: "這個瀏覽器不是用帳號登入的（agend web）：請用 /web 登入後再授權。",
+    reason_host_sign_in: "要以這台電腦的管理者身分發言，請在這台電腦上執行 agend web --code 重新登入。",
     reason_not_admin: "你的帳號在這裡不是 fleet 管理者。",
     reason_not_admin_session: "訪客無法授權。",
     reason_token_rotated: "儀表板的 token 已變更：請重新登入。",
@@ -66,7 +68,7 @@ register("webauth", {
 const tn = (k, ...v) => t(`webauth.${k}`, ...v);
 // The switch and "Only this computer" are changed in Settings on this computer — never over the public link (#2525 review).
 const fixable = (reason) => (reason === "disabled" || reason === "loopback_only") && globalThis.document?.body?.dataset?.publicLink !== "1";
-const REASONS = ["disabled", "loopback_only", "no_account", "not_admin", "not_admin_session", "token_rotated", "public_link", "named_link_off", "quick_link_off", "not_session"];
+const REASONS = ["disabled", "loopback_only", "no_account", "host_sign_in", "not_admin", "not_admin_session", "token_rotated", "public_link", "named_link_off", "quick_link_off", "not_session"];
 // Until when: the time, with the day when it isn't today (an authorization lasts up to 48 h).
 const clock = (ms) => {
   const d = new Date(ms), today = new Date().toDateString() === d.toDateString();

package/dist/unattended-install.d.ts

@@ -0,0 +1,6 @@
+/** Runs `$1` detached from any terminal, at low priority; HUP/INT/TERM on this shell reach its whole process group. */
+export declare const UNATTENDED_INSTALL_SCRIPT: string;
+/** The account's login shell, when it is an absolute path to an executable; else undefined (keep the inherited one). */
+export declare function loginShell(read?: () => string | null | undefined): Promise<string | undefined>;
+/** The window's command for an install command. `shell`: the $SHELL to give it; null keeps the inherited one. */
+export declare function unattendedInstallCommand(command: string, shell?: string | null): string;

package/dist/unattended-install.js

@@ -0,0 +1,79 @@
+/**
+ * M-2281 (#2980): how `/login` runs a CLI's installer in its window — nobody types there, so nothing may wait for
+ * an answer, and the install must not starve the fleet that is still serving every chat.
+ *
+ * - **No terminal to ask on.** `setsid -w` gives the install a session of its own with no controlling terminal, so
+ *   `/dev/tty` cannot be opened, and stdin is `/dev/null`. A prompt that asks there (codex's "Start Codex now?",
+ *   kiro's "replace it?", sudo's password) fails at once instead of waiting out the session timeout. Without
+ *   `setsid` (macOS has none), stdin is still `/dev/null`. The same wrapper install-agend.ps1 uses (#2583).
+ * - **Low priority.** `nice -n 10`, plus `ionice -c2 -n7` where it exists and is permitted: a ~0.5 GB download and
+ *   unpack (codex 0.166) yields CPU and disk to the fleet and its CLIs.
+ * - **Stoppable.** The install's own session is not the window's, so closing the window (cancel, timeout, fleet
+ *   stop) would not reach it: the window's shell forwards HUP/INT/TERM to the install's whole process group.
+ * - **The user's shell.** Installers pick the rc file for their PATH line from `$SHELL`; the window inherits the
+ *   tmux server's environment, where it may be missing (a service). The account's login shell is passed, so the
+ *   line lands in the file the user's own terminals read.
+ *
+ * - **Its verdict is kept.** In a tmux pane it starts once remain-on-exit is on (see the script): an install that ends
+ *   at once still leaves a dead pane with its exit code and output for the session to judge.
+ *
+ * The exit code is the install's own: the session judges success by it.
+ */
+import { userInfo } from "node:os";
+import { isAbsolute } from "node:path";
+import { shellQuote } from "./backend/types.js";
+import { spawnProbeCommand, PROBE_DEADLINE_MS } from "./binary-probe.js";
+/** Runs `$1` detached from any terminal, at low priority; HUP/INT/TERM on this shell reach its whole process group. */
+export const UNATTENDED_INSTALL_SCRIPT = [
+    // In a tmux pane, start only once AgEnD has set remain-on-exit on the window (at most ~10 s): an install that fails
+    // at once — a prompt with no terminal does — would otherwise close the window before it is set, taking its exit code
+    // and output with it. Outside tmux ($TMUX_PANE unset) there is nothing to wait for.
+    'if [ -n "${TMUX_PANE:-}" ] && command -v tmux >/dev/null 2>&1; then i=0; while [ "$(tmux show-options -wqv -t "$TMUX_PANE" remain-on-exit 2>/dev/null)" != on ] && [ $i -lt 100 ]; do sleep 0.1; i=$((i+1)); done; fi',
+    'P=""',
+    'if command -v ionice >/dev/null 2>&1 && ionice -c2 -n7 true >/dev/null 2>&1; then P="ionice -c2 -n7"; fi',
+    'if command -v setsid >/dev/null 2>&1; then setsid -w nice -n 10 $P sh -c "$1" </dev/null & else nice -n 10 $P sh -c "$1" </dev/null & fi',
+    "pid=$!",
+    // `kill -TERM -$pid`, not `kill -- -$pid`: dash's kill refuses `--` ("Illegal number"). Before setsid has run there is
+    // no such group yet, and the plain pid is what exists.
+    "trap 'kill -TERM -$pid 2>/dev/null || kill -TERM $pid 2>/dev/null; exit 129' HUP INT TERM",
+    'wait "$pid"',
+].join("\n");
+/** The account's login shell, when it is an absolute path to an executable; else undefined (keep the inherited one). */
+export async function loginShell(read = () => userInfo().shell) {
+    let shell;
+    try {
+        shell = read();
+    }
+    catch {
+        return undefined;
+    }
+    if (!shell || !isAbsolute(shell))
+        return undefined;
+    // Child `sh` `[ -f && -x ]`, same as resolveBackendBinary's install-dir probe: an accessSync on a dead mount
+    // can hang a pool thread forever (#3009); a child can be killed (binary-probe.ts).
+    const child = spawnProbeCommand("sh", ["-c", '[ -f "$1" ] && [ -x "$1" ] && echo "$1"', "sh", shell]);
+    let timer;
+    try {
+        const found = await Promise.race([
+            child.answer,
+            new Promise((r) => {
+                timer = setTimeout(() => { child.kill(); r(undefined); }, PROBE_DEADLINE_MS);
+                timer.unref?.();
+            }),
+        ]);
+        return found ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/** The window's command for an install command. `shell`: the $SHELL to give it; null keeps the inherited one. */
+export function unattendedInstallCommand(command, shell = null) {
+    const env = shell ? `SHELL=${shellQuote(shell)} ` : "";
+    return `${env}sh -c ${shellQuote(UNATTENDED_INSTALL_SCRIPT)} agend-install ${shellQuote(command)}`;
+}
+//# sourceMappingURL=unattended-install.js.map

package/dist/unattended-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unattended-install.js","sourceRoot":"","sources":["../src/unattended-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,uHAAuH;AACvH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,oHAAoH;IACpH,qHAAqH;IACrH,oFAAoF;IACpF,uNAAuN;IACvN,MAAM;IACN,0GAA0G;IAC1G,0IAA0I;IAC1I,QAAQ;IACR,uHAAuH;IACvH,uDAAuD;IACvD,2FAA2F;IAC3F,aAAa;CACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,wHAAwH;AACxH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAI,GAAoC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK;IAC7F,IAAI,KAAgC,CAAC;IACrC,IAAI,CAAC;QAAC,KAAK,GAAG,IAAI,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;IACnD,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,6GAA6G;IAC7G,mFAAmF;IACnF,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACtG,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAC/B,KAAK,CAAC,MAAM;YACZ,IAAI,OAAO,CAAY,CAAC,CAAC,EAAE,EAAE;gBAC3B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;gBAC7E,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAClB,CAAC,CAAC;SACH,CAAC,CAAC;QACH,OAAO,KAAK,IAAI,SAAS,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,KAAK,GAAkB,IAAI;IACnF,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO,GAAG,GAAG,SAAS,UAAU,CAAC,yBAAyB,CAAC,kBAAkB,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;AACrG,CAAC"}