@north-light/crouter 0.3.224 → 0.3.225

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

@@ -19,7 +19,7 @@
 // they belong to the compiled seam tier; neither needs tmux.
 import { after, before, test } from 'node:test';
 import assert from 'node:assert/strict';
-import { readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { appendInbox, readCursor, readInboxSince } from '../../feed/inbox.js';
 import { registerWarmSpare, subscribe, updateNode } from '../../canvas/index.js';
@@ -243,9 +243,15 @@ test('a connected broker viewer keeps an obligation-free resident live', { timeo
     });
     reviveNode(nodeId, { resume: true });
     const boot = await h.awaitBoot(nodeId);
+    // awaitBoot returns on the boot proof, which is written BEFORE the broker's
+    // own `persistAttachState()` lays down the truthful zero state. Writing our
+    // presence first lets that boot write clobber it, and the daemon then parks a
+    // node the test believes is attended — wait for the broker's file to exist.
+    const attachPath = join(h.home, 'nodes', nodeId, 'job', 'attach.json');
+    await h.waitFor(() => existsSync(attachPath), { timeoutMs: 20_000, intervalMs: 20, label: 'broker persists its boot attach state' });
     // This is the presence written by a helloed direct attach, which has no
     // focuses-table row because it did not pass through the focus opener.
-    writeFileSync(join(h.home, 'nodes', nodeId, 'job', 'attach.json'), JSON.stringify({ viewers: 1 }));
+    writeFileSync(attachPath, JSON.stringify({ viewers: 1 }));
     try {
         const seenAt = 15_000;
         await h.tick(seenAt);

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

@@ -55,6 +55,19 @@ function resolveSessionFile(nodeId, metaFile) {
         return raw;
     return null;
 }
+/** The node's readable session file, or `null` when the node exists but nothing
+ *  has been written to its session yet. pi's SessionManager computes a session's
+ *  `.jsonl` path at `newSession()` and writes the file on the FIRST appended
+ *  entry, so a freshly created node carries a bound `pi_session_file` that is
+ *  not on disk until something is said. Throws only when the node itself is
+ *  unknown. */
+function readableSessionFile(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`.' });
+    }
+    return resolveSessionFile(nodeId, node.pi_session_file);
+}
 function emptyStats(sessionId, sessionFile) {
     return {
         sessionFile,
@@ -266,6 +279,19 @@ export async function readNodeMessagesPage(nodeId, { cursor, limit = 200 }) {
             next: 'Use a limit from 1 through 500.',
         });
     }
+    // A node that exists but has said nothing has an EMPTY history, not a fault:
+    // its session file is not on disk until the first entry is appended, and a
+    // transcript read is how a UI opens a new conversation. Only this paged read
+    // can answer honestly — `/snapshot` would have to invent the engine state a
+    // never-run node does not have, so it and the raw `/session` export still
+    // reject the same state through `reconstructVisibleMessages`.
+    // Same shape a session-file-backed empty read produces: `messageIds` stays
+    // aligned 1:1 with `messages` (an absent `message_ids` would claim this read
+    // cannot identify entries, which is a different statement than "there are
+    // none"), and `nextCursor: null` is the same end-of-history marker an
+    // exhausted backward walk returns.
+    if (readableSessionFile(nodeId) === null)
+        return { messages: [], messageIds: [], nextCursor: null };
     const { messages, identified } = await reconstructVisibleMessages(nodeId);
     const before = cursor === undefined ? messages.length : decodeMessagesCursor(cursor, messages.length);
     let start = Math.max(0, before - limit);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.224",
+  "version": "0.3.225",
   "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.224",
+  "version": "0.3.225",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.224",
+      "version": "0.3.225",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {