@cat-factory/kernel 0.292.0 → 0.292.1

package/dist/domain/llm-output.d.ts

@@ -8,10 +8,22 @@
  * `{` whose balanced span doesn't parse (e.g. preamble prose like `I weighed [the auth
  * flow] and concluded: {…}` — the `[the auth flow]` is not JSON) is skipped and the next
  * bracket is tried, so the real object after the prose is still found rather than the
- * whole extraction collapsing to `null`. A fenced code block (```` ```json … ``` ````) is
- * preferred when it contains a JSON value, but if the first fence holds no JSON (e.g. a
- * model fenced its reasoning before emitting the real object) we fall back to scanning the
- * whole reply, so the JSON that follows the fence is still found.
+ * whole extraction collapsing to `null`. Fenced code blocks (```` ```json … ``` ````) are
+ * searched first, in the order written: a model that fenced its reasoning before emitting the
+ * real object still gets read, and so does one whose payload sits in a later fence.
+ *
+ * A span that is valid JSON except for RAW control characters inside a string literal is
+ * REPAIRED rather than refused (see {@link escapeControlCharsInStrings}) — but only in a second
+ * pass, after every candidate in every source has been tried AS WRITTEN.
+ *
+ * That two-pass order is the whole safety property, and repairing inside the scan loop broke it:
+ * a repair makes an earlier span parse that would otherwise have been skipped, so an example
+ * shape or a prose aside ("Notes on the field: {"name": "the field<newline>I mean"}") starts
+ * SHADOWING the real verdict written after it. A verdict is the one thing that must not be
+ * guessed, and a model told to lay a field out over several lines writes exactly the
+ * malformation that used to make such a span skippable. So a strictly-parseable value anywhere
+ * in the reply outranks a repaired one, and the repair only ever recovers a reply that had no
+ * readable JSON at all.
  */
 export declare function extractJson(text: string): unknown;
 //# sourceMappingURL=llm-output.d.ts.map

package/dist/domain/llm-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-output.d.ts","sourceRoot":"","sources":["../../src/domain/llm-output.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQjD"}
+{"version":3,"file":"llm-output.d.ts","sourceRoot":"","sources":["../../src/domain/llm-output.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYjD"}

package/dist/domain/llm-output.js

@@ -11,32 +11,62 @@
  * `{` whose balanced span doesn't parse (e.g. preamble prose like `I weighed [the auth
  * flow] and concluded: {…}` — the `[the auth flow]` is not JSON) is skipped and the next
  * bracket is tried, so the real object after the prose is still found rather than the
- * whole extraction collapsing to `null`. A fenced code block (```` ```json … ``` ````) is
- * preferred when it contains a JSON value, but if the first fence holds no JSON (e.g. a
- * model fenced its reasoning before emitting the real object) we fall back to scanning the
- * whole reply, so the JSON that follows the fence is still found.
+ * whole extraction collapsing to `null`. Fenced code blocks (```` ```json … ``` ````) are
+ * searched first, in the order written: a model that fenced its reasoning before emitting the
+ * real object still gets read, and so does one whose payload sits in a later fence.
+ *
+ * A span that is valid JSON except for RAW control characters inside a string literal is
+ * REPAIRED rather than refused (see {@link escapeControlCharsInStrings}) — but only in a second
+ * pass, after every candidate in every source has been tried AS WRITTEN.
+ *
+ * That two-pass order is the whole safety property, and repairing inside the scan loop broke it:
+ * a repair makes an earlier span parse that would otherwise have been skipped, so an example
+ * shape or a prose aside ("Notes on the field: {"name": "the field<newline>I mean"}") starts
+ * SHADOWING the real verdict written after it. A verdict is the one thing that must not be
+ * guessed, and a model told to lay a field out over several lines writes exactly the
+ * malformation that used to make such a span skippable. So a strictly-parseable value anywhere
+ * in the reply outranks a repaired one, and the repair only ever recovers a reply that had no
+ * readable JSON at all.
  */
 export function extractJson(text) {
     const trimmed = text.trim();
-    const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
-    if (fenced) {
-        const fromFence = extractJsonValue(fenced[1]);
-        if (fromFence !== null)
-            return fromFence;
+    // Fence bodies first (a deliberate delimiter of the payload), then the whole reply. The same
+    // ordered list is walked by both passes, so the fence preference holds within each.
+    const sources = [...fencedBodies(trimmed), trimmed];
+    for (const mode of PARSE_MODES) {
+        for (const source of sources) {
+            const value = extractJsonValue(source, mode);
+            if (value !== null)
+                return value;
+        }
     }
-    return extractJsonValue(trimmed);
+    return null;
+}
+/** Strict first, everywhere; repair only once nothing parsed as written. See {@link extractJson}. */
+const PARSE_MODES = ['strict', 'repair'];
+/**
+ * The body of every fenced block in the reply, in the order written.
+ *
+ * All of them, not just the first: the fence a payload sits in is not always the first one (a
+ * model fences its reasoning, or shows an example, before the object), and in the repair pass the
+ * ordering decides which candidate wins. A nested fence (a code block inside a string value) makes
+ * the split imperfect by construction — the closing ``` of the inner block ends the outer match —
+ * which is why the whole reply stays in the list as the final source.
+ */
+function fencedBodies(text) {
+    return [...text.matchAll(/```(?:json)?\s*([\s\S]*?)```/gi)].map((m) => m[1] ?? '');
 }
 /**
  * Scan `candidate` for the first balanced JSON object/array that parses, skipping any
  * earlier bracket whose balanced span is not valid JSON (e.g. a bracket inside prose).
  */
-function extractJsonValue(candidate) {
+function extractJsonValue(candidate, mode) {
     for (let from = 0; from < candidate.length;) {
         const rel = candidate.slice(from).search(/[[{]/);
         if (rel === -1)
             return null;
         const start = from + rel;
-        const value = parseBalancedFrom(candidate, start);
+        const value = parseBalancedFrom(candidate, start, mode);
         if (value !== null)
             return value;
         from = start + 1;
@@ -44,7 +74,7 @@ function extractJsonValue(candidate) {
     return null;
 }
 /** Parse the balanced JSON value that starts at `candidate[start]`, or null if it doesn't parse. */
-function parseBalancedFrom(candidate, start) {
+function parseBalancedFrom(candidate, start, mode) {
     const open = candidate[start];
     const close = open === '{' ? '}' : ']';
     let depth = 0;
@@ -67,16 +97,92 @@ function parseBalancedFrom(candidate, start) {
             depth++;
         else if (ch === close) {
             depth--;
-            if (depth === 0) {
-                try {
-                    return JSON.parse(candidate.slice(start, i + 1));
-                }
-                catch {
-                    return null;
-                }
-            }
+            if (depth === 0)
+                return parseSpan(candidate.slice(start, i + 1), mode);
         }
     }
     return null;
 }
+/**
+ * Parse one balanced span: as written in the `strict` pass, with its string literals re-escaped
+ * in the `repair` one (see {@link escapeControlCharsInStrings}). Null when it doesn't parse, which
+ * sends the caller on to the next bracket rather than claiming a value nobody wrote.
+ */
+function parseSpan(span, mode) {
+    // A span carrying no raw control character cannot be repaired into anything a strict parse did
+    // not already refuse, so the rewrite is skipped rather than run over every bracket in a long
+    // reply (a tester quoting a code block puts hundreds of them in prose).
+    if (mode === 'repair' && !hasRawControlChar(span))
+        return null;
+    try {
+        return JSON.parse(mode === 'repair' ? escapeControlCharsInStrings(span) : span);
+    }
+    catch {
+        return null;
+    }
+}
+/** Whether `span` holds any raw control character: the cheap gate on attempting a repair. */
+function hasRawControlChar(span) {
+    for (let i = 0; i < span.length; i++) {
+        if (span.charCodeAt(i) < 0x20)
+            return true;
+    }
+    return false;
+}
+/** The control characters JSON gives a short escape; the rest go to `\uXXXX`. */
+const CONTROL_ESCAPES = {
+    '\n': '\\n',
+    '\r': '\\r',
+    '\t': '\\t',
+    '\b': '\\b',
+    '\f': '\\f',
+};
+/**
+ * Re-escape raw control characters that sit INSIDE a JSON string literal.
+ *
+ * `JSON.parse` rejects a literal newline in a string, and that is the malformation a model
+ * reliably produces once a field is asked for as several lines (a review verdict laid out as
+ * blocks, a rationale with a bullet list): it writes the layout it was told to write and drops
+ * the `\n` escape. The reply is otherwise the verdict, so refusing it loses a whole review to a
+ * quoting slip. Only characters inside a string are rewritten, so the structural whitespace
+ * between tokens keeps its meaning and a genuinely broken reply still fails to parse.
+ *
+ * Copied in SLICES around each rewritten character rather than one character at a time: this runs
+ * over a whole span per failing candidate bracket, and a reply that quotes a code block has many.
+ * A span needing no rewrite therefore costs one pass and no allocation.
+ */
+function escapeControlCharsInStrings(json) {
+    let out = '';
+    let copiedTo = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < json.length; i++) {
+        const ch = json[i];
+        if (!inString) {
+            if (ch === '"')
+                inString = true;
+            continue;
+        }
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (ch === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = false;
+            continue;
+        }
+        // Only a control character needs rewriting; everything else (a surrogate pair included) is
+        // carried by the slices, untouched.
+        if (json.charCodeAt(i) >= 0x20)
+            continue;
+        const escape = CONTROL_ESCAPES[ch] ?? `\\u${json.charCodeAt(i).toString(16).padStart(4, '0')}`;
+        out += json.slice(copiedTo, i) + escape;
+        copiedTo = i + 1;
+    }
+    return out + json.slice(copiedTo);
+}
 //# sourceMappingURL=llm-output.js.map

package/dist/domain/llm-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-output.js","sourceRoot":"","sources":["../../src/domain/llm-output.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,sFAAsF;AACtF,kFAAkF;AAElF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAC7D,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAA;QAC9C,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,SAAS,CAAA;IAC1C,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,SAAiB;IACzC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;QAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAChD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAA;QAC3B,MAAM,KAAK,GAAG,IAAI,GAAG,GAAG,CAAA;QACxB,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACjD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAA;QAChC,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oGAAoG;AACpG,SAAS,iBAAiB,CAAC,SAAiB,EAAE,KAAa;IACzD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAC7B,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;IACtC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,OAAO;gBAAE,OAAO,GAAG,KAAK,CAAA;iBACvB,IAAI,EAAE,KAAK,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAA;iBAC/B,IAAI,EAAE,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAA;YACrC,SAAQ;QACV,CAAC;QACD,IAAI,EAAE,KAAK,GAAG;YAAE,QAAQ,GAAG,IAAI,CAAA;aAC1B,IAAI,EAAE,KAAK,IAAI;YAAE,KAAK,EAAE,CAAA;aACxB,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YACtB,KAAK,EAAE,CAAA;YACP,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAClD,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAA;gBACb,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}
+{"version":3,"file":"llm-output.js","sourceRoot":"","sources":["../../src/domain/llm-output.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/kernel",
-  "version": "0.292.0",
+  "version": "0.292.1",
   "description": "Shared vocabulary, pure logic, and port interfaces for the Agent Architecture Board.",
   "repository": {
     "type": "git",