agentfootprint 9.52.0 → 9.53.0

package/dist/esm/lib/semantics/format.js

@@ -0,0 +1,33 @@
+/**
+ * semantics/format — rendering one {@link SemanticsReport} for a terminal.
+ *
+ * Pattern: the tool-lint `format.ts` sibling — pure string building, no IO.
+ * Role:    lib/ layer, pure.
+ * Emits:   N/A.
+ */
+function findingLine(f) {
+    const mark = f.severity === 'error' ? '✗' : '⚠';
+    const where = f.resultIndex !== undefined ? ` result ${f.resultIndex + 1}` : '';
+    return `  ${mark} ${f.tool}${where}  [${f.code}]  field: ${f.field}\n      ${f.message}`;
+}
+/** Render the report. Every finding names its tool and its field — the two
+ *  facts a build log must carry for the fix to be a one-line edit. */
+export function formatSemanticsReport(report) {
+    const errors = report.findings.filter((f) => f.severity === 'error');
+    const warnings = report.findings.filter((f) => f.severity === 'warning');
+    const lines = [
+        `check:semantics — ${report.checkedTools} tool${report.checkedTools === 1 ? '' : 's'}, ` +
+            `${report.checkedResults} sample result${report.checkedResults === 1 ? '' : 's'}`,
+    ];
+    if (report.findings.length === 0) {
+        lines.push('  ✓ every sampled result honors the semantic vocabulary and its class rules');
+    }
+    else {
+        for (const f of report.findings)
+            lines.push(findingLine(f));
+    }
+    lines.push(`${report.ok ? 'ok' : 'FAILED'} — ${errors.length} error${errors.length === 1 ? '' : 's'}, ` +
+        `${warnings.length} warning${warnings.length === 1 ? '' : 's'}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/esm/lib/semantics/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../../src/lib/semantics/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,SAAS,WAAW,CAAC,CAAmB;IACtC,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3F,CAAC;AAED;sEACsE;AACtE,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACzE,MAAM,KAAK,GAAa;QACtB,qBAAqB,MAAM,CAAC,YAAY,QAAQ,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;YACtF,GAAG,MAAM,CAAC,cAAc,iBAAiB,MAAM,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;KACpF,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC5F,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,MAAM,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;QAC1F,GAAG,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAClE,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/esm/lib/semantics/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The semantic tool-result envelope + the `check:semantics` gate (9.53.0).
+ *
+ * The door: the main barrel publishes the AUTHORING half (`semantic()`, the
+ * recognizer, the vocabulary) — what a tool author writes and what a
+ * consumer reading raw results needs; `/observe` (via debug.ts) publishes
+ * the GATE half (`checkSemantics`, the CLI core, the formatter) — beside
+ * tool-lint, its pattern sibling. See README.md for the arguments.
+ */
+export { composeNotCovered, coverageOfSemantics, explainSemantics, isCounterLookingAggregation, readSemantics, semantic, semanticIssues, semanticsForModel, type SemanticIssue, type SemanticIssueCode, } from './envelope.js';
+export { checkSemantics, type SemanticsCatalogEntry, type SemanticsFinding, type SemanticsFindingCode, type SemanticsReport, } from './check.js';
+export { formatSemanticsReport } from './format.js';
+export { coerceSemanticsCatalog, runCheckSemanticsCli, type SemanticsCliIO } from './cli.js';
+export { COUNTER_AGGREGATION_WORDS, RESULT_CLASSES, SEMANTICS_MARKER, SEMANTICS_NOTE, type SemanticClarify, type SemanticCoverage, type SemanticDeclaration, type SemanticEdge, type SemanticFact, type SemanticGrain, type SemanticProvenance, type SemanticRender, type SemanticSeriesPoint, type ToolResultClass, type ToolSemantics, } from './types.js';

package/dist/esm/lib/semantics/index.js

@@ -0,0 +1,15 @@
+/**
+ * The semantic tool-result envelope + the `check:semantics` gate (9.53.0).
+ *
+ * The door: the main barrel publishes the AUTHORING half (`semantic()`, the
+ * recognizer, the vocabulary) — what a tool author writes and what a
+ * consumer reading raw results needs; `/observe` (via debug.ts) publishes
+ * the GATE half (`checkSemantics`, the CLI core, the formatter) — beside
+ * tool-lint, its pattern sibling. See README.md for the arguments.
+ */
+export { composeNotCovered, coverageOfSemantics, explainSemantics, isCounterLookingAggregation, readSemantics, semantic, semanticIssues, semanticsForModel, } from './envelope.js';
+export { checkSemantics, } from './check.js';
+export { formatSemanticsReport } from './format.js';
+export { coerceSemanticsCatalog, runCheckSemanticsCli } from './cli.js';
+export { COUNTER_AGGREGATION_WORDS, RESULT_CLASSES, SEMANTICS_MARKER, SEMANTICS_NOTE, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/semantics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/semantics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,aAAa,EACb,QAAQ,EACR,cAAc,EACd,iBAAiB,GAGlB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,GAKf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAuB,MAAM,UAAU,CAAC;AAE7F,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,gBAAgB,EAChB,cAAc,GAYf,MAAM,YAAY,CAAC"}

package/dist/esm/lib/semantics/types.d.ts

@@ -0,0 +1,230 @@
+/**
+ * semantics/types — the semantic tool-result vocabulary, as a PURE leaf
+ * (9.53.0, the `toolOutcome.ts` precedent).
+ *
+ * WHY IT LIVES HERE. Two sides read these words and neither may own the
+ * other: the agent loop's dispatch boundary (core/agent/stages/toolCalls.ts)
+ * recognizes the envelope at run time, and the `check:semantics` build gate
+ * (lib/semantics/check.ts) judges the same shapes with no agent anywhere in
+ * sight. Declaring the vocabulary in a leaf both sides import keeps the
+ * dependency pointing the right way — the loop and the gate depend on the
+ * words, never on each other.
+ *
+ * The one exception to "zero imports" is TYPE-ONLY and deliberate: the
+ * envelope's `coverage` field ABSORBS the existing coverage vocabulary
+ * (`CoverageItem` / `CoverageInput`, core/agent/coverage/types.ts — itself a
+ * pure-data leaf) instead of duplicating it. Two spellings of "ground this
+ * result does not cover" would eventually disagree; type-only imports erase
+ * at runtime, so this module stays a runtime leaf.
+ *
+ * ## What the envelope is
+ *
+ * A tool that answers "how many IOPS did fc1/3 do last hour?" today returns
+ * prose or an ad-hoc object, and every caveat that makes the number honest —
+ * the collection interval, whether the values are counters that must not be
+ * summed, when the world was actually measured, which clusters were not
+ * collected — is re-implemented by hand inside every tool and held in place
+ * by review. Culture scales to one disciplined author; it does not scale to
+ * a hundred tools. The semantic envelope makes those caveats TYPED DATA that
+ * travel with the values, so honesty is inherited, not re-authored — and so
+ * a build gate can refuse a triage tool that forgot its own limits.
+ *
+ * It is a SIBLING recognizer beside the effects envelope and the coverage
+ * primitives — its own reserved marker (`af_semantics`, the
+ * `af_absent`/`af_coverage` family), never new keys on the effects envelope.
+ * The three compose on one result: `{ content: semantic({…}), effects: […],
+ * status }` is a tool that returns typed data AND proposes a transition.
+ */
+import type { CoverageDeclaration, CoverageItem } from '../../core/agent/coverage/types.js';
+/**
+ * The reserved key that makes a semantic envelope recognizable. Reserved
+ * vocabulary on the tool-result wire (the `af_absent` / `af_coverage`
+ * precedent): a plain object carrying `af_semantics: true` that validates
+ * cleanly is an envelope; every other value any tool has ever returned keeps
+ * its bytes.
+ */
+export declare const SEMANTICS_MARKER = "af_semantics";
+/**
+ * One measured point. `t` is the tool's own clock words (an ISO string or an
+ * epoch number — the library never reinterprets it), `entity` is what was
+ * measured, `metric` names the measurement, `value` is the reading.
+ */
+export interface SemanticSeriesPoint {
+    readonly t: string | number;
+    readonly entity: string;
+    readonly metric: string;
+    readonly value: number | string | boolean | null;
+}
+/**
+ * One row of typed facts about one entity. The columns are the tool's own —
+ * this library requires only that every row says WHAT it is about.
+ */
+export interface SemanticFact {
+    readonly entity: string;
+    readonly [field: string]: unknown;
+}
+/** One typed relationship — "this VM rides that datastore", "this zone
+ *  contains that WWPN". `kind` names the relationship in the tool's words. */
+export interface SemanticEdge {
+    readonly from: string;
+    readonly to: string;
+    readonly kind: string;
+    readonly [field: string]: unknown;
+}
+/**
+ * The grain — what one value MEANS, stated when it is not what a reader
+ * would assume. This is the field that stops a model from adding
+ * `jobs_local` to `jobs_replicated_in` and announcing a fleet size nobody
+ * has.
+ */
+export interface SemanticGrain {
+    /** The collection interval the values live on ('30m', '1h', 'daily'). */
+    readonly interval?: string;
+    /** How the values were folded ('avg', 'max', 'sum', 'count', …). */
+    readonly aggregation?: string;
+    /**
+     * Whether the values are counters. MUST be stated (true or false) whenever
+     * `aggregation` is counter-looking (see
+     * {@link COUNTER_AGGREGATION_WORDS}): summing two counters double-counts,
+     * and a reader cannot tell a counter from a gauge by looking at a number.
+     */
+    readonly is_counter?: boolean;
+    /** What was folded away ('per-port rows collapsed to per-switch'). */
+    readonly collapsed?: string;
+}
+/**
+ * Where the values came from and how old they are. `measured_at` is when the
+ * WORLD was measured — not when the tool ran; a tool that reads a nightly
+ * export and answers in 4ms is serving yesterday.
+ */
+export interface SemanticProvenance {
+    /** When the world was measured (the tool's own clock words). Required
+     *  whenever the envelope carries `series` or `facts`. */
+    readonly measured_at: string;
+    /** How stale the data was when the tool answered, in seconds. */
+    readonly age_seconds?: number;
+    /** The system of record the values were read from. Required with
+     *  `measured_at`. */
+    readonly source: string;
+    /** For file-fed collectors: the export the values rode in on. */
+    readonly source_export_date?: string;
+}
+/**
+ * The ask-vs-answer decision, as data. A tool that matched three volumes for
+ * one WWN should not pick one silently — it should hand the question and the
+ * candidates back, typed, so the loop (or a UI) can ask.
+ */
+export interface SemanticClarify {
+    readonly question: string;
+    /** The candidates the question is choosing between. May be empty — an open
+     *  question is still a question. */
+    readonly candidates: readonly unknown[];
+}
+/**
+ * Rendering HINTS — the tool never renders. A UI that understands them draws
+ * a better table; one that does not loses nothing, because everything load-
+ * bearing is in the data fields. Dropped from the model's view entirely.
+ */
+export interface SemanticRender {
+    /** The default presentation ('table', 'chart', 'prose', …). A hint. */
+    readonly default: string;
+    /** Column order for a tabular view. */
+    readonly columns?: readonly string[];
+    /** Sort hint ('avg_iops desc'). */
+    readonly sort?: string;
+    /** A note about what filtering already happened ('replicas excluded'). */
+    readonly filter_note?: string;
+    /** Chart-shape hint ('line per entity'). */
+    readonly chart_hint?: string;
+}
+/**
+ * The envelope's coverage, normalized — the SAME three-list vocabulary the
+ * `coverage()` / `absent()` primitives speak (checked / not checked / cannot
+ * cover), in the snake_case spelling every rendered tool shape uses because
+ * a model reads it more often than code does. Declared through
+ * {@link SemanticDeclaration.coverage} with the exact `CoverageDeclaration`
+ * input the `coverage()` primitive takes; the dispatch loop declares it
+ * through the same channel (`tools.coverage_declared`, tracked state, the
+ * final-answer limits block) — absorbed, never duplicated.
+ */
+export interface SemanticCoverage {
+    readonly checked?: readonly CoverageItem[];
+    readonly not_checked?: readonly CoverageItem[];
+    readonly cannot_cover?: readonly CoverageItem[];
+}
+/**
+ * What a tool author passes to `semantic()`. At least one of `series`,
+ * `facts`, `edges` or a non-null `clarify` must be present — an envelope
+ * with no data and no question declares nothing.
+ *
+ * `not_covered` is deliberately NOT here: the prose list on the rendered
+ * envelope is DERIVED from `coverage` (not checked + cannot cover), so the
+ * two can never disagree. Declaring coverage is how not_covered is said.
+ */
+export interface SemanticDeclaration {
+    readonly series?: readonly SemanticSeriesPoint[];
+    readonly facts?: readonly SemanticFact[];
+    readonly edges?: readonly SemanticEdge[];
+    readonly grain?: SemanticGrain;
+    readonly provenance?: SemanticProvenance;
+    /** The coverage()-vocabulary declaration this envelope absorbs. */
+    readonly coverage?: CoverageDeclaration;
+    /** `null` states "ambiguity was considered; there is none" — a fact, kept
+     *  on the record. Omit the field to say nothing. */
+    readonly clarify?: SemanticClarify | null;
+    readonly render?: SemanticRender;
+}
+/**
+ * The rendered semantic envelope — the exact object a tool hands back.
+ * Field names are snake_case and English on purpose (the `ToolAbsence`
+ * precedent): this value is read by a language model far more often than by
+ * code, and `af_semantics` is the only field that exists for the machine.
+ */
+export interface ToolSemantics {
+    readonly af_semantics: true;
+    readonly series?: readonly SemanticSeriesPoint[];
+    readonly facts?: readonly SemanticFact[];
+    readonly edges?: readonly SemanticEdge[];
+    readonly grain?: SemanticGrain;
+    readonly provenance?: SemanticProvenance;
+    readonly coverage?: SemanticCoverage;
+    /** DERIVED from `coverage` (not checked + cannot cover), one prose line
+     *  per item — never author-set, so the list and the lists cannot drift. */
+    readonly not_covered?: readonly string[];
+    readonly clarify?: SemanticClarify | null;
+    readonly render?: SemanticRender;
+    /** The static sentence. Never interpolated — see `envelope.ts`. */
+    readonly note: string;
+}
+/**
+ * The declared class of a tool's RESULTS — what kind of answer this tool
+ * gives, stated by whoever wrote it (`defineTool({ resultClass })`; the
+ * `capabilities` law: declared, never inferred). The `check:semantics` gate
+ * keys its per-class rules on it:
+ *
+ *   • `'triage'` — a verdict about health or fault. Every sample result must
+ *     declare coverage: a triage that cannot say what it did NOT check turns
+ *     "everything looks fine" into a claim about ground it never stood on.
+ *   • `'inventory'` — a population listing. Every sample result must declare
+ *     coverage ("4 of 5 clusters"), and one with `facts` but no `render`
+ *     hint is warned at.
+ *
+ * Two classes, deliberately closed: each carries a rule the gate can PROVE.
+ * A class with no rule would be dead vocabulary.
+ */
+export type ToolResultClass = 'triage' | 'inventory';
+/** The closed set, as data — validators and docs read one list. */
+export declare const RESULT_CLASSES: readonly ToolResultClass[];
+/**
+ * Aggregation words that suggest the values are counters — the words that
+ * make `grain.is_counter` REQUIRED (stated true or false). Matched as whole
+ * tokens, singular or plural, case-insensitive.
+ */
+export declare const COUNTER_AGGREGATION_WORDS: readonly string[];
+/**
+ * The static sentence every semantic envelope carries in the model's view.
+ * Never interpolated (the `ABSENCE_NOTE` law): everything else the model
+ * reads is the tool's own data, and a note that quoted any of it back would
+ * hand the evidence corpus a second copy of values it already indexes.
+ */
+export declare const SEMANTICS_NOTE: string;

package/dist/esm/lib/semantics/types.js

@@ -0,0 +1,71 @@
+/**
+ * semantics/types — the semantic tool-result vocabulary, as a PURE leaf
+ * (9.53.0, the `toolOutcome.ts` precedent).
+ *
+ * WHY IT LIVES HERE. Two sides read these words and neither may own the
+ * other: the agent loop's dispatch boundary (core/agent/stages/toolCalls.ts)
+ * recognizes the envelope at run time, and the `check:semantics` build gate
+ * (lib/semantics/check.ts) judges the same shapes with no agent anywhere in
+ * sight. Declaring the vocabulary in a leaf both sides import keeps the
+ * dependency pointing the right way — the loop and the gate depend on the
+ * words, never on each other.
+ *
+ * The one exception to "zero imports" is TYPE-ONLY and deliberate: the
+ * envelope's `coverage` field ABSORBS the existing coverage vocabulary
+ * (`CoverageItem` / `CoverageInput`, core/agent/coverage/types.ts — itself a
+ * pure-data leaf) instead of duplicating it. Two spellings of "ground this
+ * result does not cover" would eventually disagree; type-only imports erase
+ * at runtime, so this module stays a runtime leaf.
+ *
+ * ## What the envelope is
+ *
+ * A tool that answers "how many IOPS did fc1/3 do last hour?" today returns
+ * prose or an ad-hoc object, and every caveat that makes the number honest —
+ * the collection interval, whether the values are counters that must not be
+ * summed, when the world was actually measured, which clusters were not
+ * collected — is re-implemented by hand inside every tool and held in place
+ * by review. Culture scales to one disciplined author; it does not scale to
+ * a hundred tools. The semantic envelope makes those caveats TYPED DATA that
+ * travel with the values, so honesty is inherited, not re-authored — and so
+ * a build gate can refuse a triage tool that forgot its own limits.
+ *
+ * It is a SIBLING recognizer beside the effects envelope and the coverage
+ * primitives — its own reserved marker (`af_semantics`, the
+ * `af_absent`/`af_coverage` family), never new keys on the effects envelope.
+ * The three compose on one result: `{ content: semantic({…}), effects: […],
+ * status }` is a tool that returns typed data AND proposes a transition.
+ */
+/**
+ * The reserved key that makes a semantic envelope recognizable. Reserved
+ * vocabulary on the tool-result wire (the `af_absent` / `af_coverage`
+ * precedent): a plain object carrying `af_semantics: true` that validates
+ * cleanly is an envelope; every other value any tool has ever returned keeps
+ * its bytes.
+ */
+export const SEMANTICS_MARKER = 'af_semantics';
+/** The closed set, as data — validators and docs read one list. */
+export const RESULT_CLASSES = ['triage', 'inventory'];
+/**
+ * Aggregation words that suggest the values are counters — the words that
+ * make `grain.is_counter` REQUIRED (stated true or false). Matched as whole
+ * tokens, singular or plural, case-insensitive.
+ */
+export const COUNTER_AGGREGATION_WORDS = [
+    'sum',
+    'count',
+    'total',
+    'cumulative',
+    'counter',
+    'delta',
+];
+/**
+ * The static sentence every semantic envelope carries in the model's view.
+ * Never interpolated (the `ABSENCE_NOTE` law): everything else the model
+ * reads is the tool's own data, and a note that quoted any of it back would
+ * hand the evidence corpus a second copy of values it already indexes.
+ */
+export const SEMANTICS_NOTE = 'Typed data, not prose. `grain` and `provenance` are caveats that travel with the ' +
+    'numbers: check `is_counter` before summing values from a series, read `measured_at` ' +
+    '(and `age_seconds`) as how old the data is, and treat everything under `not_covered` ' +
+    'as ground this result does NOT cover — a clean look here says nothing about it.';
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/semantics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/semantics/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAsL/C,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAA+B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAElF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IAC1D,KAAK;IACL,OAAO;IACP,OAAO;IACP,YAAY;IACZ,SAAS;IACT,OAAO;CACR,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,mFAAmF;IACnF,sFAAsF;IACtF,uFAAuF;IACvF,iFAAiF,CAAC"}

package/dist/events/registry.js

@@ -87,6 +87,7 @@ exports.EVENT_NAMES = {
         repeatedCall: 'agentfootprint.tools.repeated_call',
         absent: 'agentfootprint.tools.absent',
         coverageDeclared: 'agentfootprint.tools.coverage_declared',
+        semanticsDeclared: 'agentfootprint.tools.semantics_declared',
         codeRun: 'agentfootprint.tools.code_run',
     },
     skill: {
@@ -228,6 +229,7 @@ exports.ALL_EVENT_TYPES = [
     'agentfootprint.tools.absent',
     'agentfootprint.tools.code_run',
     'agentfootprint.tools.coverage_declared',
+    'agentfootprint.tools.semantics_declared',
     'agentfootprint.validation.args_invalid',
     'agentfootprint.skill.activated',
     'agentfootprint.skill.graph_declared',

package/dist/events/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/events/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AA2GH,yEAAyE;AACzE,gEAAgE;AAChE,wEAAwE;AAC3D,QAAA,WAAW,GAAG;IACzB,WAAW,EAAE;QACX,KAAK,EAAE,kCAAkC;QACzC,IAAI,EAAE,iCAAiC;QACvC,SAAS,EAAE,uCAAuC;QAClD,cAAc,EAAE,4CAA4C;QAC5D,QAAQ,EAAE,sCAAsC;QAChD,YAAY,EAAE,0CAA0C;QACxD,cAAc,EAAE,4CAA4C;QAC5D,aAAa,EAAE,2CAA2C;KAC3D;IACD,KAAK,EAAE;QACL,SAAS,EAAE,iCAAiC;QAC5C,OAAO,EAAE,+BAA+B;QACxC,cAAc,EAAE,sCAAsC;QACtD,YAAY,EAAE,oCAAoC;QAClD,YAAY,EAAE,oCAAoC;QAClD,OAAO,EAAE,8BAA8B;QACvC,4BAA4B,EAAE,sDAAsD;QACpF,iBAAiB,EAAE,0CAA0C;QAC7D,mBAAmB,EAAE,4CAA4C;QACjE,eAAe,EAAE,uCAAuC;QACxD,aAAa,EAAE,qCAAqC;QACpD,mBAAmB,EAAE,4CAA4C;KAClE;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,iCAAiC;QAC3C,MAAM,EAAE,+BAA+B;QACvC,KAAK,EAAE,6BAA6B;QACpC,SAAS,EAAE,kCAAkC;QAC7C,YAAY,EAAE,qCAAqC;QACnD,OAAO,EAAE,gCAAgC;QACzC,aAAa,EAAE,sCAAsC;QACrD,WAAW,EAAE,oCAAoC;KAClD;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,iCAAiC;QAC3C,OAAO,EAAE,gCAAgC;QACzC,YAAY,EAAE,sCAAsC;QACpD,cAAc,EAAE,wCAAwC;QACxD,SAAS,EAAE,kCAAkC;KAC9C;IACD,MAAM,EAAE;QACN,eAAe,EAAE,wCAAwC;QACzD,QAAQ,EAAE,gCAAgC;QAC1C,SAAS,EAAE,iCAAiC;QAC5C,QAAQ,EAAE,gCAAgC;QAC1C,OAAO,EAAE,+BAA+B;KACzC;IACD,KAAK,EAAE;QACL,OAAO,EAAE,8BAA8B;QACvC,SAAS,EAAE,gCAAgC;QAC3C,WAAW,EAAE,kCAAkC;QAC/C,gBAAgB,EAAE,wCAAwC;QAC1D,kBAAkB,EAAE,0CAA0C;QAC9D,eAAe,EAAE,uCAAuC;QACxD,QAAQ,EAAE,+BAA+B;QACzC,cAAc,EAAE,sCAAsC;QACtD,aAAa,EAAE,qCAAqC;QACpD,aAAa,EAAE,qCAAqC;QACpD,kBAAkB,EAAE,2CAA2C;QAC/D,MAAM,EAAE,6BAA6B;QACrC,aAAa,EAAE,qCAAqC;QACpD,YAAY,EAAE,oCAAoC;QAClD,MAAM,EAAE,6BAA6B;QACrC,gBAAgB,EAAE,wCAAwC;QAC1D,OAAO,EAAE,+BAA+B;KACzC;IACD,KAAK,EAAE;QACL,SAAS,EAAE,gCAAgC;QAC3C,aAAa,EAAE,qCAAqC;QACpD,WAAW,EAAE,kCAAkC;QAC/C,QAAQ,EAAE,+BAA+B;QACzC,iBAAiB,EAAE,yCAAyC;QAC5D,aAAa,EAAE,qCAAqC;QACpD,UAAU,EAAE,kCAAkC;QAC9C,YAAY,EAAE,oCAAoC;QAClD,WAAW,EAAE,mCAAmC;QAChD,eAAe,EAAE,uCAAuC;QACxD,SAAS,EAAE,gCAAgC;KAC5C;IACD,UAAU,EAAE;QACV,WAAW,EAAE,wCAAwC;KACtD;IACD,UAAU,EAAE;QACV,KAAK,EAAE,iCAAiC;QACxC,UAAU,EAAE,uCAAuC;QACnD,UAAU,EAAE,uCAAuC;QACnD,IAAI,EAAE,gCAAgC;KACvC;IACD,UAAU,EAAE;QACV,SAAS,EAAE,qCAAqC;QAChD,QAAQ,EAAE,oCAAoC;QAC9C,qBAAqB,EAAE,kDAAkD;QACzE,MAAM,EAAE,kCAAkC;KAC3C;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,6BAA6B;KACvC;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,mCAAmC;KAC/C;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,+BAA+B;KAC1C;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,2BAA2B;QAClC,gBAAgB,EAAE,uCAAuC;KAC1D;IACD,KAAK,EAAE;QACL,OAAO,EAAE,8BAA8B;QACvC,SAAS,EAAE,gCAAgC;QAC3C,KAAK,EAAE,4BAA4B;QACnC,cAAc,EAAE,sCAAsC;KACvD;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,sCAAsC;QAChD,OAAO,EAAE,oCAAoC;QAC7C,SAAS,EAAE,sCAAsC;KAClD;IACD,UAAU,EAAE;QACV,uBAAuB,EAAE,qDAAqD;QAC9E,gBAAgB,EAAE,8CAA8C;KACjE;IACD,KAAK,EAAE;QACL,OAAO,EAAE,8BAA8B;QACvC,MAAM,EAAE,6BAA6B;KACtC;IACD,OAAO,EAAE;QACP,OAAO,EAAE,gCAAgC;QACzC,QAAQ,EAAE,iCAAiC;KAC5C;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,oCAAoC;KAC/C;IACD,SAAS,EAAE;QACT,SAAS,EAAE,oCAAoC;KAChD;IACD,SAAS,EAAE;QACT,MAAM,EAAE,iCAAiC;QACzC,QAAQ,EAAE,mCAAmC;QAC7C,OAAO,EAAE,kCAAkC;QAC3C,OAAO,EAAE,kCAAkC;QAC3C,SAAS,EAAE,oCAAoC;KAChD;CACO,CAAC;AAubX;;;GAGG;AACU,QAAA,eAAe,GAAuC;IACjE,kCAAkC;IAClC,iCAAiC;IACjC,uCAAuC;IACvC,4CAA4C;IAC5C,sCAAsC;IACtC,0CAA0C;IAC1C,4CAA4C;IAC5C,2CAA2C;IAC3C,iCAAiC;IACjC,+BAA+B;IAC/B,sCAAsC;IACtC,oCAAoC;IACpC,oCAAoC;IACpC,8BAA8B;IAC9B,sDAAsD;IACtD,0CAA0C;IAC1C,4CAA4C;IAC5C,uCAAuC;IACvC,qCAAqC;IACrC,4CAA4C;IAC5C,iCAAiC;IACjC,+BAA+B;IAC/B,6BAA6B;IAC7B,kCAAkC;IAClC,qCAAqC;IACrC,gCAAgC;IAChC,sCAAsC;IACtC,oCAAoC;IACpC,iCAAiC;IACjC,gCAAgC;IAChC,sCAAsC;IACtC,wCAAwC;IACxC,kCAAkC;IAClC,wCAAwC;IACxC,gCAAgC;IAChC,iCAAiC;IACjC,gCAAgC;IAChC,+BAA+B;IAC/B,8BAA8B;IAC9B,gCAAgC;IAChC,kCAAkC;IAClC,wCAAwC;IACxC,0CAA0C;IAC1C,uCAAuC;IACvC,+BAA+B;IAC/B,sCAAsC;IACtC,qCAAqC;IACrC,qCAAqC;IACrC,2CAA2C;IAC3C,6BAA6B;IAC7B,qCAAqC;IACrC,oCAAoC;IACpC,6BAA6B;IAC7B,+BAA+B;IAC/B,wCAAwC;IACxC,wCAAwC;IACxC,gCAAgC;IAChC,qCAAqC;IACrC,kCAAkC;IAClC,+BAA+B;IAC/B,yCAAyC;IACzC,qCAAqC;IACrC,kCAAkC;IAClC,oCAAoC;IACpC,mCAAmC;IACnC,uCAAuC;IACvC,gCAAgC;IAChC,iCAAiC;IACjC,uCAAuC;IACvC,uCAAuC;IACvC,gCAAgC;IAChC,qCAAqC;IACrC,oCAAoC;IACpC,kDAAkD;IAClD,kCAAkC;IAClC,6BAA6B;IAC7B,mCAAmC;IACnC,0BAA0B;IAC1B,+BAA+B;IAC/B,2BAA2B;IAC3B,uCAAuC;IACvC,8BAA8B;IAC9B,gCAAgC;IAChC,4BAA4B;IAC5B,sCAAsC;IACtC,sCAAsC;IACtC,oCAAoC;IACpC,sCAAsC;IACtC,qDAAqD;IACrD,8CAA8C;IAC9C,8BAA8B;IAC9B,6BAA6B;IAC7B,gCAAgC;IAChC,iCAAiC;IACjC,oCAAoC;IACpC,oCAAoC;IACpC,iCAAiC;IACjC,mCAAmC;IACnC,kCAAkC;IAClC,kCAAkC;IAClC,oCAAoC;CAC5B,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/events/registry.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -22,9 +22,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildAgentMessageApiChart = exports.LLMCallBuilder = exports.LLMCall = exports.selectCommentaryKey = exports.renderCommentary = exports.extractCommentaryVars = exports.extractAgentName = exports.defaultCommentaryTemplates = exports.CheckInRecorder = exports.minimalEvidenceAssembler = exports.standardEvidenceAssembler = exports.lexicalDriverScorer = exports.isCheckInDecision = exports.checkInDeclined = exports.checkInApproved = exports.ACT_KEYS = exports.actKeyFor = exports.LOOP_MOMENTS = exports.MessageDeniedError = exports.deny = exports.ask = exports.allow = exports.InvalidAskComponentError = exports.assertAskComponent = exports.readAskComponent = exports.PauseAnswerRequiredError = exports.StaleDecisionError = exports.DecisionRequiredError = exports.pauseDemandsDecision = exports.isAskPause = exports.isCheckInPause = exports.isPaused = exports.isPauseRequest = exports.askHuman = exports.pauseHere = exports.makeRunId = exports.RunnerBase = exports.BASELINE_SOURCES = exports.ENGINEERED_SOURCES = exports.isBaselineSource = exports.isEngineeredSource = exports.contextEngineering = exports.COMPOSITION_KEYS = exports.isReservedSubflowSegment = exports.RESERVED_SUBFLOW_PREFIX = exports.milestoneFor = exports.stageRole = exports.isInjectionKey = exports.injectionKeyForSlot = exports.INJECTION_KEYS = void 0;
-exports.readCoverageResult = exports.readCoverageLedger = exports.readAbsence = exports.COVERAGE_NOTE = exports.COVERAGE_MARKER = exports.COVERAGE_BLOCK_HEADING = exports.coverage = exports.absent = exports.ABSENCE_NOTE = exports.ABSENCE_MARKER = exports.TOOL_RESULT_STATUSES = exports.readToolResultEnvelope = exports.explainStatusOnlyNearMiss = exports.warnIfInvalidToolName = exports.assertResultCeiling = exports.assertValidToolName = exports.defineTool = exports.flowchartAsTool = exports.RunInFlightError = exports.PendingQuestionError = exports.NoConversationError = exports.isContextWindowExceeded = exports.ERR_CONTEXT_WINDOW_EXCEEDED = exports.ContextWindowExceededError = exports.DEFAULT_SESSION_STORAGE_KEY = exports.browserSessionId = exports.RunCheckpointError = exports.ConversationMismatchError = exports.canResume = exports.UnsupportedValuesError = exports.EVIDENCE_CHECK_FRAME_PREFIX = exports.isSchemaCheckMessage = exports.SCHEMA_TOOL_NAME = exports.SCHEMA_CHECK_FRAME_PREFIX = exports.InvalidRunInputError = exports.applyOutputSchema = exports.OutputSchemaError = exports.isTruncatedToolResult = exports.tokenBudget = exports.summarizeOldest = exports.slidingWindow = exports.isDropNotice = exports.isCompactedSummary = exports.foldedSpanFor = exports.foldedMessages = exports.DROP_NOTICE_PREFIX = exports.COMPACTED_FRAME_PREFIX = exports.CompactionUnmeasurableError = exports.AgentBuilder = exports.Agent = void 0;
-exports.LoopBuilder = exports.Loop = exports.ConditionalBuilder = exports.Conditional = exports.ParallelBuilder = exports.Parallel = exports.SequenceBuilder = exports.Sequence = exports.PRESENT_TOOL_NAME = exports.placedResultKind = exports.isPlacedToolResult = exports.assertToolWants = exports.runArtifactStoreConformance = exports.runArtifactStoreCase = exports.formatArtifactStoreReport = exports.artifactStoreConformance = exports.canStreamArtifacts = exports.canPutArtifactStream = exports.canGetArtifactStream = exports.UnreadableArtifactStoreError = exports.UnreadableArtifactFileError = exports.UnknownParentRefError = exports.unconfiguredArtifacts = exports.sqliteArtifacts = exports.s3Artifacts = exports.mintArtifactRef = exports.isArtifactRef = exports.InvalidArtifactError = exports.inMemoryArtifacts = exports.gcsArtifacts = exports.fileArtifacts = exports.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION = exports.UnserializableRecordingError = exports.recordingPutInput = exports.RECORDING_MEDIA_TYPE = exports.RECORDING_ARTIFACT_KIND = exports.bindArtifacts = exports.ArtifactIntegrityError = exports.ARTIFACT_REF_PREFIX = exports.formatToolContractCheckup = exports.toolContractCheckup = exports.TOOL_SESSIONS = exports.toolSessionsOf = exports.codeRunsOf = exports.codeShape = exports.codeRunnerTool = exports.TOOL_TEARDOWN_TIMEOUT_MS = exports.ToolTeardownTimeoutError = exports.hashSessionKey = exports.toolSessionKey = void 0;
-exports.topK = exports.indexDocuments = exports.DEFAULT_CORPUS_IDENTITY = exports.defineRAG = exports.providerFromEnv = exports.Graph = exports.graph = exports.Workflow = exports.workflow = void 0;
+exports.readCoverageLedger = exports.readAbsence = exports.COVERAGE_NOTE = exports.COVERAGE_MARKER = exports.COVERAGE_BLOCK_HEADING = exports.coverage = exports.absent = exports.ABSENCE_NOTE = exports.ABSENCE_MARKER = exports.TOOL_RESULT_STATUSES = exports.readToolResultEnvelope = exports.explainStatusOnlyNearMiss = exports.warnIfInvalidToolName = exports.assertResultClass = exports.assertResultCeiling = exports.assertValidToolName = exports.defineTool = exports.flowchartAsTool = exports.RunInFlightError = exports.PendingQuestionError = exports.NoConversationError = exports.isContextWindowExceeded = exports.ERR_CONTEXT_WINDOW_EXCEEDED = exports.ContextWindowExceededError = exports.DEFAULT_SESSION_STORAGE_KEY = exports.browserSessionId = exports.RunCheckpointError = exports.ConversationMismatchError = exports.canResume = exports.UnsupportedValuesError = exports.EVIDENCE_CHECK_FRAME_PREFIX = exports.isSchemaCheckMessage = exports.SCHEMA_TOOL_NAME = exports.SCHEMA_CHECK_FRAME_PREFIX = exports.InvalidRunInputError = exports.applyOutputSchema = exports.OutputSchemaError = exports.isTruncatedToolResult = exports.tokenBudget = exports.summarizeOldest = exports.slidingWindow = exports.isDropNotice = exports.isCompactedSummary = exports.foldedSpanFor = exports.foldedMessages = exports.DROP_NOTICE_PREFIX = exports.COMPACTED_FRAME_PREFIX = exports.CompactionUnmeasurableError = exports.AgentBuilder = exports.Agent = void 0;
+exports.assertToolWants = exports.runArtifactStoreConformance = exports.runArtifactStoreCase = exports.formatArtifactStoreReport = exports.artifactStoreConformance = exports.canStreamArtifacts = exports.canPutArtifactStream = exports.canGetArtifactStream = exports.UnreadableArtifactStoreError = exports.UnreadableArtifactFileError = exports.UnknownParentRefError = exports.unconfiguredArtifacts = exports.sqliteArtifacts = exports.s3Artifacts = exports.mintArtifactRef = exports.isArtifactRef = exports.InvalidArtifactError = exports.inMemoryArtifacts = exports.gcsArtifacts = exports.fileArtifacts = exports.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION = exports.UnserializableRecordingError = exports.recordingPutInput = exports.RECORDING_MEDIA_TYPE = exports.RECORDING_ARTIFACT_KIND = exports.bindArtifacts = exports.ArtifactIntegrityError = exports.ARTIFACT_REF_PREFIX = exports.formatToolContractCheckup = exports.toolContractCheckup = exports.TOOL_SESSIONS = exports.toolSessionsOf = exports.codeRunsOf = exports.codeShape = exports.codeRunnerTool = exports.TOOL_TEARDOWN_TIMEOUT_MS = exports.ToolTeardownTimeoutError = exports.hashSessionKey = exports.toolSessionKey = exports.semanticsForModel = exports.SEMANTICS_NOTE = exports.SEMANTICS_MARKER = exports.semantic = exports.RESULT_CLASSES = exports.readSemantics = exports.isCounterLookingAggregation = exports.explainSemantics = exports.COUNTER_AGGREGATION_WORDS = exports.composeNotCovered = exports.readCoverageResult = void 0;
+exports.topK = exports.indexDocuments = exports.DEFAULT_CORPUS_IDENTITY = exports.defineRAG = exports.providerFromEnv = exports.Graph = exports.graph = exports.Workflow = exports.workflow = exports.LoopBuilder = exports.Loop = exports.ConditionalBuilder = exports.Conditional = exports.ParallelBuilder = exports.Parallel = exports.SequenceBuilder = exports.Sequence = exports.PRESENT_TOOL_NAME = exports.placedResultKind = exports.isPlacedToolResult = void 0;
 // Side-effect imports — auto-register v2.6+ cache strategies in the
 // strategy registry. Without these, only the wildcard NoOp is
 // registered and `Agent.create({ provider: browserAnthropic({...}) })`
@@ -292,6 +292,7 @@ var tools_js_1 = require("./core/tools.js");
 Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return tools_js_1.defineTool; } });
 Object.defineProperty(exports, "assertValidToolName", { enumerable: true, get: function () { return tools_js_1.assertValidToolName; } });
 Object.defineProperty(exports, "assertResultCeiling", { enumerable: true, get: function () { return tools_js_1.assertResultCeiling; } });
+Object.defineProperty(exports, "assertResultClass", { enumerable: true, get: function () { return tools_js_1.assertResultClass; } });
 Object.defineProperty(exports, "warnIfInvalidToolName", { enumerable: true, get: function () { return tools_js_1.warnIfInvalidToolName; } });
 // Typed tool effects (9.19.0) — the result envelope a tool may return to
 // steer the run with DATA instead of string conventions: propose a graph
@@ -330,6 +331,26 @@ Object.defineProperty(exports, "COVERAGE_NOTE", { enumerable: true, get: functio
 Object.defineProperty(exports, "readAbsence", { enumerable: true, get: function () { return index_js_4.readAbsence; } });
 Object.defineProperty(exports, "readCoverageLedger", { enumerable: true, get: function () { return index_js_4.readCoverageLedger; } });
 Object.defineProperty(exports, "readCoverageResult", { enumerable: true, get: function () { return index_js_4.readCoverageResult; } });
+// The semantic tool-result envelope (9.53.0) — typed series/facts/edges with
+// the caveats that make them honest (grain, provenance, coverage) as DATA,
+// so honesty is inherited, not re-authored per tool. A sibling recognizer
+// beside the effects envelope and the coverage primitives (its own
+// `af_semantics` marker); the three compose on one result. The MODEL reads
+// the compact rendering-free projection; the FULL envelope rides the typed
+// `tools.semantics_declared` event; a declared `coverage` flows through the
+// same channel `coverage()` uses. The gate half (`checkSemantics`, the
+// `agentfootprint-check-semantics` bin) ships through `/observe`.
+var index_js_5 = require("./lib/semantics/index.js");
+Object.defineProperty(exports, "composeNotCovered", { enumerable: true, get: function () { return index_js_5.composeNotCovered; } });
+Object.defineProperty(exports, "COUNTER_AGGREGATION_WORDS", { enumerable: true, get: function () { return index_js_5.COUNTER_AGGREGATION_WORDS; } });
+Object.defineProperty(exports, "explainSemantics", { enumerable: true, get: function () { return index_js_5.explainSemantics; } });
+Object.defineProperty(exports, "isCounterLookingAggregation", { enumerable: true, get: function () { return index_js_5.isCounterLookingAggregation; } });
+Object.defineProperty(exports, "readSemantics", { enumerable: true, get: function () { return index_js_5.readSemantics; } });
+Object.defineProperty(exports, "RESULT_CLASSES", { enumerable: true, get: function () { return index_js_5.RESULT_CLASSES; } });
+Object.defineProperty(exports, "semantic", { enumerable: true, get: function () { return index_js_5.semantic; } });
+Object.defineProperty(exports, "SEMANTICS_MARKER", { enumerable: true, get: function () { return index_js_5.SEMANTICS_MARKER; } });
+Object.defineProperty(exports, "SEMANTICS_NOTE", { enumerable: true, get: function () { return index_js_5.SEMANTICS_NOTE; } });
+Object.defineProperty(exports, "semanticsForModel", { enumerable: true, get: function () { return index_js_5.semanticsForModel; } });
 // Tool sessions (9.7.0) — the identity a tool holds a session under, and the
 // end-signal that releases it. The KEY DERIVATION is exported because it is the
 // isolation boundary: one implementation, or two that disagree.
@@ -356,60 +377,60 @@ Object.defineProperty(exports, "formatToolContractCheckup", { enumerable: true,
 // — both main-barrel citizens; the durable adapters load `node:fs` /
 // `node:sqlite` lazily at CONSTRUCTION (the sqliteSessions law), so a browser
 // bundle walking this barrel never sees them.
-var index_js_5 = require("./artifacts/index.js");
-Object.defineProperty(exports, "ARTIFACT_REF_PREFIX", { enumerable: true, get: function () { return index_js_5.ARTIFACT_REF_PREFIX; } });
-Object.defineProperty(exports, "ArtifactIntegrityError", { enumerable: true, get: function () { return index_js_5.ArtifactIntegrityError; } });
-Object.defineProperty(exports, "bindArtifacts", { enumerable: true, get: function () { return index_js_5.bindArtifacts; } });
+var index_js_6 = require("./artifacts/index.js");
+Object.defineProperty(exports, "ARTIFACT_REF_PREFIX", { enumerable: true, get: function () { return index_js_6.ARTIFACT_REF_PREFIX; } });
+Object.defineProperty(exports, "ArtifactIntegrityError", { enumerable: true, get: function () { return index_js_6.ArtifactIntegrityError; } });
+Object.defineProperty(exports, "bindArtifacts", { enumerable: true, get: function () { return index_js_6.bindArtifacts; } });
 // Recordings-as-artifacts (9.26.0) — a completed run's
 // `{ snapshot, events, structure }` checked in under kind 'recording/run',
 // so the existing artifact wire ops serve the Lens with no new operation.
-Object.defineProperty(exports, "RECORDING_ARTIFACT_KIND", { enumerable: true, get: function () { return index_js_5.RECORDING_ARTIFACT_KIND; } });
-Object.defineProperty(exports, "RECORDING_MEDIA_TYPE", { enumerable: true, get: function () { return index_js_5.RECORDING_MEDIA_TYPE; } });
-Object.defineProperty(exports, "recordingPutInput", { enumerable: true, get: function () { return index_js_5.recordingPutInput; } });
-Object.defineProperty(exports, "UnserializableRecordingError", { enumerable: true, get: function () { return index_js_5.UnserializableRecordingError; } });
-Object.defineProperty(exports, "DEFAULT_IN_MEMORY_ARTIFACT_RETENTION", { enumerable: true, get: function () { return index_js_5.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION; } });
-Object.defineProperty(exports, "fileArtifacts", { enumerable: true, get: function () { return index_js_5.fileArtifacts; } });
-Object.defineProperty(exports, "gcsArtifacts", { enumerable: true, get: function () { return index_js_5.gcsArtifacts; } });
-Object.defineProperty(exports, "inMemoryArtifacts", { enumerable: true, get: function () { return index_js_5.inMemoryArtifacts; } });
-Object.defineProperty(exports, "InvalidArtifactError", { enumerable: true, get: function () { return index_js_5.InvalidArtifactError; } });
-Object.defineProperty(exports, "isArtifactRef", { enumerable: true, get: function () { return index_js_5.isArtifactRef; } });
-Object.defineProperty(exports, "mintArtifactRef", { enumerable: true, get: function () { return index_js_5.mintArtifactRef; } });
-Object.defineProperty(exports, "s3Artifacts", { enumerable: true, get: function () { return index_js_5.s3Artifacts; } });
-Object.defineProperty(exports, "sqliteArtifacts", { enumerable: true, get: function () { return index_js_5.sqliteArtifacts; } });
-Object.defineProperty(exports, "unconfiguredArtifacts", { enumerable: true, get: function () { return index_js_5.unconfiguredArtifacts; } });
-Object.defineProperty(exports, "UnknownParentRefError", { enumerable: true, get: function () { return index_js_5.UnknownParentRefError; } });
-Object.defineProperty(exports, "UnreadableArtifactFileError", { enumerable: true, get: function () { return index_js_5.UnreadableArtifactFileError; } });
-Object.defineProperty(exports, "UnreadableArtifactStoreError", { enumerable: true, get: function () { return index_js_5.UnreadableArtifactStoreError; } });
+Object.defineProperty(exports, "RECORDING_ARTIFACT_KIND", { enumerable: true, get: function () { return index_js_6.RECORDING_ARTIFACT_KIND; } });
+Object.defineProperty(exports, "RECORDING_MEDIA_TYPE", { enumerable: true, get: function () { return index_js_6.RECORDING_MEDIA_TYPE; } });
+Object.defineProperty(exports, "recordingPutInput", { enumerable: true, get: function () { return index_js_6.recordingPutInput; } });
+Object.defineProperty(exports, "UnserializableRecordingError", { enumerable: true, get: function () { return index_js_6.UnserializableRecordingError; } });
+Object.defineProperty(exports, "DEFAULT_IN_MEMORY_ARTIFACT_RETENTION", { enumerable: true, get: function () { return index_js_6.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION; } });
+Object.defineProperty(exports, "fileArtifacts", { enumerable: true, get: function () { return index_js_6.fileArtifacts; } });
+Object.defineProperty(exports, "gcsArtifacts", { enumerable: true, get: function () { return index_js_6.gcsArtifacts; } });
+Object.defineProperty(exports, "inMemoryArtifacts", { enumerable: true, get: function () { return index_js_6.inMemoryArtifacts; } });
+Object.defineProperty(exports, "InvalidArtifactError", { enumerable: true, get: function () { return index_js_6.InvalidArtifactError; } });
+Object.defineProperty(exports, "isArtifactRef", { enumerable: true, get: function () { return index_js_6.isArtifactRef; } });
+Object.defineProperty(exports, "mintArtifactRef", { enumerable: true, get: function () { return index_js_6.mintArtifactRef; } });
+Object.defineProperty(exports, "s3Artifacts", { enumerable: true, get: function () { return index_js_6.s3Artifacts; } });
+Object.defineProperty(exports, "sqliteArtifacts", { enumerable: true, get: function () { return index_js_6.sqliteArtifacts; } });
+Object.defineProperty(exports, "unconfiguredArtifacts", { enumerable: true, get: function () { return index_js_6.unconfiguredArtifacts; } });
+Object.defineProperty(exports, "UnknownParentRefError", { enumerable: true, get: function () { return index_js_6.UnknownParentRefError; } });
+Object.defineProperty(exports, "UnreadableArtifactFileError", { enumerable: true, get: function () { return index_js_6.UnreadableArtifactFileError; } });
+Object.defineProperty(exports, "UnreadableArtifactStoreError", { enumerable: true, get: function () { return index_js_6.UnreadableArtifactStoreError; } });
 // Artifacts, the optional streaming leg (9.25.0) — `putStream`/`getStream` are
 // FEATURE-DETECTED members of the port, so a store that cannot move bytes
 // without holding them whole leaves them absent rather than faking one. The
 // guards narrow the type, so calling an absent member is a compile error.
-var index_js_6 = require("./artifacts/index.js");
-Object.defineProperty(exports, "canGetArtifactStream", { enumerable: true, get: function () { return index_js_6.canGetArtifactStream; } });
-Object.defineProperty(exports, "canPutArtifactStream", { enumerable: true, get: function () { return index_js_6.canPutArtifactStream; } });
-Object.defineProperty(exports, "canStreamArtifacts", { enumerable: true, get: function () { return index_js_6.canStreamArtifacts; } });
+var index_js_7 = require("./artifacts/index.js");
+Object.defineProperty(exports, "canGetArtifactStream", { enumerable: true, get: function () { return index_js_7.canGetArtifactStream; } });
+Object.defineProperty(exports, "canPutArtifactStream", { enumerable: true, get: function () { return index_js_7.canPutArtifactStream; } });
+Object.defineProperty(exports, "canStreamArtifacts", { enumerable: true, get: function () { return index_js_7.canStreamArtifacts; } });
 // Artifacts, the CONFORMANCE battery — the laws a store must hold to claim the
 // port, written once against the port and run against every store, in-tree or
 // out. On the main barrel because that is where `ArtifactStore` itself ships:
 // somebody implementing the port imports the check from the same door as the
 // interface. Nothing in it imports a test framework — a case throws to fail —
 // so it runs under vitest, jest, `node:test` or a plain script.
-var index_js_7 = require("./artifacts/index.js");
-Object.defineProperty(exports, "artifactStoreConformance", { enumerable: true, get: function () { return index_js_7.artifactStoreConformance; } });
-Object.defineProperty(exports, "formatArtifactStoreReport", { enumerable: true, get: function () { return index_js_7.formatArtifactStoreReport; } });
-Object.defineProperty(exports, "runArtifactStoreCase", { enumerable: true, get: function () { return index_js_7.runArtifactStoreCase; } });
-Object.defineProperty(exports, "runArtifactStoreConformance", { enumerable: true, get: function () { return index_js_7.runArtifactStoreConformance; } });
+var index_js_8 = require("./artifacts/index.js");
+Object.defineProperty(exports, "artifactStoreConformance", { enumerable: true, get: function () { return index_js_8.artifactStoreConformance; } });
+Object.defineProperty(exports, "formatArtifactStoreReport", { enumerable: true, get: function () { return index_js_8.formatArtifactStoreReport; } });
+Object.defineProperty(exports, "runArtifactStoreCase", { enumerable: true, get: function () { return index_js_8.runArtifactStoreCase; } });
+Object.defineProperty(exports, "runArtifactStoreConformance", { enumerable: true, get: function () { return index_js_8.runArtifactStoreConformance; } });
 // Artifacts, the data legs (9.22.0) — refs the model ROUTES: `wants` (ref
 // arguments resolved at dispatch, the declare-and-push precedent applied to
 // data), the auto-attached `present` tool (hand a ref to the screen with a
 // description snapshot the transcript keeps), and the placement threshold
 // (`artifacts: { store, placement }` — oversized results become claim
 // tickets). All zero-cost without a store.
-var index_js_8 = require("./artifacts/index.js");
-Object.defineProperty(exports, "assertToolWants", { enumerable: true, get: function () { return index_js_8.assertToolWants; } });
-Object.defineProperty(exports, "isPlacedToolResult", { enumerable: true, get: function () { return index_js_8.isPlacedToolResult; } });
-Object.defineProperty(exports, "placedResultKind", { enumerable: true, get: function () { return index_js_8.placedResultKind; } });
-Object.defineProperty(exports, "PRESENT_TOOL_NAME", { enumerable: true, get: function () { return index_js_8.PRESENT_TOOL_NAME; } });
+var index_js_9 = require("./artifacts/index.js");
+Object.defineProperty(exports, "assertToolWants", { enumerable: true, get: function () { return index_js_9.assertToolWants; } });
+Object.defineProperty(exports, "isPlacedToolResult", { enumerable: true, get: function () { return index_js_9.isPlacedToolResult; } });
+Object.defineProperty(exports, "placedResultKind", { enumerable: true, get: function () { return index_js_9.placedResultKind; } });
+Object.defineProperty(exports, "PRESENT_TOOL_NAME", { enumerable: true, get: function () { return index_js_9.PRESENT_TOOL_NAME; } });
 // Slot subflow builders are intentionally NOT exported. They are
 // internal helpers used only by `Agent.buildChart()` and
 // `LLMCall.buildChart()` to construct each primitive's three-slot
@@ -468,16 +489,16 @@ __exportStar(require("./patterns/index.js"), exports);
 // RAG — retrieval-augmented generation as a context-engineering flavor.
 // Thin sugar over `defineMemory({ type: SEMANTIC, strategy: TOP_K })`
 // plus the `indexDocuments` helper for seeding the corpus at startup.
-var index_js_9 = require("./lib/rag/index.js");
-Object.defineProperty(exports, "defineRAG", { enumerable: true, get: function () { return index_js_9.defineRAG; } });
-Object.defineProperty(exports, "DEFAULT_CORPUS_IDENTITY", { enumerable: true, get: function () { return index_js_9.DEFAULT_CORPUS_IDENTITY; } });
-Object.defineProperty(exports, "indexDocuments", { enumerable: true, get: function () { return index_js_9.indexDocuments; } });
+var index_js_10 = require("./lib/rag/index.js");
+Object.defineProperty(exports, "defineRAG", { enumerable: true, get: function () { return index_js_10.defineRAG; } });
+Object.defineProperty(exports, "DEFAULT_CORPUS_IDENTITY", { enumerable: true, get: function () { return index_js_10.DEFAULT_CORPUS_IDENTITY; } });
+Object.defineProperty(exports, "indexDocuments", { enumerable: true, get: function () { return index_js_10.indexDocuments; } });
 // The retrieval seam (8.8.0) — what a retrieval considered, and the rule
 // that decided what it kept. `topK` is the rule every release before this
 // one applied without naming it. The record types are here because a
 // consumer reading `agentfootprint.memory.retrieved` needs them.
-var index_js_10 = require("./memory/retrieval/index.js");
-Object.defineProperty(exports, "topK", { enumerable: true, get: function () { return index_js_10.topK; } });
+var index_js_11 = require("./memory/retrieval/index.js");
+Object.defineProperty(exports, "topK", { enumerable: true, get: function () { return index_js_11.topK; } });
 // MCP + tool dispatch. Tool sources — `mcpClient` / `mockMcpClient`,
 // which connect to a Model Context Protocol server and expose its tools
 // as agentfootprint `Tool[]` for `agent.tools(...)` — and the dispatch