@bli-cockpit/cli 0.2.224 → 0.2.237

package/dist/commands/mail.js

@@ -278,7 +278,7 @@ async function send(command, door) {
         body: message.body,
     });
     if (!answer.ok)
-        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+        return failAgentDoor(door, TAG, answer.httpStatus ? answer.reason : "send_outcome_unknown", answer.httpStatus ? answer.detail : "The send receipt was lost. Check Sent before sending again; Tower will not retry automatically.");
     const sent = answer.body.sent;
     // Report only what the door's receipt shows (BLI-12661), never what was posted.
     const unconfirmed = unconfirmedAttachments(message.receipt, sent?.attachments, "send");
@@ -339,8 +339,8 @@ async function sync(command, door) {
         writeLine(door.io.stdout, "Tower answered without a run. Nothing to report.");
         return 0;
     }
-    if (run.reason === "ok") {
-        writeLine(door.io.stdout, `Synced: ${run.messagesAdded} new, ${run.messagesUpdated} updated, ${run.messagesDeleted} gone.`);
+    if (["ok", "quota_deferred", "history_gap", "interrupted"].includes(run.reason)) {
+        writeLine(door.io.stdout, `Sync pass: ${run.messagesAdded} new, ${run.messagesUpdated} updated, ${run.messagesDeleted} gone. ${run.reason}${run.coverage?.complete === false ? "; more work remains" : ""}.`);
         return 0;
     }
     // A failure names itself; the exit code says it failed.
@@ -367,11 +367,13 @@ async function syncStatus(command, door) {
         return 0;
     }
     for (const account of accounts) {
+        const coverage = account.last_run?.coverage;
+        const coverageLine = coverage ? `  requested=${coverage.requested} returned=${coverage.returned} unique=${coverage.unique} pending=${coverage.pending} complete=${coverage.complete}` : "";
         const lastRun = account.last_run
             ? `${account.last_run.reason} @ ${account.last_run.started_at} (${account.last_run.items} item(s))`
             : "never synced";
         const lag = account.lag ? `${account.lag.lag_seconds}s` : "unknown";
-        writeLine(door.io.stdout, `${account.address}  last_success=${account.last_success_at ?? "never"}  last_run=${lastRun}  failures_24h=${account.failures_24h}  lag=${lag}${account.data_incomplete ? "  (partial read)" : ""}`);
+        writeLine(door.io.stdout, `${account.address}  last_success=${account.last_success_at ?? "never"}  last_run=${lastRun}  failures_24h=${account.failures_24h}  lag=${lag}${account.data_incomplete ? "  (partial read)" : ""}${coverageLine}`);
     }
     return 0;
 }

package/dist/commands/memory-exam.js

@@ -0,0 +1,47 @@
+/**
+ * `cockpit memory exam` - the nightly memory exam score (BLI-19249).
+ *
+ * A READ of `GET /api/memory/exam`, with this machine's device token, through `agent-door.ts`: the same door the
+ * `memory_exam` MCP tool calls. The exam itself is a step of the nightly `memory-consolidate` Railway job. Output: the
+ * one line (purity, graded of planned, trend, worst project); `--misses` adds the missed questions with their reason
+ * label, true answer and fix status. The rows are the owner's own words, so no one else reads them, a super admin
+ * included; a caller with no exam gets `no exam yet`, never somebody else's night. Logs carry counts only.
+ */
+import { askAgentDoor, emitAgentDoor, failAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+const TAG = "[memory cli]";
+const READ_DEADLINE_MS = 30_000;
+export async function runMemoryExam(command, door) {
+    const params = new URLSearchParams();
+    if (command.night)
+        params.set("night", command.night);
+    if (command.misses)
+        params.set("misses", "1");
+    const query = params.size > 0 ? `?${params.toString()}` : "";
+    const answer = await askAgentDoor(door, { path: `/api/memory/exam${query}`, method: "GET", label: "memory exam", timeoutMs: READ_DEADLINE_MS });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    const body = answer.body;
+    writeLine(door.io.stderr, `${TAG} exam ${JSON.stringify({ reason: body.reason ?? "exam_read", night: body.latest?.night ?? null, previous_nights: body.previous?.length ?? 0, misses: body.misses?.length ?? null })}`);
+    if (door.json)
+        return emitAgentDoor(door, answer.body);
+    if (!body.latest || !body.line) {
+        writeLine(door.io.stdout, body.reason === "night_not_found"
+            ? `No exam is recorded for ${command.night ?? "that night"}.`
+            : "No memory exam yet. It runs as the last step of the nightly memory-consolidate job; nothing has been recorded for you.");
+        return 0;
+    }
+    const { latest } = body;
+    writeLine(door.io.stdout, body.line);
+    for (const detail of body.detail ?? [])
+        writeLine(door.io.stdout, detail);
+    const reasons = Object.entries(latest.missReasons ?? {}).map(([label, count]) => `${label} ${count}`).join(", ");
+    writeLine(door.io.stdout, `Mode ${latest.mode ?? "report"}; spent $${Number(latest.costUsd ?? 0).toFixed(4)}; misses: ${reasons || "none"}.`);
+    for (const miss of body.misses ?? []) {
+        writeLine(door.io.stdout, `  #${miss.ordinal ?? "?"} [${miss.source ?? "?"}${miss.project ? ` / ${miss.project}` : ""}] ${miss.reason ?? "no reason"}${miss.fixStatus ? ` (${miss.fixKind ?? "fix"}: ${miss.fixStatus})` : ""}`);
+        writeLine(door.io.stdout, `      asked: ${miss.question ?? ""}`);
+        writeLine(door.io.stdout, `      truth: ${miss.expected ?? ""}`);
+        writeLine(door.io.stdout, `      said:  ${miss.answer ?? "(no answer)"}`);
+    }
+    return 0;
+}

package/dist/commands/memory-repeats.js

@@ -0,0 +1,44 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+/** A whole number inside a range, or a refusal that names the flag. */
+function bounded(flag, raw, min, max) {
+    if (raw === undefined)
+        return undefined;
+    if (!/^\d+$/.test(raw) || Number(raw) < min || Number(raw) > max)
+        throw new Error(`${flag} must be between ${min} and ${max}.`);
+    return Number(raw);
+}
+/** BLI-19253: `cockpit memory repeats [--project <name>] [--min <n>] [--limit <n>] [--json]`. */
+export function parseMemoryRepeatsArgs(args) {
+    const values = parseNamedArgs(args, { allowedFlags: ["--project", "--min", "--limit", "--json", "--home", "--dashboard-url"], valueFlags: ["--project", "--min", "--limit", "--home", "--dashboard-url"] });
+    if (values.positionals.slice(1).length)
+        throw new Error("memory repeats takes no positionals; use --project, --min and --limit.");
+    return { kind: "memory-store", action: "repeats", containerTags: [], project: optionalNonEmpty(values.flags.get("--project")),
+        minCount: bounded("--min", values.flags.get("--min"), 2, 50), limit: bounded("--limit", values.flags.get("--limit"), 1, 200), json: values.booleans.has("--json"),
+        homeDir: optionalNonEmpty(values.flags.get("--home")), dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")) };
+}
+export async function runMemoryRepeats(command, door) {
+    const params = new URLSearchParams();
+    if (command.project)
+        params.set("project", command.project);
+    if (command.minCount !== undefined)
+        params.set("min", String(command.minCount));
+    if (command.limit !== undefined)
+        params.set("limit", String(command.limit));
+    const query = params.toString();
+    const answer = await askAgentDoor(door, { method: "GET", path: `/api/memory/repeats${query ? `?${query}` : ""}`, label: "memory repeats", timeoutMs: 60_000 });
+    if (!answer.ok)
+        return failAgentDoor(door, "[memory repeats cli]", answer.reason, answer.detail);
+    const body = answer.body;
+    writeLine(door.io.stderr, `[memory repeats cli] answered ${JSON.stringify({ reason: body.capped ? "capped" : "exhausted", requested: body.requested, returned: body.returned })}`);
+    if (door.json)
+        return emitAgentDoor(door, body);
+    writeLine(door.io.stdout, body.words);
+    for (const repeat of body.repeats)
+        writeLine(door.io.stdout, `- ${repeat.line}${repeat.project ? ` [${repeat.project}]` : ""}`);
+    for (const row of body.coverage)
+        writeLine(door.io.stdout, `${row.label}: ${row.labelled.toLocaleString("en-US")} memories, ${row.grouped.toLocaleString("en-US")} grouped by subject`);
+    writeLine(door.io.stdout, `As of ${body.asOf}.${body.capped ? " Result capped; raise --limit (max 200)." : ""}`);
+    return 0;
+}

package/dist/commands/memory-search-print.js

@@ -0,0 +1,95 @@
+/**
+ * How `cockpit memory search` prints its rows (split out of `memory-store.ts`, which is at the file-length ceiling).
+ *
+ * A merged memory prints its originals under it (BLI-19246); an original found by an exact-detail question prints as
+ * its own row, tagged. One already printed as its own row is not repeated under its merged sentence.
+ */
+import { memoryProjectPrefix } from "./memory-project-label.js";
+import { writeLine } from "./cli-io.js";
+/** One terminal line: newlines folded, so a long memory cannot break the listing. */
+export function oneLine(value) {
+    return String(value ?? "").replace(/\s+/g, " ").trim();
+}
+/** `[87%] ` when the row was found by meaning, empty when it was a keyword hit. */
+function similarityLabel(row) {
+    const channels = row["channels"];
+    if (Array.isArray(channels) && !channels.includes("semantic"))
+        return "";
+    const similarity = Number(row["similarity"]);
+    return Number.isFinite(similarity) && similarity >= 0 && similarity <= 1
+        ? `[${Math.round(similarity * 100)}%] `
+        : "";
+}
+/**
+ * BLI-12927: memory is public across the team, so a hit can be a teammate's.
+ * `  filed by Edward on 2026-09-14` ahead of nothing when it is the caller's own.
+ */
+function filedByLabel(row) {
+    const name = typeof row["savedBy"] === "string" ? row["savedBy"].trim() : "";
+    if (!name)
+        return "";
+    const filed = typeof row["createdAt"] === "string" ? new Date(row["createdAt"]) : null;
+    const day = filed && !Number.isNaN(filed.getTime()) ? filed.toISOString().slice(0, 10) : null;
+    return day ? `  filed by ${name} on ${day}` : `  filed by ${name}`;
+}
+/** `, true from 2026-07-01 to 2026-09-01`, or nothing when the door sent no window. */
+function windowText(row) {
+    return typeof row["window"] === "string" && row["window"] ? `, ${row["window"]}` : "";
+}
+export function printSearchRows(out, results) {
+    const printed = new Set(results.filter((entry) => entry["original"] === true || entry["earlierVersion"] === true).map((entry) => String(entry["id"])));
+    for (const row of results) {
+        const head = row["original"] === true
+            ? `(original, merged into ${String(row["successorId"] ?? "?")}) `
+            : row["earlierVersion"] === true
+                // BLI-19247: a fact a newer one replaced, with when it was true.
+                ? `(earlier version${windowText(row)}, replaced by ${String(row["successorId"] ?? "?")}) `
+                : similarityLabel(row);
+        writeLine(out, `${head}${memoryProjectPrefix(row)}${oneLine(row["memory"])}`);
+        writeLine(out, `    ${String(row["id"] ?? "")}  ${String(row["containerTag"] ?? "")}${filedByLabel(row)}`);
+        printOriginals(out, row, printed);
+        printSource(out, row["source"], "    ");
+    }
+}
+/** Why a source gave no text, in words (BLI-19255). */
+const SOURCE_STATUS_WORDS = {
+    no_pointer: "this memory names no source",
+    unsupported_source: "it was imported from another store, so there is no raw source here",
+    needs_rls_client: "no session the database can attribute to you; run `cockpit login` again",
+    not_readable: "the source belongs to someone else and you may not read it",
+    missing: "the source is no longer available",
+    too_large: "the stored session is too large to read for an excerpt",
+    redaction_stub: "only a redaction stub was stored for that session",
+    fact_not_found: "the source was read and does not contain this fact",
+    budget: "reading the source ran out of time",
+    read_failed: "the archive did not answer",
+};
+/** The verbatim stretch of the raw session or note behind a memory, or the reason there is none (BLI-19255). */
+export function printSource(out, source, indent) {
+    if (!source)
+        return;
+    const excerpt = (source["excerpt"] ?? null);
+    if (source["status"] !== "excerpt" || !excerpt) {
+        writeLine(out, `${indent}source not shown: ${SOURCE_STATUS_WORDS[String(source["status"])] ?? String(source["status"])}.`);
+        return;
+    }
+    const kind = source["type"] === "meeting_note" ? "meeting note" : "session";
+    writeLine(out, `${indent}source, verbatim from the ${kind} (lines ${String(excerpt["startLine"])}-${String(excerpt["endLine"])} of ${String(excerpt["totalLines"])}):`);
+    for (const line of String(excerpt["text"] ?? "").split("\n"))
+        writeLine(out, `${indent}  | ${line}`);
+}
+function printOriginals(out, row, alreadyPrinted) {
+    const originals = Array.isArray(row["originals"]) ? row["originals"] : [];
+    const fresh = originals.filter((original) => !alreadyPrinted.has(String(original["id"])));
+    if (fresh.length === 0)
+        return;
+    const merged = Number(row["consolidatedFrom"] ?? 0);
+    writeLine(out, merged > 0 ? `    merged from ${merged} memories; originals, for exact details:` : "    earlier versions, replaced by this one:");
+    for (const original of fresh) {
+        const earlier = original["kind"] === "earlier_version" ? `[earlier version${windowText(original)}] ` : "";
+        writeLine(out, `      - ${earlier}${oneLine(original["memory"])}  (${String(original["id"] ?? "")})`);
+    }
+    const hidden = (row["originalsHidden"] ?? {});
+    if (Number(hidden["private"] ?? 0) > 0)
+        writeLine(out, `      (${String(hidden["private"])} private original(s) not shown)`);
+}

package/dist/commands/memory-source.js

@@ -0,0 +1,39 @@
+/**
+ * `cockpit memory source <id> [--query "<words>"] [--chars 200..6000]` (BLI-19255): the raw session or meeting
+ * behind a memory, as a bounded verbatim excerpt.
+ *
+ * Memory is an index over the archive. A READ over `GET /api/memory/source`, the same door the `memory_source` MCP
+ * tool calls, with this machine's device token. The door follows the memory's own source pointer and returns the
+ * stretch of the stored transcript or note around the fact, as stored (redaction unchanged), or the reason there is
+ * none (`not_readable`, `missing`, `too_large`, ...). It reads only what your own session may read and writes nothing.
+ */
+import { askAgentDoor, emitAgentDoor, failAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+import { printSource } from "./memory-search-print.js";
+const TAG = "[memory cli]";
+const READ_DEADLINE_MS = 30_000;
+export async function runMemorySource(command, door) {
+    if (!command.memoryId) {
+        return failAgentDoor(door, TAG, "id_required", "memory source needs the memory id `cockpit memory search` printed.");
+    }
+    const params = new URLSearchParams({ id: command.memoryId });
+    if (command.sourceQuery)
+        params.set("query", command.sourceQuery);
+    if (command.sourceChars !== undefined)
+        params.set("chars", String(command.sourceChars));
+    const answer = await askAgentDoor(door, {
+        path: `/api/memory/source?${params.toString()}`,
+        method: "GET",
+        label: "memory source",
+        timeoutMs: READ_DEADLINE_MS,
+    });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    const body = answer.body;
+    // Status and sizes only: a source's text never enters a log line.
+    writeLine(door.io.stderr, `${TAG} source ${JSON.stringify({ status: body.source?.status ?? null, type: body.source?.type ?? null, chars: body.source?.excerpt?.chars ?? 0 })}`);
+    if (door.json)
+        return emitAgentDoor(door, answer.body);
+    printSource(door.io.stdout, body.source, "");
+    return 0;
+}

package/dist/commands/memory-store.js

@@ -43,13 +43,17 @@
  * newline in it cannot be quoted correctly anyway.
  */
 import { runMemoryMap } from "./memory-map.js";
+import { runMemoryRepeats } from "./memory-repeats.js";
 import { runMemoryRules } from "./memory-rules.js";
 import { memoryProjectPrefix } from "./memory-project-label.js";
+import { oneLine, printSearchRows } from "./memory-search-print.js";
 import { memorySaveOutsideRoots } from "@bli-cockpit/memory-mcp/dist/recorded-outside-roots.js";
 import { resolveContainerTag } from "@bli-cockpit/memory-mcp/dist/container-tag.js";
 import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./agent-door.js";
 import { isInteractiveStdin, readPipedText, writeLine } from "./cli-io.js";
 import { runMemoryChain } from "./memory-chain.js";
+import { runMemoryExam } from "./memory-exam.js";
+import { runMemorySource } from "./memory-source.js";
 import { runMemoryConsolidation } from "./memory-consolidation.js";
 import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 import { runMemoryRequeue } from "./memory-requeue.js";
@@ -69,6 +73,9 @@ export async function runMemoryStore(command, io) {
     switch (command.action) {
         case "map":
             return runMemoryMap(door);
+        case "repeats":
+            // BLI-19253: subjects people corrected or ordered more than once. Its own module and door.
+            return runMemoryRepeats(command, door);
         case "knowledge":
         case "rules":
             return runMemoryRules(command, door);
@@ -90,6 +97,12 @@ export async function runMemoryStore(command, io) {
             return runMemoryRequeue(command, io);
         case "chain":
             return runMemoryChain(command, door);
+        case "exam":
+            // BLI-19249. Its own module: the nightly memory exam score, owner-only.
+            return runMemoryExam(command, door);
+        case "source":
+            // BLI-19255: the raw session or meeting behind a memory. Its own module, a different door and shape.
+            return runMemorySource(command, door);
         case "private":
         case "public":
             // BLI-12927: the narrowing switch. Its own module, so this file stays
@@ -163,6 +176,10 @@ async function searchMemory(command, door) {
         containerTag: containerTags,
         ...(command.limit === undefined ? {} : { limit: command.limit }),
         includeProfile: command.includeRecent !== false,
+        // BLI-19246: absent lets the door decide by the question.
+        ...(command.includeOriginals === undefined ? {} : { includeOriginals: command.includeOriginals }),
+        // BLI-19255: absent lets the door decide by the question.
+        ...(command.includeSource === undefined ? {} : { includeSource: command.includeSource }),
     };
     const answer = await readThroughCache({
         io: door.io,
@@ -216,10 +233,7 @@ async function searchMemory(command, door) {
         writeLine(door.io.stdout, "No memories matched. The record is silent on this — it does not mean the store is down.");
     }
     else {
-        for (const row of results) {
-            writeLine(door.io.stdout, `${similarityLabel(row)}${memoryProjectPrefix(row)}${oneLine(row["memory"])}`);
-            writeLine(door.io.stdout, `    ${String(row["id"] ?? "")}  ${String(row["containerTag"] ?? "")}${filedByLabel(row)}`);
-        }
+        printSearchRows(door.io.stdout, results);
     }
     if (recent.length > 0) {
         writeLine(door.io.stdout, "");
@@ -382,30 +396,4 @@ async function readBody(command, door, maxChars, what) {
             detail: error instanceof Error ? error.message : String(error),
         };
     }
-}
-/** `[87%] ` when the row was found by meaning, empty when it was a keyword hit. */
-function similarityLabel(row) {
-    const channels = row["channels"];
-    if (Array.isArray(channels) && !channels.includes("semantic"))
-        return "";
-    const similarity = Number(row["similarity"]);
-    return Number.isFinite(similarity) && similarity >= 0 && similarity <= 1
-        ? `[${Math.round(similarity * 100)}%] `
-        : "";
-}
-/**
- * BLI-12927: memory is public across the team, so a hit can be a teammate's.
- * `  filed by Edward on 2026-09-14` ahead of nothing when it is the caller's own.
- */
-function filedByLabel(row) {
-    const name = typeof row["savedBy"] === "string" ? row["savedBy"].trim() : "";
-    if (!name)
-        return "";
-    const filed = typeof row["createdAt"] === "string" ? new Date(row["createdAt"]) : null;
-    const day = filed && !Number.isNaN(filed.getTime()) ? filed.toISOString().slice(0, 10) : null;
-    return day ? `  filed by ${name} on ${day}` : `  filed by ${name}`;
-}
-/** One terminal line: newlines folded, so a long memory cannot break the listing. */
-function oneLine(value) {
-    return String(value ?? "").replace(/\s+/g, " ").trim();
 }

package/dist/commands/memory-verb-list.js

@@ -26,7 +26,7 @@ export function runMemoryVerbList(io, json) {
             ok: true,
             noun: "memory",
             machine_verbs: ["install", "status"],
-            store_verbs: ["rules", "knowledge", "search", "save", "update", "forget", "private", "public", "profile", "consolidation", "chain", "requeue"],
+            store_verbs: ["rules", "knowledge", "search", "save", "update", "forget", "private", "public", "profile", "consolidation", "chain", "source", "exam", "requeue"],
             log_verbs: ["log"],
         }));
         return 0;
@@ -35,7 +35,7 @@ export function runMemoryVerbList(io, json) {
         "cockpit memory — BLI Memory: the store, and this machine's registration.",
         "",
         "The store (Tower, over /api/memory/*):",
-        "  cockpit memory search \"<question>\" [--container <tag>] [--limit 1..20] [--no-recent] [--json]",
+        "  cockpit memory search \"<question>\" [--container <tag>] [--limit 1..20] [--no-recent] [--include-originals|--no-originals] [--include-source|--no-source] [--json]",
         "  cockpit memory save [--container <tag>] [--custom-id <id>] [--extract] [--file <path>] [--json]",
         "      the memory comes from stdin, or --file; never from the command line",
         "  cockpit memory update <id> [--file <path>] [--json]        replacement text on stdin",
@@ -45,6 +45,8 @@ export function runMemoryVerbList(io, json) {
         "  cockpit memory private <id> [--json]       only you and super admins can read this memory",
         "  cockpit memory public <id> [--json]        every member can read it again (how every memory starts)",
         "  cockpit memory map [--json]",
+        "  cockpit memory repeats [--project <name-or-slug>] [--min 2..50] [--limit 1..200] [--json]",
+        "      subjects a person corrected an agent about, or ordered with emphasis, more than once",
         "  cockpit memory rules [--person <name>] [--project <name-or-slug>] [--limit <n>] [--per-project <n>] [--machine] [--json]",
         "  cockpit memory knowledge [--person <name>] [--project <name-or-slug>] [--limit <n>] [--per-project <n>] [--machine] [--json]",
         "      plain sentences per project; --per-project 1..100 (default 15) is each project's own",
@@ -55,6 +57,9 @@ export function runMemoryVerbList(io, json) {
         "  cockpit memory consolidation [--container <tag>] [--json]",
         "      what the nightly tidy-up pass did: clusters, edits by verb, refusals, cost",
         "  cockpit memory chain <id> [--json]",
+        "  cockpit memory exam [--night <YYYY-MM-DD>] [--misses] [--json]",
+        "      the nightly memory exam: purity, coverage, trend and worst project; yours alone",
+        "  cockpit memory source <id> [--query \"<words>\"] [--chars 200..6000] [--json]",
         "      the memories the nightly pass folded into this one: who, when, what they said",
         "  cockpit memory requeue --since <iso> [--until <iso>] [--source hook|harvest] [--reason <label>] [--apply] [--json]",
         "      put a window of finished extractions back in the queue after the store refused",

package/dist/commands/msg.js

@@ -25,6 +25,8 @@ const CONTENT_MAX_CHARS = 8_000;
 export async function runMsg(command, io) {
     const door = await openAgentDoor("msg", command, io);
     switch (command.action) {
+        case "show":
+            return showMessage(command, door);
         case "channels":
             return listChannels(door);
         case "read":
@@ -59,9 +61,20 @@ async function fetchChannels(door) {
     });
     if (!answer.ok)
         return { ok: false, reason: answer.reason, detail: answer.detail };
+    const channels = answer.body.channels ?? [];
+    let page = answer.body;
+    for (let count = 0; page.hasMore; count++) {
+        if (count >= 200 || !page.nextCursor)
+            return { ok: false, reason: "read_failed", detail: "Channel listing is incomplete. Retry online or use an ID." };
+        const next = await askAgentDoor(door, { path: `/api/msg/channels?before=${encodeURIComponent(page.nextCursor)}`, method: "GET", label: "msg channels page", timeoutMs: READ_DEADLINE_MS });
+        if (!next.ok)
+            return { ok: false, reason: next.reason, detail: next.detail };
+        channels.push(...(next.body.channels ?? []));
+        page = next.body;
+    }
     return {
         ok: true,
-        channels: answer.body.channels ?? [],
+        channels,
         fromCache: answer.fromCache,
         ageMs: answer.ageMs,
         coverage: answer.coverage,
@@ -89,6 +102,12 @@ async function listChannels(door) {
 }
 /** Exact id, or exact name with or without a leading `#`. Never fuzzy. */
 async function resolveChannelId(door, ref) {
+    if (/^[0-9a-f]{8}-[0-9a-f-]{27}$/i.test(ref)) {
+        const answer = await askAgentDoor(door, { path: `/api/msg/channels?channel_id=${encodeURIComponent(ref)}`, method: "GET", label: "msg channel", timeoutMs: READ_DEADLINE_MS });
+        if (!answer.ok)
+            return answer.reason === "channel_not_found_or_unreadable" ? { status: "not_found" } : { status: "list_failed", reason: answer.reason, detail: answer.detail };
+        return { status: "ok", id: ref };
+    }
     const fetched = await fetchChannels(door);
     if (!fetched.ok)
         return { status: "list_failed", reason: fetched.reason, detail: fetched.detail };
@@ -112,6 +131,8 @@ async function readChannel(command, door) {
     if (resolved.status === "not_found")
         return channelNotFound(door, ref);
     const query = new URLSearchParams();
+    if (command.before)
+        query.set("before", command.before);
     if (command.limit !== undefined)
         query.set("limit", String(command.limit));
     if (command.threadId)
@@ -124,7 +145,7 @@ async function readChannel(command, door) {
         timeoutMs: READ_DEADLINE_MS,
     });
     if (!answer.ok)
-        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+        return failAgentDoor(door, TAG, answer.reason, answer.detail, answer.body?.coverage === "failed_partial" ? answer.body : {});
     const body = answer.body;
     const messages = body.messages ?? [];
     // BLI-10449: whether this channel is Tower's own or a Slack snapshot, and
@@ -132,12 +153,14 @@ async function readChannel(command, door) {
     const provenance = body.provenance ?? null;
     const limitApplied = body.limitApplied ?? null;
     if (door.json)
-        return emitAgentDoor(door, { ok: true, channelId: resolved.id, provenance, limitApplied, messages });
+        return emitAgentDoor(door, { ok: true, ...body, channelId: resolved.id, provenance, limitApplied, messages, nextCursor: body.nextCursor, hasMore: body.hasMore, coverage: body.coverage });
     if (provenance?.sentence)
         writeLine(door.io.stdout, provenance.sentence);
     if (limitApplied !== null) {
         writeLine(door.io.stdout, `Showing the newest ${limitApplied}: one read returns at most ${limitApplied} messages.`);
     }
+    if (body.nextCursor)
+        writeLine(door.io.stdout, `More history: --before ${body.nextCursor}`);
     if (messages.length === 0) {
         writeLine(door.io.stdout, "No messages.");
         return 0;
@@ -145,7 +168,7 @@ async function readChannel(command, door) {
     for (const message of [...messages].reverse()) {
         // An imported Slack message has no Tower user; its Slack name is the label.
         const who = message.agent_label ?? message.user_id ?? message.slack_author_label ?? "someone";
-        writeLine(door.io.stdout, `${message.created_at}  ${who}  ${message.content ?? ""}`);
+        writeLine(door.io.stdout, `${message.id}  ${message.created_at}  ${who}  ${message.content ?? ""}`);
     }
     return 0;
 }
@@ -159,23 +182,26 @@ async function readThread(command, door) {
     if (resolved.status === "not_found")
         return channelNotFound(door, command.channelRef);
     const answer = await askAgentDoor(door, {
-        path: `/api/msg/channels/${encodeURIComponent(resolved.id)}/messages?thread_parent_id=${encodeURIComponent(command.threadId ?? "")}`,
+        path: `/api/msg/channels/${encodeURIComponent(resolved.id)}/messages?thread_parent_id=${encodeURIComponent(command.threadId ?? "")}${command.before ? `&before=${encodeURIComponent(command.before)}` : ""}${command.limit ? `&limit=${command.limit}` : ""}`,
         method: "GET",
         label: "msg thread",
         timeoutMs: READ_DEADLINE_MS,
     });
     if (!answer.ok)
-        return failAgentDoor(door, TAG, answer.reason, answer.detail);
-    const messages = answer.body.messages ?? [];
+        return failAgentDoor(door, TAG, answer.reason, answer.detail, answer.body?.coverage === "failed_partial" ? answer.body : {});
+    const body = answer.body;
+    const messages = body.messages ?? [];
     if (door.json)
-        return emitAgentDoor(door, { ok: true, channelId: resolved.id, threadParentId: command.threadId, messages });
+        return emitAgentDoor(door, { ok: true, ...body, channelId: resolved.id, threadParentId: command.threadId, messages, nextCursor: body.nextCursor, hasMore: body.hasMore, coverage: body.coverage });
+    if (body.nextCursor)
+        writeLine(door.io.stdout, `More history: --before ${body.nextCursor}`);
     if (messages.length === 0) {
         writeLine(door.io.stdout, "No replies.");
         return 0;
     }
     for (const message of [...messages].reverse()) {
         const who = message.agent_label ?? message.user_id;
-        writeLine(door.io.stdout, `${message.created_at}  ${who}  ${message.content ?? ""}`);
+        writeLine(door.io.stdout, `${message.id}  ${message.created_at}  ${who}  ${message.content ?? ""}`);
     }
     return 0;
 }
@@ -307,4 +333,20 @@ async function openDm(command, door) {
     // true either way rather than claiming a creation that may not have happened.
     writeLine(door.io.stdout, `Direct message with ${email}: ${channel?.id ?? "?"}`);
     return 0;
+}
+async function showMessage(command, door) {
+    const answer = await askAgentDoor(door, { path: `/api/msg/messages/${encodeURIComponent(command.threadId ?? "")}`, method: "GET", label: "msg show", timeoutMs: READ_DEADLINE_MS });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...answer.body });
+    const body = answer.body;
+    writeLine(door.io.stdout, body.href ?? "Message context");
+    for (const page of [body.channelPage, body.threadPage]) {
+        for (const row of [...(page?.messages ?? [])].reverse())
+            writeLine(door.io.stdout, `${row.id}  ${row.created_at}  ${row.content ?? ""}`);
+        if (page?.nextCursor)
+            writeLine(door.io.stdout, `More history: --before ${page.nextCursor}`);
+    }
+    return 0;
 }

package/dist/commands/notes-reads.js

@@ -107,6 +107,21 @@ export async function listShelves(command, door) {
     }
     return 0;
 }
+/** One line per claim with its citations: `- text [s12 Ada 00:03:04]`. */
+export function renderCitedSummary(summary) {
+    const lines = [`Summary v${summary.version} (${summary.supported} cited claims, ${summary.dropped} dropped as unsupported or uncited)`];
+    for (const [kind, heading] of [["decision", "Decisions"], ["action_item", "Action items"], ["key_point", "Key points"]]) {
+        const items = summary.items.filter((item) => item.kind === kind);
+        if (items.length === 0)
+            continue;
+        lines.push("", `${heading}:`);
+        for (const item of items) {
+            const cites = item.citations.map((c) => `${c.segment_id} ${c.speaker}${c.at ? ` ${c.at}` : ""}`).join("; ");
+            lines.push(`- ${item.owner ? `${item.owner}: ` : ""}${item.text} [${cites}]`);
+        }
+    }
+    return lines;
+}
 /** `?offset=&limit=` for `notes show`: characters, like `docs read` (BLI-18006). */
 function showQuery(command) {
     const query = new URLSearchParams();
@@ -149,6 +164,11 @@ export async function showNote(command, door) {
         const { offset, returnedChars, totalChars, nextOffset } = body.slice;
         writeLine(door.io.stdout, `Characters ${offset}-${offset + returnedChars} of ${totalChars}${nextOffset === null ? " (the end)" : `; continue with --offset ${nextOffset}`}.`);
     }
+    if (body.summary && body.summary.items.length > 0) {
+        writeLine(door.io.stdout, "");
+        for (const line of renderCitedSummary(body.summary))
+            writeLine(door.io.stdout, line);
+    }
     writeLine(door.io.stdout, "");
     writeLine(door.io.stdout, note.content.replace(/^In the room:/gm, "Invited:"));
     return 0;

package/dist/commands/notes-writes.js

@@ -205,6 +205,30 @@ export async function shareNote(command, door) {
     sayUpload(door, body);
     return 0;
 }
+/** A summary run is two model calls over a long transcript: give it room (BLI-20882). */
+const SUMMARIZE_DEADLINE_MS = 330_000;
+/**
+ * `cockpit notes summarize <note-id>` (BLI-20882): write a new summary where every decision,
+ * action item and key point cites the speaker, timestamp and segment id it came from. A claim
+ * the transcript does not support is dropped. Earlier summaries are kept as older versions.
+ */
+export async function summarizeNote(command, door) {
+    const answer = await ask(door, {
+        path: `/api/notes/library/${encodeURIComponent(command.noteId ?? "")}/summary`,
+        method: "POST",
+        label: "notes summarize",
+        timeoutMs: SUMMARIZE_DEADLINE_MS,
+        body: {},
+    });
+    if (!answer.ok)
+        return fail(door, answer.reason, answer.detail);
+    const body = answer.body;
+    writeLine(door.io.stderr, `${TAG} summarize answered ${JSON.stringify({ note_id: command.noteId ?? null, status: body.status ?? null })}`);
+    if (door.json)
+        return emit(door, body);
+    writeLine(door.io.stdout, body.text ?? body.message ?? "Tower answered without a summary.");
+    return 0;
+}
 /**
  * `cockpit notes place <note-id> [--apply]` — BLI-4058.
  *

package/dist/commands/notes.js

@@ -43,7 +43,7 @@
  */
 import { loadPairedSession } from "../tower-client.js";
 import { listNotes, listShelves, showNote, showShelf } from "./notes-reads.js";
-import { uploadNotes, pasteNote, shareNote, moveNote, placeNote } from "./notes-writes.js";
+import { uploadNotes, pasteNote, shareNote, summarizeNote, moveNote, placeNote } from "./notes-writes.js";
 import { runFolderCommand } from "./notes-folders.js";
 import { armNotesWebhook, connectNotetaker, detachNotetaker, listNotesAccounts, showNotesWebhook, syncNotetaker, syncStatusNotetakers, } from "./notes-accounts.js";
 import { showBotUpcoming } from "./notes-bot-upcoming.js";
@@ -51,7 +51,7 @@ import { showGranolaStatus } from "./notes-granola-status.js";
 import { showTranscriptionStats } from "./notes-transcription-stats.js";
 import { listRecordings, showRecording } from "./notes-recordings.js";
 export { listNotes, listShelves, showNote, showShelf } from "./notes-reads.js";
-export { uploadNotes, pasteNote, shareNote, moveNote, placeNote } from "./notes-writes.js";
+export { uploadNotes, pasteNote, shareNote, summarizeNote, moveNote, placeNote } from "./notes-writes.js";
 export { armNotesWebhook, connectNotetaker, detachNotetaker, listNotesAccounts, showNotesWebhook, syncNotetaker, syncStatusNotetakers, } from "./notes-accounts.js";
 export { showGranolaStatus } from "./notes-granola-status.js";
 export { showTranscriptionStats } from "./notes-transcription-stats.js";
@@ -86,6 +86,8 @@ export async function runNotes(command, io) {
         case "share":
         case "unshare":
             return shareNote(command, door);
+        case "summarize":
+            return summarizeNote(command, door);
         case "move":
             return moveNote(command, door);
         case "place":