agentfootprint 12.2.0 → 13.0.0

package/dist/tools/script.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * tools/script — a tool's declaration that it RUNS a program, and the one rule
+ * that judges the declaration.
+ *
+ * Pattern: Map. `Tool.script` is plain data on the tool, judged by ONE assert
+ *          at the three doors a declaration crosses (the `askOrAssume`
+ *          precedent, `tools/declare.ts`): definition (`tools.ts` ·
+ *          `defineTool`), dispatch (`scriptOf`, for a Tool built by hand or
+ *          served by a ToolProvider, which never passes `defineTool`) and MCP
+ *          ingest (`mcp/toolExtras.ts` · `readToolExtras`).
+ * Role:    tools/ layer leaf (L7). Imports nothing from the agent.
+ * Emits:   N/A.
+ *
+ * ## Declared, never inferred
+ *
+ * A tool is code-running because it SAYS so. The library never reads it off a
+ * tool's name (`run_code`), a property named `code` or the description. A tool
+ * that runs code and does not declare it has no submissions on the record, so
+ * a script the model shows for it is prose, as it always was. `codeRunnerTool`
+ * declares `{ argument: 'code', language }` on the tool it builds.
+ *
+ * What the declaration arms (design: docs/design/2026-10-script-artifact.md):
+ * the dispatch loop files one `script` row per call of the tool while
+ * `.namesAndNumbersFromEvidence({ code: 'match' })` or
+ * `.scriptTravelsWithTheAnswer()` is on — the program SUBMITTED to the tool,
+ * and what the runner reported. Never evidence for a value.
+ *
+ * @example
+ * ```ts
+ * const runSql = defineTool({
+ *   name: 'run_sql',
+ *   description: 'Run a read-only SQL query and print the rows.',
+ *   inputSchema: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'] },
+ *   script: { argument: 'query', language: 'sql' },
+ *   execute: async ({ query }) => db.read(query),
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scriptOf = exports.copyToolScript = exports.assertToolScript = void 0;
+const footprintjs_1 = require("footprintjs");
+const MAX_LANGUAGE_CHARS = 64;
+const KEYS = ['argument', 'language'];
+/** Whether a unit may sit in a fence's info string: printable, no backtick. */
+function infoUnitAllowed(unit) {
+    if (unit < 0x20 || unit === 0x7f || unit === 0x60)
+        return false;
+    // Line and paragraph separators end a line for some readers.
+    return unit !== 0x2028 && unit !== 0x2029;
+}
+/**
+ * The one judge of a `script` declaration: refuses, naming the tool, the field
+ * and the fix — a declaration the dispatch loop could not honour, never one it
+ * would quietly repair.
+ *
+ * - a plain object holding only `argument` and `language`;
+ * - `argument` names a property of the input schema whose `type` is `'string'`
+ *   (a program is text), and not a `wants` argument (that one carries an
+ *   artifact ref, then its data — never the program);
+ * - `language`, when present, is one plain token the fence can carry.
+ */
+function assertToolScript(toolName, script, inputSchema, wants) {
+    if (script === undefined)
+        return;
+    const at = `defineTool('${toolName}'): \`script\``;
+    if (script === null || typeof script !== 'object' || Array.isArray(script)) {
+        throw new Error(`${at} must be { argument, language? } — the string argument that carries the program ` +
+            `and its language. Got ${script === null ? 'null' : Array.isArray(script) ? 'an array' : typeof script}.`);
+    }
+    const unknown = Object.keys(script).filter((k) => !KEYS.includes(k));
+    if (unknown.length > 0) {
+        throw new Error(`${at} has unknown key(s) ${unknown.map((k) => `'${k}'`).join(', ')}. ` +
+            'It holds `argument` (the string argument carrying the program) and `language`.');
+    }
+    const { argument, language } = script;
+    if (typeof argument !== 'string' || argument.length === 0) {
+        throw new Error(`${at}.argument must name the ONE string argument that carries the program — got ` +
+            `${JSON.stringify(argument) ?? typeof argument}.`);
+    }
+    const properties = inputSchema?.properties;
+    const property = properties !== null && typeof properties === 'object' && Object.hasOwn(properties, argument)
+        ? properties[argument]
+        : undefined;
+    if (property === null ||
+        typeof property !== 'object' ||
+        property.type !== 'string') {
+        throw new Error(`${at}.argument is '${argument}', which the input schema does not declare as a string ` +
+            `property. Declare \`properties.${argument}: { type: 'string' }\` — the program is ` +
+            'the text the model passes there.');
+    }
+    if (wants !== undefined && Object.hasOwn(wants, argument)) {
+        throw new Error(`${at}.argument is '${argument}', which is a \`wants\` argument: it carries an artifact ` +
+            'ref, and then the artifact’s data — never the program. Name the argument that ' +
+            'holds the code.');
+    }
+    if (language === undefined)
+        return;
+    if (typeof language !== 'string' || language.length === 0) {
+        throw new Error(`${at}.language must be a non-empty string (\`python\`, \`sql\`) when present — got ` +
+            `${JSON.stringify(language) ?? typeof language}.`);
+    }
+    if (language.length > MAX_LANGUAGE_CHARS) {
+        throw new Error(`${at}.language is ${language.length} characters; at most ${MAX_LANGUAGE_CHARS}. It is ` +
+            'the fence’s info string, one token.');
+    }
+    for (let i = 0; i < language.length; i++) {
+        if (!infoUnitAllowed(language.charCodeAt(i))) {
+            throw new Error(`${at}.language holds a line break, a control character or a backtick. It becomes ` +
+                'the info string of the fence the library renders the program in, which may carry ' +
+                'none of them.');
+        }
+    }
+}
+exports.assertToolScript = assertToolScript;
+/** A frozen copy of a well-formed declaration: the two fields, nothing else. */
+function copyToolScript(script) {
+    return Object.freeze({
+        argument: script.argument,
+        ...(script.language !== undefined && { language: script.language }),
+    });
+}
+exports.copyToolScript = copyToolScript;
+/** One verdict per tool object: a judged declaration, or `null` when refused. */
+const verdicts = new WeakMap();
+/** Tools already warned about at the dispatch door — one warning per tool per process. */
+const warned = new WeakSet();
+/**
+ * THE DISPATCH DOOR — the tool's `script` declaration, judged once per tool
+ * object, or `undefined` when it declares none.
+ *
+ * A tool built by hand or served by a ToolProvider never passed `defineTool`,
+ * so its declaration is judged here by the same assert. One that fails it is
+ * NOT a code-running tool for the record (no row is filed, a block the model
+ * shows for it is prose) — never half-honoured — and dev mode names the rule
+ * once, the MCP ingest law (`mcp/toolExtras.ts`): the rail stays unarmed and
+ * the developer is told which and why.
+ */
+function scriptOf(tool) {
+    if (tool === undefined || tool.script === undefined)
+        return undefined;
+    const cached = verdicts.get(tool);
+    if (cached !== undefined)
+        return cached ?? undefined;
+    let verdict;
+    try {
+        assertToolScript(tool.schema.name, tool.script, tool.schema.inputSchema, tool.wants);
+        verdict = copyToolScript(tool.script);
+    }
+    catch (error) {
+        verdict = null;
+        if ((0, footprintjs_1.isDevMode)() && !warned.has(tool)) {
+            warned.add(tool);
+            // eslint-disable-next-line no-console
+            console.warn(`agentfootprint: tool '${tool.schema.name}' declares a \`script\` the library cannot ` +
+                `read, so its calls file no script row — ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    verdicts.set(tool, verdict);
+    return verdict ?? undefined;
+}
+exports.scriptOf = scriptOf;
+//# sourceMappingURL=script.js.map

package/dist/tools/script.js.map

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

package/dist/tools/tools.js

@@ -18,6 +18,7 @@ const askComponent_js_1 = require("./askComponent.js");
 const toolName_js_1 = require("../lib/toolName.js");
 const displayName_js_1 = require("../lib/displayName.js");
 const declare_js_1 = require("./declare.js");
+const script_js_1 = require("./script.js");
 const declaration_js_1 = require("../semantics/coverage/search/declaration.js");
 const review_js_1 = require("../semantics/coverage/search/review.js");
 const searchOf_js_1 = require("./searchOf.js");
@@ -359,6 +360,8 @@ function defineTool(options) {
     assertToolEffects(options.name, options.effects);
     // The app's words reach a person verbatim — refused HERE, naming the tool.
     assertDisplayName(options.name, options.displayName);
+    // The program's argument must be a declared string — refused HERE, naming the tool.
+    (0, script_js_1.assertToolScript)(options.name, options.script, options.inputSchema ?? { type: 'object', properties: {} }, options.wants);
     const tool = {
         schema: {
             name: options.name,
@@ -389,6 +392,7 @@ function defineTool(options) {
         ...(options.search !== undefined && { search: (0, declaration_js_1.freezeSearch)(options.search) }),
         ...(options.effects !== undefined && { effects: options.effects }),
         ...(options.displayName !== undefined && { displayName: options.displayName.trim() }),
+        ...(options.script !== undefined && { script: (0, script_js_1.copyToolScript)(options.script) }),
         execute: options.execute,
     };
     // The app's own word — the one `effects: 'read'` a later check may honour.

package/dist/tools/tools.js.map

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

package/dist/types/adapters/code/output.d.ts

@@ -7,6 +7,7 @@
  * only what the backend reported (no exit status is ever made up).
  */
 import type { CodeCommandOptions, CodeCommandResult, CodeTruncation } from '../../provider-contract/types.js';
+export { isHighSurrogate, isLowSurrogate, utf8Length } from '../../lib/utf8.js';
 /** stdout and stderr after the cut, and what the cut took. */
 export interface BoundedOutput {
     readonly stdout: string;
@@ -62,10 +63,6 @@ export declare function printedLine(stdout: string, line: string): boolean;
  * the one place nobody expects to have to scrub.
  */
 export declare function commandBounds(command: unknown, options: CodeCommandOptions | undefined, runnerMaxOutputChars: number): CommandBounds;
-/** UTF-8 byte length of a string, without encoding it. */
-export declare function utf8Length(text: string): number;
 /** Bytes of a staged or returned payload: a string's UTF-8 length, bytes as they are. */
 export declare function payloadBytes(data: string | Uint8Array): number;
-export declare function isHighSurrogate(unit: number): boolean;
-export declare function isLowSurrogate(unit: number): boolean;
 //# sourceMappingURL=output.d.ts.map

package/dist/types/adapters/code/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/adapters/code/output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACf,MAAM,kCAAkC,CAAC;AAE1C,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;oDACgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAC/B,aAAa,CAgBf;AAQD,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAkB7F;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,oBAAoB,EAAE,MAAM,GAC3B,aAAa,CAgCf;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY/C;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAE9D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/adapters/code/output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACf,MAAM,kCAAkC,CAAC;AAI1C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhF,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;oDACgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAC/B,aAAa,CAgBf;AAQD,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAkB7F;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,oBAAoB,EAAE,MAAM,GAC3B,aAAa,CAgCf;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAE9D"}

package/dist/types/adapters/observability/audit.d.ts

@@ -31,9 +31,9 @@
  *
  * A call a paused batch never dispatched (9.113.0) lands as its two
  * brackets, each carrying `notDispatched: { pausedCall: { toolCallId,
- * toolName } }` and neither carrying `error` — identifiers only, so the field
- * rides VERBATIM in both payload modes (it is not in `BOUND_FIELDS`). The
- * chained record therefore says the call never ran — neither that it
+ * toolName } }` and neither carrying `error` — identifiers only. Bounded mode
+ * checks each field by its declared shape; verbatim mode sanitizes the payload.
+ * The chained record therefore says the call never ran — neither that it
  * succeeded nor that it failed; the bounded `result` (`[type: string]`) never
  * had to say it.
  *
@@ -67,14 +67,25 @@
  *
  * ## PII discipline (mirrors #19's otelObservability)
  *
- * Payloads enter records through a bounding layer — by default
- * (`payloadMode: 'bounded'`) record payloads NEVER carry raw runtime
- * values that can echo PII:
+ * Payloads enter records through a bounding layer: every registered event
+ * has a shape that names every field of its payload (`auditShapes.ts`, total
+ * over the event registry and exhaustive by type, built from the combinators
+ * in `auditBounding.ts`). In the default `payloadMode: 'bounded'` a record
+ * payload keeps the run's STRUCTURE and never its CONTENT — every string or
+ * value the run composed from what it read or produced, whoever wrote it —
+ * except what is named below under "What a bounded record still carries".
+ * Bounding is CLOSED by default: a field a shape does not name, a value that
+ * is not the declared shape, and every field of an event type the registry
+ * does not declare (a consumer's own `emit`), is a marker. Some of what that
+ * bounds:
  *
  *   - tool args             → `'[keys: …]'` (top-level key NAMES only);
  *                             `tool_end`'s `changedArgKeys` is names already
  *   - tool results          → `'[type: …]'` (typeof only) — `result` and,
  *                             when a rule changed it, `modelResult` alike
+ *   - an attached script's program (`turn_end.scripts.shown[].text`)
+ *                           → `'[N chars]'`; checked labels, ids, counts and
+ *                             rendering-boundary flags retain their shapes
  *   - an evaluation's `explanation` → `'[N chars]'` (a judge's reason can
  *                             quote the answer it graded)
  *   - userPrompt / LLM content / thinking blocks / history
@@ -87,13 +98,58 @@
  *     `rawOutput`)          → `'[N chars]'` (messages can echo values)
  *   - free-form Records (`questionPayload`, `resumeInput`, risk/eval
  *     `evidence`, memory `scoreEvidence`) → `'[keys: …]'`
+ *   - a typed answer's limits and negatives on `turn_end` (`answerCoverage`,
+ *     `answerNegatives`) → the same shape, every sentence and value a
+ *     `'[N chars]'` marker: a coverage item's `what` / `why` / `short`, a
+ *     declared period's instants, an in-progress item's prose, an assumed
+ *     `value`, a negative's `statement` and `about`. The tool and argument
+ *     names, call ids, counts, kinds, codes and verdicts stay; a field the
+ *     shape does not name is a marker too, so one added later is bounded
+ *     until it is classified
+ *   - every other event whose content sits beside structure keeps its
+ *     shape, each content leaf a marker: a tool's absence, coverage
+ *     and described-result words and data (`tools.absent`,
+ *     `tools.coverage_declared`, `tools.semantics_declared`), the evidence
+ *     gate's values, an external ground's value, the message text a routing
+ *     match quotes (`map.engaged`, `map.parked`, `skill.turn_routed`,
+ *     `context.evaluated`), a validation issue's quoted value, parser and
+ *     fallback messages and previews, a tool's progress payload and a
+ *     check-in's evidence pack, a person's note, a middleware's reason or
+ *     question, the model's own words (`skill.step_skipped`, `agent.handoff`),
+ *     the opt-in assembled system prompt, a retrieved passage's heading, an
+ *     integrity finding's witnessed values and message, a tool effect's
+ *     reason, a pause's own reason, an artifact's label and refusal detail, a
+ *     fail-fast reason, a check's `rationale` and `tellLLM`, a fallback's or a
+ *     credential failure's message, and a router's own reason
  *
- * Everything else is embedded as the registry payload (sanitized:
- * strings capped at 256 chars, lists at 32 items, cycles broken) —
- * those payloads are bounded by construction: identifiers, counts,
- * enums, decide() evidence (engine-bounded + redaction-aware),
- * validation issues (paths/TYPES per #9), credential events (no
- * secrets by contract).
+ * What the shapes keep is checked structure: a number, boolean or string
+ * must arrive as that kind, and a closed enum must be one of its declared
+ * words. Every container is classified field by field, even if its declared
+ * type contains only counts. Unknown children and wrong kinds are markers.
+ * Strings are capped at 256 characters and lists at 32 items. This retains
+ * ids, names, kinds, codes, telemetry tags, verdicts, counts, library times
+ * and the words the app declared up front (labels, descriptions, step notes,
+ * hints, display names, rule ids). The type walker and runtime damage sweep
+ * check both halves; `auditKeptByContract.ts` names the exceptions below.
+ *
+ * What a bounded record still carries, by contract:
+ *
+ *   - each record's `meta`: run and stage ids, paths, turn and iteration
+ *     indices and — when the caller named them — `sessionId`, `principal`
+ *     and `tenant`, the who of an audit record;
+ *   - decision evidence as the engine summarized it: `decide()` evidence on
+ *     `composition.route_decided` and a skill guard's conditions on
+ *     `context.evaluated` — rule labels, operators, thresholds and a summary
+ *     of each value a rule read. It is redaction-aware (under an agent's
+ *     `redact` a selected key is the placeholder); otherwise the summary
+ *     shows the value;
+ *   - a policy's telemetry `reason` tag, and the reason word an app attaches
+ *     to a lifecycle event it emits itself (`skill.deactivated`,
+ *     `tools.offered`, `permission.gate_closed`): the app's own words, as
+ *     written — an app that writes a run's value into one carries it;
+ *   - a `tryInsteadTool` name, only once this strategy has seen that tool run.
+ *
+ * Sanitizing caps a string's length; it does not hide what the string says.
  *
  * `payloadMode: 'verbatim'` embeds full payloads (still
  * JSON-sanitized). For Art. 12 completeness on an access-controlled
@@ -148,6 +204,7 @@
  */
 import { CANONICAL_JSON_VERSION } from '../../lib/canonicalJson.js';
 import type { ObservabilityStrategy } from '../../strategies/types.js';
+import { type BoundRule } from './auditBounding.js';
 /** SHA-256 of "nothing" — the `prevHash` of the first record in a
  *  chain and the `chainHead` of a chain's first segment. */
 export declare const AUDIT_ZERO_HASH: string;
@@ -262,6 +319,16 @@ export interface AuditExportStrategy extends ObservabilityStrategy {
  * @internal
  */
 export declare function boundedContentFieldNames(): readonly string[];
+/**
+ * The rules `BOUND_FIELDS` declares, by event type and field — what the pin
+ * holds every event's shape to.
+ *
+ * @internal
+ */
+export declare function boundedFieldRules(): Readonly<Record<string, Readonly<Record<string, BoundRule>>>>;
+/** The bounded content leaves, pinned against the redaction vocabulary's value-kind rule.
+ * @internal */
+export declare function boundedContentLeaves(): readonly string[];
 export declare function auditExport(opts?: AuditExportOptions): AuditExportStrategy;
 /**
  * Recompute the hash chain of a bundle (or of consecutive drained

package/dist/types/adapters/observability/audit.d.ts.map

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

package/dist/types/adapters/observability/auditBounding.d.ts

@@ -0,0 +1,216 @@
+/**
+ * auditBounding — HOW the audit chain's bounded mode bounds a value: the
+ * markers, the sanitizer, the leaves and the combinators every shape is built
+ * from (`auditShapes.ts` says WHAT each event keeps; `auditKeptByContract.ts`
+ * names what a record keeps although it may carry a run's value).
+ *
+ * Pattern: small pure rules composed into shapes; every rule records what it is
+ *          (`ruleKind`), so a test can walk a shape beside the type it bounds
+ *          and hand every rule what its kind forbids.
+ * Role:    the bounding layer `auditExport({ payloadMode: 'bounded' })` runs
+ *          every payload and every record's meta through (`audit.ts`). No I/O,
+ *          no clock.
+ * Emits:   N/A.
+ *
+ * THE RULE, the one `otel.ts` maps spans by: **structure is kept, content is
+ * a marker**, bounding is CLOSED by default, and every kept value is CHECKED:
+ *
+ *   - Every registered event has a shape that names every field of its
+ *     payload type (`shapeOf` is exhaustive by type: a field added to a
+ *     payload does not compile until it is classified).
+ *   - A field a shape does not name, a value that is not the declared shape,
+ *     and every field of an event type the registry does not declare, is a
+ *     marker.
+ *   - A type says what a field holds; it cannot say what ARRIVES. So nothing is
+ *     kept on a type's word: a kept leaf checks at runtime the kind its type
+ *     promises — `num` a number, `bool` a boolean, `str` a string, `oneOf` one
+ *     of the words it lists — and anything else is a marker. No container is
+ *     kept whole: an object is a `shapeOf` (or a `recordOf`), a list a
+ *     `listOf`, every child ruled, so a child the type does not declare is a
+ *     marker however it got there (structural typing lets an object carry one).
+ *     The type walker (`test/type-regressions/AuditBoundingDepth.test.ts`)
+ *     holds every rule to the type beneath it; the runtime sweep
+ *     (`test/observability-providers/audit-bounded-sweep.test.ts`) hands every
+ *     rule what its kind forbids.
+ *   - Names are data. A key is kept as an own key of the record, whatever it is
+ *     (a name `Object.prototype` holds included: an assignment would drop
+ *     `__proto__`, or re-prototype the record), and no rule table is ever asked
+ *     for a name it merely inherits.
+ *
+ * Content becomes `'[N chars]'` (a string), `'[type: …]'` (anything else),
+ * `'[keys: …]'` (a free-form record: its key names, never its values), or a
+ * count (`'[N messages]'`, `'[N blocks]'`, `'[N summaries]'`). A kept string is
+ * capped at 256 characters, a list at 32 items.
+ */
+/**
+ * Convert any value to a JSON-safe, size-bounded tree:
+ * strings capped, arrays capped with an overflow marker, cycles
+ * broken, depth capped, Date → ISO, bigint → string, non-finite →
+ * null, functions/symbols/undefined dropped (objects) or null
+ * (arrays). Every key an own key. Output always canonicalizes without
+ * throwing.
+ */
+export declare function sanitizeJson(value: unknown, depth?: number, seen?: Set<object>): unknown;
+/** How the bounded mode writes one value. */
+export type BoundRule = (value: unknown) => unknown;
+/** The kind of a value, as a rule checks it at runtime. */
+export type ValueKind = 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object';
+/** A value's kind — `undefined` for one JSON has no word for (a function, a symbol, a bigint). */
+export declare function valueKindOf(value: unknown): ValueKind | undefined;
+/**
+ * What a rule is, so a test can walk a shape beside the type it bounds and
+ * hand each rule what its kind forbids. Every rule this module builds has one;
+ * a function it did not build has none, and the walkers refuse it.
+ */
+export type RuleKind = 
+/** Keeps nothing of the value: its length, its key names, its type or its count. */
+{
+    readonly kind: 'marker';
+    readonly marks: 'chars' | 'keys' | 'type' | 'count';
+}
+/** Keeps a value of this one kind (a string capped); anything else is a marker. */
+ | {
+    readonly kind: 'leaf';
+    readonly accepts: 'number' | 'boolean' | 'string';
+}
+/** Keeps a value that is one of these words; anything else is a marker. */
+ | {
+    readonly kind: 'oneOf';
+    readonly values: ReadonlySet<string | number | boolean>;
+}
+/** An object: each named field by its rule, any other field a marker. */
+ | {
+    readonly kind: 'shape';
+    readonly fields: ReadonlyMap<string, BoundRule>;
+}
+/** A list: each item by the rule. */
+ | {
+    readonly kind: 'list';
+    readonly item: BoundRule;
+}
+/** An object with open keys: every key kept, every value by the rule. */
+ | {
+    readonly kind: 'record';
+    readonly value: BoundRule;
+}
+/** One value or a list of them, each by the rule. */
+ | {
+    readonly kind: 'orList';
+    readonly item: BoundRule;
+}
+/** `null` kept; anything else by the rule. */
+ | {
+    readonly kind: 'nullOr';
+    readonly inner: BoundRule;
+}
+/** The first alternative that accepts the value's kind; none, a marker. */
+ | {
+    readonly kind: 'either';
+    readonly alternatives: readonly BoundRule[];
+}
+/** One rule or another, by a test of the value — the reason written down. */
+ | {
+    readonly kind: 'when';
+    readonly why: string;
+    readonly then: BoundRule;
+    readonly otherwise: BoundRule;
+}
+/** A position the record keeps although it may carry a run's value — named (`auditKeptByContract.ts`). */
+ | {
+    readonly kind: 'byContract';
+    readonly exception: string;
+    readonly inner: BoundRule;
+};
+/** What a rule is — `undefined` only for a function this module did not build. */
+export declare function ruleKind(rule: BoundRule): RuleKind | undefined;
+/**
+ * The value kinds a rule KEEPS something of at its own position — what
+ * `either` dispatches on. A marker accepts none: it keeps nothing of any value.
+ *
+ * @internal
+ */
+export declare function acceptedKinds(rule: BoundRule): ReadonlySet<ValueKind>;
+export declare function typeofOf(value: unknown): string;
+/** `'[23 chars]'` — length evidence without content. */
+export declare function charsMarker(value: unknown): string;
+/** `'[keys: a, b, c]'` — shape evidence for free-form Records. */
+export declare function keysMarker(value: unknown): string;
+/** `'[type: object]'` — what kind of value, nothing of it (a tool's result). */
+export declare const typeMarker: BoundRule;
+/** `'[3 messages]'` — a conversation's history. */
+export declare const messagesMarker: BoundRule;
+/** `'[2 blocks]'` — the model's thinking blocks. */
+export declare const blocksMarker: BoundRule;
+/** `'[4 summaries]'` — the previews of what a slot dropped. */
+export declare const summariesMarker: BoundRule;
+/** A count, a duration, a score, an index: kept when it IS a number (non-finite as `null`). */
+export declare const num: BoundRule;
+/** A flag or a verdict: kept when it IS a boolean. */
+export declare const bool: BoundRule;
+/**
+ * The record's own word — an id, a name, a code, a label the app declared: kept
+ * when it IS a string, capped. Where the type is a closed union of words, use
+ * `oneOf`, which keeps only those words.
+ */
+export declare const str: BoundRule;
+/**
+ * One of the listed words (or numbers, or booleans): kept when the value IS one
+ * of them — so what it keeps is always a word this table wrote. Anything else
+ * is a marker.
+ */
+export declare function oneOf(...values: readonly (string | number | boolean)[]): BoundRule;
+/**
+ * Every key of `T` — of EVERY member when `T` is a union. `keyof` of a union is
+ * only the keys all members share, so a field one member alone carries would
+ * escape the shape's exhaustiveness.
+ */
+export type AnyKeyOf<T> = T extends unknown ? keyof T : never;
+/**
+ * An object of a known shape, every field ruled (exhaustive by type, so a field
+ * added to `T` does not compile until it is). A field the rules do not name is
+ * a marker: whatever the value carries at runtime is bounded until someone
+ * decides it is the record's own words. Anything but an object is a marker too.
+ */
+export declare function shapeOf<T>(rules: {
+    readonly [K in AnyKeyOf<T>]-?: BoundRule;
+}): BoundRule;
+/** A list: each entry by `rule`, capped at 32 like every list. Anything else is a marker. */
+export declare function listOf(rule: BoundRule): BoundRule;
+/** A map with open keys: every key kept (a key is a name), every value by `rule`. Anything else is a marker. */
+export declare function recordOf(rule: BoundRule): BoundRule;
+/** One value, or a list of them, each by `rule` — a guard's declared value is either. */
+export declare function orList(rule: BoundRule): BoundRule;
+/** `null` stays `null` (a declared "none"); anything else by `rule`. */
+export declare function nullOr(rule: BoundRule): BoundRule;
+/**
+ * A value of one of several kinds — a library word or a window, a facet word or
+ * a filter: the first alternative that accepts the value's kind bounds it. A
+ * value no alternative accepts is a marker.
+ */
+export declare function either(...alternatives: readonly BoundRule[]): BoundRule;
+/**
+ * One rule or another, by a test of the value itself, the reason written down —
+ * the few places a field is structure only for some values (a name this
+ * strategy has seen run, the engine's own decision evidence).
+ */
+export declare function when(why: string, test: (value: unknown) => boolean, then: BoundRule, otherwise: BoundRule): BoundRule;
+/**
+ * A position a bounded record keeps although its value may come from the run —
+ * one of the exceptions `auditKeptByContract.ts` names, in one place. The rule
+ * inside still checks the value like every other: an exception keeps a value of
+ * its declared kind, never whatever arrives.
+ */
+export declare function byContract(exception: string, rule: BoundRule): BoundRule;
+/** An event type the registry does not declare (a consumer's own `emit`): every field a marker. */
+export declare const unknownEventShape: BoundRule;
+/**
+ * Tool names this strategy has seen RUN — a `stream.tool_end` without `error`,
+ * `notExecuted` or `notDispatched`, matched to its `tool_start` by
+ * `toolCallId` — so a tool this agent holds, by construction. What a
+ * `tryInsteadTool` name is recognized against (`otel.ts` keeps the same set).
+ */
+export declare function createToolRunTracker(): {
+    observe(type: string, payload: unknown): void;
+    ran(name: string): boolean;
+};
+//# sourceMappingURL=auditBounding.d.ts.map