agentfootprint 12.0.1 → 12.2.0

package/dist/types/mcp/pool/work.d.ts

@@ -0,0 +1,117 @@
+/**
+ * work — an admitted operation's charge, and the work under it until that work
+ * has settled.
+ *
+ * Pattern: one object per unit of work that is at once the request guard
+ *          (`mcp/requestGuard.ts`) and the count of what is still running.
+ * Role:    The pool's third budget (`docs/design/2026-10-mcp-client-pool.md`
+ *          § 5.3). The accounting unit is the admitted LOGICAL operation: a
+ *          `tools/call`, a listing (one `list(ctx)` for one conversation), an
+ *          `acquire` and an ending each take one slot at admission. Setup an
+ *          operation performs for itself — the open of its key's client, the
+ *          revalidating `tools/list` of a replacement — runs inside that slot.
+ *
+ * AN ABORT IS NOT SETTLEMENT. A slot is released only when the operation's
+ * logical request has its answer AND every piece of work under it has settled:
+ * the `send()` it made, a credential vend, an attempt's `fetch`, an AWS `send`,
+ * the open it owns. A caller's timeout answers the caller; it frees nothing.
+ * Work that never settles keeps its charge — `stats().unsettled` reports it,
+ * and the budget refuses new work rather than admit it against room that does
+ * not exist. There is no release that returns capacity sooner.
+ */
+import type { RequestGuard } from '../requestGuard.js';
+/** What a unit of work is doing now — what `stats().unsettled` counts it under. */
+export type WorkKind = 'open' | 'listing' | 'call' | 'ending';
+/** What an operation is, as the budget admits it. */
+export type OperationKind = 'listing' | 'call' | 'acquire' | 'ending';
+/** What a request's answer proved, as the pool's fetch read it (`pool.ts`). */
+export type WorkEvidence = 'server-404' | 'handle-lost';
+/**
+ * One unit of pooled work: its requests are checked against it at every
+ * boundary (`check`), and every promise started for it is counted until it
+ * settles (`track`). It is SETTLED once its logical part has finished and the
+ * count is zero.
+ */
+export declare class Work implements RequestGuard {
+    /** What it is doing now. */
+    phase: WorkKind;
+    private readonly link;
+    private pending;
+    private finished;
+    private done;
+    /** Still running underneath when the caller was answered: it lingered. */
+    private lingered;
+    private readonly listeners;
+    /** What `check` asks besides the abort — a call's binding. */
+    private extra;
+    /** What the latest answered request proved, if anything. */
+    evidence: WorkEvidence | undefined;
+    constructor(
+    /** What it is doing now. */
+    phase: WorkKind, sources: readonly (AbortSignal | undefined)[]);
+    /** What aborts its own work: its sources, its deadline, its caller detaching. */
+    get signal(): AbortSignal;
+    /** True once its logical part finished and everything under it settled. */
+    get settled(): boolean;
+    /** Its caller was answered while work under it still ran. */
+    get unsettledPastAnswer(): boolean;
+    /** Abort its work with `reason` (a deadline, a detached caller). Idempotent. */
+    abort(reason: unknown): void;
+    /** Ask `gate` too, each time a request is checked. */
+    guardWith(gate: () => void): void;
+    /**
+     * The send gate: refused once its caller was answered (nothing more is sent
+     * for an answered operation), once aborted, or when the extra gate refuses.
+     */
+    check(): void;
+    /** Count `work` until it settles. Never throws; never surfaces its rejection. */
+    track(work: PromiseLike<unknown>): void;
+    /** Record what a request's answer proved. */
+    note(evidence: WorkEvidence): void;
+    /**
+     * Its logical part is over: the caller has its answer. It settles now, or —
+     * when work under it still runs — when that work does.
+     */
+    finish(): void;
+    /** Did it linger — answered while work under it ran? Read once it settled. */
+    get settledLate(): boolean;
+    /** Call `listener` once it has settled (at once when it already has). */
+    onSettled(listener: () => void): void;
+    /** A promise that resolves once it has settled. */
+    whenSettled(): Promise<void>;
+    private settleIfDone;
+}
+/** An admitted operation: a unit of work that holds one slot of the budget. */
+export declare class Operation extends Work {
+    readonly kind: OperationKind;
+    /** When it was admitted, on the pool's clock. */
+    readonly admittedAt: number;
+    constructor(kind: OperationKind, phase: WorkKind, sources: readonly (AbortSignal | undefined)[], 
+    /** When it was admitted, on the pool's clock. */
+    admittedAt: number);
+}
+/**
+ * The pool-wide operation budget: at most `max` operations charged, each from
+ * its admission until it has SETTLED (see the module note). Admission is the
+ * only way in; settlement the only way out.
+ */
+export declare class OperationBudget {
+    readonly max: number;
+    private readonly charged;
+    private readonly onRelease;
+    constructor(max: number);
+    /** Operations charged now. */
+    get count(): number;
+    /** Is there a free slot? */
+    get hasRoom(): boolean;
+    /**
+     * Admit one operation, or `undefined` when the budget is full. The slot is
+     * charged from here until the operation settles.
+     */
+    admit(kind: OperationKind, phase: WorkKind, sources: readonly (AbortSignal | undefined)[], now: number): Operation | undefined;
+    /** Call `listener` each time an operation settles and frees its slot. Returns the unsubscribe. */
+    whenReleased(listener: (operation: Operation) => void): () => void;
+    /** Charged work whose caller was already answered and which has not settled, by what it is doing. */
+    unsettled(): Record<WorkKind, number>;
+}
+//# sourceMappingURL=work.d.ts.map

package/dist/types/mcp/pool/work.d.ts.map

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

package/dist/types/mcp/requestGuard.d.ts

@@ -0,0 +1,71 @@
+/**
+ * requestGuard — the last check a pooled operation's request meets at every
+ * boundary the library controls, and the count of the work under it until
+ * that work has settled.
+ *
+ * Pattern: one object per operation, carried on the request's `init` under a
+ *          library-private symbol.
+ * Role:    The send gate of the MCP client pool (`mcp/pool/`). The MCP SDK and
+ *          the transport wait between a tool call and the network — `send()`
+ *          awaits its own headers, a gateway vends a credential inside `fetch`,
+ *          the AWS SDK signs inside `send` — so the last check cannot live in
+ *          the tool. Each place that waits asks the request's guard after its
+ *          wait and before it hands the request on:
+ *
+ *   - the watched `send` (`requestLedger.ts`) — the last boundary on stdio,
+ *     whose `send` writes without waiting;
+ *   - the pool's own fetch, before the request enters the transport;
+ *   - the retry series, before every attempt (`throttleRetry.ts`);
+ *   - the vending fetch, once the credential has arrived (`gatewayTransport.ts`);
+ *   - the AWS SDK command, after it is signed and before its request handler
+ *     sends it (`adapters/mcp/agentcoreRuntime/invoke.ts`).
+ *
+ * A refusal there sends nothing. What no guard can recall is a request already
+ * handed on: to the network, or to an app's own `fetch`.
+ *
+ * The same object COUNTS the work under the request: every promise a boundary
+ * starts for it — an attempt's `fetch`, a credential vend, an AWS `send` — is
+ * tracked until it settles, whatever the caller was told. An abort is a
+ * signal, not proof that the work stopped, so the pool keeps an operation
+ * charged until this count says it has.
+ *
+ * The guard rides `init` under a symbol, so a layer that rebuilds `init` with
+ * a spread (`{ ...init, headers }`) carries it on, and nothing reaches the
+ * wire: `fetch` reads only the fields it knows. A request with no guard — every
+ * request of a client the pool did not build — is exactly what it always was.
+ */
+/** @internal The `init` key a pooled request's guard rides under. */
+export declare const REQUEST_GUARD: unique symbol;
+/** What one pooled operation's requests are checked against, and counted by. */
+export interface RequestGuard {
+    /**
+     * Throw the refusal when the request may not be handed on now — its binding
+     * went stale, or its operation was aborted or ran out of time. Synchronous:
+     * nothing waits between this check and the hand-off it guards.
+     */
+    check(): void;
+    /** Count `work` as work under this request until it settles. Never throws. */
+    track(work: PromiseLike<unknown>): void;
+    /** What aborts the operation's own work — linked into each request it makes. */
+    readonly signal?: AbortSignal;
+}
+/** The guard `init` carries, or `undefined` — a request no pool sent. Never throws. */
+export declare function guardOf(init: RequestInit | undefined): RequestGuard | undefined;
+/** `init` carrying `guard`: a new object, every other field in place. */
+export declare function withGuard(init: RequestInit | undefined, guard: RequestGuard): RequestInit;
+/**
+ * Track `work` under `init`'s guard, when it has one, and hand `work` back
+ * unchanged. The one line every boundary uses.
+ */
+export declare function trackedBy<T extends PromiseLike<unknown>>(init: RequestInit | undefined, work: T): T;
+/**
+ * @internal The call-context key a pooled tool hands its guard down under, to
+ * the MCP tool it runs (`callLifetime.ts` · `openCall` issues the call with
+ * it). Enumerable, so a wrapper that copies the context keeps it.
+ */
+export declare const CALL_GUARD: unique symbol;
+/** `ctx` carrying `guard` for the MCP tool it is handed to. */
+export declare function withCallGuard<C extends object>(ctx: C, guard: RequestGuard): C;
+/** The guard a call's context carries, or `undefined`. Never throws, whatever `ctx` is. */
+export declare function callGuardOf(ctx: unknown): RequestGuard | undefined;
+//# sourceMappingURL=requestGuard.d.ts.map

package/dist/types/mcp/requestGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestGuard.d.ts","sourceRoot":"","sources":["../../../src/mcp/requestGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,OAAO,MAAmD,CAAC;AAEvF,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IACd,8EAA8E;IAC9E,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAKD,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAa/E;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,WAAW,CAEzF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,WAAW,CAAC,OAAO,CAAC,EACtD,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,IAAI,EAAE,CAAC,GACN,CAAC,CAGH;AAID;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,MAAgD,CAAC;AAEjF,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,CAE9E;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAalE"}

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

@@ -67,6 +67,7 @@
  * has stopped waiting for them.
  */
 import type { RequestEvidenceSink } from '../tools/requestEvidence.js';
+import type { RequestGuard } from './requestGuard.js';
 import { RequestReplay } from './replay.js';
 /** One call's claim on the request it sends. */
 export interface RequestTicket {
@@ -83,6 +84,11 @@ export interface ClaimedRequest {
     readonly cancelled: AbortSignal;
     /** What this request's series and its call share (`replay.ts` · `RequestReplay`). */
     readonly replay: RequestReplay;
+    /**
+     * The send gate of the pooled call this request belongs to (`requestGuard.ts`)
+     * — absent for a call no pool made.
+     */
+    readonly guard?: RequestGuard;
 }
 /** How a connection's ledger is set up. */
 export interface RequestLedgerOptions {
@@ -90,6 +96,16 @@ export interface RequestLedgerOptions {
     readonly server: string;
     /** The `'app-authorized'` policy is in force: see the module note. */
     readonly strict: boolean;
+    /**
+     * A pooled client's guard for every message that does not carry its own — its
+     * open, its listing, its ending (`mcp/pool/`) — and for a `tools/call` that
+     * reached `send` without a call carrying a guard: the pool answers that one
+     * with a guard that refuses it, so a pooled request is never sent unchecked,
+     * under either replay policy. A request it guards is checked before it is
+     * sent, and every message's send is counted under it. Absent for a client no
+     * pool built.
+     */
+    readonly guardFor?: (message: unknown) => RequestGuard | undefined;
 }
 type JsonRpcId = string | number;
 /** The request a call's marker was matched to. */
@@ -105,6 +121,8 @@ export interface MatchedRequest {
 export interface IssuedCall {
     readonly marker: string;
     readonly ticket?: RequestTicket;
+    /** The pooled call's send gate, when a pool made the call (`requestGuard.ts`). */
+    readonly guard?: RequestGuard;
     /** Set once, by the watched `send`: a marker matches ONE request. */
     readonly request?: MatchedRequest;
 }
@@ -117,6 +135,12 @@ export declare class RequestLedger {
     private readonly sending;
     /** Matched requests whose JSON-RPC answer is awaited (`strict` only) — by id. */
     private readonly awaiting;
+    /**
+     * A pooled call's guard by its request's id, until the call settles: the SDK's
+     * `notifications/cancelled` for that request is work started for the call, and
+     * is counted under it (`requestGuard.ts`).
+     */
+    private readonly guards;
     private initializeId;
     private initializeAnswered;
     private markers;
@@ -129,7 +153,7 @@ export declare class RequestLedger {
      * is where its attempts are filed, when the call carries the run's evidence
      * port.
      */
-    issue(ticket?: RequestTicket): IssuedCall;
+    issue(ticket?: RequestTicket, guard?: RequestGuard): IssuedCall;
     /** `call` settled: forget it, and stop awaiting its request's answer. */
     settle(call: IssuedCall): void;
     /** The connection closed: nothing it sent is awaited, and no call is pending, any more. */
@@ -172,6 +196,16 @@ export declare class RequestLedger {
     claim(body: unknown): ClaimedRequest | undefined;
     /** One message through the watched transport. */
     private send;
+    /**
+     * Any message but a `tools/call`: sent as it always was — unless a pool
+     * guards it (`guardFor`), and then a REQUEST is checked first and refused
+     * unsent, and every message's send is counted under the guard.
+     * Notifications are never refused: a `notifications/cancelled` is the
+     * courtesy that tells the server to stop.
+     */
+    private sendOther;
+    /** The guard of the pooled call a `notifications/cancelled` names, if any. */
+    private cancelledGuard;
     /** The `initialize` request: its answer is the one that proves the observer is in place. */
     private noteInitialize;
     /** The SDK gave a request up: stop the series still sending it, and stop awaiting its answer. */

package/dist/types/mcp/requestLedger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestLedger.d.ts","sourceRoot":"","sources":["../../../src/mcp/requestLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAIjC,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAqBD,0GAA0G;AAC1G,qBAAa,aAAa;IAaZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,YAAY,CAAS;gBAEA,OAAO,GAAE,oBAA8B;IAEpE;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU;IAUzC,yEAAyE;IACzE,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAQ9B,2FAA2F;IAC3F,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,gGAAgG;IAChG,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,8GAA8G;IAC9G,YAAY,IAAI,OAAO;IAMvB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAyBpD,4FAA4F;IAC5F,OAAO,CAAC,aAAa;IAcrB,0FAA0F;IAC1F,OAAO,CAAC,OAAO;IAUf;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS;IAkBhD,iDAAiD;IACjD,OAAO,CAAC,IAAI;IA0CZ,4FAA4F;IAC5F,OAAO,CAAC,cAAc;IAQtB,iGAAiG;IACjG,OAAO,CAAC,aAAa;CAStB"}
+{"version":3,"file":"requestLedger.d.ts","sourceRoot":"","sources":["../../../src/mcp/requestLedger.ts"],"names":[],"mappings":"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"}

package/dist/types/mcp/seriesEvidence.d.ts

@@ -119,11 +119,13 @@ export declare class SeriesEvidence {
     /**
      * The series delivered a response. It is the last attempt's — an answer, or a
      * refusal it will not ask again after. A refusal it MEANT to ask again after
-     * is delivered when the deadline lands inside the wait: the runner's wait
-     * ends early, the series stops, and the end says so (`no-time-left`, during
-     * the `wait`). Filed when the call has read it.
+     * is delivered when the series stopped inside the wait: the deadline landed
+     * there (`no-time-left`), or a pooled call's send gate refused the next
+     * attempt before it was sent (`stoppedBy`, `not-permitted`). The end says
+     * which, during the `wait`; the attempt that was never sent has no row.
+     * Filed when the call has read it.
      */
-    delivered(): void;
+    delivered(stoppedBy?: DeclineReason): void;
     /**
      * The series threw. The end is the last attempt's when that attempt ended it
      * (a failure, a timed-out request). The rest is defensive — footprintjs 10.6's
@@ -131,9 +133,11 @@ export declare class SeriesEvidence {
      * as one: a deadline that had passed before the first request (`timed-out`,
      * no `during`, nothing sent) or one a future runner reports from inside a wait
      * (`during: 'wait'`); anything else is filed as a failure the record cannot
-     * account for, so a request is never left unfiled. Filed when the call settles.
+     * account for, so a request is never left unfiled. A pooled call's send gate
+     * that refused the next attempt before it was sent ends it as `stoppedBy`,
+     * during the `wait`. Filed when the call settles.
      */
-    threw(outOfTime: boolean): void;
+    threw(outOfTime: boolean, stoppedBy?: DeclineReason): void;
     private add;
     /**
      * File `end` once the call has settled — its verdict is what says whether an

package/dist/types/mcp/seriesEvidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seriesEvidence.d.ts","sourceRoot":"","sources":["../../../src/mcp/seriesEvidence.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"seriesEvidence.d.ts","sourceRoot":"","sources":["../../../src/mcp/seriesEvidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAGjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAElE,0FAA0F;AAC1F,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;AAExE,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC;QAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnG;AAED,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,OAAO,CACjC,iBAAiB,EACf,WAAW,GACX,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,qBAAqB,CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAOD,2EAA2E;AAC3E,qBAAa,cAAc;IAYvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAb9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAiC;gBAG5B,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,YAAY,EACnB,UAAU,CAAC,wBAAY;IAG1C,+EAA+E;IAC/E,OAAO,CACL,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,QAAQ,CAAC,EAAE,aAAa,EACxB,KAAK,CAAC,EAAE,YAAY,GACnB,IAAI;IASP;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAajD;;;;;OAKG;IACH,SAAS,IAAI,IAAI;IAajB;;;;;;;;OAQG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI;IAa1C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI;IAwB1D,OAAO,CAAC,GAAG;IAOX;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,IAAI;IAsBZ;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAQrB;AAcD,wEAAwE;AACxE,wBAAgB,KAAK,CACnB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,QAAQ,CAAC,EAAE,aAAa,GACvB,kBAAkB,CAqBpB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,YAAY,GAAG,SAAS,GAC9B,kBAAkB,CASpB"}

package/dist/types/mcp/terminate.d.ts

@@ -0,0 +1,95 @@
+/**
+ * terminate — ending a client's remote session, and saying what the remote side
+ * answered.
+ *
+ * Pattern: a pass-through `fetch` that reads one status + one bounded procedure.
+ * Role:    `McpClient.terminate()` (`mcpClient.ts`). The MCP SDK's
+ *          `StreamableHTTPClientTransport.close()` only aborts the requests in
+ *          flight; `terminateSession()` is the one method that sends the
+ *          Streamable HTTP `DELETE` carrying `Mcp-Session-Id`. It treats a 405
+ *          as success, so the status is read here, by a pass-through `fetch`
+ *          the library installs on every transport it builds — it changes no
+ *          request and reads only a `DELETE`'s answer.
+ *
+ * The procedure, at most once per client:
+ *
+ *   1. no session id was ever issued → `'no-session'`, nothing is sent;
+ *   2. otherwise the transport's own `terminateSession()`, bounded by
+ *      `TOOL_TEARDOWN_TIMEOUT_MS` (the tool-session tier's `withTimeout`, shared):
+ *      at the deadline the request is aborted and the outcome is `'timed-out'`;
+ *   3. a local close, whatever happened.
+ *
+ * ONE DEADLINE ANSWERS THE CALLER: the remote answer and the local close are
+ * waited for together for at most `TOOL_TEARDOWN_TIMEOUT_MS` of ELAPSED time,
+ * measured by timers started together at the start — never by reading the wall
+ * clock, so a clock stepped back cannot stretch it. A close that finishes in
+ * time is finished before the caller hears; one that hangs does not hold the
+ * answer. The work's own settlement — the `DELETE`, a `fetch` that ignores its
+ * abort, the close — may come later, and is returned apart (`settled`): the MCP
+ * client pool keeps an ending charged until then. The clock (`now`) only
+ * measures `durationMs`.
+ *
+ * Never vendor-aware: the one port is the Streamable HTTP `DELETE`. A transport
+ * that turns it into something else (AgentCore Runtime's `StopRuntimeSession`)
+ * answers it like a server would.
+ */
+import type { McpClient, McpTerminateOutcome } from './types.js';
+/** An `McpClient` that can end its remote session. */
+export type TerminableMcpClient = McpClient & {
+    terminate(): Promise<McpTerminateOutcome>;
+};
+/**
+ * Can `client` end its remote session? Reads the member, never assumes it —
+ * the feature-detection law (`provider-contract/types.ts` · `canStageCodeInputs`).
+ * True for `mcpClient()` and `mockMcpClient()`; false for a hand-written client
+ * without `terminate`.
+ */
+export declare function canTerminate(client: unknown): client is TerminableMcpClient;
+/** What ending one client came to: the caller's answer, and when the work under it settled. */
+export interface Ending {
+    /** Answers by `TOOL_TEARDOWN_TIMEOUT_MS`. Never rejects. */
+    readonly outcome: Promise<McpTerminateOutcome>;
+    /** Resolves once every piece of work the ending started has settled. Never rejects. */
+    readonly settled: Promise<void>;
+}
+/** The slice of the SDK's Streamable HTTP transport the procedure uses. */
+export interface TerminableTransport {
+    readonly sessionId?: string;
+    terminateSession(): Promise<void>;
+}
+/**
+ * What the pass-through `fetch` saw of a transport's `DELETE` requests: the
+ * status of the latest answer, and the signal it links into each one while an
+ * ending is under way.
+ */
+export declare class DeleteWatch {
+    private status;
+    private cut;
+    /** Arm for one ending: forget the last status, link `cut` into its `DELETE`. */
+    arm(cut: AbortSignal): void;
+    /** The status the latest `DELETE` was answered with, if one was. */
+    get answered(): number | undefined;
+    /**
+     * `inner` (the global `fetch` when `undefined`, looked up at call time),
+     * passed through untouched except that a `DELETE`'s answer status is read and
+     * an armed ending's signal is linked into it.
+     */
+    fetch(inner: ((input: string | URL, init?: RequestInit) => Promise<Response>) | undefined): (input: string | URL, init?: RequestInit) => Promise<Response>;
+}
+/** The outcome for an ending that sent nothing. */
+export declare function outcomeWithout(remote: 'no-session' | 'unavailable', durationMs?: number): McpTerminateOutcome;
+/**
+ * An ending that sends nothing — `remote` says why — only the local close:
+ * the caller is answered when the close finishes or at `timeoutMs`, whichever
+ * comes first; `settled` waits for the close itself.
+ */
+export declare function endLocally(remote: 'no-session' | 'unavailable', close: () => Promise<void>, now?: () => number, timeoutMs?: number): Ending;
+/**
+ * End `transport`'s session, then close locally with `close` — the procedure
+ * in the module note. `watch` is the `DeleteWatch` installed on the transport's
+ * fetch. `now` is the clock the duration is measured with.
+ */
+export declare function endSession(transport: TerminableTransport, watch: DeleteWatch, close: () => Promise<void>, now?: () => number, timeoutMs?: number): Ending;
+/** A failure's class name, never its message. */
+export declare function classOf(error: unknown): string;
+//# sourceMappingURL=terminate.d.ts.map

package/dist/types/mcp/terminate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminate.d.ts","sourceRoot":"","sources":["../../../src/mcp/terminate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AASH,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjE,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG;IAC5C,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,mBAAmB,CAO3E;AAED,+FAA+F;AAC/F,MAAM,WAAW,MAAM;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/C,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,GAAG,CAA0B;IAErC,gFAAgF;IAChF,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAK3B,oEAAoE;IACpE,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;;;OAIG;IACH,KAAK,CACH,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAClF,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC;CAWlE;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,GAAG,aAAa,EACpC,UAAU,SAAI,GACb,mBAAmB,CAErB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,GAAG,aAAa,EACpC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC1B,GAAG,GAAE,MAAM,MAAiB,EAC5B,SAAS,GAAE,MAAiC,GAC3C,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC1B,GAAG,GAAE,MAAM,MAAiB,EAC5B,SAAS,GAAE,MAAiC,GAC3C,MAAM,CA2BR;AAgED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO9C"}

package/dist/types/mcp/throttleRetry.d.ts.map

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

package/dist/types/mcp/toolList.d.ts

@@ -0,0 +1,91 @@
+/**
+ * toolList — every page of a server's `tools/list` answer, or a typed refusal
+ * that says the list is incomplete.
+ *
+ * Pattern: one bounded loop + one typed refusal.
+ * Role:    MCP pages a tool list: a page carries `nextCursor` while the server
+ *          has more, and the next page is asked for with `{ cursor }`. Reading
+ *          only the first page cut a paginating server's catalogue short in
+ *          silence — the agent saw part of it and nothing said so. This reads
+ *          until the server sends no cursor, within a bound, and when it cannot
+ *          finish the list it says why:
+ *
+ *   - `'page-limit'` — the list did not end within {@link MAX_TOOL_LIST_PAGES}
+ *     pages;
+ *   - `'cursor-repeated'` — a page named a cursor this listing already sent, so
+ *     following it would loop.
+ *
+ * The first page is asked exactly as before pagination was followed: no params
+ * (and, with no signal, no arguments at all). The client's signal rides every
+ * page in the SDK's trailing options, and it is checked immediately before each
+ * page is asked for and again when each answer arrives (`lib/abort.ts`): once
+ * it has fired, nothing more is asked for and no page is accepted, the last one
+ * included. An abort is the caller's word, so it wins over an incomplete list.
+ * What it cannot do is settle a page a connection that ignores the signal is
+ * still holding: that promise settles when the connection says.
+ *
+ * Every page request is counted from the moment it is sent until it settles
+ * (`listingGenerations.ts`): the MCP SDK's `Client` replaces its per-tool call
+ * checks with each answer, so a tool's checks depend on which answer is the
+ * latest (`callChecks.ts`).
+ */
+import type { Tool } from '../tools/tools.js';
+import type { ListingGenerations } from './listingGenerations.js';
+import type { McpConnection, McpListedTool } from './types.js';
+/**
+ * The most `tools/list` requests one listing sends. A bound on REQUESTS, not on
+ * the catalogue's size: a page may hold any number of tools. A server that
+ * keeps paging past it is reported as incomplete rather than read without end.
+ */
+export declare const MAX_TOOL_LIST_PAGES = 100;
+/** Why a server's tool list could not be read to its end. */
+export type McpToolListIncompleteReason = 'page-limit' | 'cursor-repeated';
+/** What a listing read: every tool its pages held, how many pages, and whether it ended. */
+export interface ToolListing {
+    readonly tools: readonly McpListedTool[];
+    readonly pages: number;
+    /**
+     * For a list read in ONE answer, the generation that answer settled at: the
+     * MCP SDK's `Client` holds its tools' checks while it stays the latest
+     * (`listingGenerations.ts`). Absent for a paged list: no one answer holds all
+     * of its tools.
+     */
+    readonly generation?: number;
+    /** Absent when the server's list ended: the last page carried no cursor. */
+    readonly incomplete?: McpToolListIncompleteReason;
+}
+/**
+ * Read the server's tool list, page by page, until a page carries no cursor —
+ * or until it cannot be finished, which the result says (`incomplete`).
+ *
+ * @param listings the connection's count of list requests, which every page
+ *   request joins (`listingGenerations.ts`)
+ * @throws the abort, when `signal` has fired before a page is asked for or by
+ *   the time its answer arrives; and whatever the connection rejects a page
+ *   with, as it always did
+ */
+export declare function listEveryPage(connection: McpConnection, signal: AbortSignal | undefined, listings: ListingGenerations): Promise<ToolListing>;
+/**
+ * A server's tool list that could not be read to its end. `tools()` and
+ * `refresh()` reject with it rather than return a list cut short: an agent
+ * handed part of a catalogue cannot know what it was not offered.
+ *
+ * `tools` holds what WAS listed — wrapped and callable, exactly as `tools()`
+ * would have returned them — for a caller that decides to use an incomplete
+ * list knowingly. Names the server, the reason and the count, never a cursor.
+ */
+export declare class McpToolListIncompleteError extends Error {
+    readonly reason: McpToolListIncompleteReason;
+    readonly server: string;
+    /** The pages read before the listing stopped. */
+    readonly pages: number;
+    /** The tools those pages listed, in page order. */
+    readonly tools: readonly Tool[];
+    readonly code: "ERR_MCP_TOOL_LIST_INCOMPLETE";
+    constructor(reason: McpToolListIncompleteReason, server: string, 
+    /** The pages read before the listing stopped. */
+    pages: number, 
+    /** The tools those pages listed, in page order. */
+    tools: readonly Tool[]);
+}
+//# sourceMappingURL=toolList.d.ts.map

package/dist/types/mcp/toolList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolList.d.ts","sourceRoot":"","sources":["../../../src/mcp/toolList.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,6DAA6D;AAC7D,MAAM,MAAM,2BAA2B,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAE3E,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,2BAA2B,CAAC;CACnD;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,aAAa,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CA0BtB;AAwBD;;;;;;;;GAQG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IAIjD,QAAQ,CAAC,MAAM,EAAE,2BAA2B;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE;IARjC,QAAQ,CAAC,IAAI,iCAA2C;gBAG7C,MAAM,EAAE,2BAA2B,EACnC,MAAM,EAAE,MAAM;IACvB,iDAAiD;IACxC,KAAK,EAAE,MAAM;IACtB,mDAAmD;IAC1C,KAAK,EAAE,SAAS,IAAI,EAAE;CASlC"}