@north-light/crouter 0.3.232 → 0.3.234

package/dist/shared/env.js

@@ -0,0 +1,171 @@
+// The reader-side surface for every environment variable crouter reads back
+// out of `process.env`, outside `core/runtime/spawn-env.ts`'s writer
+// allowlist. That module documents what a broker child is ADMITTED to see;
+// this one documents what crouter itself reads. Two families:
+//
+//   - Identity: raw passthrough (`string | undefined`, exactly what
+//     `process.env[name]` returns). Every existing call site keeps its own
+//     established fallback (`?? ''`, `|| null`, `?? cfg.cwd`, a presence
+//     check, ...) — the fallback has always been call-site-owned, not
+//     var-owned, so centralizing it here would be a behavior change, not a
+//     dedup. `CRTR_HOME` also has a resolved-path accessor, `crtrHome()` in
+//     `core/canvas/paths.ts`; that stays the canonical way to get the
+//     resolved canvas home; `envHomeOverride()` here is for the handful of
+//     sites that want the raw override value itself (to check presence or
+//     propagate it verbatim to a child env).
+//
+//   - Tuning: parsed, with the default baked into the accessor. Each of
+//     these had exactly one parse site before this module existed; the
+//     parse logic moved here unchanged so a second site, if one appears,
+//     reads the single implementation instead of re-deriving it.
+//
+// `CRTR_DIR_NAME` is NOT here — it is a plain exported string constant
+// (`types.ts`), never read off `process.env`.
+// Identity
+/** The current node's id (`CRTR_NODE_ID`), or undefined outside a node. */
+export function envNodeId() {
+    return process.env['CRTR_NODE_ID'];
+}
+/** The current node's target profile id (`CRTR_PROFILE_ID`), or undefined. */
+export function envProfileId() {
+    return process.env['CRTR_PROFILE_ID'];
+}
+/** The current node's working directory (`CRTR_NODE_CWD`), or undefined. */
+export function envNodeCwd() {
+    return process.env['CRTR_NODE_CWD'];
+}
+/** An explicit model-routing override for this turn (`CRTR_MODEL_INTENT`), or
+ *  undefined. Cleared (not read) via `delete process.env['CRTR_MODEL_INTENT']`
+ *  in `runtime/broker.ts` — a mutation, not a read, so it stays there. */
+export function envModelIntent() {
+    return process.env['CRTR_MODEL_INTENT'];
+}
+/** The raw `CRTR_HOME` override, unresolved. Use `crtrHome()`
+ *  (`core/canvas/paths.ts`) to get the resolved canvas-home path; use this
+ *  only when a caller needs the override itself — to check whether one is
+ *  set, or to propagate it verbatim into a child process's env. */
+export function envHomeOverride() {
+    return process.env['CRTR_HOME'];
+}
+// Tuning
+/** Generic `Number(raw)` parse with a positive-finite guard, shared by every
+ *  millisecond tuning var below (each previously reimplemented this locally,
+ *  identically). */
+function parsePositiveMs(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+const DEFAULT_STREAM_WATCHDOG_MS = 5 * 60_000; // 5 minutes.
+/** Dead-provider watchdog timeout (`CRTR_STREAM_WATCHDOG_MS`), 5 minutes by
+ *  default. See `runtime/stream-watchdog.ts` for what it guards. */
+export function envStreamWatchdogMs() {
+    return parsePositiveMs(process.env['CRTR_STREAM_WATCHDOG_MS'], DEFAULT_STREAM_WATCHDOG_MS);
+}
+const DEFAULT_WATCHER_TICK_MS = 800;
+/** The canvas inbox watcher's poll tick (`CRTR_WATCHER_TICK_MS`). */
+export function envWatcherTickMs() {
+    return parsePositiveMs(process.env['CRTR_WATCHER_TICK_MS'], DEFAULT_WATCHER_TICK_MS);
+}
+const DEFAULT_WATCHER_DEBOUNCE_MS = 1000;
+/** The canvas inbox watcher's debounce window (`CRTR_WATCHER_DEBOUNCE_MS`). */
+export function envWatcherDebounceMs() {
+    return parsePositiveMs(process.env['CRTR_WATCHER_DEBOUNCE_MS'], DEFAULT_WATCHER_DEBOUNCE_MS);
+}
+const DEFAULT_RECAP_IDLE_MS = 60_000;
+/** No-new-message window before a recap is shown (`CRTR_RECAP_IDLE_MS`), 60s
+ *  by default. */
+export function envRecapIdleMs() {
+    return parsePositiveMs(process.env['CRTR_RECAP_IDLE_MS'], DEFAULT_RECAP_IDLE_MS);
+}
+/** Explicit recap-model override (`CRTR_RECAP_MODEL`), trimmed; undefined if
+ *  unset or blank. */
+export function envRecapModelOverride() {
+    const raw = process.env['CRTR_RECAP_MODEL'];
+    return raw !== undefined && raw.trim() !== '' ? raw.trim() : undefined;
+}
+const DEFAULT_BASH_VALVE_MS = 5 * 60 * 1000;
+/** The bash safety-valve deadline (`CRTR_BASH_VALVE_MS`), 5 minutes by
+ *  default; undocumented test-only override so the E2E valve check doesn't
+ *  sleep 5 minutes. */
+export function envBashValveMs() {
+    return parsePositiveMs(process.env['CRTR_BASH_VALVE_MS'], DEFAULT_BASH_VALVE_MS);
+}
+/** Explicit pidfile path override (`CRTR_PIDFILE`, tests only); undefined if
+ *  unset or blank. */
+export function envPidfileOverride() {
+    const raw = process.env['CRTR_PIDFILE'];
+    return raw !== undefined && raw !== '' ? raw : undefined;
+}
+const DEFAULT_BROKER_ENGINE = '@earendil-works/pi-coding-agent';
+/** The broker engine module spec (`CRTR_BROKER_ENGINE`, the T11 test seam),
+ *  defaulting to the real SDK. `runtime/host.ts` layers `inv.env` ahead of
+ *  this (a launch-time override mirrored into the child's env, since
+ *  spawn-env.ts's default-deny allowlist strips `CRTR_*` from ambient env). */
+export function envBrokerEngine() {
+    return process.env['CRTR_BROKER_ENGINE'] ?? DEFAULT_BROKER_ENGINE;
+}
+/** Test-only pi-binary substitution (`CRTR_PI_BINARY`) so the integration
+ *  harness can point a real `crtr node new` at a deterministic fake-pi
+ *  vehicle. Undefined in production. */
+export function envPiBinaryOverride() {
+    return process.env['CRTR_PI_BINARY'];
+}
+/** Whether implicit daemon autostart is suppressed for this invocation
+ *  (`CRTR_NO_DAEMON_AUTOSTART=1`). */
+export function envNoDaemonAutostart() {
+    return process.env['CRTR_NO_DAEMON_AUTOSTART'] === '1';
+}
+/** The `--tcp` fallback for crtrd's opt-in TCP listener (`CRTRD_TCP`), raw
+ *  (`host:port` or undefined — absent means unix socket only). */
+export function envCrtrdTcp() {
+    return process.env['CRTRD_TCP'];
+}
+/** Kill switch for the host-exports writer/pruner (`CRTR_NO_EXPORTS=1`). */
+export function envNoExports() {
+    return process.env['CRTR_NO_EXPORTS'] === '1';
+}
+/** Verbose-diagnostics gate for otherwise-silent best-effort catches
+ *  (`CRTR_DEBUG=1`). Distinct from `CRTR_DEBUG_PID_LIVENESS`
+ *  (`core/canvas/pid.ts`), a different, unrelated var. */
+export function envDebug() {
+    return process.env['CRTR_DEBUG'] === '1';
+}
+// Precedence — broker-supervision.ts's threshold/interval overrides. Each
+// returns the raw parsed value with NO default: the caller (config for the
+// thresholds, a hardcoded production constant for the intervals) supplies
+// the default, and env wins over it when set. Undefined, unparseable, or
+// non-positive all mean "no override" — the caller's own default applies.
+function parsePositiveInteger(raw) {
+    if (raw === undefined || raw === '')
+        return undefined;
+    const n = Number(raw);
+    return Number.isSafeInteger(n) && n >= 1 ? n : undefined;
+}
+/** Live-broker automatic-revive cap override (`CRTR_MAX_LIVE_BROKERS`); wins
+ *  over `readConfig('user').brokerThresholds.automaticReviveCap` when set. */
+export function envMaxLiveBrokers() {
+    return parsePositiveInteger(process.env['CRTR_MAX_LIVE_BROKERS']);
+}
+/** Live-broker warning threshold override (`CRTR_WARN_LIVE_BROKERS`); wins
+ *  over `readConfig('user').brokerThresholds.warning` when set. */
+export function envWarnLiveBrokers() {
+    return parsePositiveInteger(process.env['CRTR_WARN_LIVE_BROKERS']);
+}
+function parsePositiveMsNoDefault(raw) {
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+/** Test-only unattended-park interval override (`CRTR_TEST_UNATTENDED_PARK_MS`),
+ *  gated by `envNoDaemonAutostart()` at the call site; no production default. */
+export function envTestUnattendedParkMs() {
+    return parsePositiveMsNoDefault(process.env['CRTR_TEST_UNATTENDED_PARK_MS']);
+}
+/** Test-only park-summary grace-period override
+ *  (`CRTR_TEST_PARK_SUMMARY_GRACE_MS`); no production default. */
+export function envTestParkSummaryGraceMs() {
+    return parsePositiveMsNoDefault(process.env['CRTR_TEST_PARK_SUMMARY_GRACE_MS']);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.232",
+  "version": "0.3.234",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -74,6 +74,8 @@
     "typecheck:pi-packages": "npx tsc -p src/builtin-pi-packages/pi-crtr-extensions/tsconfig.json",
     "test:build-output": "node scripts/build-concurrency-test.mjs",
     "check:cli-no-canvas": "node scripts/check-cli-no-canvas.mjs",
+    "check:daemon-no-barrel": "node scripts/check-daemon-no-barrel.mjs",
+    "check:quote-style": "node scripts/check-quote-style.mjs",
     "postinstall": "node scripts/postinstall.mjs",
     "install-runtime": "node scripts/install-runtime.mjs",
     "prepack": "node scripts/runtime-lock.mjs prepack",

package/runtime.lock.json

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

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

@@ -1,47 +0,0 @@
-import { type DashboardRow } from './render-source.js';
-export * from './render-source.js';
-/**
- * Render the subscription sub-DAG rooted at `rootId` as an ASCII tree.
- * The root is the first line (no connector prefix); children are indented.
- *
- * Each line: `<glyph> <name> [<kind>/<mode>] ctx <Nk>[ ⚑<asks>]`
- *
- * Returns a multi-line string (no trailing newline).
- */
-export declare function renderTree(rootId: string): string;
-/**
- * Render all canvas roots as a forest. A root is a node with no subscribers
- * (no one subscribes to it = it has no managers in the org chart).
- *
- * If there are no roots on the canvas, returns a placeholder string.
- */
-export declare function renderForest(): string;
-/** One row per node visible in the sub-DAG of `rootId` (including root). */
-export declare function dashboardRows(rootId: string): DashboardRow[];
-/**
- * CHEAP boot builder — one row per node across the entire canvas, with only the
- * fields that need no per-node meta/telemetry/session read. Two db queries total:
- * `listNodes()` + `listFocuses()` (the focus set replaces per-node getFocusByNode
- * calls). See {@link dashboardRowFromNodeRow} for the per-row projection, and
- * {@link enrichRow}/{@link enrichRows}/{@link loadPreview} for the lazy fields.
- */
-export declare function dashboardRowsAll(): DashboardRow[];
-/** Fold the cheap-boot row's deferred fields in for ONE row: the full label
- *  (meta.description → fullName), ctx tokens (telemetry.json), and ⚑ asks. One
- *  meta read + one telemetry read + one ticket scan. Idempotent (no-op once enriched).
- *  For a batch, prefer {@link enrichRows} — it scans each cwd's ticket inbox once. */
-export declare function enrichRow(row: DashboardRow): DashboardRow;
-/** Batch {@link enrichRow}: enrich every not-yet-enriched row, scanning each
- *  distinct cwd's ticket inbox exactly ONCE (via `ticketCountsForNodes`) instead
- *  of per row. Use this for a whole viewport / the full forest; mutates each row in place. */
-export declare function enrichRows(rows: DashboardRow[]): void;
-/** Load the SELECTED row's preview text: the spawn `goal` (initial-prompt.md) plus
- *  the whole-conversation `prompts` and the `lastAssistant` reply — the latter two
- *  folded into ONE session-file read (see {@link readSessionParts}). Mutates the row
- *  in place; idempotent. Call only for the cursor row (and lazily/in-background to
- *  warm the prompt super-search corpus), never on the boot path. */
-export declare function loadPreview(row: DashboardRow): DashboardRow;
-/** {@link isStreaming} keyed by node id alone — hydrates the broker pid off the
- *  db row. The exported "is this node actively generating right now?" guard so a
- *  reap never nukes a node mid-first-turn before its output lands on disk. */
-export declare function isNodeStreaming(nodeId: string): boolean;

package/dist/core/canvas/render.js

@@ -1,245 +0,0 @@
-// render.ts — the db-backed (sync, `openDb`) half of canvas rendering.
-//
-// Holds the SYNC renderers that read the local canvas.db directly
-// (renderTree/renderForest/dashboardRows/dashboardRowsAll/enrichRow(s)/loadPreview
-// /isNodeStreaming). The openDb-FREE `*FromSource` variants + every pure/disk
-// helper they share live in ./render-source.ts; this module imports those helpers
-// (one direction) and RE-EXPORTS the whole render-source module, so existing
-// importers of `render.js` keep resolving both the sync and the FromSource APIs
-// unchanged. A caller that must stay off openDb imports from ./render-source.js
-// directly instead.
-//
-// `subscriptionsOf(nodeId)` returns the nodes a node subscribes to (its reports /
-// children); walking it recursively walks DOWN the org chart.
-import { getNode, listNodes, subscriptionsOf, view } from './canvas.js';
-import { fullName } from './labels.js';
-import { countTickets, ticketCountsForNodes } from './attention.js';
-import { listFocuses } from './focuses.js';
-import { resolveNodeVisual, faultSummary } from './status-glyph.js';
-import { readNodeTelemetry, fmtCtx, hangingFor, isStreaming, dashboardRowFromNodeRow, readGoalText, readSessionParts, } from './render-source.js';
-// Re-export the openDb-free half so `render.js` importers keep resolving the
-// FromSource variants + shared types/helpers unchanged.
-export * from './render-source.js';
-// ---------------------------------------------------------------------------
-// Tree builder (sync, db-backed)
-// ---------------------------------------------------------------------------
-/** Build one line of the ASCII tree. */
-function nodeLine(nodeId, indent, connector) {
-    const node = getNode(nodeId);
-    if (node === null) {
-        // Node id is in the db but meta.json is gone — paranoid guard.
-        return `${indent}${connector}? <missing meta: ${nodeId}>`;
-    }
-    const hanging = hangingFor(node);
-    const glyph = resolveNodeVisual(node.status, { hanging }).glyph;
-    const tel = readNodeTelemetry(nodeId);
-    const ctx = fmtCtx(tel.tokens_in);
-    const asks = countTickets(nodeId);
-    const askSuffix = asks > 0 ? ` ⚑${asks}` : '';
-    const faultSuffix = hanging !== null ? ` · ${faultSummary(hanging)}` : '';
-    return `${indent}${connector}${glyph} ${fullName(node)} [${node.kind}/${node.mode}] ctx ${ctx}${askSuffix}${faultSuffix}`;
-}
-/**
- * Recursively walk the subscription sub-DAG rooted at `nodeId`, appending
- * rendered lines to `out`. Cycle-safe via `visited`.
- */
-function walkTree(nodeId, indent, isLast, visited, out) {
-    // Guard: if we have already rendered this node in this traversal, emit a
-    // back-ref marker instead of recursing (prevents infinite loops in graphs
-    // with cycles introduced by manual edge manipulation).
-    if (visited.has(nodeId)) {
-        // The line for this node was already emitted by the caller; just return.
-        return;
-    }
-    visited.add(nodeId);
-    const connector = isLast ? '└─ ' : '├─ ';
-    out.push(nodeLine(nodeId, indent, connector));
-    const children = subscriptionsOf(nodeId);
-    const childIndent = indent + (isLast ? '   ' : '│  ');
-    for (let i = 0; i < children.length; i++) {
-        const child = children[i];
-        const childIsLast = i === children.length - 1;
-        if (visited.has(child.node_id)) {
-            // Cycle reference — show the back-edge without recursing.
-            const cycleConnector = childIsLast ? '└─ ' : '├─ ';
-            out.push(`${childIndent}${cycleConnector}↺ <cycle: ${child.node_id}>`);
-            continue;
-        }
-        walkTree(child.node_id, childIndent, childIsLast, visited, out);
-    }
-}
-// ---------------------------------------------------------------------------
-// Public API (sync)
-// ---------------------------------------------------------------------------
-/**
- * Render the subscription sub-DAG rooted at `rootId` as an ASCII tree.
- * The root is the first line (no connector prefix); children are indented.
- *
- * Each line: `<glyph> <name> [<kind>/<mode>] ctx <Nk>[ ⚑<asks>]`
- *
- * Returns a multi-line string (no trailing newline).
- */
-export function renderTree(rootId) {
-    const node = getNode(rootId);
-    if (node === null)
-        return `? <missing node: ${rootId}>`;
-    const tel = readNodeTelemetry(rootId);
-    const ctx = fmtCtx(tel.tokens_in);
-    const asks = countTickets(rootId);
-    const askSuffix = asks > 0 ? ` ⚑${asks}` : '';
-    const hanging = hangingFor(node);
-    const glyph = resolveNodeVisual(node.status, { hanging }).glyph;
-    const faultSuffix = hanging !== null ? ` · ${faultSummary(hanging)}` : '';
-    const out = [];
-    out.push(`${glyph} ${fullName(node)} [${node.kind}/${node.mode}] ctx ${ctx}${askSuffix}${faultSuffix}`);
-    // visited starts with root already rendered (walkTree doesn't re-emit root).
-    const visited = new Set([rootId]);
-    const children = subscriptionsOf(rootId);
-    for (let i = 0; i < children.length; i++) {
-        const child = children[i];
-        const isLast = i === children.length - 1;
-        walkTree(child.node_id, '', isLast, visited, out);
-    }
-    return out.join('\n');
-}
-/**
- * Render all canvas roots as a forest. A root is a node with no subscribers
- * (no one subscribes to it = it has no managers in the org chart).
- *
- * If there are no roots on the canvas, returns a placeholder string.
- */
-export function renderForest() {
-    const all = listNodes();
-    if (all.length === 0)
-        return '(canvas is empty)';
-    // A root has no subscribers (nobody is watching it). We discover this by
-    // looking for nodes whose node_id never appears as a "to" side of a
-    // subscribes_to edge — equivalently, nodes with parent === null are the
-    // authoritative roots per the spawn contract (spawn sets parent and records
-    // a spawned_by edge + subscribe). Fall back to parent===null because querying
-    // the full edge table would require opening the db here.
-    //
-    // Fine to use parent===null: roots are created by bare `crtr` / `node new --root`
-    // without a parent; non-roots always have a parent.
-    //
-    // Filter to LIVE roots: each `/new` parks a `done` root (option C relaunch)
-    // with parent===null, so an unfiltered forest would render every parked root
-    // as a sibling tree and clutter the dashboard. Showing only active|idle roots
-    // drops parked (`done`) roots and, as a bonus, stray `dead`/`canceled` roots.
-    // Parked roots stay reachable by id (inspect / revive / focus).
-    const roots = all.filter((n) => n.parent === null && (n.status === 'active' || n.status === 'idle'));
-    // No LIVE roots: render an empty/placeholder forest rather than resurrecting
-    // parked (`done`) / dead / canceled roots. The live-only filter is the intent;
-    // falling back to all-status roots would re-clutter the dashboard with the very
-    // parked trees the filter drops (e.g. a sole root `/quit`'d with no `/new`).
-    // Parked roots stay reachable by id (inspect / revive / focus).
-    if (roots.length === 0)
-        return '(no live roots)';
-    const parts = [];
-    for (const r of roots) {
-        parts.push(renderTree(r.node_id));
-    }
-    return parts.join('\n\n');
-}
-// ---------------------------------------------------------------------------
-// Structured row builder (sync, db-backed)
-// ---------------------------------------------------------------------------
-/** One row per node visible in the sub-DAG of `rootId` (including root). */
-export function dashboardRows(rootId) {
-    const ids = [rootId, ...view(rootId)];
-    return ids.flatMap((id) => {
-        const node = getNode(id);
-        if (node === null)
-            return [];
-        const tel = readNodeTelemetry(id);
-        return [{
-                node_id: id,
-                name: fullName(node),
-                handle: node.name,
-                description: node.description,
-                status: node.status,
-                kind: node.kind,
-                mode: node.mode,
-                ctx_tokens: tel.tokens_in ?? 0,
-                asks: countTickets(id),
-                cwd: node.cwd,
-                created: node.created,
-            }];
-    });
-}
-/**
- * CHEAP boot builder — one row per node across the entire canvas, with only the
- * fields that need no per-node meta/telemetry/session read. Two db queries total:
- * `listNodes()` + `listFocuses()` (the focus set replaces per-node getFocusByNode
- * calls). See {@link dashboardRowFromNodeRow} for the per-row projection, and
- * {@link enrichRow}/{@link enrichRows}/{@link loadPreview} for the lazy fields.
- */
-export function dashboardRowsAll() {
-    const focusedNodeIds = new Set(listFocuses().map((f) => f.node_id));
-    return listNodes().map((row) => dashboardRowFromNodeRow(row, focusedNodeIds, false));
-}
-// ---------------------------------------------------------------------------
-// Lazy enrichment API (sync, db-backed) — fold the expensive per-node reads into
-// rows on demand, for the VISIBLE viewport / top tiers only (never all up front).
-// Each function mutates the row in place and is idempotent via a guard flag.
-// ---------------------------------------------------------------------------
-/** Fold the cheap-boot row's deferred fields in for ONE row: the full label
- *  (meta.description → fullName), ctx tokens (telemetry.json), and ⚑ asks. One
- *  meta read + one telemetry read + one ticket scan. Idempotent (no-op once enriched).
- *  For a batch, prefer {@link enrichRows} — it scans each cwd's ticket inbox once. */
-export function enrichRow(row) {
-    if (row.enriched === true)
-        return row;
-    const meta = getNode(row.node_id);
-    if (meta !== null) {
-        row.name = fullName(meta);
-        row.handle = meta.name;
-        row.description = meta.description;
-    }
-    row.ctx_tokens = readNodeTelemetry(row.node_id).tokens_in ?? 0;
-    row.asks = countTickets(row.node_id);
-    row.enriched = true;
-    return row;
-}
-/** Batch {@link enrichRow}: enrich every not-yet-enriched row, scanning each
- *  distinct cwd's ticket inbox exactly ONCE (via `ticketCountsForNodes`) instead
- *  of per row. Use this for a whole viewport / the full forest; mutates each row in place. */
-export function enrichRows(rows) {
-    const todo = rows.filter((r) => r.enriched !== true);
-    if (todo.length === 0)
-        return;
-    const asks = ticketCountsForNodes(todo.map((r) => r.node_id));
-    for (const row of todo) {
-        const meta = getNode(row.node_id);
-        if (meta !== null) {
-            row.name = fullName(meta);
-            row.handle = meta.name;
-            row.description = meta.description;
-        }
-        row.ctx_tokens = readNodeTelemetry(row.node_id).tokens_in ?? 0;
-        row.asks = asks[row.node_id] ?? 0;
-        row.enriched = true;
-    }
-}
-/** Load the SELECTED row's preview text: the spawn `goal` (initial-prompt.md) plus
- *  the whole-conversation `prompts` and the `lastAssistant` reply — the latter two
- *  folded into ONE session-file read (see {@link readSessionParts}). Mutates the row
- *  in place; idempotent. Call only for the cursor row (and lazily/in-background to
- *  warm the prompt super-search corpus), never on the boot path. */
-export function loadPreview(row) {
-    if (row.previewLoaded === true)
-        return row;
-    row.goal = readGoalText(row.node_id);
-    const meta = getNode(row.node_id);
-    const { prompts, lastAssistant } = readSessionParts(meta?.pi_session_file);
-    row.prompts = prompts;
-    row.lastAssistant = lastAssistant;
-    row.previewLoaded = true;
-    return row;
-}
-/** {@link isStreaming} keyed by node id alone — hydrates the broker pid off the
- *  db row. The exported "is this node actively generating right now?" guard so a
- *  reap never nukes a node mid-first-turn before its output lands on disk. */
-export function isNodeStreaming(nodeId) {
-    return isStreaming(nodeId, getNode(nodeId)?.pi_pid ?? null);
-}