@north-light/crouter 0.3.199 → 0.3.201

package/dist/core/__tests__/helpers/harness.js

@@ -28,7 +28,7 @@ import { fileURLToPath } from 'node:url';
 import { createRequire } from 'node:module';
 import { createNode, getNode, recordPid, subscribersOf, subscriptionsOf, } from '../../canvas/canvas.js';
 import { closeDb } from '../../canvas/db.js';
-import { reviveNode } from '../../runtime/revive.js';
+import { spawnChild } from '../../runtime/spawn.js';
 import { superviseTick } from '../../../daemon/crtrd.js';
 import { DaemonFleet } from '../../../daemon/fleet.js';
 import { apiSocketPath } from '../../canvas/paths.js';
@@ -150,11 +150,11 @@ export async function createHarness(opts = {}) {
     const tmpHome = mkdtempSync(join(tmpdir(), 'crtr-harness-HOME-'));
     const session = `${opts.sessionPrefix ?? 'crtr-harness'}-${process.pid}-${Date.now().toString(36)}`;
     // The harness reads/writes the isolated canvas in-process. CRTR_PI_BINARY in
-    // OUR env makes in-process revives (superviseTick → reviveNode → openNodeWindow)
+    // OUR env makes in-process launches (spawnChild and superviseTick → reviveNode)
     // bake the fake-pi into the command string.
     process.env['CRTR_HOME'] = home;
     // HOME must be isolated in THIS process too, not just in the subprocess envs
-    // below: an in-process launch (spawnHeadlessChild's reviveNode, superviseTick
+    // below: an in-process launch (spawnHeadlessChild's spawnChild, superviseTick
     // pass-2 wakes) builds its broker env from process.env, so a real HOME here
     // makes every broker read the developer's OWN ~/.pi/agent — auth.json and the
     // managed subscription pools — instead of agentHome, and provider tests then
@@ -202,7 +202,7 @@ export async function createHarness(opts = {}) {
     resetEventSourceForTests();
     bindDaemonEventSource();
     // The harness also stands in for the daemon's FLEET: every in-harness broker
-    // launch (reviveNode from a test, superviseTick pass-2 wakes) registers its
+    // launch (spawnChild, reviveNode, superviseTick pass-2 wakes) registers its
     // ChildProcess handle here, and real child exits enqueue exit-policy jobs on
     // this serial work lane — the same single-lane discipline crtrd runs, but
     // drainable to a deterministic quiescent point. Reset first for the same
@@ -367,17 +367,9 @@ export async function createHarness(opts = {}) {
     }
     function nodeDirs() {
         try {
-            // Node ids are minted by newNodeId() (runtime/nodes.ts) as
-            // `<install>-<time36>-<rand4hex>` (a72554e3 stamped the canvas-install id
-            // onto the historical 2-segment `<time36>-<rand4hex>` shape, so the id is
-            // opaque and its segment count has already changed once — mirror
-            // profiles/manifest.ts's ID_SHAPE rather than hard-coding a segment
-            // count). Scope the scan to "one or more lowercase-alnum segments ending
-            // in an 8-hex random suffix" so a stray non-node sibling under nodes/ is
-            // never miscounted as a new node dir — e.g. a `reports/` dir created for
-            // an empty node id (the rare CI flake on compiled-seam run 27459304455 that
-            // broke the spawn counters with `expected exactly 1 new node dir, got
-            // [<id>, reports]`), or literal `reports` (no hyphen, no hex suffix).
+            // Node ids end in an 8-hex random suffix and may have any number of
+            // lowercase-alphanumeric prefix segments. Only return those node dirs so
+            // fixture cleanup never treats a non-node sibling as a canvas row.
             return readdirSync(join(home, 'nodes')).filter((d) => /^[a-z0-9]+(?:-[a-z0-9]+)*-[0-9a-f]{8}$/.test(d));
         }
         catch {
@@ -507,46 +499,16 @@ export async function createHarness(opts = {}) {
             return id;
         },
         async spawnHeadlessChild(parentId, task, o = {}) {
-            const before = new Set(nodeDirs());
-            // The synchronous CLI must reach the separate API fixture process, which
-            // creates the row and necessarily starts a fixture-owned broker before
-            // returning. Production has one daemon/fleet; the harness split exists
-            // only because spawnSync blocks this process's event loop. Retire that
-            // fixture launch immediately, then perform the authoritative boot through
-            // THIS process's reviveNode so the harness fleet owns the ChildProcess
-            // handle and its real exit event (§H harness mode a).
-            const args = ['node', 'new', task, '--parent', parentId, '--cwd', CROUTER];
-            if (o.kind)
-                args.push('--kind', o.kind);
-            if (o.mode)
-                args.push('--mode', o.mode);
-            if (o.model)
-                args.push('--model', o.model);
-            const res = cli(parentId, args);
-            if (res.code !== 0) {
-                throw new Error(`spawnHeadlessChild(${parentId}) failed (code ${res.code})\n--stdout--\n${res.stdout}\n--stderr--\n${res.stderr}`);
-            }
-            const added = nodeDirs().filter((d) => !before.has(d));
-            if (added.length !== 1) {
-                throw new Error(`spawnHeadlessChild: expected exactly 1 new node dir, got [${added.join(', ')}]`);
-            }
-            const childId = added[0];
-            closeDb();
-            const fixtureRow = getNode(childId);
-            const fixturePid = fixtureRow?.pi_pid ?? null;
-            const fixtureIdentity = fixtureRow?.pi_pid_identity ?? null;
-            const priorBoots = harness.bootCount(childId);
-            if (fixturePid !== null && fixtureIdentity !== null && recordedPidLiveness(fixturePid, fixtureIdentity) === 'alive') {
-                process.kill(fixturePid, 'SIGTERM');
-                await waitFor(() => recordedPidLiveness(fixturePid, fixtureIdentity) !== 'alive', {
-                    timeoutMs: 10_000,
-                    intervalMs: 25,
-                    label: `API-fixture broker exit for ${childId}`,
-                });
-            }
-            reviveNode(childId, { resume: false });
-            await harness.awaitBoot(childId, { minCount: priorBoots + 1 });
-            return childId;
+            const result = await spawnChild({
+                kind: o.kind ?? 'general',
+                cwd: CROUTER,
+                prompt: task,
+                parent: parentId,
+                ...(o.mode !== undefined ? { mode: o.mode } : {}),
+                ...(o.model !== undefined ? { model: o.model } : {}),
+            });
+            await harness.awaitBoot(result.node.node_id);
+            return result.node.node_id;
         },
         cli,
         async stop(nodeId, reason = 'stop', errorMessage) {

package/dist/core/__tests__/seam/broker-crash-teardown.test.js

@@ -10,11 +10,10 @@
 // lifecycle close` then tears the replacement down (shutdown frame → exit,
 // socket unlinked, status canceled, daemon leaves it).
 //
-// The harness API server is a separate process (so synchronous CLI calls can be
-// served) whose fixture fleet is inert; spawnHeadlessChild retires its fixture
-// broker and reboots the node through THIS process's reviveNode, so every
-// broker below is harness-fleet-owned and every SIGKILL's REAL ChildProcess
-// exit drives policy automatically — no synthetic delivery, no tick, no grace.
+// spawnHeadlessChild calls the production birth path in the harness process, so
+// every broker below is harness-fleet-owned from its first and only boot and
+// every SIGKILL's REAL ChildProcess exit drives policy automatically — no
+// synthetic delivery, no tick, no grace.
 // Each crash has its own real broker setup, so either top-level test remains a
 // complete journey under name filtering and pays only its own first respawn
 // backoff.

package/dist/core/__tests__/seam/dormancy-release.test.js

@@ -93,6 +93,7 @@ test('idle-release settles its real watcher before exit; daemon revives exactly
     // settles its own prompt lifecycle: watcher → engine → stophook → settle →
     // broker exit. No test-driven turn or settlement dispatch is involved.
     await awaitReleased(manager);
+    await h.awaitFleetExit(manager);
     assert.equal(readCursor(manager), first.entry_id, 'the exact handed-off row commits before clean shutdown');
     const cyclesAfterRelease = h.node(manager).cycles ?? 0;
     await h.tick();
@@ -112,6 +113,7 @@ test('idle-release settles its real watcher before exit; daemon revives exactly
     await h.awaitBoot(manager, { minCount: 2 });
     await h.awaitWake(manager, { sinceCount: injectedBeforeSecond, match: /second completed/ });
     await awaitReleased(manager);
+    await h.awaitFleetExit(manager);
     assert.equal(readCursor(manager), second.entry_id, 'the later row commits at its own natural idle release');
     await h.tick();
     assert.equal(h.node(manager).cycles ?? 0, cyclesAfterRelease + 1, 'the settled later row does not cause a duplicate revival');

package/dist/core/human/scan.d.ts

@@ -1,9 +1,7 @@
 import type { PageTicketSummary, TicketSummary } from './types.js';
 /** Read all unresolved page/review tickets, newest first. Progress never affects visibility. */
 export declare function scanInbox(): TicketSummary[];
-export interface PageHistoryEntry extends PageTicketSummary {
-    state: 'pending' | 'resolved' | 'canceled' | 'passive';
-}
+export type PageHistoryEntry = PageTicketSummary;
 /**
  * Every page ticket raised by one node — pending, resolved or canceled — oldest
  * first. This is the durable discovery seam for transcript placement, so it is a

package/dist/core/human/scan.js

@@ -56,6 +56,7 @@ function pageSummary(dir, id) {
         awaitsResponse: manifest.delivery.reply,
         source: manifest.source ?? {},
         emittedAt,
+        state: pageTicketState(dir),
         claim: claimSummary(dir),
     };
 }
@@ -112,9 +113,8 @@ export function scanPageHistory(nodeId) {
         const summary = pageSummary(dir, basename(dir));
         if (summary === null || summary.source.nodeId !== nodeId)
             continue;
-        const state = pageTicketState(dir);
-        const result = state === 'resolved' ? readTicketResult(dir) : null;
-        items.push({ ...summary, state, ...(result?.kind === 'page' ? { answerDigest: result.summary.replace(/\s+/g, ' ').trim() } : {}) });
+        const result = summary.state === 'resolved' ? readTicketResult(dir) : null;
+        items.push({ ...summary, ...(result?.kind === 'page' ? { answerDigest: result.summary.replace(/\s+/g, ' ').trim() } : {}) });
     }
     return items.sort((a, b) => Date.parse(a.emittedAt) - Date.parse(b.emittedAt) || a.id.localeCompare(b.id));
 }

package/dist/core/human/types.d.ts

@@ -65,6 +65,7 @@ export interface PageTicketSummary {
     steps: number;
     slotKinds: string[];
     awaitsResponse: boolean;
+    state: 'pending' | 'resolved' | 'canceled' | 'passive';
 }
 /** The only pending-ticket shape scanners expose. */
 export type TicketSummary = ReviewTicketSummary | PageTicketSummary;

package/dist/core/keybindings/attach-control.d.ts

@@ -28,6 +28,9 @@ export declare const ATTACH_CONTROL_BINDINGS: readonly [{
 }, {
     readonly menuId: "crtr.tmux.menu.attach.profile-files";
     readonly actionId: "crtr.attach.profile-files";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.search";
+    readonly actionId: "crtr.attach.search";
 }, {
     readonly menuId: "crtr.tmux.menu.attach.whip";
     readonly actionId: "crtr.attach.whip";

package/dist/core/keybindings/attach-control.js

@@ -9,6 +9,7 @@ export const ATTACH_CONTROL_BINDINGS = [
     { menuId: 'crtr.tmux.menu.attach.command.inspect', actionId: 'crtr.attach.command.inspect' },
     { menuId: 'crtr.tmux.menu.attach.file-review', actionId: 'crtr.attach.file-review' },
     { menuId: 'crtr.tmux.menu.attach.profile-files', actionId: 'crtr.attach.profile-files' },
+    { menuId: 'crtr.tmux.menu.attach.search', actionId: 'crtr.attach.search' },
     { menuId: 'crtr.tmux.menu.attach.whip', actionId: 'crtr.attach.whip' },
 ];
 const ATTACH_CONTROL_PREFIX = '\x1b_crtr;';

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

@@ -8,8 +8,8 @@ type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' |
 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' | 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.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.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.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 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.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.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

@@ -77,6 +77,7 @@ export const BINDING_CATALOG = Object.freeze([
     ...attachEntry('crtr.tmux.menu.attach.command.inspect', 'crtr.attach.command.inspect', 'Inspect loaded command', 'Open the loaded slash command’s expanded prompt.', ['h'], ['alt+shift+h']),
     ...attachEntry('crtr.tmux.menu.attach.file-review', 'crtr.attach.file-review', 'Review a file', 'Open a line-anchored review of a file named in the transcript.', [], ['alt+shift+r']),
     ...attachEntry('crtr.tmux.menu.attach.profile-files', 'crtr.attach.profile-files', 'Search profile files', 'Search files across the node’s profile projects, profile memory, cwd, and ancestor crouter memory stores.', ['f'], ['ctrl+f']),
+    ...attachEntry('crtr.tmux.menu.attach.search', 'crtr.attach.search', 'Search transcript', 'Search the transcript as it is currently displayed — folded tool output is not searched until it is unfolded.', ['/'], ['alt+/']),
     ...attachEntry('crtr.tmux.menu.attach.whip', 'crtr.attach.whip', 'Whip agent', 'Interrupt the agent and send a playful command.', ['w'], []),
     b('crtr.attach.scroll.up', 'Attach', 'Scroll up', 'Scroll the transcript one line up.', ['shift+up'], 'terminal', ATTACH_CONTEXTS),
     b('crtr.attach.scroll.down', 'Attach', 'Scroll down', 'Scroll the transcript one line down.', ['shift+down'], 'terminal', ATTACH_CONTEXTS),
@@ -85,6 +86,10 @@ export const BINDING_CATALOG = Object.freeze([
     b('crtr.attach.scroll.live', 'Attach', 'Return to live', 'Return the transcript to the live bottom.', ['shift+end'], 'terminal', ATTACH_CONTEXTS),
     b('crtr.attach.mouse.toggle', 'Attach', 'Toggle mouse wheel scrolling', 'Toggle mouse wheel scrolling on or off.', ['alt+shift+o'], 'terminal', ATTACH_CONTEXTS),
     b('crtr.attach.copy.message', 'Attach', 'Copy visible message', 'Copy the newest message visible in the transcript viewport.', ['alt+shift+y'], 'terminal', ATTACH_CONTEXTS),
+    b('crtr.attach.search.next', 'Attach', 'Next match', 'Move to the next transcript search match.', ['n'], 'terminal', ['attach.search']),
+    b('crtr.attach.search.previous', 'Attach', 'Previous match', 'Move to the previous transcript search match.', ['shift+n'], 'terminal', ['attach.search']),
+    b('crtr.attach.search.edit', 'Attach', 'Edit query', 'Return to editing the transcript search query.', ['/'], 'terminal', ['attach.search']),
+    b('crtr.attach.search.close', 'Attach', 'Close search', 'Leave transcript search and clear its highlights.', ['escape'], 'terminal', ['attach.search'], 'dismiss-modal'),
     b('crtr.graph.down', 'GRAPH', 'Move down', 'Move to the next graph row.', ['j'], 'terminal', ['graph']),
     b('crtr.graph.up', 'GRAPH', 'Move up', 'Move to the previous graph row.', ['k'], 'terminal', ['graph']),
     b('crtr.graph.first', 'GRAPH', 'First row', 'Move to the first graph row.', ['g'], 'terminal', ['graph']),
@@ -219,6 +224,7 @@ export const SAFETY_REQUIREMENTS = Object.freeze([
     { context: 'graph.confirm', capability: 'dismiss-modal' },
     { context: 'inspector', capability: 'leave-screen' },
     { context: 'inspector', capability: 'dismiss-modal' },
+    { context: 'attach.search', capability: 'dismiss-modal' },
     { context: 'browse', capability: 'leave-screen' },
     { context: 'browse.search', capability: 'dismiss-modal' },
     { context: 'profile.menu', capability: 'leave-screen' },

package/dist/core/runtime/node-read.d.ts

@@ -28,9 +28,20 @@ export interface NodeSnapshotRead {
         source: 'builtin';
     }>;
 }
+export interface NodeMessagesPageRead {
+    messages: unknown[];
+    nextCursor: string | null;
+}
+export interface NodeMessagesPageOptions {
+    cursor?: string;
+    limit?: number;
+}
 /** Reconstruct a persisted session without launching its broker. Backs the
  * machine-readable snapshot endpoint and the human transcript render. */
 export declare function readNodeSnapshot(nodeId: string): Promise<NodeSnapshotRead>;
+/** A backward-paged, chronological window over the same visible history as a
+ * snapshot. `nextCursor` walks toward older messages. */
+export declare function readNodeMessagesPage(nodeId: string, { cursor, limit }: NodeMessagesPageOptions): Promise<NodeMessagesPageRead>;
 /** Human-readable history only: text messages plus terse tool records, never
  * private model reasoning. */
 export declare function transcriptMarkdown(nodeId: string): Promise<string>;

package/dist/core/runtime/node-read.js

@@ -135,9 +135,10 @@ function readToolGroupSummaries(nodeId) {
         return {};
     }
 }
-/** Reconstruct a persisted session without launching its broker. Backs the
- * machine-readable snapshot endpoint and the human transcript render. */
-export async function readNodeSnapshot(nodeId) {
+/** Reconstruct the visible message history from a stable at-rest session copy.
+ * Both snapshot and paged reads use this one path so their histories cannot
+ * diverge. */
+async function reconstructVisibleMessages(nodeId) {
     const node = getNode(nodeId);
     if (node === null) {
         throw new InputError({ error: 'not_found', message: `no node: ${nodeId}`, field: 'id', next: 'List nodes with `crtr node inspect list`.' });
@@ -146,57 +147,122 @@ export async function readNodeSnapshot(nodeId) {
     if (sessionFile === null) {
         throw new InputError({ error: 'no_session', message: `node has no readable session file: ${nodeId}`, field: 'id', next: 'Choose a node with captured conversation history.' });
     }
-    const tempDir = mkdtempSync(join(tmpdir(), 'crtr-node-snapshot-'));
+    const tempDir = mkdtempSync(join(tmpdir(), 'crtr-node-session-'));
     try {
         const copy = join(tempDir, basename(sessionFile));
         copyFileSync(sessionFile, copy);
         const manager = SessionManager.open(copy);
         const context = manager.buildSessionContext();
         const messages = visibleMessages(cycleAwareMessages(manager), { boundaryReviewId: node.review_binding?.review_id });
-        const sessionId = manager.getSessionId();
-        const sessionName = manager.getSessionName();
-        const snapshot = {
-            messages,
-            stats: statsFromMessages(messages, sessionId, sessionFile),
-            // pi's `get_state` shape (RpcSessionState), reconstructed offline: the
-            // live-only fields report their at-rest values (nothing is streaming or
-            // queued for a node with no broker).
-            state: {
-                model: await resolveRecordedModel(context.model),
-                thinkingLevel: context.thinkingLevel,
-                isStreaming: false,
-                isCompacting: false,
-                steeringMode: 'one-at-a-time',
-                followUpMode: 'one-at-a-time',
-                sessionFile,
-                sessionId,
-                sessionName,
-                autoCompactionEnabled: true,
-                messageCount: messages.length,
-                pendingMessageCount: 0,
-            },
-            // A snapshot reconstructed from the .jsonl alone: display state is broker
-            // process state (last setStatus/setWidget/setTitle) and is not persisted,
-            // so an offline read has none.
-            display: { statuses: {}, widgets: {}, title: undefined },
-            // The unrun queue lives in the engine's memory; a dormant node has no
-            // engine, so nothing is waiting to run.
-            queued: { steering: [], followUp: [] },
-            // Sidecar summaries survive broker exit so a dormant transcript receives
-            // the same completed-group data as a live welcome snapshot. Malformed or
-            // absent sidecars are deliberately ignored: tool calls remain visible.
-            toolGroupSummaries: readToolGroupSummaries(nodeId),
-        };
         return {
-            nodeId,
-            snapshot,
-            commands: BUILTIN_SLASH_COMMANDS.map((c) => ({ ...c, source: 'builtin' })),
+            sessionFile,
+            messages,
+            model: context.model,
+            thinkingLevel: context.thinkingLevel,
+            sessionId: manager.getSessionId(),
+            sessionName: manager.getSessionName(),
         };
     }
     finally {
         rmSync(tempDir, { recursive: true, force: true });
     }
 }
+function invalidCursor() {
+    throw new InputError({
+        error: 'invalid_cursor',
+        message: 'cursor must be a base64url-encoded messages cursor.',
+        field: 'cursor',
+        next: 'Omit cursor to start from the newest messages.',
+    });
+}
+function decodeMessagesCursor(cursor, messagesLength) {
+    if (!/^[A-Za-z0-9_-]+$/u.test(cursor))
+        invalidCursor();
+    let parsed;
+    try {
+        const json = Buffer.from(cursor, 'base64url').toString('utf8');
+        if (Buffer.from(json, 'utf8').toString('base64url') !== cursor)
+            invalidCursor();
+        parsed = JSON.parse(json);
+    }
+    catch {
+        invalidCursor();
+    }
+    if (typeof parsed !== 'object'
+        || parsed === null
+        || parsed.v !== 1
+        || !Number.isSafeInteger(parsed.before)) {
+        invalidCursor();
+    }
+    const before = parsed.before;
+    if (before < 0 || before > messagesLength)
+        invalidCursor();
+    return before;
+}
+function encodeMessagesCursor(before) {
+    return Buffer.from(JSON.stringify({ v: 1, before }), 'utf8').toString('base64url');
+}
+/** Reconstruct a persisted session without launching its broker. Backs the
+ * machine-readable snapshot endpoint and the human transcript render. */
+export async function readNodeSnapshot(nodeId) {
+    const read = await reconstructVisibleMessages(nodeId);
+    const snapshot = {
+        messages: read.messages,
+        stats: statsFromMessages(read.messages, read.sessionId, read.sessionFile),
+        // pi's `get_state` shape (RpcSessionState), reconstructed offline: the
+        // live-only fields report their at-rest values (nothing is streaming or
+        // queued for a node with no broker).
+        state: {
+            model: await resolveRecordedModel(read.model),
+            thinkingLevel: read.thinkingLevel,
+            isStreaming: false,
+            isCompacting: false,
+            steeringMode: 'one-at-a-time',
+            followUpMode: 'one-at-a-time',
+            sessionFile: read.sessionFile,
+            sessionId: read.sessionId,
+            sessionName: read.sessionName,
+            autoCompactionEnabled: true,
+            messageCount: read.messages.length,
+            pendingMessageCount: 0,
+        },
+        // A snapshot reconstructed from the .jsonl alone: display state is broker
+        // process state (last setStatus/setWidget/setTitle) and is not persisted,
+        // so an offline read has none.
+        display: { statuses: {}, widgets: {}, title: undefined },
+        // The unrun queue lives in the engine's memory; a dormant node has no
+        // engine, so nothing is waiting to run.
+        queued: { steering: [], followUp: [] },
+        // Sidecar summaries survive broker exit so a dormant transcript receives
+        // the same completed-group data as a live welcome snapshot. Malformed or
+        // absent sidecars are deliberately ignored: tool calls remain visible.
+        toolGroupSummaries: readToolGroupSummaries(nodeId),
+    };
+    return {
+        nodeId,
+        snapshot,
+        commands: BUILTIN_SLASH_COMMANDS.map((c) => ({ ...c, source: 'builtin' })),
+    };
+}
+/** A backward-paged, chronological window over the same visible history as a
+ * snapshot. `nextCursor` walks toward older messages. */
+export async function readNodeMessagesPage(nodeId, { cursor, limit = 200 }) {
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 500) {
+        throw new InputError({
+            error: 'invalid_limit',
+            message: 'limit must be an integer from 1 through 500.',
+            field: 'limit',
+            next: 'Use a limit from 1 through 500.',
+        });
+    }
+    const { messages } = await reconstructVisibleMessages(nodeId);
+    const before = cursor === undefined ? messages.length : decodeMessagesCursor(cursor, messages.length);
+    const start = Math.max(0, before - limit);
+    return {
+        messages: messages.slice(start, before),
+        nextCursor: start === 0 ? null : encodeMessagesCursor(start),
+    };
+}
 function textFromContent(content) {
     if (typeof content === 'string')
         return content;

package/dist/daemon/api/handlers/inbox.js

@@ -187,6 +187,7 @@ function handleList() {
                 slot_kinds: item.slotKinds,
                 inbox: item.inbox,
                 awaits_response: item.awaitsResponse,
+                state: item.state,
             };
             if (item.subtitle !== '')
                 dto.subtitle = item.subtitle;

package/dist/daemon/api/handlers/nodes.js

@@ -14,7 +14,7 @@ import { childrenOf, subscribersOf, subscriptionsOf, setMessageWait, updateNode
 import { subtreeIds } from '../../../core/canvas/nav-model.js';
 import { contextDir, reportsDir } from '../../../core/canvas/paths.js';
 import { nodeArtifacts } from '../../../core/canvas/history.js';
-import { readNodeSession, readNodeSnapshot, transcriptMarkdown } from '../../../core/runtime/node-read.js';
+import { readNodeMessagesPage, readNodeSession, readNodeSnapshot, transcriptMarkdown } from '../../../core/runtime/node-read.js';
 import { reviveAll } from '../../../core/runtime/revive-all.js';
 import { promote, requestYield, reshapeNode } from '../../../core/runtime/promote.js';
 import { recycleNode } from '../../../core/runtime/recycle.js';
@@ -301,6 +301,38 @@ async function handleSnapshot(ctx) {
     };
     return { status: 200, body };
 }
+function parseMessagesQuery(ctx) {
+    for (const [field] of ctx.query) {
+        if (field !== 'cursor' && field !== 'limit')
+            throw usage(`unknown messages query parameter: ${field}`);
+    }
+    const cursors = ctx.query.getAll('cursor');
+    const limits = ctx.query.getAll('limit');
+    if (cursors.length > 1)
+        throw usage('cursor must appear at most once');
+    if (limits.length > 1)
+        throw usage('limit must appear at most once');
+    if (limits.length === 0)
+        return cursors.length === 0 ? {} : { cursor: cursors[0] };
+    const rawLimit = limits[0];
+    const limit = Number(rawLimit);
+    if (!Number.isSafeInteger(limit) || rawLimit === '') {
+        throw usage('limit must be an integer from 1 through 500');
+    }
+    return cursors.length === 0 ? { limit } : { cursor: cursors[0], limit };
+}
+/** Offline, backward-paged read of the cycle-flattened visible history. */
+async function handleMessages(ctx) {
+    const id = ctx.params['id'];
+    const read = await readNodeMessagesPage(id, parseMessagesQuery(ctx));
+    const body = {
+        node_id: id,
+        messages: read.messages,
+        next_cursor: read.nextCursor,
+        captured_at: nowIso(),
+    };
+    return { status: 200, body };
+}
 /** The faithful export read: raw `.jsonl` bytes + assembled system prompt.
  *  `/snapshot` reconstructs a cycle-flattened `AgentMessage[]` for renderers and
  *  drops what a renderer cannot show; this drops nothing. */
@@ -598,6 +630,7 @@ export const nodeRoutes = [
     { method: 'POST', pattern: '/v1/nodes/revive-all', handler: () => handleReviveAll() },
     { method: 'GET', pattern: '/v1/nodes/:id', handler: handleDetail },
     { method: 'GET', pattern: '/v1/nodes/:id/snapshot', handler: handleSnapshot },
+    { method: 'GET', pattern: '/v1/nodes/:id/messages', handler: handleMessages },
     { method: 'GET', pattern: '/v1/nodes/:id/session', handler: handleSession },
     { method: 'GET', pattern: '/v1/nodes/:id/transcript', handler: handleTranscript },
     { method: 'GET', pattern: '/v1/nodes/:id/context', handler: handleContext },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.199",
+  "version": "0.3.201",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -83,7 +83,8 @@
     "prepublishOnly": "npm run build",
     "test": "node --conditions=crtr-src --import tsx/esm --test --test-concurrency=4 --test-timeout=10000 'src/**/__tests__/*.test.ts'",
     "test:serial": "node --conditions=crtr-src --import tsx/esm --test --test-concurrency=1 --test-timeout=60000 'src/**/__tests__/serial/*.test.ts'",
-    "test:seam": "npm run build && node --test --test-concurrency=1 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'"
+    "test:seam": "npm run build && npm run test:seam:built",
+    "test:seam:built": "node --test --test-concurrency=2 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'"
   },
   "overrides": {
     "@earendil-works/pi-ai": "0.84.1",

package/runtime.lock.json

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