agentfootprint 11.2.0 → 11.4.0

package/dist/esm/lib/displayName.js

@@ -0,0 +1,119 @@
+/**
+ * displayName — the ONE rule for a tool's `displayName` (the app's own words
+ * for what a call of the tool does, read by a person), and the ONE way the
+ * library names a set of calls in those words: the declared ones named, the
+ * rest counted.
+ *
+ * Pattern: two pure functions and one small reader, no state.
+ * Role:    Leaf. Asked for the RULE by `tools/tools.ts` · `defineTool` and by
+ *          the registration funnel (`core/agent/buildToolRegistry.ts`), and for
+ *          the NAMING by the two texts the library appends after an answer —
+ *          the standing line (`core/agent/assessment/compose.ts`) and the
+ *          limits block (`semantics/coverage/answer.ts`). Those two cannot
+ *          import each other, so the naming lives here and they cannot name
+ *          the same calls in two different ways.
+ * Emits:   N/A.
+ *
+ * ## Why only the app's words
+ *
+ * A tool's registered name is the MODEL's vocabulary (`load_attachment`), and
+ * an app may forbid showing it to the people it serves. This module never
+ * prints it: a call is named only by the words its tool declared, and a call
+ * whose tool declared none is counted ("and 1 other call"), never named. A
+ * caller that gets `undefined` back says what it always said. Not every
+ * surface asks this module yet — the time layer's limits lines and the
+ * answer account's rows still print the registered name (a known follow-up).
+ *
+ * ## Why the plain-line rule
+ *
+ * The words reach a person verbatim, after an answer, so they are held to the
+ * rule every declared label a report prints is held to (`lib/plainLine.ts` ·
+ * `plainLineProblem`: no control, line or paragraph separator, or invisible
+ * format character — a bidi override would reverse what the person reads),
+ * judged BEFORE the length, and capped at the 60 characters a skill's `title`
+ * and an account label are capped at.
+ */
+import { plainLineProblem } from './plainLine.js';
+/** The longest display name a person reads — the cap every declared label a report prints has. */
+export const MAX_DISPLAY_NAME_CHARS = 60;
+/**
+ * At most this many declared names in one phrase; any further call is counted
+ * with the calls whose tools declared none. A line for a person, not a list.
+ */
+export const MAX_NAMED_CALLS = 3;
+/**
+ * Why `value` is not a display name, or `undefined` when it is — judged on the
+ * trimmed text (the text a person would read). `label` names the field in the
+ * sentence, so a refusal says where it was written.
+ */
+export function displayNameProblem(label, value) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        return (`${label} must be a non-empty string — the app's own words for what a call of this ` +
+            `tool does, read by a person (got ${typeof value === 'string' ? JSON.stringify(value) : typeof value}). Omit it to ` +
+            'leave the call unnamed.');
+    }
+    const text = value.trim();
+    const notPlain = plainLineProblem(label, text);
+    if (notPlain !== undefined)
+        return notPlain;
+    if (text.length > MAX_DISPLAY_NAME_CHARS) {
+        return `${label} is ${text.length} characters; the limit is ${MAX_DISPLAY_NAME_CHARS}.`;
+    }
+    return undefined;
+}
+/**
+ * The display name a person may read — trimmed — or `undefined`. A value the
+ * rule refuses is never printed: a tool assembled by hand, or served by a
+ * ToolProvider after the agent was built, is read through this too.
+ */
+export function readDisplayName(value) {
+    return displayNameProblem('displayName', value) === undefined
+        ? value.trim()
+        : undefined;
+}
+/**
+ * The calls, named in the app's words — each distinct declared name once, in
+ * the calls' order, at most {@link MAX_NAMED_CALLS}; every other call counted,
+ * with `alsoUnnamed` (calls the record does not name at all). `calls` holds one
+ * entry per CALL (the caller has already said each call once), each with its
+ * tool's registered name — the key a declared name is looked up by, never
+ * printed:
+ *
+ * - `loading the attached data`
+ * - `loading the attached data and searching the catalog`
+ * - `loading the attached data and 1 other call`
+ *
+ * `undefined` when no call's tool declared a name: the caller then says what
+ * it always said — the registered name is never the fallback.
+ *
+ * @example
+ * ```ts
+ * namedCalls(
+ *   [{ toolCallId: 'c1', toolName: 'load_attachment' }, { toolCallId: 'c2', toolName: 'list_runs' }],
+ *   0,
+ *   (tool) => (tool === 'load_attachment' ? 'loading the attached data' : undefined),
+ * ); // 'loading the attached data and 1 other call'
+ * ```
+ */
+export function namedCalls(calls, alsoUnnamed, displayNameOf) {
+    const named = [];
+    let rest = alsoUnnamed;
+    for (const call of calls) {
+        const words = displayNameOf(call.toolName);
+        if (words === undefined)
+            rest += 1;
+        else if (named.includes(words))
+            continue;
+        else if (named.length < MAX_NAMED_CALLS)
+            named.push(words);
+        else
+            rest += 1;
+    }
+    if (named.length === 0)
+        return undefined;
+    const parts = rest > 0 ? [...named, `${rest} other ${rest === 1 ? 'call' : 'calls'}`] : named;
+    return parts.length === 1
+        ? parts[0]
+        : `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`;
+}
+//# sourceMappingURL=displayName.js.map

package/dist/esm/lib/displayName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayName.js","sourceRoot":"","sources":["../../../src/lib/displayName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,kGAAkG;AAClG,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAc;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,CACL,GAAG,KAAK,4EAA4E;YACpF,oCACE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAC7D,gBAAgB;YAChB,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACzC,OAAO,GAAG,KAAK,OAAO,IAAI,CAAC,MAAM,6BAA6B,sBAAsB,GAAG,CAAC;IAC1F,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,kBAAkB,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,SAAS;QAC3D,CAAC,CAAE,KAAgB,CAAC,IAAI,EAAE;QAC1B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,UAAU,CACxB,KAA+C,EAC/C,WAAmB,EACnB,aAAuD;IAEvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,WAAW,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,IAAI,CAAC,CAAC;aAC9B,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;aACpC,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YACtD,IAAI,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,IAAI,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9F,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACV,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/esm/mcp/callLifetime.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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`).
+ */
+import type { RequestLedger } from './requestLedger.js';
+/** A call that has been opened: the signal its SDK request runs under, and how to close it. */
+export interface OpenCall {
+    /** What cancels the SDK request — absent when nothing can. */
+    readonly signal?: AbortSignal;
+    /** The call settled: undo the link, cut a series still sending, check the ticket was bound. */
+    close(): void;
+}
+/**
+ * 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.
+ */
+export declare function openCall(params: object, ctx: unknown, clientSignal: AbortSignal | undefined, ledger: RequestLedger | undefined, server: string): OpenCall;

package/dist/esm/mcp/callLifetime.js

@@ -0,0 +1,99 @@
+/**
+ * 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`).
+ */
+import { isDevMode } from 'footprintjs';
+import { eitherSignal, linkedController } from '../lib/abort.js';
+import { requestEvidenceOf } from '../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.
+ */
+export function openCall(params, ctx, clientSignal, ledger, server) {
+    const own = signalOf(ctx);
+    const link = own === undefined ? undefined : linkedController(own, clientSignal);
+    const signal = link?.controller.signal ?? clientSignal;
+    const sink = ledger === undefined ? undefined : requestEvidenceOf(ctx);
+    const settled = sink === undefined ? undefined : new AbortController();
+    const ticket = sink === undefined
+        ? undefined
+        : { sink, signal: 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);
+            }
+        },
+    };
+}
+/** 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 (!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/esm/mcp/callLifetime.js.map

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

package/dist/esm/mcp/mcpClient.d.ts

@@ -33,7 +33,10 @@
  *          `agentfootprint.stream.tool_start` / `tool_end` events
  *          when the agent calls them. Add `name: '<mcp-server>'` to
  *          `McpClientOptions` so observability surfaces can group
- *          tool calls by server.
+ *          tool calls by server. On a transport this module builds,
+ *          a call the agent dispatched also gets its request's retry
+ *          series as `agentfootprint.tools.request_attempts`, filed by
+ *          the series through the call's own port (`requestLedger.ts`).
  *
  * Lazy-require pattern: the `@modelcontextprotocol/sdk` peer-dep
  * loads only when a consumer actually constructs a client. Tests

package/dist/esm/mcp/mcpClient.js

@@ -33,7 +33,10 @@
  *          `agentfootprint.stream.tool_start` / `tool_end` events
  *          when the agent calls them. Add `name: '<mcp-server>'` to
  *          `McpClientOptions` so observability surfaces can group
- *          tool calls by server.
+ *          tool calls by server. On a transport this module builds,
+ *          a call the agent dispatched also gets its request's retry
+ *          series as `agentfootprint.tools.request_attempts`, filed by
+ *          the series through the call's own port (`requestLedger.ts`).
  *
  * Lazy-require pattern: the `@modelcontextprotocol/sdk` peer-dep
  * loads only when a consumer actually constructs a client. Tests
@@ -42,7 +45,9 @@
 import { callMetaOf, readToolExtras } from './toolExtras.js';
 import { readToolResult, resultModeOf } from './toolResult.js';
 import { createVendingFetch } from './gatewayTransport.js';
-import { retryingFetch } from './throttleRetry.js';
+import { ledgeredFetch, retryingFetch } from './throttleRetry.js';
+import { RequestLedger } from './requestLedger.js';
+import { openCall } from './callLifetime.js';
 import { refuseConflictingOptions } from './connectionRefusals.js';
 import { sdkLoadFailure } from './sdkLoadFailure.js';
 import { transportUrl } from './transportUrl.js';
@@ -82,7 +87,7 @@ export async function mcpClient(opts) {
     // Before anything connects: an option that names a behaviour which cannot
     // happen on the chosen arm is a defect, not a preference.
     refuseConflictingOptions(opts, name);
-    const connection = await openConnection(opts);
+    const { connection, ledger } = await openConnection(opts);
     // Tool cache so consumers calling `.tools()` more than once don't
     // hammer the server. `.refresh()` invalidates it.
     let cache = null;
@@ -98,7 +103,7 @@ export async function mcpClient(opts) {
         const listed = opts.signal
             ? await connection.listTools(undefined, { signal: opts.signal })
             : await connection.listTools();
-        return listed.tools.map((t) => wrapMcpTool(name, connection, t, opts.signal, resultMode));
+        return listed.tools.map((t) => wrapMcpTool(name, connection, t, opts.signal, resultMode, ledger));
     };
     return {
         name,
@@ -122,19 +127,20 @@ export async function mcpClient(opts) {
         },
     };
 }
-// ─── Getting a connection ──────────────────────────────────────────
 /**
  * The one funnel every arm passes through, in precedence order: a connection
  * you handed over, the internal test seam, then the library building one.
+ * Only the last has a ledger: a connection built elsewhere has no retry series
+ * of ours to file a call's attempts.
  *
  * A call with neither `connection` nor `sdk` reaches `resolveClient` with two
  * `undefined` arguments and takes the identical path it always took.
  */
 async function openConnection(opts) {
     if (opts.connection !== undefined)
-        return opts.connection;
+        return { connection: opts.connection };
     if (opts._client !== undefined)
-        return opts._client;
+        return { connection: opts._client };
     // `refuseConflictingOptions` has already refused the case where this is
     // absent, so the assertion documents that guarantee rather than assuming it.
     const transport = opts.transport;
@@ -148,13 +154,13 @@ async function resolveClient(transport, clientInfo, signal, retryOnThrottle, sdk
     const client = new mod.Client(clientInfo ?? DEFAULT_CLIENT_INFO, {
         capabilities: {},
     });
-    const transportImpl = await buildTransport(transport, retryOnThrottle, sdk);
+    const built = await buildTransport(transport, retryOnThrottle, sdk);
     // Same rule as callTool: options ride beside the transport, never inside it.
     if (signal)
-        await client.connect(transportImpl, { signal });
+        await client.connect(built.transport, { signal });
     else
-        await client.connect(transportImpl);
-    return client;
+        await client.connect(built.transport);
+    return { connection: client, ...(built.ledger !== undefined && { ledger: built.ledger }) };
 }
 /**
  * An injected `sdk` is checked before anything is built, so a wrong import (a
@@ -218,12 +224,15 @@ async function buildTransport(t, retryOnThrottle, sdk) {
                     "reach the server over `transport: { transport: 'http', url }` instead.",
             }));
         }
-        return new stdioMod.StdioClientTransport({
-            command: t.command,
-            args: t.args ? [...t.args] : [],
-            ...(t.env && { env: { ...t.env } }),
-            ...(t.cwd !== undefined && { cwd: t.cwd }),
-        });
+        // No fetch, so no retry series: a stdio call has no attempts to file.
+        return {
+            transport: new stdioMod.StdioClientTransport({
+                command: t.command,
+                args: t.args ? [...t.args] : [],
+                ...(t.env && { env: { ...t.env } }),
+                ...(t.cwd !== undefined && { cwd: t.cwd }),
+            }),
+        };
     }
     // http + gateway transports both ride Streamable HTTP. They differ only in
     // WHEN the auth headers are decided: `http` fixes them at construction,
@@ -237,6 +246,12 @@ async function buildTransport(t, retryOnThrottle, sdk) {
     // did before 8.11.0. A transport fetch that already runs a retry series of
     // its own (AgentCore Runtime's) is never wrapped: `retryingFetch` joins the
     // 429 rule to that series, so one call is one series.
+    //
+    // The ledger joins the same series, so each request a dispatched tool call
+    // sends files its attempts into that call's run; the transport's `send` is
+    // watched to bind each request to its call (`requestLedger.ts`). A fetch that
+    // runs no series (retry off) gets no ledger: there is nothing to file.
+    const ledger = new RequestLedger();
     if (t.transport === 'gateway') {
         // The consumer's own `fetch` (9.32.0) goes UNDERNEATH the vending, not
         // beside it: `createVendingFetch` resolves the credential, applies it to
@@ -245,19 +260,34 @@ async function buildTransport(t, retryOnThrottle, sdk) {
         // credential is still vended per request. Passing `undefined` is the
         // default global `fetch`, which is byte-identical to every release before
         // the seam existed.
-        return new httpMod.StreamableHTTPClientTransport(transportUrl(t.url, 'mcpClient'), {
-            fetch: retryingFetch(createVendingFetch(t, t.fetch), retryOnThrottle),
-        });
+        const gatewayFetch = retryingFetch(createVendingFetch(t, t.fetch), retryOnThrottle);
+        const ledgered = gatewayFetch && ledgeredFetch(gatewayFetch, ledger);
+        return watched(new httpMod.StreamableHTTPClientTransport(transportUrl(t.url, 'mcpClient'), {
+            fetch: ledgered ?? gatewayFetch,
+        }), ledgered && ledger);
     }
     // Both options ride the SAME SDK transport, and both are forwarded when both
     // are given. The SDK folds `requestInit.headers` into the `init.headers` it
     // hands the custom fetch, so a signer sees the static headers and has the
     // final word over the bytes — see `McpHttpTransport.fetch`.
     const httpFetch = retryingFetch(t.fetch, retryOnThrottle);
-    return new httpMod.StreamableHTTPClientTransport(transportUrl(t.url, 'mcpClient'), {
+    const ledgered = httpFetch && ledgeredFetch(httpFetch, ledger);
+    const fetch = ledgered ?? httpFetch;
+    return watched(new httpMod.StreamableHTTPClientTransport(transportUrl(t.url, 'mcpClient'), {
         ...(t.headers && { requestInit: { headers: { ...t.headers } } }),
-        ...(httpFetch && { fetch: httpFetch }),
-    });
+        ...(fetch && { fetch }),
+    }), ledgered && ledger);
+}
+/**
+ * `transport` with its sends watched by `ledger` — the SAME object, its own
+ * `send` installed in place. As it is, with no ledger, when there is none or it
+ * cannot be watched: then no call expects its attempts filed.
+ */
+function watched(transport, ledger) {
+    if (ledger === undefined || transport === null || typeof transport !== 'object') {
+        return { transport };
+    }
+    return ledger.watch(transport) === undefined ? { transport } : { transport, ledger };
 }
 /** The Node loader path for Streamable HTTP — reached only with no `sdk`. */
 function loadHttpModule(transport) {
@@ -277,7 +307,7 @@ function loadHttpModule(transport) {
     }
 }
 // ─── Tool wrapping ─────────────────────────────────────────────────
-function wrapMcpTool(serverName, connection, mcp, signal, resultMode) {
+function wrapMcpTool(serverName, connection, mcp, signal, resultMode, ledger) {
     const tool = {
         schema: {
             name: mcp.name,
@@ -318,10 +348,22 @@ function wrapMcpTool(serverName, connection, mcp, signal, resultMode) {
                 arguments: argsObj,
                 ...(ctx?.time !== undefined && { _meta: callMetaOf(ctx.time) }),
             };
-            const result = signal
-                ? await connection.callTool(params, undefined, { signal })
-                : await connection.callTool(params);
-            return readToolResult(result, mcp.name, serverName, resultMode);
+            // The call's lifetime (`callLifetime.ts`): its context's signal and the
+            // client's cancel the SDK request while it runs; a call the agent
+            // dispatched issues a ticket keyed by THIS params object — the one the
+            // SDK hands the transport — so the retry series that sends it files its
+            // attempts into the call's run; and however the call settles, a series
+            // still sending is cut, inside the call. Nothing is added to the request.
+            const call = openCall(params, ctx, signal, ledger, serverName);
+            try {
+                const result = call.signal
+                    ? await connection.callTool(params, undefined, { signal: call.signal })
+                    : await connection.callTool(params);
+                return readToolResult(result, mcp.name, serverName, resultMode);
+            }
+            finally {
+                call.close();
+            }
         },
     };
     return tool;

package/dist/esm/mcp/mcpClient.js.map

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

package/dist/esm/mcp/requestLedger.d.ts

@@ -0,0 +1,97 @@
+/**
+ * requestLedger — which dispatched tool call an MCP request belongs to, so the
+ * retry series that sends it files its attempts into THAT call's run; and when
+ * the MCP SDK cancels a request, so the series sending it stops.
+ *
+ * Pattern: a per-connection ledger + the SDK transport's `send`, watched in place.
+ * Role:    The middle of the evidence seam (`tools/requestEvidence.ts` is its
+ *          door). The retry series runs inside the transport's `fetch`, which
+ *          the MCP SDK calls with a serialized body and nothing else — no tool
+ *          call, no run. Three hops carry the call down to it, each by an
+ *          identity the hop already holds:
+ *
+ *   1. call → params    `issue`: the MCP tool keys its ticket by the request's
+ *                       params OBJECT. The SDK puts that very object into the
+ *                       JSON-RPC message it hands the transport.
+ *   2. params → id      the watched `send` finds the ticket by `message.params`
+ *                       and keys it by the JSON-RPC `id` the SDK assigned, until
+ *                       that send settles.
+ *   3. id → series      `claim`: the series reads the `id` back out of the body
+ *                       it is about to send.
+ *
+ * CANCELLATION DOES NOT WAIT ON ATTRIBUTION. Every `tools/call` in flight gets
+ * an entry, ticket or not, and the SDK says when it gives a request up: it sends
+ * `notifications/cancelled` naming the request's id — on its own timeout, or
+ * when the call's signal fires — through this same `send`. The ledger aborts
+ * that request's series there and then, so a request nobody waits for is never
+ * asked again, even when its params could not be matched to a call.
+ *
+ * Nothing is added to the wire: the request the server receives is
+ * byte-identical, and the SDK's own options keep their meanings. Ids are the
+ * client's, one ledger per connection, so concurrent calls — and concurrent
+ * runs sharing one client — can never claim each other's request. A request
+ * that is not a `tools/call` (a `tools/list`, a notification, a response)
+ * claims nothing.
+ *
+ * `send` is installed as an OWN property of the transport instance — the same
+ * object, its own `send` bound to it, so a transport class with `#private`
+ * fields works as it always did. Assigning `send` again afterwards THROWS: a
+ * send that bypassed the ledger would quietly lose every call's attempts.
+ *
+ * What it does NOT do: retry, wait, or decide anything. The series is the one
+ * retry owner; this only tells it whose attempts it is making, and when the SDK
+ * has stopped waiting for them.
+ */
+import type { RequestEvidenceSink } from '../tools/requestEvidence.js';
+/** One call's claim on the request it sends. */
+export interface RequestTicket {
+    /** Where the request's attempts are filed. */
+    readonly sink: RequestEvidenceSink;
+    /** What cancels the call's series — the call's own signal, the client's, the call settling. */
+    readonly signal?: AbortSignal;
+}
+/** What a series claims for the `tools/call` request it sends. */
+export interface ClaimedRequest {
+    /** The ticket a dispatched call issued for this request — absent when none was matched. */
+    readonly ticket?: RequestTicket;
+    /** Fires when the MCP SDK cancels this request (`notifications/cancelled`). */
+    readonly cancelled: AbortSignal;
+}
+/** Per connection: the tickets issued and not yet sent, and the requests being sent. */
+export declare class RequestLedger {
+    /** Issued, not yet sent — keyed by the request's params object. Collected with it. */
+    private readonly issued;
+    /** Tickets a request was bound to. */
+    private readonly bound;
+    /** Every `tools/call` sent and not yet settled — keyed by its JSON-RPC id. */
+    private readonly sending;
+    private calls;
+    private unboundNamed;
+    /** The call about to send `params` files its attempts through `ticket`. */
+    issue(params: object, ticket: RequestTicket): void;
+    /** Whether a request the transport sent was bound to `ticket`. */
+    wasBound(ticket: RequestTicket): boolean;
+    /** How many `tools/call` requests the watched transport has sent — matched to a call or not. */
+    get toolCallsSent(): number;
+    /** `true` the first time it is asked, then never again: an unmatched request is named once per connection. */
+    firstUnbound(): boolean;
+    /**
+     * Watch `transport`'s `send`: install a wrapped `send` as its OWN property, the
+     * original bound to the instance itself. Returns the SAME object — or
+     * `undefined` when it has no `send` to watch or refuses the property, and
+     * then nothing is watched and no call should expect its attempts filed.
+     */
+    watch<T extends object>(transport: T): T | undefined;
+    /**
+     * The `tools/call` request `body` carries, while its send runs — its ticket
+     * when a call issued one, and the signal its cancellation fires. `undefined`
+     * for any other body. Parses only while some request is being sent.
+     */
+    claim(body: unknown): ClaimedRequest | undefined;
+    /** One message through the watched transport. */
+    private send;
+    /** Register a `tools/call` in flight, with the ticket its params were issued — if any. */
+    private bind;
+    /** The SDK gave a request up: stop the series still sending it. */
+    private cancelIfAsked;
+}