@north-light/crouter 0.3.277 → 0.3.279

package/dist/core/canvas/render-source.d.ts

@@ -103,6 +103,15 @@ export interface DashboardRow {
     /** Lazy-enrichment guard (internal): true once loadPreview has read goal + the
      *  session (prompts + lastAssistant). Idempotency marker for the selected row. */
     previewLoaded?: boolean;
+    /** The node's conversation as ORDERED user/assistant turns — what the preview panel
+     *  paints as a chat transcript. Populated LAZILY by loadTranscript for the SELECTED
+     *  row only (never on the background warm pass): one transcript per row is a few KB,
+     *  and holding one for every node on a multi-thousand-node canvas is what `prompts`
+     *  and `lastAssistant` exist to avoid. Undefined until asked for; an empty array
+     *  means "read, and the node has no session turns". */
+    transcript?: TranscriptTurn[];
+    /** Lazy guard (internal): true once loadTranscript has read the session for this row. */
+    transcriptLoaded?: boolean;
     /** The source `NodeRow` this row was built from (dashboardRowFromNodeRow only).
      *  Carries every column listNodes already fetched — the runtime fields
      *  (host_kind/parent/waiting_for/final_report/finalized_at/pi_pid) plus the
@@ -132,6 +141,17 @@ interface SessionParts {
     lastAssistant?: string;
 }
 export declare function readSessionParts(sessionFile: string | null | undefined): SessionParts;
+/** One conversation turn as the preview panel paints it. */
+export interface TranscriptTurn {
+    role: 'user' | 'assistant';
+    text: string;
+}
+/** The node's conversation as ordered user/assistant turns, newest-last, capped to
+ *  the last TRANSCRIPT_TURNS. Generated context cards are dropped (they are runtime
+ *  scaffolding, not something the user or the agent said) and so are assistant turns
+ *  with no text (tool-only turns), so the result reads as a chat rather than a log.
+ *  One file read; never throws; empty for a node that was never revived. */
+export declare function readTranscript(sessionFile: string | null | undefined): TranscriptTurn[];
 /** Did this node's engine ever PRODUCE something — an assistant message with real
  *  text, a tool call, or non-empty reasoning? The signal that a node did work and
  *  is not an empty shell. A never-revived node (no session file) is trivially
@@ -174,4 +194,10 @@ export declare function enrichRowsFromSource(_source: CanvasSource, rows: Dashbo
 /** goal (initial-prompt.md) and session parts are local disk reads — suppressed
  *  to undefined for a remote source. */
 export declare function loadPreviewFromSource(source: CanvasSource, row: DashboardRow): Promise<DashboardRow>;
+/** Fold the ordered conversation onto `row` — the preview panel's chat body. Kept
+ *  OUT of loadPreviewFromSource because that runs over every row on the background
+ *  warm pass, and a per-row transcript across a whole canvas is exactly the memory
+ *  cost the capped `prompts` string avoids. Call it for the selected row only.
+ *  Remote sources have no local session file, so the transcript stays empty. */
+export declare function loadTranscriptFromSource(source: CanvasSource, row: DashboardRow): Promise<DashboardRow>;
 export {};

package/dist/core/canvas/render-source.js

@@ -307,6 +307,61 @@ export function readSessionParts(sessionFile) {
     }
     return { prompts, lastAssistant };
 }
+/** How many trailing turns the transcript keeps. A preview panel can paint a few
+ *  dozen lines, and search only ever windows to a match, so the whole history is
+ *  never needed — but the window has to be wide enough that a match found in
+ *  `prompts` (which spans the whole session) is usually still present here. */
+const TRANSCRIPT_TURNS = 120;
+const TRANSCRIPT_MSG_CAP = 4096;
+/** The node's conversation as ordered user/assistant turns, newest-last, capped to
+ *  the last TRANSCRIPT_TURNS. Generated context cards are dropped (they are runtime
+ *  scaffolding, not something the user or the agent said) and so are assistant turns
+ *  with no text (tool-only turns), so the result reads as a chat rather than a log.
+ *  One file read; never throws; empty for a node that was never revived. */
+export function readTranscript(sessionFile) {
+    if (sessionFile === undefined || sessionFile === null || sessionFile === '')
+        return [];
+    let lines;
+    try {
+        if (!existsSync(sessionFile))
+            return [];
+        lines = readFileSync(sessionFile, 'utf8').split('\n');
+    }
+    catch {
+        return [];
+    }
+    const turns = [];
+    for (const line of lines) {
+        // Same cheap prefilter as readSessionParts: skip every line that cannot be a
+        // user or assistant message before paying for JSON.parse.
+        if (line === '')
+            continue;
+        const isUser = line.indexOf('"role":"user"') !== -1 || line.indexOf('"role": "user"') !== -1;
+        const isAssistant = !isUser
+            && (line.indexOf('"role":"assistant"') !== -1 || line.indexOf('"role": "assistant"') !== -1);
+        if (!isUser && !isAssistant)
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (rec.type !== 'message')
+            continue;
+        const role = rec.message?.role;
+        if (role !== 'user' && role !== 'assistant')
+            continue;
+        const text = extractUserText(rec.message?.content);
+        if (text === '')
+            continue;
+        if (parseCard({ role, content: text }) !== null)
+            continue;
+        turns.push({ role, text: text.length > TRANSCRIPT_MSG_CAP ? text.slice(0, TRANSCRIPT_MSG_CAP) : text });
+    }
+    return turns.length > TRANSCRIPT_TURNS ? turns.slice(turns.length - TRANSCRIPT_TURNS) : turns;
+}
 /** Did this node's engine ever PRODUCE something — an assistant message with real
  *  text, a tool call, or non-empty reasoning? The signal that a node did work and
  *  is not an empty shell. A never-revived node (no session file) is trivially
@@ -550,3 +605,21 @@ export async function loadPreviewFromSource(source, row) {
     row.previewLoaded = true;
     return row;
 }
+/** Fold the ordered conversation onto `row` — the preview panel's chat body. Kept
+ *  OUT of loadPreviewFromSource because that runs over every row on the background
+ *  warm pass, and a per-row transcript across a whole canvas is exactly the memory
+ *  cost the capped `prompts` string avoids. Call it for the selected row only.
+ *  Remote sources have no local session file, so the transcript stays empty. */
+export async function loadTranscriptFromSource(source, row) {
+    if (row.transcriptLoaded === true)
+        return row;
+    if (source instanceof RemoteCanvasSource) {
+        row.transcript = [];
+        row.transcriptLoaded = true;
+        return row;
+    }
+    const meta = await source.getNode(row.node_id);
+    row.transcript = readTranscript(meta?.pi_session_file);
+    row.transcriptLoaded = true;
+    return row;
+}

package/dist/core/keybindings/catalog.d.ts

@@ -3,13 +3,13 @@ import type { AttachBindingId, AttachMenuBindingId } from './attach-control.js';
 type TmuxMenuAction = 'open' | 'attach' | 'show' | 'view-settings' | 'fold-tools' | 'metadata' | 'promote' | 'demote-mode' | 'resume' | 'fork' | 'demote' | 'make-resident' | 'detach' | 'close-subtree' | 'background-bash' | 'file-review' | 'pin' | 'reload-viewer' | 'recap' | 'context' | 'context-admin' | 'providers' | 'plugins' | 'graph' | 'focus-manager' | 'copy-id' | 'issues';
 type TmuxMenuEntryAction = Exclude<TmuxMenuAction, 'open' | 'attach'> | `issue.${'idea' | 'bug'}`;
 type GraphAction = 'down' | 'up' | 'first' | 'last' | 'collapse-or-manager' | 'expand-or-child' | 'focus' | 'revive' | 'focus-manager' | 'close-subtree' | 'dismiss';
-type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4 | 5}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'profile' | 'residents' | 'preview' | 'pin' | 'search' | 'revive-now' | 'focus' | 'focus-background' | 'yank-id';
+type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4 | 5}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'profile' | 'residents' | 'preview' | 'report' | 'pin' | 'search' | 'revive-now' | 'focus' | 'focus-background' | 'yank-id';
 type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' | `slot.${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | 'create' | 'search-existing' | 'use-root' | 'set-default' | 'add-directory' | 'unpin' | 'manage';
 type SetupAction = 'cancel' | 'tab-next' | 'tab-previous' | 'open' | 'list-down' | 'list-up' | 'toggle' | 'details' | 'advance' | 'cell-previous' | 'cell-next';
 type SetupKeybindingAction = 'edit' | 'commit-edit' | 'cancel-edit' | 'unbind' | 'reset-row' | 'reset-all' | 'save' | 'discard' | 'page-up' | 'page-down' | 'filter' | 'filter-delete' | 'filter-clear';
 type SetupModelsAction = 'open' | 'commit' | 'cancel' | 'scope-next';
 export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | AttachMenuBindingId | `crtr.tmux.menu-global.${TmuxMenuEntryAction}` | `crtr.tmux.node.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | `crtr.attach.scroll.${'up' | 'down' | 'page-up' | 'page-down' | 'live'}` | 'crtr.attach.mouse.toggle' | 'crtr.attach.copy.message' | 'crtr.attach.help.toggle' | `crtr.attach.search.${'next' | 'previous' | 'edit' | 'close'}` | AttachBindingId | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.inspector.${'force-quit' | 'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'open-log' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.browse.${BrowseAction}` | `crtr.browse.search.${'cancel' | 'commit' | 'delete' | 'quit'}` | `crtr.profile.menu.${ProfileMenuAction}` | `crtr.profile.search.${'up' | 'down' | 'pick' | 'back' | 'delete' | 'abort'}` | `crtr.setup.${SetupAction}` | `crtr.setup.confirm.${'accept' | 'back'}` | `crtr.setup.keybindings.${SetupKeybindingAction}` | `crtr.setup.models.${SetupModelsAction}`;
-export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.attach.search.next"> | BindingDefinition<"crtr.attach.search.previous"> | BindingDefinition<"crtr.attach.search.edit"> | BindingDefinition<"crtr.attach.search.close"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.inspector.force-quit"> | BindingDefinition<"crtr.inspector.down"> | BindingDefinition<"crtr.inspector.up"> | BindingDefinition<"crtr.inspector.section-next"> | BindingDefinition<"crtr.inspector.section-prev"> | BindingDefinition<"crtr.inspector.page-down"> | BindingDefinition<"crtr.inspector.page-up"> | BindingDefinition<"crtr.inspector.toggle-detail"> | BindingDefinition<"crtr.inspector.cancel-item"> | BindingDefinition<"crtr.inspector.open-log"> | BindingDefinition<"crtr.inspector.confirm"> | BindingDefinition<"crtr.inspector.dismiss"> | BindingDefinition<"crtr.inspector.retarget"> | BindingDefinition<"crtr.inspector.refresh"> | BindingDefinition<"crtr.inspector.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.pin"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.yank-id"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.menu.manage">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
+export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.attach.search.next"> | BindingDefinition<"crtr.attach.search.previous"> | BindingDefinition<"crtr.attach.search.edit"> | BindingDefinition<"crtr.attach.search.close"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.inspector.force-quit"> | BindingDefinition<"crtr.inspector.down"> | BindingDefinition<"crtr.inspector.up"> | BindingDefinition<"crtr.inspector.section-next"> | BindingDefinition<"crtr.inspector.section-prev"> | BindingDefinition<"crtr.inspector.page-down"> | BindingDefinition<"crtr.inspector.page-up"> | BindingDefinition<"crtr.inspector.toggle-detail"> | BindingDefinition<"crtr.inspector.cancel-item"> | BindingDefinition<"crtr.inspector.open-log"> | BindingDefinition<"crtr.inspector.confirm"> | BindingDefinition<"crtr.inspector.dismiss"> | BindingDefinition<"crtr.inspector.retarget"> | BindingDefinition<"crtr.inspector.refresh"> | BindingDefinition<"crtr.inspector.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.report"> | BindingDefinition<"crtr.browse.pin"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.yank-id"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.menu.manage">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
 export declare const BINDING_IDS: ReadonlySet<string>;
 /** True for an action whose direct gesture is handled inside an attach viewer.
  *  Tmux menu selectors and root shortcuts are chrome, not pane input. */

package/dist/core/keybindings/catalog.js

@@ -148,6 +148,7 @@ function browseBindings() {
         b('crtr.browse.profile', 'Browse and pickers', 'Toggle profile', 'Toggle the browse profile scope.', ['shift+p'], 'terminal', [nav]),
         b('crtr.browse.residents', 'Browse and pickers', 'Toggle residents', 'Toggle resident display.', ['r'], 'terminal', [nav]),
         b('crtr.browse.preview', 'Browse and pickers', 'Toggle preview', 'Toggle the preview panel.', ['v'], 'terminal', [nav]),
+        b('crtr.browse.report', 'Browse and pickers', 'Toggle report', 'Swap the preview panel between the conversation and the node\'s newest report.', ['shift+v'], 'terminal', [nav]),
         b('crtr.browse.pin', 'Browse and pickers', 'Pin node', 'Star or unstar the selected node.', ['p'], 'terminal', [nav]),
         b('crtr.browse.search', 'Browse and pickers', 'Search', 'Open browse search.', ['/'], 'terminal', [nav]),
         b('crtr.browse.revive-now', 'Browse and pickers', 'Revive now', 'Revive the selected node now.', ['shift+k'], 'terminal', [nav]),

package/dist/core/runtime/busy.d.ts

@@ -1,3 +1,7 @@
+export type TransportPoisonVerdict = {
+    consecutivePasses: number;
+    routes: string[];
+};
 /** Mark a node mid-turn (pi entered a turn). Best-effort. A new turn makes any
  * prior clean-abort certificate stale before it can affect a later crash. */
 export declare function markBusy(nodeId: string): void;
@@ -10,6 +14,15 @@ export declare function clearBusy(nodeId: string): void;
 export declare function markCleanAbort(nodeId: string): void;
 /** Remove a consumed clean-abort certificate as a broker boots. */
 export declare function clearCleanAbort(nodeId: string): void;
+/** Record the provider-rotation verdict immediately before it terminates this broker.
+ * It survives the broker exit so the fleet can surface the cause if this launch
+ * exhausts respawn recovery. */
+export declare function recordTransportPoisonVerdict(nodeId: string, verdict: TransportPoisonVerdict): void;
+/** A verdict belongs to one broker launch. Clear it before every replacement so
+ * a later unrelated crash loop cannot inherit an old transport diagnosis. */
+export declare function clearTransportPoisonVerdict(nodeId: string): void;
+/** Read only a complete, structurally valid provider-rotation verdict. */
+export declare function readTransportPoisonVerdict(nodeId: string): TransportPoisonVerdict | null;
 /** Whether the dead broker left a persisted clean-abort turn witness. */
 export declare function hasCleanAbort(nodeId: string): boolean;
 /** Is the node currently inside a turn? AND this with `pidAlive` at the call

package/dist/core/runtime/busy.js

@@ -13,7 +13,7 @@
 // read site, so a stale marker (process crashed mid-turn without firing
 // agent_end) is harmless — the dead pid fails the AND and the node is reaped.
 // No db migration, atomic touch/unlink, best-effort (never throws).
-import { existsSync, writeFileSync, rmSync, mkdirSync, statSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, rmSync, mkdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { jobDir } from '../canvas/paths.js';
 function busyPath(nodeId) {
@@ -22,6 +22,9 @@ function busyPath(nodeId) {
 function cleanAbortPath(nodeId) {
     return join(jobDir(nodeId), 'clean-abort');
 }
+function transportPoisonPath(nodeId) {
+    return join(jobDir(nodeId), 'transport-poison.json');
+}
 /** Mark a node mid-turn (pi entered a turn). Best-effort. A new turn makes any
  * prior clean-abort certificate stale before it can affect a later crash. */
 export function markBusy(nodeId) {
@@ -65,6 +68,45 @@ export function clearCleanAbort(nodeId) {
         /* best-effort */
     }
 }
+/** Record the provider-rotation verdict immediately before it terminates this broker.
+ * It survives the broker exit so the fleet can surface the cause if this launch
+ * exhausts respawn recovery. */
+export function recordTransportPoisonVerdict(nodeId, verdict) {
+    try {
+        mkdirSync(jobDir(nodeId), { recursive: true });
+        writeFileSync(transportPoisonPath(nodeId), JSON.stringify(verdict));
+    }
+    catch {
+        /* best-effort: no marker means the crash report remains explicitly unknown */
+    }
+}
+/** A verdict belongs to one broker launch. Clear it before every replacement so
+ * a later unrelated crash loop cannot inherit an old transport diagnosis. */
+export function clearTransportPoisonVerdict(nodeId) {
+    try {
+        rmSync(transportPoisonPath(nodeId), { force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/** Read only a complete, structurally valid provider-rotation verdict. */
+export function readTransportPoisonVerdict(nodeId) {
+    try {
+        const value = JSON.parse(readFileSync(transportPoisonPath(nodeId), 'utf8'));
+        if (typeof value !== 'object' || value === null)
+            return null;
+        const verdict = value;
+        const consecutivePasses = verdict.consecutivePasses;
+        const routes = verdict.routes;
+        if (typeof consecutivePasses !== 'number' || !Number.isInteger(consecutivePasses) || consecutivePasses < 1 || !Array.isArray(routes) || routes.length === 0 || !routes.every((route) => typeof route === 'string' && route !== ''))
+            return null;
+        return { consecutivePasses, routes };
+    }
+    catch {
+        return null;
+    }
+}
 /** Whether the dead broker left a persisted clean-abort turn witness. */
 export function hasCleanAbort(nodeId) {
     return existsSync(cleanAbortPath(nodeId));

package/dist/core/runtime/revive.js

@@ -38,6 +38,7 @@ import { encodeKickoffOrigin, KICKOFF_ORIGIN_ENV } from './stamp/protocol.js';
 import { headlessBrokerHost } from './host.js';
 import { boundFleet, brokerCapReached, brokerThresholdsForDaemon } from './fleet.js';
 import { clearFault, beginBootFaultAttempt } from './fault.js';
+import { clearTransportPoisonVerdict } from './busy.js';
 import { clearContextExposureState, initializeForkContextExposure, } from '../substrate/injected-store.js';
 import { rootOfSpine } from './nodes.js';
 import { isReviewCompanionBound } from '../review/companion.js';
@@ -468,6 +469,7 @@ async function launchRevive(nodeId, meta, opts) {
     if (opts.recovery !== true)
         cancelCronsOnWake(nodeId);
     ensureNodeDirs(nodeId);
+    clearTransportPoisonVerdict(nodeId);
     const lifecycleHooks = discoverLifecycleHookRegistry(meta.cwd, meta.profile_id).plans.get('node:start') ?? [];
     await invokeLifecycleHooks(lifecycleHooks, {
         node: {

package/dist/core/runtime/tmux-bindings.js

@@ -15,7 +15,7 @@ const TMUX_BINDING_MANIFEST = '@crtr_keybindings_manifest';
 const ROOT_TABLE = 'root';
 const LEAF_MENU_ACTIONS = {
     'crtr.tmux.menu.promote': { description: 'promote to orchestrator', action: { kind: 'keys', keys: '/promote' } },
-    'crtr.tmux.menu.resume': { description: 'find node', action: { kind: 'keys', keys: '/resume-node' } },
+    'crtr.tmux.menu.resume': { description: 'find node', action: { kind: 'keys', keys: '/resume' } },
     'crtr.tmux.menu.fork': { description: 'fork into idle root', action: { kind: 'direct', run: 'node fork --pane {pane}' } },
     // Mode demote is the mirror of `/promote`: `node config` persists the change;
     // the broker appends its pending context before the next provider response.

package/dist/daemon/fleet.d.ts

@@ -52,6 +52,9 @@ export interface DaemonFleetOpts {
     enqueue: (job: () => void | Promise<void>) => void;
     /** Injectable clock for tests. */
     now?: () => number;
+    /** Injectable network-reachability probe. Every respawn decision consults it,
+     *  so tests drive the offline branch without touching the real network. */
+    probeOnline?: () => Promise<boolean>;
 }
 export declare class DaemonFleet implements FleetRegistry {
     #private;

package/dist/daemon/fleet.js

@@ -16,9 +16,10 @@ import { fullName } from '../core/canvas/labels.js';
 import { isSafeNodeId } from '../core/canvas/paths.js';
 import { transition } from '../core/runtime/lifecycle.js';
 import { fanDoctrineWake } from '../core/runtime/close.js';
-import { hasCleanAbort, isBusy } from '../core/runtime/busy.js';
+import { hasCleanAbort, isBusy, readTransportPoisonVerdict } from '../core/runtime/busy.js';
 import { hasPendingWake } from './reconcilers/live-obligation.js';
-import { clearRespawnPolicy, MAX_RESPAWN_ATTEMPTS, recordRespawnPolicy, respawnBackoffMs } from './reconcilers/node-lifecycle/respawn-policy.js';
+import { clearRespawnPolicy, deferRespawnWhileOffline, MAX_RESPAWN_ATTEMPTS, OFFLINE_RESPAWN_RETRY_MS, recordRespawnPolicy, respawnBackoffMs, } from './reconcilers/node-lifecycle/respawn-policy.js';
+import { probeOnline as probeOnlineReal } from '../core/runtime/connectivity.js';
 import { reviveNode } from '../core/runtime/revive.js';
 import { pushUrgent } from '../core/feed/feed.js';
 import { emitEvent } from '../core/events/emit.js';
@@ -42,9 +43,14 @@ export async function surfaceBootFailure(meta) {
     await pushUrgent(meta.node_id, body, { from: meta.node_id });
 }
 async function surfaceCrashLoop(meta) {
+    const transportPoison = readTransportPoisonVerdict(meta.node_id);
+    const observedCause = transportPoison === null
+        ? ''
+        : `\n\nProvider rotation observed ${transportPoison.consecutivePasses} consecutive route-queue passes with no HTTP response (tried ${transportPoison.routes.join(', ')}). Check network and provider transport before reviving.`;
     const body = `⚠ Crash loop — \`${meta.name}\` (${meta.kind}) kept dying without settling a turn.\n\n` +
-        `Its session started successfully, but six consecutive relaunches made no progress, so the daemon stopped retrying.\n\n` +
-        `Fix the crash cause, then revive the node if the work still needs doing.`;
+        `Its session started successfully, but six consecutive relaunches made no progress, so the daemon stopped retrying.` +
+        observedCause +
+        `\n\nFix the crash cause, then revive the node if the work still needs doing.`;
     await pushUrgent(meta.node_id, body, { from: meta.node_id });
 }
 /** Surface a recovery refusal that happened before a broker could launch. */
@@ -121,6 +127,7 @@ export class DaemonFleet {
     #epoch;
     #enqueue;
     #now;
+    #probeOnline;
     #map = new Map();
     /** Slots claimed by launches that have not registered a broker yet. */
     #reservations = new Set();
@@ -129,6 +136,7 @@ export class DaemonFleet {
         this.#epoch = opts.epoch;
         this.#enqueue = opts.enqueue;
         this.#now = opts.now ?? Date.now;
+        this.#probeOnline = opts.probeOnline ?? (() => probeOnlineReal());
     }
     epoch() {
         return this.#epoch;
@@ -292,8 +300,30 @@ export class DaemonFleet {
         const row = getRow(nodeId);
         if (row === null)
             return;
-        const assess = row.respawn_not_before == null;
         const priorFailures = row.respawn_failures ?? 0;
+        // A box with no network fails every relaunch for a reason that has nothing
+        // to do with this node: with no route reachable, the broker's provider queue
+        // exhausts with no HTTP response at all, it declares its own transport
+        // poisoned, and it exits for a fresh process that fails identically. Six of
+        // those and the node is dead a few minutes into an outage, holding an
+        // unfinished turn that only a human revive resumes. Park instead of counting
+        // — the outage is a condition to wait out, not a failure sequence to pace.
+        if (!(await this.#probeOnline())) {
+            deferRespawnWhileOffline(nodeId, priorFailures, this.#now());
+            emitEvent({
+                level: 'info',
+                event: 'broker.respawn.offline_deferred',
+                ...(isSafeNodeId(nodeId) ? { node_id: nodeId } : {}),
+                fields: {
+                    ...(isSafeNodeId(nodeId) ? {} : { affected_node_id: nodeId }),
+                    action,
+                    retry_in_ms: OFFLINE_RESPAWN_RETRY_MS,
+                    consecutive_failures: priorFailures,
+                },
+            });
+            return;
+        }
+        const assess = row.respawn_not_before == null;
         const attempt = assess
             ? recordRespawnPolicy(row, this.#now())
             : { failures: priorFailures, notBefore: row.respawn_not_before, exhausted: priorFailures >= MAX_RESPAWN_ATTEMPTS };

package/dist/daemon/reconcilers/node-lifecycle/respawn-policy.d.ts

@@ -1,5 +1,11 @@
 import { type NodeRow } from '../../../core/canvas/index.js';
 export declare const MAX_RESPAWN_ATTEMPTS = 6;
+/** How long an offline box waits before re-testing the network and relaunching.
+ *  Flat, not exponential: this is not a failure sequence being paced, it is a
+ *  wait for a condition outside the node — the same "my wifi is back" gate the
+ *  broker's connection-fault retry uses, sampled less often because each sample
+ *  here can cost a whole broker launch. */
+export declare const OFFLINE_RESPAWN_RETRY_MS = 30000;
 export declare function respawnBackoffMs(consecutiveFailures: number): number;
 export interface RespawnAttempt {
     failures: number;
@@ -11,6 +17,14 @@ export declare function isInBackoff(row: NodeRow, now: number): boolean;
 /** The only respawn-failure policy: progress since launch clears the sequence;
  * every other missing-engine observation advances it and records its backoff. */
 export declare function decideRespawnAttempt(row: Pick<NodeRow, 'last_settled_at' | 'launched_at' | 'respawn_failures'>, now: number): RespawnAttempt;
+/** Hold a relaunch while the box has no network, WITHOUT advancing the failure
+ *  sequence. An outage makes every launch fail identically, so counting those
+ *  launches spends the whole respawn budget on a condition the node did not
+ *  cause and cannot fix — the node terminalizes minutes into an outage and only
+ *  a human revive brings it back. Re-arming instead parks it: the row stays
+ *  active, the tick re-enters this policy after the window, and the first
+ *  launch made once the network returns resumes the interrupted turn. */
+export declare function deferRespawnWhileOffline(nodeId: string, failures: number, now: number): RespawnAttempt;
 /** Persist the policy decision through the daemon-only canvas writer. */
 export declare function recordRespawnPolicy(row: NodeRow, now: number): RespawnAttempt;
 export declare function clearRespawnPolicy(nodeId: string): void;

package/dist/daemon/reconcilers/node-lifecycle/respawn-policy.js

@@ -2,6 +2,12 @@ import { recordRespawnAttempt } from '../../../core/canvas/index.js';
 export const MAX_RESPAWN_ATTEMPTS = 6;
 const RESPAWN_BACKOFF_BASE_MS = 5_000;
 const RESPAWN_BACKOFF_MAX_MS = 10 * 60_000;
+/** How long an offline box waits before re-testing the network and relaunching.
+ *  Flat, not exponential: this is not a failure sequence being paced, it is a
+ *  wait for a condition outside the node — the same "my wifi is back" gate the
+ *  broker's connection-fault retry uses, sampled less often because each sample
+ *  here can cost a whole broker launch. */
+export const OFFLINE_RESPAWN_RETRY_MS = 30_000;
 export function respawnBackoffMs(consecutiveFailures) {
     if (consecutiveFailures <= 0)
         return 0;
@@ -30,6 +36,18 @@ export function decideRespawnAttempt(row, now) {
         exhausted: failures >= MAX_RESPAWN_ATTEMPTS,
     };
 }
+/** Hold a relaunch while the box has no network, WITHOUT advancing the failure
+ *  sequence. An outage makes every launch fail identically, so counting those
+ *  launches spends the whole respawn budget on a condition the node did not
+ *  cause and cannot fix — the node terminalizes minutes into an outage and only
+ *  a human revive brings it back. Re-arming instead parks it: the row stays
+ *  active, the tick re-enters this policy after the window, and the first
+ *  launch made once the network returns resumes the interrupted turn. */
+export function deferRespawnWhileOffline(nodeId, failures, now) {
+    const notBefore = new Date(now + OFFLINE_RESPAWN_RETRY_MS).toISOString();
+    recordRespawnAttempt(nodeId, { failures, notBefore });
+    return { failures, notBefore, exhausted: false };
+}
 /** Persist the policy decision through the daemon-only canvas writer. */
 export function recordRespawnPolicy(row, now) {
     const attempt = decideRespawnAttempt(row, now);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.277",
+  "version": "0.3.279",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.277",
+  "version": "0.3.279",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.277",
+      "version": "0.3.279",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {