agentfootprint 9.75.0 → 9.76.1

package/dist/esm/core/flowchartAsTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowchartAsTool.js","sourceRoot":"","sources":["../../../src/core/flowchartAsTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqHG;AAEH,OAAO,EACL,iBAAiB,GAIlB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,GAId,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiJxC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,eAAe,CAAC,IAA4B;IAC1D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,iCAAiC,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,+BAA+B,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,IAAI,4DAA4D;gBACtF,oFAAoF;gBACpF,qFAAqF;gBACrF,mCAAmC,CACtC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,IAAI,mDAAmD;gBAC7E,iCAAiC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,oBAAoB;gBACjF,uEAAuE,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GACV,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvE,sEAAsE;IACtE,wEAAwE;IACxE,MAAM,KAAK,GACT,IAAI,CAAC,UAAU,KAAK,IAAI;QACtB,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,eAAe,IAAI,uBAAuB,CAAC;QAChE,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,IAAI,GAAG,UAAU,CAAkC;QACvD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAyB,EAAE,EAAE;YACjD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvD,IAAI,IAAI,CAAC,MAAM;gBAAE,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;gBAC5C,QAAQ,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;YAC5C,CAAC;YACD,oEAAoE;YACpE,gEAAgE;YAChE,gEAAgE;YAChE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACtD,IAAI,IAAI;gBAAE,QAAQ,CAAC,sBAAsB,CAAC,IAAmC,CAAC,CAAC;YAE/E;;;;;;;;;;;;eAYG;YACH,MAAM,YAAY,GAAG,CAAC,OAAwB,EAAE,KAAe,EAAQ,EAAE;gBACvE,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,KAAK,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;oBACjD,MAAM,SAAS,GAAI,QAA+C,CAAC,SAAS,CAAC;oBAC7E,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC;yBACnD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;yBAClE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBACrC,KAAK,CAAC,IAAI,CAAC;wBACT,UAAU,EAAE,GAAG,CAAC,UAAU;wBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;wBACnB,OAAO;wBACP,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;wBACtD,SAAS,EAAE;4BACT,QAAQ;4BACR,SAAS,EAAG,IAAI,CAAC,SAA8C,CAAC,kBAAkB;yBACnF;wBACD,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;wBAC3D,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;qBAC3C,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,KAAK,CAAC,IAAI,CAAC;wBACT,UAAU,EAAE,GAAG,CAAC,UAAU;wBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;wBACnB,OAAO;wBACP,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;qBACpD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,GAAG,GAA6B,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,MAAM;gBAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CAAC,CAAC;YACV,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACxB,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACvB,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,mBAAmB,IAAI,CAAC,IAAI,6BAA6B;oBACvD,kFAAkF,CACrF,CAAC;gBACD,GAAwC,CAAC,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAChF,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YACnC,mEAAmE;YACnE,6CAA6C;YAC7C,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACxB,8DAA8D;YAC9D,+DAA+D;YAC/D,qCAAqC;YACrC,MAAM,WAAW,GACd,GAA2D,CAAC,WAAW;gBACvE,GAAsD,CAAC,MAAM;gBAC9D,EAAE,CAAC;YACL,MAAM,QAAQ,GAA0B;gBACtC,MAAM,EAAE,WAAW;gBACnB,SAAS,EAAE,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC;aAC3C,CAAC;YACF,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,6DAA6D;gBAC7D,8DAA8D;gBAC9D,oBAAoB;gBACpB,MAAM,MAAM,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC1D,OAAO,kBAAkB,MAAM,GAAG,CAAC;YACrC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,sEAAsE;IACtE,sEAAsE;IACtE,oEAAoE;IACpE,+DAA+D;IAC/D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,YAAY,GAA0B,EAAE,GAAG,IAAI,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC;IACpF,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CACvB,GAAY,EACZ,QAAwE;IAExE,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,mBAAmB,KAAK,UAAU,EAAE,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,mBAAmB,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,OAAO,OAAwE,CAAC;YAClF,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,SAAS,GACZ,GAA+B,CAAC,SAAS;QACzC,GAAsC,CAAC,gBAAgB,CAAC;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,SAA0E,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"flowchartAsTool.js","sourceRoot":"","sources":["../../../src/core/flowchartAsTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/runbook/coverage.d.ts

@@ -0,0 +1,69 @@
+/**
+ * runbook/coverage — the spine's ledger: inner folds + chart-declared
+ * entries + the bridge's own, and the sentence naming the rules.
+ *
+ * Pattern: pure fold over three sources, reusing the coverage primitives'
+ *          own recognizer and merge — no second grammar.
+ * Role:    core/runbook.
+ * Emits:   N/A.
+ *
+ * The three sources, in the order they land:
+ *   1. INNER LEDGERS — every recorded inner call's result is read by the
+ *      same `readCoverageResult` funnel the dispatch loop uses, and its
+ *      three lists fold upward. An inner tool's honesty is carried, never
+ *      re-authored.
+ *   2. THE CHART'S OWN — the procedure states run-specific coverage by
+ *      writing a `coverage` state key (`{ checked?, not_checked?,
+ *      cannot_cover? }`, items as `{what, why?}` bags or bare strings).
+ *      This is the app's vocabulary (which counters mean "not assessed" is
+ *      the chart's to know); the ENVELOPE is the bridge's.
+ *   3. THE BRIDGE'S OWN — one `checked` entry naming the procedure, its
+ *      recorded step count and the rule set it ran under; and, for a
+ *      verdict-shaped runbook, a `not_checked` entry counting DECLINED rows
+ *      (the three-outcome honesty: a row that reached no classification is
+ *      ground the answer does not cover).
+ */
+import type { CoverageItem } from '../agent/coverage/types.js';
+import type { InnerCallRecord } from './dispatch.js';
+import type { RunbookRules } from './types.js';
+/** The three lists, mid-fold. */
+export interface LedgerLists {
+    readonly checked: readonly CoverageItem[];
+    readonly notChecked: readonly CoverageItem[];
+    readonly cannotCover: readonly CoverageItem[];
+}
+/** Fold every recorded inner call's declared coverage upward. */
+export declare function foldInnerCoverage(records: readonly InnerCallRecord[]): LedgerLists;
+/** The chart-declared lists, read off the final state's `coverage` key.
+ *  Accepts both spellings of the two-word keys (state is often snake_case,
+ *  the declaration camelCase) — one reader, no drift. */
+export declare function chartCoverageOf(state: Readonly<Record<string, unknown>>): LedgerLists;
+/** What the composed ledger needs to know about this run. */
+export interface LedgerFacts {
+    readonly chartName: string;
+    readonly stepsExecuted: number;
+    readonly rules?: RunbookRules;
+    /** Rowset facts — present only for a verdict-shaped runbook. */
+    readonly rowsTotal?: number;
+    readonly declinedRows?: number;
+}
+/** The composed `af_coverage` value: three merged lists + the static law
+ *  note + this run's own sentence. */
+export interface ComposedLedger {
+    readonly checked?: readonly CoverageItem[];
+    readonly not_checked?: readonly CoverageItem[];
+    readonly cannot_cover?: readonly CoverageItem[];
+    readonly note: string;
+    readonly sentence: string;
+}
+/** Compose the whole ledger. Inner folds land first, chart-declared second,
+ *  the bridge's own last — provenance order, so a reader meets the sources
+ *  before the summary. */
+export declare function composeLedger(inner: LedgerLists, chart: LedgerLists, facts: LedgerFacts): ComposedLedger;
+/**
+ * The carried provenance stamp: the FIRST inner result that declared an
+ * `af_provenance` (on its unwrapped payload, or at its top level — both are
+ * read, in that order). A derived answer is still an answer, and a source's
+ * confession (`source: 'LOCAL SEED'`) must survive composition.
+ */
+export declare function carriedProvenanceOf(records: readonly InnerCallRecord[]): Record<string, unknown> | undefined;

package/dist/esm/core/runbook/coverage.js

@@ -0,0 +1,155 @@
+/**
+ * runbook/coverage — the spine's ledger: inner folds + chart-declared
+ * entries + the bridge's own, and the sentence naming the rules.
+ *
+ * Pattern: pure fold over three sources, reusing the coverage primitives'
+ *          own recognizer and merge — no second grammar.
+ * Role:    core/runbook.
+ * Emits:   N/A.
+ *
+ * The three sources, in the order they land:
+ *   1. INNER LEDGERS — every recorded inner call's result is read by the
+ *      same `readCoverageResult` funnel the dispatch loop uses, and its
+ *      three lists fold upward. An inner tool's honesty is carried, never
+ *      re-authored.
+ *   2. THE CHART'S OWN — the procedure states run-specific coverage by
+ *      writing a `coverage` state key (`{ checked?, not_checked?,
+ *      cannot_cover? }`, items as `{what, why?}` bags or bare strings).
+ *      This is the app's vocabulary (which counters mean "not assessed" is
+ *      the chart's to know); the ENVELOPE is the bridge's.
+ *   3. THE BRIDGE'S OWN — one `checked` entry naming the procedure, its
+ *      recorded step count and the rule set it ran under; and, for a
+ *      verdict-shaped runbook, a `not_checked` entry counting DECLINED rows
+ *      (the three-outcome honesty: a row that reached no classification is
+ *      ground the answer does not cover).
+ */
+import { readCoverageResult } from '../agent/coverage/read.js';
+import { mergeItems } from '../agent/coverage/items.js';
+import { COVERAGE_NOTE } from '../agent/coverage/ledger.js';
+const EMPTY = { checked: [], notChecked: [], cannotCover: [] };
+/** Fold every recorded inner call's declared coverage upward. */
+export function foldInnerCoverage(records) {
+    const checked = [];
+    const notChecked = [];
+    const cannotCover = [];
+    for (const record of records) {
+        if (record.result === undefined)
+            continue;
+        const reading = readCoverageResult(record.result);
+        for (const declared of reading?.declared ?? []) {
+            checked.push(declared.coverage.checked);
+            notChecked.push(declared.coverage.notChecked);
+            cannotCover.push(declared.coverage.cannotCover);
+        }
+    }
+    return {
+        checked: mergeItems(checked),
+        notChecked: mergeItems(notChecked),
+        cannotCover: mergeItems(cannotCover),
+    };
+}
+/** One list off the chart's `coverage` state key, normalized leniently —
+ *  this is state the chart wrote, not a foreign wire; a malformed entry is
+ *  dropped rather than refused (the run already happened). */
+function stateList(value) {
+    if (!Array.isArray(value))
+        return [];
+    const items = [];
+    for (const entry of value) {
+        if (typeof entry === 'string' && entry.trim() !== '') {
+            items.push({ what: entry.trim() });
+        }
+        else if (entry !== null &&
+            typeof entry === 'object' &&
+            typeof entry.what === 'string') {
+            const what = entry.what;
+            const why = entry.why;
+            items.push({ what, ...(typeof why === 'string' && { why }) });
+        }
+    }
+    return items;
+}
+/** The chart-declared lists, read off the final state's `coverage` key.
+ *  Accepts both spellings of the two-word keys (state is often snake_case,
+ *  the declaration camelCase) — one reader, no drift. */
+export function chartCoverageOf(state) {
+    const bag = state.coverage;
+    if (bag === null || typeof bag !== 'object' || Array.isArray(bag))
+        return EMPTY;
+    const rec = bag;
+    return {
+        checked: stateList(rec.checked),
+        notChecked: stateList(rec.not_checked ?? rec.notChecked),
+        cannotCover: stateList(rec.cannot_cover ?? rec.cannotCover),
+    };
+}
+/** The rules clause every sentence carries — or the honest silence. */
+function rulesClause(rules) {
+    return rules !== undefined ? ` under ${rules.name} ${rules.version}` : '';
+}
+/** Compose the whole ledger. Inner folds land first, chart-declared second,
+ *  the bridge's own last — provenance order, so a reader meets the sources
+ *  before the summary. */
+export function composeLedger(inner, chart, facts) {
+    const own = [
+        {
+            what: `the declared procedure '${facts.chartName}' — ${facts.stepsExecuted} step(s) ` +
+                `recorded${rulesClause(facts.rules)}`,
+            ...(facts.rowsTotal !== undefined && {
+                why: `${facts.rowsTotal} row(s) assessed, one decider pass per row`,
+            }),
+        },
+    ];
+    const declinedEntries = facts.declinedRows !== undefined && facts.declinedRows > 0
+        ? [
+            {
+                what: `${facts.declinedRows} row(s) that reached NO classification (verdict 'declined')`,
+                why: 'the declared rules could not be read for them; they are in the rowset with ' +
+                    'everything that IS known, and nothing was guessed to fill the gap',
+            },
+        ]
+        : [];
+    const checked = mergeItems([inner.checked, chart.checked, own]);
+    const notChecked = mergeItems([inner.notChecked, chart.notChecked, declinedEntries]);
+    const cannotCover = mergeItems([inner.cannotCover, chart.cannotCover]);
+    const rowsPart = facts.rowsTotal !== undefined
+        ? `; ${facts.rowsTotal} row(s) assessed` +
+            (facts.declinedRows !== undefined && facts.declinedRows > 0
+                ? `, ${facts.declinedRows} declined (no classification reached)`
+                : '')
+        : '';
+    const gapsPart = notChecked.length > 0 ? `; ${notChecked.length} not-checked item(s) declared` : '';
+    const sentence = `Ran '${facts.chartName}'${rulesClause(facts.rules)} — ` +
+        `${facts.stepsExecuted} step(s) recorded${rowsPart}${gapsPart}.`;
+    return {
+        ...(checked.length > 0 && { checked }),
+        ...(notChecked.length > 0 && { not_checked: notChecked }),
+        ...(cannotCover.length > 0 && { cannot_cover: cannotCover }),
+        note: COVERAGE_NOTE,
+        sentence,
+    };
+}
+/**
+ * The carried provenance stamp: the FIRST inner result that declared an
+ * `af_provenance` (on its unwrapped payload, or at its top level — both are
+ * read, in that order). A derived answer is still an answer, and a source's
+ * confession (`source: 'LOCAL SEED'`) must survive composition.
+ */
+export function carriedProvenanceOf(records) {
+    const bagOf = (value) => value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+    for (const record of records) {
+        const top = bagOf(record.result);
+        if (top === undefined)
+            continue;
+        const payload = bagOf(top.result);
+        for (const candidate of [payload, top]) {
+            const stamp = bagOf(candidate?.af_provenance);
+            if (stamp !== undefined)
+                return stamp;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=coverage.js.map

package/dist/esm/core/runbook/coverage.js.map

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

package/dist/esm/core/runbook/dispatch.d.ts

@@ -0,0 +1,69 @@
+/**
+ * runbook/dispatch — the bridge's wrapper over `ctx.tools`.
+ *
+ * Pattern: decorator over {@link ToolDispatch}. The RAW dispatch (delivered
+ *          by the agent) returns every result untouched; POLICY about what a
+ *          result means belongs to the consumer — and this is the runbook's
+ *          policy: every inner outcome is RECORDED (for the coverage fold and
+ *          the provenance carry), and an inner ABSENCE short-circuits the
+ *          procedure unless the call site declared it survivable.
+ * Role:    core/runbook, pure.
+ * Emits:   N/A.
+ *
+ * WHY an absence short-circuits: "the inventory found nothing" IS the
+ * runbook's answer, and it must go back EXACTLY as it arrived so the
+ * framework still reads it as an absence — a verdict reached over a source
+ * that answered "nothing here" would be the confident-partial-answer failure
+ * this whole envelope exists to prevent. A stage that can genuinely carry on
+ * without the source says so at the call site (`{ allowAbsent: true }`) and
+ * owns stating the gap (usually as a coverage entry).
+ */
+import type { ToolAbsence } from '../agent/coverage/types.js';
+import type { ToolDispatch } from '../tools.js';
+/** One inner call, as the bridge recorded it. */
+export interface InnerCallRecord {
+    readonly tool: string;
+    readonly outcome: 'ok' | 'absent' | 'error';
+    /** The raw returned value (`'ok'` and `'absent'` outcomes). */
+    readonly result?: unknown;
+}
+/** The marker property that survives any error wrapping between a stage and
+ *  the bridge's catch. */
+declare const ABSENCE_SIGNAL: "af_runbook_absence";
+/**
+ * The control signal an un-survivable inner absence throws through the
+ * chart. The engine commits staged state and rethrows (commit-on-error is
+ * the law upstream), so the bridge catches this at `executor.run` and
+ * returns the absence verbatim.
+ */
+export declare class RunbookAbsenceSignal extends Error {
+    readonly absence: ToolAbsence;
+    readonly [ABSENCE_SIGNAL] = true;
+    constructor(absence: ToolAbsence, innerTool: string);
+}
+/** Recognize the signal on an error OR anywhere down its `cause` chain — an
+ *  engine layer that wraps the stage's throw must not defeat the pass-through. */
+export declare function absenceSignalOf(err: unknown): RunbookAbsenceSignal | undefined;
+/** What `recordingDispatch` hands back: the dispatch the procedure closes
+ *  over, and the record the envelope folds. */
+export interface RecordedDispatch {
+    readonly tools: ToolDispatch;
+    readonly records: readonly InnerCallRecord[];
+}
+/**
+ * Wrap the delivered dispatch (or its absence) for one runbook invocation.
+ *
+ * With NO dispatch delivered (`ctx.tools` absent — a hand-built context, a
+ * door with no dispatch map) the wrapper is the fail-closed teacher: `has`
+ * answers false and `call` refuses naming the fix, so a procedure that needs
+ * inner tools fails loudly at its first call instead of half-running.
+ */
+export declare function recordingDispatch(delivered: ToolDispatch | undefined, runbookName: string): RecordedDispatch;
+/**
+ * The definition-time probe dispatch — handed to the procedure factory ONCE
+ * at `runbookAsTool(...)` so the bridge can read the chart's declared
+ * contract. Stage bodies do not run at build; a factory that calls tools at
+ * build time hears exactly why that cannot work.
+ */
+export declare function probeDispatch(runbookName: string): ToolDispatch;
+export {};

package/dist/esm/core/runbook/dispatch.js

@@ -0,0 +1,112 @@
+/**
+ * runbook/dispatch — the bridge's wrapper over `ctx.tools`.
+ *
+ * Pattern: decorator over {@link ToolDispatch}. The RAW dispatch (delivered
+ *          by the agent) returns every result untouched; POLICY about what a
+ *          result means belongs to the consumer — and this is the runbook's
+ *          policy: every inner outcome is RECORDED (for the coverage fold and
+ *          the provenance carry), and an inner ABSENCE short-circuits the
+ *          procedure unless the call site declared it survivable.
+ * Role:    core/runbook, pure.
+ * Emits:   N/A.
+ *
+ * WHY an absence short-circuits: "the inventory found nothing" IS the
+ * runbook's answer, and it must go back EXACTLY as it arrived so the
+ * framework still reads it as an absence — a verdict reached over a source
+ * that answered "nothing here" would be the confident-partial-answer failure
+ * this whole envelope exists to prevent. A stage that can genuinely carry on
+ * without the source says so at the call site (`{ allowAbsent: true }`) and
+ * owns stating the gap (usually as a coverage entry).
+ */
+import { readAbsence } from '../agent/coverage/absent.js';
+/** The marker property that survives any error wrapping between a stage and
+ *  the bridge's catch. */
+const ABSENCE_SIGNAL = 'af_runbook_absence';
+/**
+ * The control signal an un-survivable inner absence throws through the
+ * chart. The engine commits staged state and rethrows (commit-on-error is
+ * the law upstream), so the bridge catches this at `executor.run` and
+ * returns the absence verbatim.
+ */
+export class RunbookAbsenceSignal extends Error {
+    absence;
+    [ABSENCE_SIGNAL] = true;
+    constructor(absence, innerTool) {
+        super(`runbook inner tool '${innerTool}' answered with an absence — the runbook's answer ` +
+            `IS that absence, passed through verbatim. (Declare the call survivable with ` +
+            `{ allowAbsent: true } if the procedure can carry on without this source.)`);
+        this.absence = absence;
+        this.name = 'RunbookAbsenceSignal';
+    }
+}
+/** Recognize the signal on an error OR anywhere down its `cause` chain — an
+ *  engine layer that wraps the stage's throw must not defeat the pass-through. */
+export function absenceSignalOf(err) {
+    let current = err;
+    for (let hops = 0; hops < 8 && current !== null && typeof current === 'object'; hops += 1) {
+        if (current[ABSENCE_SIGNAL] === true) {
+            return current;
+        }
+        current = current.cause;
+    }
+    return undefined;
+}
+/**
+ * Wrap the delivered dispatch (or its absence) for one runbook invocation.
+ *
+ * With NO dispatch delivered (`ctx.tools` absent — a hand-built context, a
+ * door with no dispatch map) the wrapper is the fail-closed teacher: `has`
+ * answers false and `call` refuses naming the fix, so a procedure that needs
+ * inner tools fails loudly at its first call instead of half-running.
+ */
+export function recordingDispatch(delivered, runbookName) {
+    const records = [];
+    const tools = {
+        has(name) {
+            return delivered?.has(name) ?? false;
+        },
+        async call(name, args, opts) {
+            if (delivered === undefined) {
+                throw new Error(`runbookAsTool('${runbookName}'): the procedure called tools.call('${name}') but ` +
+                    `no dispatch was delivered on ctx.tools. Register this runbook on an Agent ` +
+                    `(agent dispatch delivers ctx.tools at execute time), or supply a ToolDispatch ` +
+                    `on the execution context when invoking the tool directly.`);
+            }
+            let raw;
+            try {
+                raw = await delivered.call(name, args, opts);
+            }
+            catch (err) {
+                records.push({ tool: name, outcome: 'error' });
+                throw err;
+            }
+            const absence = readAbsence(raw);
+            if (absence !== undefined) {
+                records.push({ tool: name, outcome: 'absent', result: raw });
+                if (opts?.allowAbsent === true)
+                    return raw;
+                throw new RunbookAbsenceSignal(absence, name);
+            }
+            records.push({ tool: name, outcome: 'ok', result: raw });
+            return raw;
+        },
+    };
+    return { tools, records };
+}
+/**
+ * The definition-time probe dispatch — handed to the procedure factory ONCE
+ * at `runbookAsTool(...)` so the bridge can read the chart's declared
+ * contract. Stage bodies do not run at build; a factory that calls tools at
+ * build time hears exactly why that cannot work.
+ */
+export function probeDispatch(runbookName) {
+    return {
+        has: () => false,
+        call: (name) => {
+            throw new Error(`runbookAsTool('${runbookName}'): tools.call('${name}') was invoked while BUILDING ` +
+                `the chart. The dispatch only exists at execute time — call tools from inside ` +
+                `stage functions (which close over it), never from the factory body.`);
+        },
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/esm/core/runbook/dispatch.js.map

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

package/dist/esm/core/runbook/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * runbook — the standard bridge from a footprintjs procedure to an Agent
+ * tool with the mandatory honesty spine. See README.md in this folder.
+ */
+export { runbookAsTool } from './runbookAsTool.js';
+export { absenceSignalOf, probeDispatch, recordingDispatch, RunbookAbsenceSignal, type InnerCallRecord, type RecordedDispatch, } from './dispatch.js';
+export { DECLINED_VERDICT, DEFAULT_MAX_ROWS, renderVerdictTable, VERDICT_RENDER_NOTE, verdictRowsOf, } from './verdicts.js';
+export { DEFAULT_WALK_CAP, projectWalk, type ProjectedWalk, type WalkRow } from './walk.js';
+export type { RunbookAsToolOptions, RunbookEnvelope, RunbookProcedure, RunbookRules, RunbookVerdictsOptions, RunbookWalkOptions, VerdictRow, WalkDescriptor, } from './types.js';

package/dist/esm/core/runbook/index.js

@@ -0,0 +1,9 @@
+/**
+ * runbook — the standard bridge from a footprintjs procedure to an Agent
+ * tool with the mandatory honesty spine. See README.md in this folder.
+ */
+export { runbookAsTool } from './runbookAsTool.js';
+export { absenceSignalOf, probeDispatch, recordingDispatch, RunbookAbsenceSignal, } from './dispatch.js';
+export { DECLINED_VERDICT, DEFAULT_MAX_ROWS, renderVerdictTable, VERDICT_RENDER_NOTE, verdictRowsOf, } from './verdicts.js';
+export { DEFAULT_WALK_CAP, projectWalk } from './walk.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/runbook/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/runbook/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GAGrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAoC,MAAM,WAAW,CAAC"}

package/dist/esm/core/runbook/report.d.ts

@@ -0,0 +1,52 @@
+/**
+ * runbook/report — the chart's own `report` bag, admitted UNDER the envelope.
+ *
+ * Pattern: one pure partition (admitted fields / refused names) plus the
+ *          sentence that names what was refused. No behavior beyond the law.
+ * Role:    core/runbook. `runbookAsTool.ts` consumes at assembly time.
+ * Emits:   N/A.
+ *
+ * THE PRECEDENCE LAW: the names the envelope itself assembles — the honesty
+ * spine, and the projection keys this run actually produced — are RESERVED.
+ * A chart's `report` may add fields BESIDE them; it may never replace one.
+ * The spine is the boundary of the answer, and a boundary a chart can
+ * overwrite is a boundary that reports whatever the chart says about itself:
+ * a seeded number could arrive stamped as a sourced one, or an answer
+ * produced under one reading of the rules could name a version it never ran.
+ * A `report` key spelled `af_coverage` is refused too — it lands one level
+ * under the real ledger, which is exactly where a decoy would want to sit.
+ *
+ * AND WHY THE REFUSAL IS SPOKEN, not silent: every other reduction this
+ * envelope performs is declared out loud — the walk's `projection`, the
+ * rowset's `rows_complete`, declined rows counted into the ledger. Dropping
+ * a field the chart wrote with no trace would be the one silent edit in an
+ * envelope whose whole argument is that reductions are declared, and the
+ * author would debug "where did my field go?" against a shape that never
+ * mentions it. So a collision costs one `report_note` naming every refused
+ * field — present ONLY when something was actually refused, so the clean
+ * path (every real runbook) pays nothing.
+ */
+/** The ledger's key. It lives at the ENVELOPE's top level, and is reserved
+ *  inside `result` too — see the module header. */
+export declare const LEDGER_KEY = "af_coverage";
+/** The key the refusal note ships under — itself reserved, because a
+ *  chart-authored `report_note` is a forged receipt for a refusal that
+ *  never happened. */
+export declare const REPORT_NOTE_KEY = "report_note";
+/** The chart's `report`, partitioned against the names the envelope owns. */
+export interface AdmittedReport {
+    /** The fields that may be spread into `result`, in the chart's own order. */
+    readonly fields: Record<string, unknown>;
+    /** The names refused, in the chart's own order — empty on the clean path. */
+    readonly refused: readonly string[];
+}
+/**
+ * Partition the chart's `report` against the names this envelope assembled.
+ * `assembled` is read from the actual spine and projection objects, never
+ * from a hand-listed copy — a spine field added later is protected the day
+ * it lands.
+ */
+export declare function admitReport(report: Readonly<Record<string, unknown>>, assembled: Iterable<string>): AdmittedReport;
+/** The sentence for a refused collision: which fields were discarded, whose
+ *  the surviving values are, and what is safe to read. */
+export declare function shadowedFieldsNote(refused: readonly string[]): string;

package/dist/esm/core/runbook/report.js

@@ -0,0 +1,64 @@
+/**
+ * runbook/report — the chart's own `report` bag, admitted UNDER the envelope.
+ *
+ * Pattern: one pure partition (admitted fields / refused names) plus the
+ *          sentence that names what was refused. No behavior beyond the law.
+ * Role:    core/runbook. `runbookAsTool.ts` consumes at assembly time.
+ * Emits:   N/A.
+ *
+ * THE PRECEDENCE LAW: the names the envelope itself assembles — the honesty
+ * spine, and the projection keys this run actually produced — are RESERVED.
+ * A chart's `report` may add fields BESIDE them; it may never replace one.
+ * The spine is the boundary of the answer, and a boundary a chart can
+ * overwrite is a boundary that reports whatever the chart says about itself:
+ * a seeded number could arrive stamped as a sourced one, or an answer
+ * produced under one reading of the rules could name a version it never ran.
+ * A `report` key spelled `af_coverage` is refused too — it lands one level
+ * under the real ledger, which is exactly where a decoy would want to sit.
+ *
+ * AND WHY THE REFUSAL IS SPOKEN, not silent: every other reduction this
+ * envelope performs is declared out loud — the walk's `projection`, the
+ * rowset's `rows_complete`, declined rows counted into the ledger. Dropping
+ * a field the chart wrote with no trace would be the one silent edit in an
+ * envelope whose whole argument is that reductions are declared, and the
+ * author would debug "where did my field go?" against a shape that never
+ * mentions it. So a collision costs one `report_note` naming every refused
+ * field — present ONLY when something was actually refused, so the clean
+ * path (every real runbook) pays nothing.
+ */
+/** The ledger's key. It lives at the ENVELOPE's top level, and is reserved
+ *  inside `result` too — see the module header. */
+export const LEDGER_KEY = 'af_coverage';
+/** The key the refusal note ships under — itself reserved, because a
+ *  chart-authored `report_note` is a forged receipt for a refusal that
+ *  never happened. */
+export const REPORT_NOTE_KEY = 'report_note';
+/**
+ * Partition the chart's `report` against the names this envelope assembled.
+ * `assembled` is read from the actual spine and projection objects, never
+ * from a hand-listed copy — a spine field added later is protected the day
+ * it lands.
+ */
+export function admitReport(report, assembled) {
+    const reserved = new Set([LEDGER_KEY, REPORT_NOTE_KEY, ...assembled]);
+    // Own enumerable string keys, DEFINED not assigned — the same two rules the
+    // spread this replaced followed, so an admitted field lands exactly as it
+    // used to (a `__proto__` key stays a key instead of reaching a setter).
+    const entries = Object.entries(report);
+    return {
+        fields: Object.fromEntries(entries.filter(([key]) => !reserved.has(key))),
+        refused: entries.filter(([key]) => reserved.has(key)).map(([key]) => key),
+    };
+}
+/** The sentence for a refused collision: which fields were discarded, whose
+ *  the surviving values are, and what is safe to read. */
+export function shadowedFieldsNote(refused) {
+    const names = refused.map((name) => `\`${name}\``).join(', ');
+    return (`${refused.length} field(s) the chart's \`report\` wrote were DISCARDED: ${names}. ` +
+        `Those names belong to this envelope — the honesty spine (\`af_coverage\`, ` +
+        `\`af_provenance\`, \`rule_version\`, \`walk\`) and the projection this run ` +
+        `assembled — so the values you are reading under them are the bridge's, not the ` +
+        `chart's. A report adds fields beside the spine; it never replaces one. Every ` +
+        `other report field is here verbatim.`);
+}
+//# sourceMappingURL=report.js.map

package/dist/esm/core/runbook/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../../src/core/runbook/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;mDACmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC;;sBAEsB;AACtB,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAU7C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,MAAyC,EACzC,SAA2B;IAE3B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IAC9E,4EAA4E;IAC5E,0EAA0E;IAC1E,wEAAwE;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED;0DAC0D;AAC1D,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CACL,GAAG,OAAO,CAAC,MAAM,0DAA0D,KAAK,IAAI;QACpF,4EAA4E;QAC5E,6EAA6E;QAC7E,iFAAiF;QACjF,+EAA+E;QAC/E,sCAAsC,CACvC,CAAC;AACJ,CAAC"}