agentfootprint 9.69.0 → 9.71.0

package/dist/core/tools.js

@@ -8,7 +8,7 @@
  * Emits:   N/A (types only).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineTool = exports.warnIfInvalidToolName = exports.assertValidToolName = exports.assertResultClass = exports.assertResultCeiling = void 0;
+exports.defineTool = exports.warnIfInvalidToolName = exports.assertValidToolName = exports.assertArgumentsFrom = exports.assertToolOwner = exports.assertResultKind = exports.assertResultClass = exports.assertResultCeiling = void 0;
 const footprintjs_1 = require("footprintjs");
 const wants_js_1 = require("../artifacts/wants.js");
 const types_js_1 = require("../lib/semantics/types.js");
@@ -22,7 +22,11 @@ const askComponent_js_1 = require("./askComponent.js");
 function assertResultCeiling(toolName, ceiling) {
     if (ceiling === undefined)
         return;
-    const { maxChars, narrowBy } = ceiling;
+    // Destructured through a fallback because this rule is also asked about
+    // values NO COMPILER vetted — a `_meta` bag from a foreign MCP server
+    // (`readToolExtras`). A `null` or a number must reach the teaching refusal
+    // below, not blow up on the destructuring on the way to it.
+    const { maxChars, narrowBy } = (ceiling ?? {});
     if (!Number.isFinite(maxChars) || !Number.isInteger(maxChars) || maxChars <= 0) {
         throw new Error(`defineTool: tool '${toolName}' declares resultCeiling.maxChars = ${String(maxChars)}, ` +
             `which is not a positive whole number of characters. The ceiling is the size over ` +
@@ -61,6 +65,96 @@ function assertResultClass(toolName, resultClass) {
     }
 }
 exports.assertResultClass = assertResultClass;
+/**
+ * Refuse a `resultKind` that could never be redeemed, at definition time —
+ * naming the tool and the fix (the `assertResultCeiling` / `assertResultClass`
+ * law: a declaration this library cannot honor fails HERE, never at the first
+ * oversized result of the first run). Exported beside them for consumers
+ * assembling `Tool` objects by hand.
+ *
+ * The one rule is non-blankness, and it is not a formality: the kind is what a
+ * `wants` argument is matched against by exact string equality, so a blank or
+ * whitespace-only kind mints a ticket no declaration can ever name — the same
+ * refusal `assertToolWants` raises on the consuming end, raised on the
+ * producing end too. There is deliberately NO charset or shape rule: the kind
+ * is the consumer's vocabulary, and the library does not own it.
+ */
+function assertResultKind(toolName, resultKind) {
+    if (resultKind === undefined)
+        return;
+    if (typeof resultKind !== 'string' || resultKind.trim().length === 0) {
+        throw new Error(`defineTool: tool '${toolName}' declares resultKind ${JSON.stringify(resultKind)}, which ` +
+            `is not a kind anything could want. It is the artifact kind a PLACED result is minted ` +
+            `under, matched by exact string equality against a consuming tool's ` +
+            `\`wants\` (e.g. 'dataset/rows'), so a blank kind is a ticket no argument can redeem. ` +
+            `Name the kind your consumers declare, or omit the field — omitting it mints ` +
+            `\`tool-result/${toolName}\`, exactly as before.`);
+    }
+}
+exports.assertResultKind = assertResultKind;
+/**
+ * Refuse an `owner` stamp with a blank half, at definition time — naming the
+ * tool and what a blank half would do.
+ *
+ * An identity edge with a blank half is worse than none: the Context Integrity
+ * checks JOIN on it, so a blank `kind` or `id` joins the wrong subjects rather
+ * than no subjects. Extracted from `defineTool` (9.71.0) so the MCP ingest
+ * boundary can hold the SAME line on a declaration that arrived over the wire —
+ * one rule, one message, two doors.
+ *
+ * Deliberately NOT a closed-set check on `kind`: the union is enforced by the
+ * compiler for anyone calling `defineTool`, and the value is only ever read
+ * into a prose reason (`owned by <kind> '<id>'`), never switched on.
+ */
+function assertToolOwner(toolName, owner) {
+    if (owner === undefined)
+        return;
+    // Same reason as `assertResultCeiling`: this is also asked about untyped
+    // values from a foreign MCP server, so a scalar or a `null` must land on the
+    // message rather than on a TypeError from the destructuring.
+    const { kind, id } = (owner ?? {});
+    if (typeof owner !== 'object' ||
+        typeof kind !== 'string' ||
+        kind.length === 0 ||
+        typeof id !== 'string' ||
+        id.length === 0) {
+        throw new Error(`defineTool('${toolName}'): \`owner\` must carry a non-empty kind and id — it is ` +
+            `the identity edge integrity checks join on, and a blank half joins the wrong ` +
+            `subjects. Got ${JSON.stringify(owner)}.`);
+    }
+}
+exports.assertToolOwner = assertToolOwner;
+/**
+ * Refuse an `argumentsFrom` edge that could never join, at definition time.
+ *
+ * The dangling-reference and unsupported-argument checks join on these names,
+ * so a blank one — or a tool grounded by itself — would join the wrong subjects
+ * or none at all. Extracted from `defineTool` (9.71.0) for the same reason as
+ * {@link assertToolOwner}: the MCP ingest boundary enforces the identical rule
+ * on a declaration a remote server sent.
+ */
+function assertArgumentsFrom(toolName, argumentsFrom) {
+    if (argumentsFrom === undefined)
+        return;
+    // The array check is part of the rule, not a formality: a foreign server can
+    // put a bare string here, and `for…of` over one would walk its CHARACTERS
+    // and refuse them one letter at a time.
+    if (!Array.isArray(argumentsFrom) || argumentsFrom.length === 0) {
+        throw new Error(`defineTool('${toolName}'): \`argumentsFrom\` must name at least one tool — ` +
+            `omitting the field is how "no grounds" is said.`);
+    }
+    for (const ground of argumentsFrom) {
+        if (typeof ground !== 'string' || ground.length === 0) {
+            throw new Error(`defineTool('${toolName}'): \`argumentsFrom\` entries must be non-empty tool ` +
+                `names. Got ${JSON.stringify(ground)}.`);
+        }
+        if (ground === toolName) {
+            throw new Error(`defineTool('${toolName}'): \`argumentsFrom\` names the tool itself — a tool ` +
+                `cannot be its own argument ground.`);
+        }
+    }
+}
+exports.assertArgumentsFrom = assertArgumentsFrom;
 /**
  * Ergonomic builder for `Tool`. Equivalent to constructing an object
  * literal with `schema` + `execute`, but flatter and safer — the name
@@ -138,6 +232,9 @@ function defineTool(options) {
     // A class outside the closed set fails HERE too — not at the first
     // `check:semantics` run of the first CI pipeline.
     assertResultClass(options.name, options.resultClass);
+    // A placed-result kind nothing could want fails HERE too — not at the first
+    // oversized result of the first run with placement configured.
+    assertResultKind(options.name, options.resultKind);
     // A decision component for a gate that never fires is configuration that
     // lies — configured-and-inert looks exactly like configured-and-working
     // (the `.checkIn({ scorer })`-with-minimal-evidence precedent). And a
@@ -159,36 +256,11 @@ function defineTool(options) {
     (0, wants_js_1.assertToolWants)(options.name, options.wants, options.inputSchema ?? { type: 'object', properties: {} });
     // An identity edge with a blank half is worse than none: a checker would
     // join on it and compare the wrong subjects. Refused HERE, naming the tool.
-    if (options.owner !== undefined) {
-        const { kind, id } = options.owner;
-        if (typeof kind !== 'string' ||
-            kind.length === 0 ||
-            typeof id !== 'string' ||
-            id.length === 0) {
-            throw new Error(`defineTool('${options.name}'): \`owner\` must carry a non-empty kind and id — it is ` +
-                `the identity edge integrity checks join on, and a blank half joins the wrong ` +
-                `subjects. Got ${JSON.stringify(options.owner)}.`);
-        }
-    }
+    assertToolOwner(options.name, options.owner);
     // The grounds edge is judged at the same door and for the same reason: the
     // dangling-reference check joins on these names, and a blank one — or a
     // tool grounded by itself — would join the wrong subjects or none.
-    if (options.argumentsFrom !== undefined) {
-        if (options.argumentsFrom.length === 0) {
-            throw new Error(`defineTool('${options.name}'): \`argumentsFrom\` must name at least one tool — ` +
-                `omitting the field is how "no grounds" is said.`);
-        }
-        for (const ground of options.argumentsFrom) {
-            if (typeof ground !== 'string' || ground.length === 0) {
-                throw new Error(`defineTool('${options.name}'): \`argumentsFrom\` entries must be non-empty tool ` +
-                    `names. Got ${JSON.stringify(ground)}.`);
-            }
-            if (ground === options.name) {
-                throw new Error(`defineTool('${options.name}'): \`argumentsFrom\` names the tool itself — a tool ` +
-                    `cannot be its own argument ground.`);
-            }
-        }
-    }
+    assertArgumentsFrom(options.name, options.argumentsFrom);
     return {
         schema: {
             name: options.name,
@@ -206,6 +278,7 @@ function defineTool(options) {
         ...(options.capabilities !== undefined && { capabilities: options.capabilities }),
         ...(options.resultCeiling !== undefined && { resultCeiling: options.resultCeiling }),
         ...(options.resultClass !== undefined && { resultClass: options.resultClass }),
+        ...(options.resultKind !== undefined && { resultKind: options.resultKind }),
         ...(options.owner !== undefined && { owner: options.owner }),
         ...(options.argumentsFrom !== undefined && { argumentsFrom: options.argumentsFrom }),
         ...(options.repeatedWhen !== undefined && { repeatedWhen: options.repeatedWhen }),

package/dist/core/tools.js.map

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

package/dist/esm/artifacts/placement.d.ts

@@ -4,7 +4,8 @@
  * An OPTIONAL operator dial on the agent's artifacts wiring:
  * `Agent.create({ artifacts: { store, placement: { maxInlineChars: N } } })`.
  * A tool result whose finalized text exceeds the threshold is checked into
- * the store (kind `tool-result/<toolName>`) and the model receives the claim
+ * the store (kind `tool-result/<toolName>`, or the tool's declared
+ * `resultKind` — see `placedResultKind`) and the model receives the claim
  * ticket instead — a SHORT substitute naming ref + meta + how to consume it.
  * The whole 879,073-token failure class, retired by configuration.
  *
@@ -55,11 +56,24 @@ export interface ArtifactPlacement {
  * — never at the first oversized result of the first run.
  */
 export declare function assertArtifactPlacement(site: string, placement: ArtifactPlacement | undefined): void;
-/** The kind vocabulary a placement mint declares: `tool-result/<toolName>`.
- *  Honest — it says exactly what the payload is and which tool produced it —
- *  and it is what a `wants` declaration or a `present` call names to consume
- *  the placed result. */
-export declare function placedResultKind(toolName: string): string;
+/**
+ * The kind vocabulary a placement mint declares — THE one decision, and the
+ * only place it is made.
+ *
+ * Default: `tool-result/<toolName>`. Honest — it says exactly what the payload
+ * is and which tool produced it — and it is what a `wants` declaration or a
+ * `present` call names to consume the placed result.
+ *
+ * `declared` is the tool's own `Tool.resultKind` (9.70.0), and when a tool
+ * declares one it WINS. The reason is the exact-match law on the consuming
+ * end: `wants` matches kinds by exact string equality — no wildcards, no
+ * hierarchy — so the framework's default vocabulary is a ticket a
+ * `wants: { dataset: 'dataset/rows' }` argument must refuse. Rather than
+ * loosen the matcher (a ticket would stop being a promise) or make consumers
+ * re-mint at the seam (the framework declining to carry its own ref), the
+ * MINT speaks the author's vocabulary. Absent → today's bytes exactly.
+ */
+export declare function placedResultKind(toolName: string, declared?: string): string;
 /**
  * The substitute the model reads in place of the payload — ONE shape, always
  * the object (the `TruncatedToolResult` law: a consumer branches on
@@ -70,7 +84,8 @@ export interface PlacedToolResult {
     /** Always `true`. The field a consumer branches on. */
     readonly placed: true;
     readonly ref: string;
-    /** `tool-result/<toolName>` — what a consumer names to want it. */
+    /** The minted kind — what a consumer names to want it. The tool's declared
+     *  `Tool.resultKind` when it has one, `tool-result/<toolName>` otherwise. */
     readonly kind: string;
     readonly mediaType: string;
     /** The stored payload's true size — the chars the window did NOT pay. */

package/dist/esm/artifacts/placement.js

@@ -4,7 +4,8 @@
  * An OPTIONAL operator dial on the agent's artifacts wiring:
  * `Agent.create({ artifacts: { store, placement: { maxInlineChars: N } } })`.
  * A tool result whose finalized text exceeds the threshold is checked into
- * the store (kind `tool-result/<toolName>`) and the model receives the claim
+ * the store (kind `tool-result/<toolName>`, or the tool's declared
+ * `resultKind` — see `placedResultKind`) and the model receives the claim
  * ticket instead — a SHORT substitute naming ref + meta + how to consume it.
  * The whole 879,073-token failure class, retired by configuration.
  *
@@ -45,12 +46,25 @@ export function assertArtifactPlacement(site, placement) {
             `measured and never placed, exactly as before.`);
     }
 }
-/** The kind vocabulary a placement mint declares: `tool-result/<toolName>`.
- *  Honest — it says exactly what the payload is and which tool produced it —
- *  and it is what a `wants` declaration or a `present` call names to consume
- *  the placed result. */
-export function placedResultKind(toolName) {
-    return `tool-result/${toolName}`;
+/**
+ * The kind vocabulary a placement mint declares — THE one decision, and the
+ * only place it is made.
+ *
+ * Default: `tool-result/<toolName>`. Honest — it says exactly what the payload
+ * is and which tool produced it — and it is what a `wants` declaration or a
+ * `present` call names to consume the placed result.
+ *
+ * `declared` is the tool's own `Tool.resultKind` (9.70.0), and when a tool
+ * declares one it WINS. The reason is the exact-match law on the consuming
+ * end: `wants` matches kinds by exact string equality — no wildcards, no
+ * hierarchy — so the framework's default vocabulary is a ticket a
+ * `wants: { dataset: 'dataset/rows' }` argument must refuse. Rather than
+ * loosen the matcher (a ticket would stop being a promise) or make consumers
+ * re-mint at the seam (the framework declining to carry its own ref), the
+ * MINT speaks the author's vocabulary. Absent → today's bytes exactly.
+ */
+export function placedResultKind(toolName, declared) {
+    return declared ?? `tool-result/${toolName}`;
 }
 /** Type guard for consumers reading `tool_end.result` or a tool message. */
 export function isPlacedToolResult(value) {

package/dist/esm/artifacts/placement.js.map

@@ -1 +1 @@
-{"version":3,"file":"placement.js","sourceRoot":"","sources":["../../../src/artifacts/placement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAyBH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,SAAwC;IAExC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,0EAA0E;YAC/E,mBAAmB,MAAM,CAAC,KAAK,CAAC,qDAAqD;YACrF,iFAAiF;YACjF,sFAAsF;YACtF,+CAA+C,CAClD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;yBAGyB;AACzB,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,eAAe,QAAQ,EAAE,CAAC;AACnC,CAAC;AAqBD,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAA8B,CAAC,MAAM,KAAK,IAAI;QAC/C,OAAQ,KAA2B,CAAC,GAAG,KAAK,QAAQ;QACpD,OAAQ,KAA8B,CAAC,MAAM,KAAK,QAAQ,CAC3D,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,IAAkB,EAClB,SAAiB,EACjB,cAAsB;IAEtB,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EACJ,GAAG,QAAQ,aAAa,SAAS,oBAAoB,cAAc,kBAAkB;YACrF,yDAAyD,IAAI,CAAC,GAAG,IAAI;YACrE,IAAI,IAAI,CAAC,IAAI,mEAAmE;YAChF,WAAW,IAAI,CAAC,GAAG,qCAAqC,IAAI,CAAC,IAAI,aAAa;YAC9E,mBAAmB,IAAI,CAAC,GAAG,yDAAyD;YACpF,sCAAsC;KACzC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"placement.js","sourceRoot":"","sources":["../../../src/artifacts/placement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAyBH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,SAAwC;IAExC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,0EAA0E;YAC/E,mBAAmB,MAAM,CAAC,KAAK,CAAC,qDAAqD;YACrF,iFAAiF;YACjF,sFAAsF;YACtF,+CAA+C,CAClD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAiB;IAClE,OAAO,QAAQ,IAAI,eAAe,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAsBD,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAA8B,CAAC,MAAM,KAAK,IAAI;QAC/C,OAAQ,KAA2B,CAAC,GAAG,KAAK,QAAQ;QACpD,OAAQ,KAA8B,CAAC,MAAM,KAAK,QAAQ,CAC3D,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,IAAkB,EAClB,SAAiB,EACjB,cAAsB;IAEtB,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EACJ,GAAG,QAAQ,aAAa,SAAS,oBAAoB,cAAc,kBAAkB;YACrF,yDAAyD,IAAI,CAAC,GAAG,IAAI;YACrE,IAAI,IAAI,CAAC,IAAI,mEAAmE;YAChF,WAAW,IAAI,CAAC,GAAG,qCAAqC,IAAI,CAAC,IAAI,aAAa;YAC9E,mBAAmB,IAAI,CAAC,GAAG,yDAAyD;YACpF,sCAAsC;KACzC,CAAC;AACJ,CAAC"}

package/dist/esm/core/agent/stages/toolCalls.d.ts

@@ -103,8 +103,9 @@ export interface ToolCallsHandlerDeps {
      * The placement threshold (9.22.0) — the operator's ref-ing dial. When set
      * (only ever beside `artifactStore`; the Agent option's shape enforces it),
      * every finalized tool result on every dispatch path is measured, and one
-     * whose text exceeds `maxInlineChars` is checked into the store (kind
-     * `tool-result/<toolName>`) with the model reading the claim ticket
+     * whose text exceeds `maxInlineChars` is checked into the store (under the
+     * tool's declared `resultKind`, or `tool-result/<toolName>` when it
+     * declares none) with the model reading the claim ticket
      * instead. Judged AFTER the tool's own `resultCeiling` and the after-tool
      * chain, BEFORE the `maxToolResultChars` truncation net. Undefined — the
      * default — and results are never measured against it (zero-cost).

package/dist/esm/core/agent/stages/toolCalls.js

@@ -1155,7 +1155,13 @@ export function buildToolCallsHandler(deps) {
             // `mediaType` states what that text is: a JSON serialization when the
             // tool returned a value, plain text when it returned a string.
             meta = await bound.artifacts.put({
-                kind: placedResultKind(call.toolName),
+                // The tool's own `resultKind` when it declared one (9.70.0), the
+                // framework's `tool-result/<name>` when it did not. Resolved HERE
+                // rather than threaded through the five dispatch doors: `lookupTool`
+                // is the closure's one resolver (registry + this iteration's cached
+                // provider list), so a sixth door added later cannot forget to carry
+                // the declaration — the `capResults` landmine, avoided by shape.
+                kind: placedResultKind(call.toolName, lookupTool(call.toolName)?.resultKind),
                 mediaType: typeof values.modelResult === 'string' ? 'text/plain' : 'application/json',
                 data: text,
                 label: `${call.toolName} result`,