@cavelang/cli 0.34.0 → 0.36.0

package/dist/internal/ingest/web.js

@@ -1,3 +1,4 @@
+import { booleanOption, sourceList } from "./options.js";
 /**
  * URL sources for ingestion — `cave ingest https://…` fetches the page
  * with the built-in fetch and reduces HTML to its readable article text
@@ -8,13 +9,18 @@
  * is taken over the *extracted* text, so a page is re-ingested only when
  * its readable content changes — not on every markup or chrome tweak.
  */
+import { errorMessage } from "./error-message.js";
+import { sourceLabel } from "./content.js";
 import { Readability } from '@mozilla/readability';
 import { parseHTML } from 'linkedom';
 import { digestOf, isIngested } from "./files.js";
+import { agentTimeoutMs } from "./timeout.js";
 /** @returns whether an ingest pattern is a fetchable URL. */
 export const isUrl = (pattern) => /^https?:\/\//i.test(pattern);
 /** Block-level elements worth a line of their own in the extracted text. */
-const blockSelector = 'p, h1, h2, h3, h4, h5, h6, li, pre, blockquote, td, figcaption';
+const blockSelector = 'p, h1, h2, h3, h4, h5, h6, li, pre, blockquote, th, td, caption, dt, dd, figcaption, address';
+// Structural containers separate text but do not absorb nested headings or code.
+const containerSelector = 'div, section, article, main, header, footer, aside, nav, figure, details, summary, form, fieldset, ul, ol, dl, table, thead, tbody, tfoot, tr';
 const headingPrefix = {
     H1: '# ', H2: '## ', H3: '### ', H4: '#### ', H5: '##### ', H6: '###### ', LI: '- '
 };
@@ -23,17 +29,68 @@ const headingPrefix = {
 const Parser = Readability;
 /** Flattens a DOM subtree into markdown-ish text, one block per line. */
 const textOf = (root) => {
-    const blocks = [...root.querySelectorAll(blockSelector)]
+    for (const lineBreak of root.querySelectorAll('br'))
+        lineBreak.replaceWith('\n');
+    const elements = [...root.querySelectorAll(blockSelector)];
+    // textContent does not separate adjacent blocks. Keep nested content in its
+    // outer block, but retain word boundaries before flattening its whitespace.
+    for (const element of [...elements, ...root.querySelectorAll(containerSelector)]) {
+        if (element.parentElement?.closest(blockSelector) != null) {
+            element.before('\n');
+            element.after('\n');
+        }
+    }
+    const blocks = new Map(elements
         // Keep outermost blocks only — a <p> inside a kept <li> is its text.
         .filter(element => element.parentElement === null || element.parentElement.closest(blockSelector) === null)
         .map(element => {
         const text = element.textContent ?? '';
-        return element.tagName === 'PRE' ?
-            text.trim() :
-            `${headingPrefix[element.tagName] ?? ''}${text.replace(/\s+/g, ' ').trim()}`;
-    })
-        .filter(line => line !== '');
-    return blocks.length > 0 ? blocks.join('\n\n') : (root.textContent ?? '').trim();
+        if (element.tagName === 'PRE')
+            return [element, text];
+        const content = text.replace(/\s+/g, ' ').trim();
+        return [element, content === '' ? '' : `${headingPrefix[element.tagName] ?? ''}${content}`];
+    }));
+    const containers = new Set(root.querySelectorAll(containerSelector));
+    if (blocks.size === 0 && containers.size === 0)
+        return (root.textContent ?? '').trim();
+    const output = [];
+    let pending = [];
+    const flush = () => {
+        const text = pending.join('').replace(/\s+/g, ' ').trim();
+        if (text !== '')
+            output.push(text);
+        pending = [];
+    };
+    // Traverse iteratively and skip the descendants of emitted blocks. Text
+    // between those blocks belongs to the retained article too.
+    const stack = root.firstChild === null ? [] : [root.firstChild];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (node === null) {
+            flush();
+            continue;
+        }
+        if (node.nextSibling !== null)
+            stack.push(node.nextSibling);
+        const block = blocks.get(node);
+        if (block !== undefined) {
+            flush();
+            if (block !== '')
+                output.push(block);
+        }
+        else if (node.nodeType === 3) {
+            pending.push(node.textContent ?? '');
+        }
+        else if (node.nodeType === 1 && node.firstChild !== null) {
+            if (containers.has(node)) {
+                flush();
+                stack.push(null);
+            }
+            stack.push(node.firstChild);
+        }
+    }
+    flush();
+    return output.join('\n\n');
 };
 /**
  * @returns the readable text of an HTML page — Readability's article when
@@ -52,9 +109,12 @@ export const readableTextOf = (html) => {
     };
     const text = article === null || article.content === null || article.content === undefined ?
         body() :
-        textOf(parseHTML(`<html><body>${article.content}</body></html>`).document);
+        textOf(parseHTML(`<html><body>${article.content}</body></html>`).document.body);
     const title = (article?.title ?? parse().title ?? '').trim();
-    return title === '' || text.startsWith(`# ${title}`) ? text : `# ${title}\n\n${text}`;
+    const heading = `# ${title}`;
+    if (title === '' || text === heading || text.startsWith(`${heading}\n`))
+        return text;
+    return text === '' ? heading : `${heading}\n\n${text}`;
 };
 class FetchFailure extends Error {
     failure;
@@ -67,14 +127,19 @@ const retryableStatus = (status) => status === 408 || status === 425 || status =
 const failureOf = (url, error) => {
     if (error instanceof FetchFailure)
         return error.failure;
-    const detail = error instanceof Error ? error.message : String(error);
-    return { path: url, kind: 'network', retryable: true, message: `fetch ${url} failed: ${detail}` };
+    const detail = errorMessage(error);
+    return { path: url, kind: 'network', retryable: true, message: `fetch ${sourceLabel(url)} failed: ${sourceLabel(detail)}` };
 };
 /**
  * Fetches one URL and returns it as a selectable source — readable text
  * for HTML responses, the verbatim body for anything else.
  */
-export const fetchDocument = async (url, fetchImpl = fetch, timeoutSeconds = 60) => {
+export const fetchDocument = async (url, fetchImpl = fetch, timeoutSeconds = 60, signal) => {
+    signal?.throwIfAborted();
+    if (/[\uD800-\uDFFF]/u.test(url)) {
+        throw new TypeError('URL must contain well-formed Unicode');
+    }
+    const timeoutMs = agentTimeoutMs(timeoutSeconds, true);
     let response;
     try {
         response = await fetchImpl(url, {
@@ -83,24 +148,50 @@ export const fetchDocument = async (url, fetchImpl = fetch, timeoutSeconds = 60)
                 accept: 'text/html, text/markdown, text/plain, application/json;q=0.9, */*;q=0.8'
             },
             redirect: 'follow',
-            signal: AbortSignal.timeout(timeoutSeconds * 1000)
+            signal: AbortSignal.any([
+                AbortSignal.timeout(timeoutMs),
+                ...signal === undefined ? [] : [signal]
+            ])
         });
     }
     catch (error) {
+        signal?.throwIfAborted();
         throw new FetchFailure(failureOf(url, error));
     }
+    if (signal?.aborted) {
+        await response.body?.cancel().catch(() => undefined);
+        signal.throwIfAborted();
+    }
     if (!response.ok) {
+        await response.body?.cancel().catch(() => undefined);
+        signal?.throwIfAborted();
         throw new FetchFailure({
             path: url,
             kind: 'http',
             retryable: retryableStatus(response.status),
             status: response.status,
-            message: `fetch ${url} failed: ${response.status} ${response.statusText}`
+            message: `fetch ${sourceLabel(url)} failed: ${response.status} ${sourceLabel(response.statusText)}`
         });
     }
-    const type = response.headers.get('content-type') ?? '';
-    const body = await response.text();
-    const html = /html|xhtml/i.test(type) || (type === '' && /^\s*</.test(body));
+    const type = (response.headers.get('content-type') ?? '').split(';', 1)[0].trim().toLowerCase();
+    let bytes;
+    try {
+        bytes = await response.arrayBuffer();
+    }
+    catch (error) {
+        signal?.throwIfAborted();
+        throw error;
+    }
+    signal?.throwIfAborted();
+    let body;
+    try {
+        body = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes);
+    }
+    catch (cause) {
+        throw new FetchFailure(failureOf(url, new TypeError('invalid UTF-8 response body', { cause })));
+    }
+    const html = type === 'text/html' || type === 'application/xhtml+xml' ||
+        (type === '' && /^\s*</.test(body));
     const content = html ? readableTextOf(body) : body;
     return { path: url, digest: digestOf(content), content };
 };
@@ -111,24 +202,39 @@ export const fetchDocument = async (url, fetchImpl = fetch, timeoutSeconds = 60)
  * but unchanged pages cost no agent run.
  */
 export const select = async (store, urls, options = {}) => {
+    const signal = options.signal;
+    signal?.throwIfAborted();
+    const force = booleanOption(options.force, 'force');
+    const fetchImpl = options.fetchImpl;
     const files = [];
     const skipped = [];
     const failures = [];
-    const outcomes = await Promise.all([...new Set(urls)].map(async (url) => {
-        try {
-            return { document: await fetchDocument(url, options.fetchImpl) };
-        }
-        catch (error) {
-            return { failure: failureOf(url, error) };
+    const selected = [...new Set(sourceList(urls, 'URLs'))];
+    const outcomes = new Array(selected.length);
+    let next = 0;
+    // Bound in-flight requests while retaining input order for reports and batches.
+    await Promise.all(Array.from({ length: Math.min(8, selected.length) }, async () => {
+        while (next < selected.length) {
+            signal?.throwIfAborted();
+            const index = next++;
+            const url = selected[index];
+            try {
+                outcomes[index] = { document: await fetchDocument(url, fetchImpl, 60, signal) };
+            }
+            catch (error) {
+                signal?.throwIfAborted();
+                outcomes[index] = { failure: failureOf(url, error) };
+            }
         }
     }));
+    signal?.throwIfAborted();
     for (const outcome of outcomes) {
         if ('failure' in outcome) {
             failures.push(outcome.failure);
             continue;
         }
         const document = outcome.document;
-        if (options.force !== true && isIngested(store, document.path, document.digest)) {
+        if (force !== true && isIngested(store, document.path, document.digest)) {
             skipped.push(document.path);
         }
         else {

package/dist/internal/ingest/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"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"}

package/dist/internal/loop/budgets.d.ts

@@ -0,0 +1,3 @@
+/** Validate built-in policy budgets before traversal or model work. */
+export declare const validateBudgets: (maxSteps: number, maxClaims: number) => void;
+//# sourceMappingURL=budgets.d.ts.map

package/dist/internal/loop/budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/budgets.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,IAOrE,CAAA"}

package/dist/internal/loop/budgets.js

@@ -0,0 +1,10 @@
+/** Validate built-in policy budgets before traversal or model work. */
+export const validateBudgets = (maxSteps, maxClaims) => {
+    if (!Number.isSafeInteger(maxSteps) || maxSteps < 0) {
+        throw new TypeError('maxSteps must be a nonnegative safe integer');
+    }
+    if (maxClaims !== Infinity && (!Number.isSafeInteger(maxClaims) || maxClaims < 0)) {
+        throw new TypeError('maxClaims must be a nonnegative safe integer or Infinity');
+    }
+};
+//# sourceMappingURL=budgets.js.map

package/dist/internal/loop/budgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.js","sourceRoot":"","sources":["../../src/budgets.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAQ,EAAE;IAC3E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAA;IACpE,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAA;IACjF,CAAC;AACH,CAAC,CAAA"}

package/dist/internal/loop/index.d.ts

@@ -19,4 +19,6 @@ export { llmPolicy, parseSelection, selectPrompt, shellComplete, stopToken } fro
 export { ProcessFailure, defaultMaxStderrBytes, defaultMaxStdoutBytes, directCommand, quoteShellArgument, runProcess, runProcessSync, shellCommand, shellSyntaxFor, substituteShell } from './process.ts';
 export type { ProcessCommand, ProcessFailureKind, ProcessFailureRecord, ProcessOptions, ProcessResult, ShellSyntax, SyncProcessOptions } from './process.ts';
 export type { Complete, LlmOptions, ShellCompleteOptions } from './llm.ts';
+export { jsonValueEnds } from './json-spans.ts';
+export { lastJsonArray } from './json-answer.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/internal/loop/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACjF,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC/G,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,WAAW,EACX,kBAAkB,EACnB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACjF,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC/G,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,WAAW,EACX,kBAAkB,EACnB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/internal/loop/index.js

@@ -15,4 +15,6 @@ export { sqliteStore } from "./sqlite.js";
 export { heuristicPolicy, reconstruct, reconstructAsync } from "./reconstruct.js";
 export { llmPolicy, parseSelection, selectPrompt, shellComplete, stopToken } from "./llm.js";
 export { ProcessFailure, defaultMaxStderrBytes, defaultMaxStdoutBytes, directCommand, quoteShellArgument, runProcess, runProcessSync, shellCommand, shellSyntaxFor, substituteShell } from "./process.js";
+export { jsonValueEnds } from "./json-spans.js";
+export { lastJsonArray } from "./json-answer.js";
 //# sourceMappingURL=index.js.map

package/dist/internal/loop/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEjF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEjF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,cAAc,CAAA;AAYrB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/internal/loop/json-answer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Last eligible JSON array amid prose. Complete strings and objects consume
+ * nested candidates; an optional own property names a supported object wrapper.
+ * Malformed prose retains balanced-candidate recovery. No input is evaluated.
+ */
+export declare const lastJsonArray: (output: string, property?: string) => unknown[] | undefined;
+//# sourceMappingURL=json-answer.d.ts.map

package/dist/internal/loop/json-answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-answer.d.ts","sourceRoot":"","sources":["../../src/json-answer.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,EAAE,GAAG,SA8D7E,CAAA"}

package/dist/internal/loop/json-answer.js

@@ -0,0 +1,79 @@
+import { jsonValueEnds } from "./json-spans.js";
+/**
+ * Last eligible JSON array amid prose. Complete strings and objects consume
+ * nested candidates; an optional own property names a supported object wrapper.
+ * Malformed prose retains balanced-candidate recovery. No input is evaluated.
+ */
+export const lastJsonArray = (output, property) => {
+    // Complete JSON containers consume nested candidates before array answers
+    // are selected. Raw delimiter boundaries retain recovery from unfinished prose.
+    const spans = [];
+    const stack = [];
+    const rawStack = [];
+    let quote;
+    let escaped = false;
+    for (let at = 0; at < output.length; at += 1) {
+        const char = output[at];
+        let opening;
+        if (char === '[' || char === '{') {
+            opening = { index: spans.length, close: char === '[' ? ']' : '}' };
+            spans.push({ start: at, end: -1, rawEnd: -1 });
+            rawStack.push(opening);
+        }
+        else if (rawStack.length > 0 && char === rawStack[rawStack.length - 1].close) {
+            spans[rawStack.pop().index].rawEnd = at;
+        }
+        if (quote !== undefined) {
+            if (escaped)
+                escaped = false;
+            else if (char === '\\')
+                escaped = true;
+            else if (char === '"') {
+                spans[quote].end = at;
+                quote = undefined;
+            }
+            continue;
+        }
+        if (char === '"') {
+            quote = spans.length;
+            spans.push({ start: at, end: -1, rawEnd: -1 });
+        }
+        else if (opening !== undefined) {
+            stack.push(opening);
+        }
+        else if (stack.length > 0 && char === stack[stack.length - 1].close) {
+            spans[stack.pop().index].end = at;
+        }
+    }
+    const valueEnds = jsonValueEnds(output);
+    let parsed;
+    let consumed = -1;
+    for (const { start, end, rawEnd } of spans) {
+        if (start <= consumed)
+            continue;
+        // Recover answers after unfinished prose brackets or quotes, but only
+        // after valid outer JSON has consumed every candidate inside its span.
+        for (const candidate of new Set([end, rawEnd])) {
+            if (candidate === -1 || valueEnds[start] !== candidate + 1)
+                continue;
+            try {
+                const value = JSON.parse(output.slice(start, candidate + 1));
+                if (Array.isArray(value))
+                    parsed = value;
+                else if (property !== undefined && value !== null && typeof value === 'object' &&
+                    Object.hasOwn(value, property)) {
+                    const nested = value[property];
+                    if (Array.isArray(nested))
+                        parsed = nested;
+                }
+                consumed = candidate;
+                break;
+            }
+            catch {
+                // Try the recovery boundary, then the next balanced candidate.
+            }
+        }
+    }
+    return Array.isArray(parsed) ? parsed : undefined;
+};
+//# sourceMappingURL=json-answer.js.map

package/dist/internal/loop/json-answer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-answer.js","sourceRoot":"","sources":["../../src/json-answer.ts"],"names":[],"mappings":"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"}

package/dist/internal/loop/json-spans.d.ts

@@ -0,0 +1,3 @@
+/** Index valid JSON value prefixes in linear time, without recursion or decoding. */
+export declare const jsonValueEnds: (text: string) => Int32Array;
+//# sourceMappingURL=json-spans.d.ts.map

package/dist/internal/loop/json-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-spans.d.ts","sourceRoot":"","sources":["../../src/json-spans.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,UAmE5C,CAAA"}

package/dist/internal/loop/json-spans.js

@@ -0,0 +1,88 @@
+/** Index valid JSON value prefixes in linear time, without recursion or decoding. */
+export const jsonValueEnds = (text) => {
+    const size = text.length;
+    const next = new Int32Array(size + 1);
+    const digits = new Int32Array(size + 1);
+    const strings = new Int32Array(size + 1);
+    const values = new Int32Array(size + 1);
+    const elements = new Int32Array(size + 1);
+    const members = new Int32Array(size + 1);
+    next[size] = size;
+    digits[size] = size;
+    const digit = (at) => at < size && text[at] >= '0' && text[at] <= '9';
+    for (let at = size - 1; at >= 0; at--) {
+        const char = text[at];
+        next[at] = char === ' ' || char === '\n' || char === '\r' || char === '\t' ? next[at + 1] : at;
+        digits[at] = digit(at) ? digits[at + 1] : at;
+        if (char === '"')
+            strings[at] = at + 1;
+        else if (char === '\\') {
+            const escaped = text[at + 1];
+            if (escaped !== undefined && '"\\/bfnrt'.includes(escaped))
+                strings[at] = strings[at + 2] ?? 0;
+            else if (escaped === 'u' && /^[0-9a-fA-F]{4}$/.test(text.slice(at + 2, at + 6)))
+                strings[at] = strings[at + 6] ?? 0;
+        }
+        else if (char.charCodeAt(0) >= 0x20)
+            strings[at] = strings[at + 1];
+    }
+    // Suffix indexes share comma-separated tails across all candidate openings.
+    // Every dependency lies to the right, including nested objects and arrays.
+    for (let at = size - 1; at >= 0; at--) {
+        const char = text[at];
+        if (char === '"')
+            values[at] = strings[at + 1];
+        else if (char === '[' || char === '{') {
+            const start = next[at + 1];
+            const close = char === '[' ? ']' : '}';
+            values[at] = text[start] === close ? start + 1 : (char === '[' ? elements[start] : members[start]);
+        }
+        else if (text.startsWith('true', at))
+            values[at] = at + 4;
+        else if (text.startsWith('false', at))
+            values[at] = at + 5;
+        else if (text.startsWith('null', at))
+            values[at] = at + 4;
+        else if (char === '-' || digit(at)) {
+            let end = char === '-' ? at + 1 : at;
+            if (digit(end)) {
+                end = text[end] === '0' ? end + 1 : digits[end];
+                let valid = true;
+                if (text[end] === '.') {
+                    end++;
+                    valid = digit(end);
+                    end = digits[end] ?? end;
+                }
+                if (text[end] === 'e' || text[end] === 'E') {
+                    end++;
+                    if (text[end] === '+' || text[end] === '-')
+                        end++;
+                    valid = valid && digit(end);
+                    end = digits[end] ?? end;
+                }
+                if (valid)
+                    values[at] = end;
+            }
+        }
+        const end = values[at];
+        if (end === 0)
+            continue;
+        const separator = next[end];
+        if (text[separator] === ']')
+            elements[at] = separator + 1;
+        else if (text[separator] === ',')
+            elements[at] = elements[next[separator + 1]];
+        if (char === '"' && text[separator] === ':') {
+            const value = values[next[separator + 1]];
+            if (value === 0)
+                continue;
+            const after = next[value];
+            if (text[after] === '}')
+                members[at] = after + 1;
+            else if (text[after] === ',')
+                members[at] = members[next[after + 1]];
+        }
+    }
+    return values;
+};
+//# sourceMappingURL=json-spans.js.map

package/dist/internal/loop/json-spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-spans.js","sourceRoot":"","sources":["../../src/json-spans.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAc,EAAE;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAA;IACxB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACrC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACzC,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACxC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACnB,MAAM,KAAK,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,EAAE,GAAG,IAAI,IAAI,IAAI,CAAC,EAAE,CAAE,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,CAAE,IAAI,GAAG,CAAA;IACxF,KAAK,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAE,CAAA;QACtB,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/F,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7C,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;aACjC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;YAC5B,IAAI,OAAO,KAAK,SAAS,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;iBACzF,IAAI,OAAO,KAAK,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;QACrH,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI;YAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,GAAG,CAAC,CAAE,CAAA;IACvE,CAAC;IACD,4EAA4E;IAC5E,2EAA2E;IAC3E,KAAK,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAE,CAAA;QACtB,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,GAAG,CAAC,CAAE,CAAA;aAC1C,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAE,CAAA;YAC3B,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YACtC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC,CAAA;QACtG,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;aACtD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;aACrD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;aACpD,IAAI,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACnC,IAAI,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YACpC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACf,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAE,CAAA;gBAChD,IAAI,KAAK,GAAG,IAAI,CAAA;gBAChB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;oBACtB,GAAG,EAAE,CAAA;oBACL,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;oBAClB,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAA;gBAC1B,CAAC;gBACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC3C,GAAG,EAAE,CAAA;oBACL,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;wBAAE,GAAG,EAAE,CAAA;oBACjD,KAAK,GAAG,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;oBAC3B,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAA;gBAC1B,CAAC;gBACD,IAAI,KAAK;oBAAE,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,CAAA;YAC7B,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAE,CAAA;QACvB,IAAI,GAAG,KAAK,CAAC;YAAE,SAAQ;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAE,CAAA;QAC5B,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG;YAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,CAAA;aACpD,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG;YAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAE,CAAE,CAAA;QAChF,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAE,CAAE,CAAA;YAC3C,IAAI,KAAK,KAAK,CAAC;gBAAE,SAAQ;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAE,CAAA;YAC1B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG;gBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;iBAC3C,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG;gBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAE,CAAE,CAAA;QACxE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/internal/loop/llm.d.ts

@@ -11,7 +11,7 @@
  *   model twice per step (select, then "are we done?"). Both decisions fit
  *   one prompt: the model replies with the next cue to expand *or* `STOP`,
  *   and the loop already treats an `undefined` selection as the stop
- *   signal. `done` then only enforces the hard budgets, for free.
+ *   signal. `done` then only checks the stopping budgets, for free.
  * - **Scoring stays local.** Models are better spent on select/stop than
  *   on per-edge arithmetic; `score` is the same parent × confidence ×
  *   decay the heuristic uses, so the scores shown in the prompt mean the
@@ -39,7 +39,7 @@ export type LlmOptions = {
     readonly instructions?: string;
     /** Hard step budget — and completion budget, one per step (default 16). */
     readonly maxSteps?: number;
-    /** Stop once this many claims are collected (default ∞). */
+    /** Claim-count stopping threshold, checked between complete expansions (default ∞). */
     readonly maxClaims?: number;
     /** Per-hop decay of the local edge score (default 0.8). */
     readonly decay?: number;
@@ -60,6 +60,7 @@ export declare const selectPrompt: (state: State, options?: LlmOptions) => strin
  *
  * 1. the trimmed reply, its last non-empty line, or either with list
  *    markers/quotes stripped, is exactly a frontier entity → that cue;
+ *    trailing sentence punctuation prefers the longest matching literal name;
  * 2. the reply's first word is the stop token (any case) → stop;
  * 3. the earliest frontier entity mentioned anywhere in the reply → that
  *    cue (ties at one position go to the longer name; occurrences inside

package/dist/internal/loop/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAG/D,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE1D,MAAM,MAAM,UAAU,GAAG;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,8CAA8C;AAC9C,eAAO,MAAM,SAAS,SAAS,CAAA;AAQ/B;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,UAAS,UAAe,KAAG,MAiBrE,CAAA;AA4BD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,KAAG,SAAS,GAAG,GAiCpF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,QAAQ,EAAE,UAAS,UAAe,KAAG,WAkBxE,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,UAAS,oBAAyB,KAAG,QA4BpF,CAAA"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAM/D,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE1D,MAAM,MAAM,UAAU,GAAG;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,8CAA8C;AAC9C,eAAO,MAAM,SAAS,SAAS,CAAA;AAqB/B;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,UAAS,UAAe,KAAG,MAoBrE,CAAA;AA6CD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,KAAG,SAAS,GAAG,GA0CpF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,QAAQ,EAAE,UAAS,UAAe,KAAG,WA0BxE,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,UAAS,oBAAyB,KAAG,QAoDpF,CAAA"}