@north-light/crouter 0.3.290 → 0.3.292

package/dist/core/preview-registry.d.ts

@@ -32,6 +32,16 @@ export interface CrtrPreview {
     jsonl?: Record<string, unknown>[];
     error?: Record<string, unknown>;
 }
+/** Every crtr invocation's own structured result in one bash tool result, in
+ *  invocation order — mirrored onto `details` by the canvas preview extension
+ *  (pi-extensions/canvas-preview-result.ts), and present on live tool events and
+ *  on rebuilt snapshot messages alike.
+ *
+ *  `crtrPreviews` carries every invocation in the call; `crtrPreview` (the last
+ *  record alone) is all a transcript persisted before the channel became a list
+ *  can offer, so both are read. This validates only the transport envelope —
+ *  command-owned summaries validate the fields they use. */
+export declare function crtrPreviewRecords(result: unknown): CrtrPreview[];
 type SummaryInput = {
     result?: Record<string, unknown>;
     jsonl?: Record<string, unknown>[];

package/dist/core/preview-registry.js

@@ -185,6 +185,42 @@ export function iconForPath(tokens) {
     const familyCp = tokens.length > 0 ? FAMILY_ICON_CP[tokens[0]] : undefined;
     return familyCp !== undefined ? String.fromCodePoint(familyCp) : '◆';
 }
+function plainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+/** Every crtr invocation's own structured result in one bash tool result, in
+ *  invocation order — mirrored onto `details` by the canvas preview extension
+ *  (pi-extensions/canvas-preview-result.ts), and present on live tool events and
+ *  on rebuilt snapshot messages alike.
+ *
+ *  `crtrPreviews` carries every invocation in the call; `crtrPreview` (the last
+ *  record alone) is all a transcript persisted before the channel became a list
+ *  can offer, so both are read. This validates only the transport envelope —
+ *  command-owned summaries validate the fields they use. */
+export function crtrPreviewRecords(result) {
+    const details = plainObject(plainObject(result)?.['details']);
+    if (details === undefined)
+        return [];
+    const all = details['crtrPreviews'];
+    const records = Array.isArray(all) ? all : [details['crtrPreview']];
+    return records.flatMap((entry) => {
+        const record = plainObject(entry);
+        if (record === undefined || typeof record['path'] !== 'string')
+            return [];
+        const jsonl = record['jsonl'];
+        return [{
+                path: record['path'],
+                result: plainObject(record['result']),
+                jsonl: Array.isArray(jsonl) ? jsonl.flatMap((row) => {
+                    const parsed = plainObject(row);
+                    return parsed === undefined ? [] : [parsed];
+                }) : undefined,
+                error: plainObject(record['error']),
+            }];
+    });
+}
 const MEMORY_READ_CONTENT_LINES = 3;
 function record(input) {
     return input.result;

package/dist/core/substrate/schema.d.ts

@@ -142,3 +142,10 @@ export declare function effectiveDocKind(doc: MemoryDoc): string;
  *  lives once here to prevent drift. Light cleanup normalizes the trailing
  *  period. */
 export declare function previewLine(doc: Pick<SubstrateSchema, 'whenAndWhyToRead'>): string;
+/** Tolerant `surfaces` parse: a non-array yields `[]`; invalid entries are
+ *  dropped (bad `on`, bad `at`, a read/memory-read/command/pre-command entry
+ *  left with neither `match` nor — read only — `match-frontmatter`). `match-frontmatter`
+ *  on a non-read event is dropped from the entry, which survives iff it still
+ *  carries a `match`; an invalid entry `gate` is dropped. Lint owns strict
+ *  enforcement; the runtime parser maps over many docs and must never throw. */
+export declare function parseSurfaces(v: unknown): SurfaceEntry[];

package/dist/core/substrate/schema.js

@@ -137,7 +137,7 @@ function parseGate(v) {
  *  on a non-read event is dropped from the entry, which survives iff it still
  *  carries a `match`; an invalid entry `gate` is dropped. Lint owns strict
  *  enforcement; the runtime parser maps over many docs and must never throw. */
-function parseSurfaces(v) {
+export function parseSurfaces(v) {
     if (!Array.isArray(v))
         return [];
     const out = [];

package/dist/daemon/api/map.js

@@ -62,12 +62,13 @@ export function toNodeOutcomeDTO(node) {
     };
     if (node.outcome_kind === 'result')
         return { ...base, kind: 'result', reason: node.outcome_reason, declined: null };
-    if (node.outcome_reason === 'declined') {
-        // The decline lane always records its detail; a declined row without one is corrupt, not a legacy shape.
-        if (detail?.declined === undefined)
-            throw new Error(`node ${node.node_id}: outcome reason 'declined' without a declined detail`);
-        return { ...base, kind: 'failure', reason: 'declined', declined: detail.declined };
-    }
+    // A declined row whose detail holds no decline block still projects: the row
+    // predates the decline block being recorded, or the outcome-column backfill
+    // rebuilt it from `terminal_reason` alone. This mapper also runs per row in
+    // the canvas-wide list projection, so throwing here would take every
+    // graph-wide read down over one unreadable node.
+    if (node.outcome_reason === 'declined')
+        return { ...base, kind: 'failure', reason: 'declined', declined: detail?.declined ?? null };
     return { ...base, kind: 'failure', reason: node.outcome_reason, declined: null };
 }
 /** Project a durable delivery row without exposing its execution coordinates or stderr tail. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.290",
+  "version": "0.3.292",
   "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.290",
+  "version": "0.3.292",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.290",
+      "version": "0.3.292",
       "hasInstallScript": true,
       "license": "MIT",
       "workspaces": [
@@ -4244,17 +4244,17 @@
     },
     "packages/crouter-api": {
       "name": "@north-light/crouter-api",
-      "version": "0.3.290",
+      "version": "0.3.292",
       "license": "UNLICENSED"
     },
     "packages/crouter-env-docker": {
       "name": "@north-light/crouter-env-docker",
-      "version": "0.3.290",
+      "version": "0.3.292",
       "license": "UNLICENSED"
     },
     "packages/crouter-sdk": {
       "name": "@north-light/crouter-sdk",
-      "version": "0.3.290",
+      "version": "0.3.292",
       "license": "UNLICENSED",
       "dependencies": {
         "@north-light/crouter-api": "*"