agentfootprint 11.2.0 → 11.3.0

package/dist/esm/tools/requestEvidence.js

@@ -0,0 +1,331 @@
+/**
+ * requestEvidence — the door a tool call's REQUEST attempts enter its run by.
+ *
+ * Pattern: a per-dispatch port (the `LLMCallHooks` precedent) + one allow-list.
+ * Role:    The seam between a retry series that runs BELOW a tool — inside
+ *          `mcpClient`'s transport, built before any run existed — and the run
+ *          that dispatched the call. The dispatcher builds the port for each
+ *          call (`requestEvidenceFor`) and puts it on the call's context under
+ *          an internal symbol; the MCP tool hands it down to the series that
+ *          sends its request (`mcp/requestLedger.ts`); the series files ONE
+ *          record when the request ends. Nothing here retries anything.
+ * Emits:   agentfootprint.tools.request_attempts
+ *
+ * Why a port and not a scope: a decorator constructed by the consumer before
+ * any run exists can never reach a scope (`resilienceHooks` says the same of
+ * the provider decorators). The call is the one thing both sides share, so the
+ * port rides the call — and the identity on the event (`toolCallId`,
+ * `toolName`, `iteration`, the run's ids in the meta) is stamped HERE, from the
+ * dispatch, never by whatever files: a filing cannot claim another call.
+ *
+ * Why an internal symbol and not a public `ctx` field: this is the evidence
+ * path for the library's own retry series, not a retry API. A public member
+ * would invite every tool to file attempts the library cannot vouch for. The
+ * symbol is enumerable, so a wrapper that copies the context (`{ ...ctx }`)
+ * keeps it; a filing from anyone else still passes the allow-list below.
+ *
+ * The port only FILES. What cancels a call is the call's own context signal
+ * (`ctx.signal`), read by the MCP tool whether or not a port rides along — a
+ * cancellation must never depend on evidence being attributable.
+ *
+ * THE ALLOW-LIST is the whole record: numbers, the library's own words, the
+ * endpoint label the app declared or else the endpoint's ORIGIN. A filing with
+ * anything else in it — a field nobody listed, a word outside its set, a URL
+ * with a path, an array that is not a plain one — is refused whole, never
+ * trimmed into something it did not say. Values are read as DATA, through own
+ * property descriptors, so no getter, `toJSON` or array subclass a filing
+ * carries ever runs or reaches the record.
+ */
+import { isDevMode } from 'footprintjs';
+import { typedEmit } from '../recorders/core/typedEmit.js';
+/** At most this many attempts are listed per request; the rest are counted (`omitted`). */
+export const MAX_REQUEST_ATTEMPT_ROWS = 100;
+/** @internal The context key the dispatcher puts a call's sink under. */
+export const REQUEST_EVIDENCE = Symbol('agentfootprint.request-evidence');
+/**
+ * The port for one dispatch: files `agentfootprint.tools.request_attempts`
+ * mid-stage through `typedEmit` (so the run's redaction rule serves it, and the
+ * meta carries the real `runtimeStageId`), stamped with `call`.
+ */
+export function requestEvidenceFor(scope, call) {
+    const sink = {
+        file: (evidence) => {
+            const served = servedRequestEvidence(evidence);
+            if (served === undefined) {
+                warnOnce(call.toolName, 'a filing outside the allow-list was refused');
+                return;
+            }
+            try {
+                typedEmit(scope, 'agentfootprint.tools.request_attempts', {
+                    toolCallId: call.toolCallId,
+                    toolName: call.toolName,
+                    iteration: call.iteration,
+                    ...served,
+                });
+            }
+            catch (err) {
+                // Evidence is not the work: a sink that dies must not fail the call.
+                warnOnce(call.toolName, err instanceof Error ? err.message : String(err));
+            }
+        },
+    };
+    return { [REQUEST_EVIDENCE]: sink };
+}
+/**
+ * The sink a call's context carries, or `undefined` — a context from a door with
+ * no run (`mcpServe`, a direct `execute`), or one a wrapper rebuilt without it.
+ * Never throws, whatever `ctx` is.
+ */
+export function requestEvidenceOf(ctx) {
+    if (ctx === null || typeof ctx !== 'object')
+        return undefined;
+    let port;
+    try {
+        port = ctx[REQUEST_EVIDENCE];
+    }
+    catch {
+        return undefined;
+    }
+    if (port === null || typeof port !== 'object')
+        return undefined;
+    let file;
+    try {
+        file = port.file;
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof file !== 'function')
+        return undefined;
+    return port;
+}
+const ATTEMPT_OUTCOMES = {
+    answered: true,
+    refused: true,
+    failed: true,
+    'timed-out': true,
+    cut: true,
+};
+/** An end may also be `cancelled`: no request was in flight. A row never is — a sent request is `cut`. */
+const END_OUTCOMES = { ...ATTEMPT_OUTCOMES, cancelled: true };
+const REMOTE = { unknown: true };
+const REASONS = {
+    retryable: true,
+    answered: true,
+    exhausted: true,
+    'wait-limit': true,
+    'no-time-left': true,
+    'not-replayable': true,
+    'not-retryable': true,
+    cancelled: true,
+};
+const KINDS = {
+    throttle: true,
+    'session-busy': true,
+};
+const CATEGORIES = {
+    timeout: true,
+    'rate-limited': true,
+    server: true,
+    network: true,
+    auth: true,
+    permanent: true,
+    unknown: true,
+};
+const SENTENCES = {
+    'The request failed before an answer arrived. Its error is not kept.': true,
+    'The call ran out of time before an answer arrived.': true,
+};
+const DURING = { request: true, wait: true };
+const ATTEMPT_FIELDS = new Set([
+    'attempt',
+    'outcome',
+    'reason',
+    'status',
+    'kind',
+    'failure',
+    'waitMs',
+    'retryAfterMs',
+    'error',
+    'remote',
+]);
+const END_FIELDS = new Set([
+    'outcome',
+    'reason',
+    'status',
+    'kind',
+    'failure',
+    'during',
+    'error',
+    'remote',
+]);
+const EVIDENCE_FIELDS = new Set(['endpoint', 'origin', 'attempts', 'omitted', 'end']);
+/** Thrown inside the walk when a filing leaves the allow-list; caught at its root. */
+class Refused extends Error {
+    name = 'Refused';
+}
+/**
+ * `raw` rebuilt from allow-listed fields — a fresh plain object — or
+ * `undefined` when anything in it is outside the list.
+ */
+export function servedRequestEvidence(raw) {
+    try {
+        const evidence = record(raw, EVIDENCE_FIELDS);
+        const { endpoint, origin } = evidence;
+        if (endpoint !== undefined && origin !== undefined)
+            throw new Refused();
+        return {
+            ...(endpoint !== undefined && { endpoint: label(endpoint) }),
+            ...(origin !== undefined && { origin: originOnly(origin) }),
+            attempts: plainArray(evidence.attempts, MAX_REQUEST_ATTEMPT_ROWS).map(servedAttempt),
+            omitted: count(evidence.omitted),
+            end: servedEnd(evidence.end),
+        };
+    }
+    catch {
+        // `Refused`, or anything a hostile value threw while it was read: this door
+        // never throws, whatever it is handed.
+        return undefined;
+    }
+}
+function servedAttempt(raw) {
+    const row = record(raw, ATTEMPT_FIELDS);
+    const attempt = count(row.attempt);
+    if (attempt < 1)
+        throw new Refused();
+    return {
+        attempt,
+        outcome: word(ATTEMPT_OUTCOMES, row.outcome),
+        reason: word(REASONS, row.reason),
+        ...(row.status !== undefined && { status: status(row.status) }),
+        ...(row.kind !== undefined && { kind: word(KINDS, row.kind) }),
+        ...(row.failure !== undefined && { failure: word(CATEGORIES, row.failure) }),
+        ...(row.waitMs !== undefined && { waitMs: duration(row.waitMs) }),
+        ...(row.retryAfterMs !== undefined && { retryAfterMs: duration(row.retryAfterMs) }),
+        ...(row.error !== undefined && { error: servedError(row.error) }),
+        ...(row.remote !== undefined && { remote: word(REMOTE, row.remote) }),
+    };
+}
+function servedEnd(raw) {
+    const end = record(raw, END_FIELDS);
+    return {
+        outcome: word(END_OUTCOMES, end.outcome),
+        reason: word(REASONS, end.reason),
+        ...(end.status !== undefined && { status: status(end.status) }),
+        ...(end.kind !== undefined && { kind: word(KINDS, end.kind) }),
+        ...(end.failure !== undefined && { failure: word(CATEGORIES, end.failure) }),
+        ...(end.during !== undefined && { during: word(DURING, end.during) }),
+        ...(end.error !== undefined && { error: servedError(end.error) }),
+        ...(end.remote !== undefined && { remote: word(REMOTE, end.remote) }),
+    };
+}
+function servedError(raw) {
+    const error = record(raw, new Set(['message', 'code']));
+    return { message: word(SENTENCES, error.message), code: word(CATEGORIES, error.code) };
+}
+/**
+ * A PLAIN array's elements, copied by index into a fresh array: its prototype
+ * exactly `Array.prototype` (no subclass, so no `toJSON` or species of its own),
+ * every index from 0 to `length - 1` an own data property (no hole, no getter),
+ * and no other own key — a property riding on the array is refused, not
+ * dropped. At most `max` elements.
+ */
+function plainArray(raw, max) {
+    if (!Array.isArray(raw) || Object.getPrototypeOf(raw) !== Array.prototype)
+        throw new Refused();
+    const length = Object.getOwnPropertyDescriptor(raw, 'length')?.value;
+    if (typeof length !== 'number' || !Number.isSafeInteger(length) || length > max) {
+        throw new Refused();
+    }
+    const keys = Reflect.ownKeys(raw);
+    if (keys.length !== length + 1)
+        throw new Refused();
+    const out = [];
+    for (let i = 0; i < length; i++) {
+        const descriptor = Object.getOwnPropertyDescriptor(raw, String(i));
+        if (descriptor === undefined || !('value' in descriptor))
+            throw new Refused();
+        out.push(descriptor.value);
+    }
+    return out;
+}
+/** A plain object whose every own key is listed; read once, by key. */
+function record(raw, fields) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+        throw new Refused();
+    const proto = Object.getPrototypeOf(raw);
+    if (proto !== Object.prototype && proto !== null)
+        throw new Refused();
+    const out = {};
+    for (const key of Reflect.ownKeys(raw)) {
+        if (typeof key !== 'string' || !fields.has(key))
+            throw new Refused();
+        const descriptor = Object.getOwnPropertyDescriptor(raw, key);
+        if (descriptor === undefined || !('value' in descriptor))
+            throw new Refused();
+        out[key] = descriptor.value;
+    }
+    return out;
+}
+function word(words, value) {
+    if (typeof value === 'string' && Object.prototype.hasOwnProperty.call(words, value)) {
+        return value;
+    }
+    throw new Refused();
+}
+/** A whole number ≥ 0. */
+function count(value) {
+    if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)
+        return value;
+    throw new Refused();
+}
+/** An HTTP status. */
+function status(value) {
+    if (typeof value === 'number' && Number.isInteger(value) && value >= 100 && value <= 599) {
+        return value;
+    }
+    throw new Refused();
+}
+/** A finite length of time in ms, ≥ 0. */
+function duration(value) {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0)
+        return value;
+    throw new Refused();
+}
+/** An app-declared label: 1–128 characters, none of them control characters. */
+function label(value) {
+    if (typeof value !== 'string' || value.length < 1 || value.length > 128)
+        throw new Refused();
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code < 0x20 || (code >= 0x7f && code <= 0x9f))
+            throw new Refused();
+    }
+    return value;
+}
+/** An origin and nothing more: what `new URL(it)` reads back as scheme, host and port. */
+function originOnly(value) {
+    if (typeof value !== 'string' || value.length > 2048)
+        throw new Refused();
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Refused();
+    }
+    if (url.host === '' || `${url.protocol}//${url.host}` !== value)
+        throw new Refused();
+    return value;
+}
+const warned = new Set();
+/** Named in dev mode, once per tool — evidence is telemetry, never the call's failure. */
+function warnOnce(toolName, why) {
+    if (!isDevMode() || warned.has(toolName))
+        return;
+    warned.add(toolName);
+    // eslint-disable-next-line no-console
+    console.warn(`[agentfootprint] tool '${toolName}': its request attempts were not recorded (${why}). ` +
+        'The call itself is unaffected.');
+}
+//# sourceMappingURL=requestEvidence.js.map

package/dist/esm/tools/requestEvidence.js.map

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

package/dist/events/registry.js

@@ -94,6 +94,7 @@ exports.EVENT_NAMES = {
         coverageDeclared: 'agentfootprint.tools.coverage_declared',
         semanticsDeclared: 'agentfootprint.tools.semantics_declared',
         codeRun: 'agentfootprint.tools.code_run',
+        requestAttempts: 'agentfootprint.tools.request_attempts',
     },
     skill: {
         activated: 'agentfootprint.skill.activated',
@@ -269,6 +270,7 @@ exports.ALL_EVENT_TYPES = [
     'agentfootprint.tools.repeated_call',
     'agentfootprint.tools.absent',
     'agentfootprint.tools.code_run',
+    'agentfootprint.tools.request_attempts',
     'agentfootprint.tools.coverage_declared',
     'agentfootprint.tools.semantics_declared',
     'agentfootprint.validation.args_invalid',

package/dist/events/registry.js.map

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

package/dist/hosting/doorGuard.js

@@ -2,7 +2,7 @@
 /**
  * hosting/doorGuard — what a request has to be before any handler sees it.
  *
- *   const guard = doorGuard({ name: 'auth', allowedHosts: ['neo.corp.example'] });
+ *   const guard = doorGuard({ name: 'auth', allowedHosts: ['bot.corp.example'] });
  *   const refusal = guard.check(req);          // an IncomingMessage works as-is
  *   if (refusal) return answer(refusal.status, refusal.message, refusal.code);
  *
@@ -205,7 +205,7 @@ exports.checkSessionId = checkSessionId;
  *  - **A reverse proxy on the same machine that forwards the PUBLIC name** in
  *    `Host` (nginx `proxy_set_header Host $host`) — the common case, and the
  *    recommended "bind 127.0.0.1 behind nginx" setup. The proxy's requests
- *    arrive on loopback carrying `neo.corp.example`, which the socket cannot
+ *    arrive on loopback carrying `bot.corp.example`, which the socket cannot
  *    tell from a rebinding page. List that name in `allowedHosts`; the 421
  *    says so, naming this default (`HostNotAllowedError` · `rule`).
  *  - A hosts-file alias for a loopback address — the same fix.

package/dist/mcp/callLifetime.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * callLifetime — one MCP tool call, from the moment it is sent until it settles:
+ * what cancels it while it runs, and what its settling stops.
+ *
+ * Pattern: open / close around `callTool` (`mcpClient.ts` · `wrapMcpTool`).
+ * Role:    The call's side of the evidence seam (`requestLedger.ts` is the
+ *          transport's). Three things are true of a call while it runs, and
+ *          none of them may outlive it:
+ *
+ *   1. ITS CANCELLATION reaches the SDK. The call's context signal (the run's,
+ *      for a call the agent dispatched) and the client's own `signal` are linked
+ *      into one signal the SDK request is given — so a cancelled run makes the
+ *      SDK reject the call, drop its response handler and send the server
+ *      `notifications/cancelled`, whether or not the request could be matched to
+ *      the call. The link is undone when the call settles: the SDK keeps its
+ *      abort listener on the signal it was given, and a link that outlived the
+ *      call would cancel a request that had already finished.
+ *   2. ITS TICKET is issued, when the call carries the run's evidence port and
+ *      the connection has a ledger, keyed by the request's params object.
+ *   3. ITS SETTLING ENDS ITS SERIES. However `callTool` settles — answered,
+ *      failed, or given up by the SDK (its own timeout) — a retry series still
+ *      sending the request is cut there and then, inside the call: it files
+ *      `cancelled` before the call's result is read, and sends nothing more.
+ *
+ * In dev mode, a ticket that no request was bound to by the time the call
+ * settled, when a `tools/call` request DID go out, is named once per connection: the SDK copied
+ * the params, so the call's attempts could not be matched to it. Its
+ * cancellation still reached the request (1, and the ledger's own watch on
+ * `notifications/cancelled`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openCall = void 0;
+const footprintjs_1 = require("footprintjs");
+const abort_js_1 = require("../lib/abort.js");
+const requestEvidence_js_1 = require("../tools/requestEvidence.js");
+/**
+ * Open one call.
+ *
+ * @param params the request's params object — the SDK hands this very object to
+ *   the transport, which is how the ledger knows the request is this call's.
+ * @param ctx the call's context: its signal, and the run's evidence port if any.
+ * @param clientSignal the client's own `signal` (`McpClientOptions.signal`).
+ * @param ledger the connection's ledger, when the library built its transport.
+ * @param server the client's name, for the dev-mode note.
+ */
+function openCall(params, ctx, clientSignal, ledger, server) {
+    const own = signalOf(ctx);
+    const link = own === undefined ? undefined : (0, abort_js_1.linkedController)(own, clientSignal);
+    const signal = link?.controller.signal ?? clientSignal;
+    const sink = ledger === undefined ? undefined : (0, requestEvidence_js_1.requestEvidenceOf)(ctx);
+    const settled = sink === undefined ? undefined : new AbortController();
+    const ticket = sink === undefined
+        ? undefined
+        : { sink, signal: (0, abort_js_1.eitherSignal)(signal, settled?.signal) };
+    const sentBefore = ledger?.toolCallsSent ?? 0;
+    if (ticket !== undefined)
+        ledger?.issue(params, ticket);
+    return {
+        ...(signal !== undefined && { signal }),
+        close: () => {
+            settled?.abort(callSettled());
+            link?.unlink();
+            if (ticket !== undefined && ledger !== undefined) {
+                noteUnbound(ledger, ticket, sentBefore, server);
+            }
+        },
+    };
+}
+exports.openCall = openCall;
+/** The call's own signal, when its context carries a real one. */
+function signalOf(ctx) {
+    if (ctx === null || typeof ctx !== 'object' || typeof AbortSignal === 'undefined') {
+        return undefined;
+    }
+    let signal;
+    try {
+        signal = ctx.signal;
+    }
+    catch {
+        return undefined;
+    }
+    return signal instanceof AbortSignal ? signal : undefined;
+}
+/** Why a series is cut when its call settled first — a fixed sentence. */
+function callSettled() {
+    return Object.assign(new Error('The tool call settled before its MCP request series did.'), {
+        name: 'AbortError',
+    });
+}
+/** Dev mode, once per connection: a request went out for this call, but the ledger never matched it. */
+function noteUnbound(ledger, ticket, sentBefore, server) {
+    if (!(0, footprintjs_1.isDevMode)() || ledger.wasBound(ticket) || ledger.toolCallsSent <= sentBefore)
+        return;
+    if (!ledger.firstUnbound())
+        return;
+    // eslint-disable-next-line no-console
+    console.warn(`[agentfootprint] mcpClient[${server}]: a tool call's request could not be matched to ` +
+        'the call, so its retry attempts were not recorded in the run. The MCP SDK copied the ' +
+        "request's params before sending them. The call itself is unaffected, and its " +
+        'cancellation still reached the request.');
+}
+//# sourceMappingURL=callLifetime.js.map

package/dist/mcp/callLifetime.js.map

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