agentfootprint 9.74.0 → 9.76.0

package/dist/esm/core/agent/toolDispatch.js

@@ -0,0 +1,97 @@
+/**
+ * toolDispatch — the run's own tool dispatch, delivered as `ctx.tools`.
+ *
+ * Pattern: a deps-closure factory beside `toolArtifacts` / `toolProgress` in
+ *          the tool-calls handler; this module holds the PURE half (the
+ *          dispatch object over a lookup + an inner-context maker) so the
+ *          handler wires closures and nothing else.
+ * Role:    core/agent — composition over the registry (the runbookAsTool
+ *          substrate; any tool may consume it).
+ * Emits:   nothing itself. Inner executes flow through the tool's own
+ *          channels (`ctx.progress`, its result); they do NOT fire
+ *          `tool_start`/`tool_end` — an inner call is the OUTER call's work,
+ *          not a turn of the model's, and synthesizing model-facing events
+ *          for it would put calls in the record the model never made.
+ *
+ * What an inner call is NOT (phase 1, refused loudly, never silently):
+ *   - it cannot pause — a `checkIn` tool or a credential that needs
+ *     interactive consent refuses by name;
+ *   - it cannot redeem artifact refs — a `wants` tool refuses by name
+ *     (dispatch-time resolution belongs to the model-facing loop);
+ *   - it does not see ToolProvider-delivered tools — there is no build-time
+ *     list of those (the 9.72.0 caveat, carried forward honestly);
+ *   - it does not carry `ctx.tools` itself — composition depth stops at one,
+ *     the same bound the runbook grammar declares for sub-runbooks.
+ */
+/**
+ * Build the `ctx.tools` dispatch for one outer tool call.
+ *
+ * `call` resolves the inner tool's declared `needs` through the inner
+ * context's own credential provider (fail-closed — the provider throws its
+ * teaching refusal when none is attached), refuses the shapes an inner call
+ * cannot honor (see the module header), executes, and returns the result
+ * exactly as the tool returned it. Policy about what a result MEANS — an
+ * absence that should short-circuit, a coverage ledger that should fold —
+ * belongs to the consumer wrapping this dispatch, never here.
+ */
+export function agentToolDispatch(deps) {
+    let seq = 0;
+    return {
+        has(name) {
+            return deps.lookup(name) !== undefined;
+        },
+        async call(name, args, opts) {
+            const tool = deps.lookup(name);
+            if (tool === undefined) {
+                throw new Error(`ctx.tools.call('${name}'): no tool of that name is in this agent's dispatch map ` +
+                    `(static .tool() registrations plus skill-carried tools). Tools delivered by a ` +
+                    `ToolProvider are not visible to inner dispatch — there is no build-time list of ` +
+                    `them. Register the tool statically, or check ctx.tools.has() first.`);
+            }
+            if (tool.checkIn !== undefined) {
+                throw new Error(`ctx.tools.call('${name}'): that tool declares a human check-in, and an inner ` +
+                    `dispatch call cannot pause — running it here would silently skip a consent ` +
+                    `gate somebody declared. Call it as a top-level tool, where the check-in rail ` +
+                    `holds.`);
+            }
+            if (tool.wants !== undefined) {
+                throw new Error(`ctx.tools.call('${name}'): that tool declares artifact arguments (wants), and ` +
+                    `inner dispatch does not resolve refs — the tool would run believing the ` +
+                    `framework delivered data it did not. Call it as a top-level tool, or pass the ` +
+                    `data through a tool that takes it directly.`);
+            }
+            seq += 1;
+            const base = deps.innerContext(name, seq);
+            const ctx = {
+                ...base,
+                ...(opts?.signal !== undefined && { signal: opts.signal }),
+                ...(tool.needs !== undefined && {
+                    credential: await resolveInnerCredential(name, tool, base),
+                }),
+            };
+            return await tool.execute(args, ctx);
+        },
+    };
+}
+/**
+ * Resolve a declared `needs` for an inner call — the simple, non-interactive
+ * path only. Fail-closed: anything short of an issued credential refuses by
+ * name, because the consent flow the outer loop would ride (pause, URL,
+ * resume) has no seat inside a dispatch call.
+ */
+async function resolveInnerCredential(name, tool, ctx) {
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const need = tool.needs;
+    const result = await ctx.credentials.getCredential({
+        service: need.credential,
+        ...(need.scopes && { scopes: need.scopes }),
+        ...(need.mode && { mode: need.mode }),
+    });
+    if (result.status === 'issued')
+        return result.credential;
+    throw new Error(`ctx.tools.call('${name}'): the tool's declared credential '${need.credential}' did not ` +
+        `resolve to an issued credential (status '${result.status}'). An inner dispatch call ` +
+        `cannot pause for consent — complete the authorization first, or call the tool at the ` +
+        `top level where the consent rail can hold the run.`);
+}
+//# sourceMappingURL=toolDispatch.js.map

package/dist/esm/core/agent/toolDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDispatch.js","sourceRoot":"","sources":["../../../../src/core/agent/toolDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAuBH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO;QACL,GAAG,CAAC,IAAY;YACd,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAa,EAAE,IAA8B;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,2DAA2D;oBAChF,gFAAgF;oBAChF,kFAAkF;oBAClF,qEAAqE,CACxE,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,wDAAwD;oBAC7E,6EAA6E;oBAC7E,+EAA+E;oBAC/E,QAAQ,CACX,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,yDAAyD;oBAC9E,0EAA0E;oBAC1E,gFAAgF;oBAChF,6CAA6C,CAChD,CAAC;YACJ,CAAC;YACD,GAAG,IAAI,CAAC,CAAC;YACT,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAyB;gBAChC,GAAG,IAAI;gBACP,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC1D,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI;oBAC9B,UAAU,EAAE,MAAM,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;iBAC3D,CAAC;aACH,CAAC;YACF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAA+B,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,sBAAsB,CACnC,IAAY,EACZ,IAAU,EACV,GAAyB;IAEzB,oEAAoE;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAM,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,aAAa,CAAC;QACjD,OAAO,EAAE,IAAI,CAAC,UAAU;QACxB,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KACtC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,UAAU,CAAC;IACzD,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,uCAAuC,IAAI,CAAC,UAAU,YAAY;QACvF,4CAA4C,MAAM,CAAC,MAAM,6BAA6B;QACtF,uFAAuF;QACvF,oDAAoD,CACvD,CAAC;AACJ,CAAC"}

package/dist/esm/core/flowchartAsTool.d.ts

@@ -1,6 +1,12 @@
 /**
  * flowchartAsTool — wrap a footprintjs `FlowChart` as an Agent `Tool`.
  *
+ * NOTE (9.76.0): for NEW procedures prefer `runbookAsTool` (core/runbook/) —
+ * the standard bridge whose every answer carries the honesty envelope
+ * (coverage, provenance, rule version, the recorded walk). This thin wrapper
+ * stays for compatibility; `resultMapper` users stay put and nothing here
+ * changes.
+ *
  * The Block A7 piece. footprintjs is the substrate; agentfootprint is
  * the agent layer above it. When a multi-step procedure is already
  * expressed as a footprintjs flowchart (intake validation, refund

package/dist/esm/core/flowchartAsTool.js

@@ -1,6 +1,12 @@
 /**
  * flowchartAsTool — wrap a footprintjs `FlowChart` as an Agent `Tool`.
  *
+ * NOTE (9.76.0): for NEW procedures prefer `runbookAsTool` (core/runbook/) —
+ * the standard bridge whose every answer carries the honesty envelope
+ * (coverage, provenance, rule version, the recorded walk). This thin wrapper
+ * stays for compatibility; `resultMapper` users stay put and nothing here
+ * changes.
+ *
  * The Block A7 piece. footprintjs is the substrate; agentfootprint is
  * the agent layer above it. When a multi-step procedure is already
  * expressed as a footprintjs flowchart (intake validation, refund
@@ -247,8 +253,9 @@ export function flowchartAsTool(opts) {
             }
             if (executor.isPaused()) {
                 keepRecordOf('paused');
-                const err = new Error(`flowchartAsTool(${opts.name}): inner flowchart paused. ` +
-                    `Agent-side pause integration lands in v2.6. The checkpoint is on err.checkpoint.`);
+                const err = new Error(`flowchartAsTool(${opts.name}): inner flowchart paused. Agent-side pause ` +
+                    `integration lands with the runbook program's approval-gate phase (see ` +
+                    `runbookAsTool). The checkpoint is on err.checkpoint.`);
                 err.checkpoint = executor.getCheckpoint();
                 throw err;
             }

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

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