agentfootprint 11.1.1 → 11.2.0

package/dist/esm/mcp/throttleRetry.js

@@ -1,5 +1,6 @@
 /**
- * throttleRetry — when an MCP server says "too many requests", wait and ask again.
+ * throttleRetry — when an MCP server refuses a request before running it, wait
+ * and ask again.
  *
  * ── Why this exists ──────────────────────────────────────────────────────────
  * Managed MCP gateways enforce per-principal rate limits. A throttled
@@ -43,25 +44,48 @@
  * that would have died during the wait is simply never the one reused. The
  * gateway secrecy invariant is untouched: each attempt vends, applies, drops.
  *
+ * ── The loop is footprintjs's attempt runner, one series per call ────────────
+ * Each call runs ONE `attempt()` series (footprintjs, used as it ships). Its
+ * runner makes an attempt record per try; they stay inside this module for
+ * now — only `onRetry`, before each wait, reaches a caller. An attempt sends
+ * the request once, and an attempt that got a RESPONSE is not an operation
+ * that succeeded: a 503 is delivered as the answer it was, never retried.
+ * A response a rule's decision recognises is thrown as a refusal that names
+ * its kind, and the policy's `retryOn` accepts those refusals and nothing
+ * else — so a 5xx, a dropped connection or a timeout ends the series on the
+ * attempt it happened in, as it always did. When the
+ * series ends on a refusal (attempts spent, a ceiling reached, no time left),
+ * the refusal's response is delivered as the server sent it: the caller sees
+ * the 429, never an error of ours.
+ *
+ * ── A fetch that already retries is JOINED, never wrapped ────────────────────
+ * A transport whose own fetch runs a series (AgentCore Runtime's session-busy
+ * retry) says how to rebuild itself with one more rule (`joinableRetry`).
+ * `retryingFetch` over such a fetch — what `mcpClient` applies to every http
+ * transport — adds its 429 rule to THAT series instead of starting a second
+ * one around it. One series means one attempt count, one waiting total and one
+ * deadline per call, by construction: the layers can never multiply requests.
+ * The series' FIRST rule holds the call's budget — its `maxAttempts`,
+ * `maxWaitMs` and `maxElapsedMs` bound every attempt and wait, whatever the
+ * reason. A rule that joins keeps its own values as limits on its own kind:
+ * they can stop its retries sooner, never make the call longer.
+ *
+ * ── The wait: a stated one wins, whole ───────────────────────────────────────
+ * Each retry's wait is `statedWaitFirst(retry-after, exponentialBackoff({ …,
+ * maxDelayMs }))`: the server's `Retry-After` when it sent one, else our
+ * jittered backoff, whose CEILING is capped at `maxDelayMs` before the draw
+ * (so capped waits keep their jitter). The cap is on the SCHEDULE only —
+ * never on a stated wait — so the footprintjs policy's `maxBackoffMs`,
+ * which would cut every wait and send the request again before the server
+ * said it may, is left unset. A stated wait too long for `maxWaitMs` or the
+ * deadline is never shortened either: the series stops, and the 429 is
+ * delivered as the server sent it.
+ *
  * Pattern: Decorator over `fetch`. Role: Layer-3 tool transport.
  */
-import { sleep } from '../lib/sleep.js';
-// ─── Defaults ────────────────────────────────────────────────────────
-const DEFAULT_MAX_ATTEMPTS = 3;
-const DEFAULT_MAX_WAIT_MS = 10_000;
-/** First backoff when the server sent no `Retry-After`. */
-const BASE_BACKOFF_MS = 200;
-/** `undefined` means "do not retry" — the caller then leaves `fetch` alone. */
-function resolveConfig(config) {
-    if (config === false)
-        return undefined;
-    const opts = config === true || config === undefined ? {} : config;
-    return {
-        maxAttempts: Math.max(1, opts.maxAttempts ?? DEFAULT_MAX_ATTEMPTS),
-        maxWaitMs: Math.max(0, opts.maxWaitMs ?? DEFAULT_MAX_WAIT_MS),
-        ...(opts.onRetry && { onRetry: opts.onRetry }),
-    };
-}
+import { attempt, } from 'footprintjs';
+import { abortErrorOf, eitherSignal, linkedController } from '../lib/abort.js';
+import { exponentialBackoff, statedWaitFirst } from './backoff.js';
 /** HTTP 429, with the server's own `Retry-After` when it sent one. */
 export function throttled(response) {
     if (response.status !== 429)
@@ -69,6 +93,49 @@ export function throttled(response) {
     const retryAfterMs = parseRetryAfter(response.headers.get('retry-after'));
     return retryAfterMs === undefined ? {} : { retryAfterMs };
 }
+/**
+ * `retryOnThrottle`'s defaults — unchanged since 8.11.0: 3 attempts, a 200 ms
+ * backoff doubling with equal jitter (100–200 ms, then 200–400 ms), never more
+ * than 10 s of waiting in total. No deadline and no cap on one wait.
+ */
+export const THROTTLE_RETRY_DEFAULTS = Object.freeze({
+    maxAttempts: 3,
+    maxWaitMs: 10_000,
+    maxElapsedMs: Infinity,
+    baseDelayMs: 200,
+    multiplier: 2,
+    jitter: 'equal',
+    maxDelayMs: Infinity,
+});
+/**
+ * @internal A rule from a caller's options — `undefined` when retry is off
+ * (`false`). An option field left out, or set to `undefined`, takes its
+ * default. `maxAttempts` and `maxWaitMs` keep the clamps they always had (below
+ * 1 reads as 1, below 0 as 0).
+ *
+ * @throws TypeError, when the rule is BUILT, for a value the schedule cannot
+ *   mean — named by option, never echoing a value that is not a number.
+ */
+export function retryRule(kind, decide, config, defaults, where) {
+    if (config === false)
+        return undefined;
+    const opts = typeof config === 'object' && config !== null ? config : {};
+    const option = new OptionReader(where);
+    const rule = {
+        kind,
+        decide,
+        maxAttempts: option.atLeast('maxAttempts', Math.max(1, opts.maxAttempts ?? defaults.maxAttempts)),
+        maxWaitMs: option.atLeast('maxWaitMs', Math.max(0, opts.maxWaitMs ?? defaults.maxWaitMs)),
+        maxElapsedMs: option.positive('maxElapsedMs', opts.maxElapsedMs ?? defaults.maxElapsedMs),
+        maxDelayMs: option.nonNegative('maxDelayMs', opts.maxDelayMs ?? defaults.maxDelayMs),
+        baseDelayMs: option.finite('baseDelayMs', opts.baseDelayMs ?? defaults.baseDelayMs, 0),
+        multiplier: option.finite('multiplier', opts.multiplier ?? defaults.multiplier, 1),
+        jitter: option.jitter(opts.jitter ?? defaults.jitter),
+        ...(opts.endpointLabel !== undefined && { endpointLabel: option.label(opts.endpointLabel) }),
+        ...(opts.onRetry && { onRetry: opts.onRetry }),
+    };
+    return rule;
+}
 // ─── The decorator ───────────────────────────────────────────────────
 /**
  * Wrap a `fetch` so HTTP 429 responses are retried, honouring `Retry-After`.
@@ -77,6 +144,10 @@ export function throttled(response) {
  * so a transport that passed no custom fetch keeps passing none and its
  * behaviour is byte-identical to before this existed.
  *
+ * When `inner` already runs a retry series of its own (an AgentCore Runtime
+ * transport's fetch), the 429 rule JOINS that series rather than wrapping it,
+ * so the two can never multiply requests — see the module note.
+ *
  * ── Why this is public ───────────────────────────────────────────────────────
  * `mcpClient({ transport })` applies it for you, ON by default. `mcpClient({
  * connection })` cannot: the library builds no transport on that arm, so there
@@ -98,70 +169,333 @@ export function throttled(response) {
  * @param inner the fetch to wrap. `undefined` means the global `fetch`,
  *   resolved at CALL time so a later polyfill still wins.
  * @param config `true` / `undefined` for the defaults, `false` to get `inner`
- *   back unchanged, or an object to tune the ceilings.
+ *   back unchanged, or an object to tune the ceilings and the backoff.
+ * @throws TypeError when an option is outside its range — here, when the fetch
+ *   is built, never at the first call.
  */
 export function retryingFetch(inner, config) {
-    return retryingFetchWhen(inner, config, throttled);
+    const rule = retryRule('throttle', throttled, config, THROTTLE_RETRY_DEFAULTS, 'retryOnThrottle');
+    if (rule === undefined)
+        return inner;
+    const join = inner === undefined ? undefined : JOINS.get(inner);
+    return join !== undefined ? join(rule) : retryingFetchFor(inner ?? platformFetch, [rule]);
 }
 /**
- * The bounded loop itself, asking `decide` of every response.
- *
- * {@link retryingFetch} is this loop asking {@link throttled}. A vendor adapter
- * whose service documents a refusal of its own — one made before anything ran —
- * passes its decision here instead of writing a second loop, so the ceilings,
- * the `Retry-After` rail, the replay check, the abort and the `onRetry` report
- * stay one implementation.
- *
- * `decide` is asked only when a retry could actually follow — attempts left, a
- * body that can be sent again, no abort — so a decision that has to read the
- * response pays for that only when its answer can matter.
- *
- * @internal Public to adapters, not to the door: the decision is the vendor's
- *   fact, and each one is reviewed against the license on {@link RetryDecision}.
+ * Fetches that run their retries in one series, each with the way to rebuild
+ * it with one more rule. Module-private: only `joinableRetry` adds to it, so a
+ * caller cannot make a fetch claim a series it does not run.
+ */
+const JOINS = new WeakMap();
+/**
+ * @internal Declare that `fetch` runs its retries in ONE series, and how to
+ * rebuild it with one more rule in that same series. `retryingFetch` joins such
+ * a fetch instead of wrapping it. A transport whose public fetch wraps its
+ * series (a session applied around it, its answers rewritten after it) uses
+ * this so the rule lands INSIDE that wrapping.
  */
-export function retryingFetchWhen(inner, config, decide) {
-    const resolved = resolveConfig(config);
-    if (!resolved)
+export function joinableRetry(fetch, join) {
+    JOINS.set(fetch, join);
+    return fetch;
+}
+/**
+ * @internal The one series per call over `inner`, asking `rules` in order —
+ * `inner` itself when there are none. The first rule holds the call's budget;
+ * see the module note. The result is joinable.
+ */
+export function retryingFetchFor(inner, rules) {
+    const [owner] = rules;
+    if (owner === undefined)
         return inner;
-    const base = inner ?? ((input, init) => globalThis.fetch(input, init));
-    return async (input, init) => {
-        let totalWaited = 0;
-        for (let attempt = 1;; attempt++) {
-            const response = await base(input, init);
-            if (attempt >= resolved.maxAttempts)
-                return response;
-            // A body we cannot send twice makes a retry a different request. Rare
-            // for MCP (JSON strings), but silently replaying half a stream would be
-            // worse than surfacing the refusal.
-            if (!isReplayable(input, init))
-                return response;
-            if (init?.signal?.aborted)
-                return response;
-            const verdict = await decide(response);
-            if (verdict === undefined)
-                return response;
-            const { retryAfterMs } = verdict;
-            const waitMs = retryAfterMs ?? backoffMs(attempt);
-            // The rail on Retry-After: never let a server talk us into a wait that
-            // breaks the caller's budget.
-            if (totalWaited + waitMs > resolved.maxWaitMs)
+    const bound = rules.map((rule) => boundRule(rule, owner));
+    return joinableRetry((input, init) => new Series(bound, input, init).run(inner), (rule) => retryingFetchFor(inner, [...rules, rule]));
+}
+/** The platform's fetch, looked up at call time so a later polyfill still wins. */
+const platformFetch = (input, init) => globalThis.fetch(input, init);
+function boundRule(rule, owner) {
+    const maxDelayMs = Math.min(rule.maxDelayMs, owner.maxDelayMs);
+    const schedule = exponentialBackoff({
+        baseDelayMs: rule.baseDelayMs,
+        multiplier: rule.multiplier,
+        jitter: rule.jitter,
+        maxDelayMs,
+    });
+    return {
+        ...rule,
+        maxAttempts: Math.min(rule.maxAttempts, owner.maxAttempts),
+        maxWaitMs: Math.min(rule.maxWaitMs, owner.maxWaitMs),
+        maxElapsedMs: Math.min(rule.maxElapsedMs, owner.maxElapsedMs),
+        maxDelayMs,
+        // The cap is on the schedule's ceiling only: a stated wait wins, whole.
+        backoffMs: statedWaitFirst(retryAfterOf, schedule),
+    };
+}
+/** The wait a refusal stated (its parsed `Retry-After`), or none. */
+function retryAfterOf(error) {
+    return error instanceof RetryableRefusal ? error.retryAfterMs : undefined;
+}
+/** What a series names its records' target — a name from code, never a value. */
+const SERIES_TARGET = 'mcp-request';
+/**
+ * One call: one `attempt()` series, and what its policy's functions share while
+ * it runs — the waiting so far, and the latest refusal.
+ */
+class Series {
+    rules;
+    input;
+    init;
+    owner;
+    startedAt = Date.now();
+    deadline;
+    signal;
+    replayable;
+    attemptNo = 0;
+    waitedMs = 0;
+    plannedWaitMs = 0;
+    latest;
+    constructor(rules, input, init) {
+        this.rules = rules;
+        this.input = input;
+        this.init = init;
+        this.owner = rules[0];
+        this.signal = init?.signal ?? undefined;
+        this.replayable = isReplayable(input, init);
+        const { maxElapsedMs } = this.owner;
+        this.deadline = Number.isFinite(maxElapsedMs) ? this.startedAt + maxElapsedMs : undefined;
+    }
+    async run(inner) {
+        try {
+            return await attempt((t) => this.send(inner, t), this.policy(), this.options());
+        }
+        catch (error) {
+            return this.settle(error);
+        }
+    }
+    /**
+     * The owner's budget as footprintjs reads it; the rest is this series'
+     * `retryOn` and backoff. `maxBackoffMs` is deliberately unset: it would cap a
+     * stated `Retry-After` too, and send the request before the server said.
+     */
+    policy() {
+        const { maxAttempts } = this.owner;
+        return {
+            // A whole number for the runner; "no count" is a count no call reaches.
+            attempts: Number.isFinite(maxAttempts) ? Math.ceil(maxAttempts) : Number.MAX_SAFE_INTEGER,
+            retryOn: (error) => this.retryOn(error),
+            // `retryOn` planned the wait — it needs the length to hold the ceilings.
+            backoffMs: () => this.plannedWaitMs,
+        };
+    }
+    options() {
+        return {
+            target: SERIES_TARGET,
+            ...(this.signal !== undefined && { signal: this.signal }),
+            ...(this.deadline !== undefined && { deadline: this.deadline }),
+            onAttempt: (record) => this.report(record),
+        };
+    }
+    /**
+     * One attempt: the request, sent once, and its answer classified. A refusal
+     * a rule recognises is thrown for the runner to decide on.
+     *
+     * With no deadline of ours the request carries the caller's own `init`,
+     * exactly as before this series existed. Under a deadline the runner can cut
+     * the attempt before it is ANSWERED — and an answer is not in until it has
+     * been classified, which can mean reading its body (a session-busy reply is
+     * JSON in a 200). So the cut stays connected through the classification: a
+     * stall in the request or in that body stops the request and releases the
+     * body. Only then does it let go: an answer handed back to the caller keeps
+     * streaming for as long as the caller's own signal allows.
+     */
+    async send(inner, t) {
+        this.attemptNo = t.attempt;
+        // The previous attempt's refusal will not be delivered: release its body, so
+        // a keep-alive connection is not pinned by an unread stream.
+        this.supersede();
+        const cut = this.deadline === undefined ? undefined : linkedController(t.signal);
+        const signal = eitherSignal(this.signal, cut?.controller.signal);
+        try {
+            const init = cut === undefined ? this.init : { ...this.init, ...(signal && { signal }) };
+            const response = await inner(this.input, init);
+            const refused = await this.recognise(response, signal);
+            if (refused === undefined)
                 return response;
-            // Release the throttle response's body before asking again, so a
-            // keep-alive connection is not pinned by an unread stream.
+            this.latest = refused;
+            throw refused.refusal;
+        }
+        finally {
+            cut?.unlink();
+        }
+    }
+    /**
+     * The first rule whose decision says "again", or none. A decision the
+     * request's signal cut short leaves an answer nobody will read: it is
+     * released here, so its connection is not held open.
+     */
+    async recognise(response, signal) {
+        try {
+            for (const rule of this.rules) {
+                const verdict = await rule.decide(response, signal);
+                if (verdict === undefined)
+                    continue;
+                return { refusal: new RetryableRefusal(rule.kind, verdict), rule, verdict, response };
+            }
+            return undefined;
+        }
+        catch (error) {
             discardBody(response);
-            resolved.onRetry?.({
-                attempt: attempt + 1,
-                maxAttempts: resolved.maxAttempts,
-                waitMs,
-                ...(retryAfterMs !== undefined && { retryAfterMs }),
-                url: describeUrl(input),
-            });
-            await sleep(waitMs, init?.signal);
-            totalWaited += waitMs;
+            throw error;
         }
-    };
+    }
+    /**
+     * The runner's `retryOn`: is this attempt's error a refusal worth another
+     * attempt? Plans the wait as it answers, because the ceilings need its length.
+     */
+    retryOn(error) {
+        this.plannedWaitMs = 0;
+        const refused = this.latest;
+        // The license: only a refusal made before the server ran anything. A 5xx, a
+        // dropped connection or a timeout may be the record of work that ran.
+        if (refused === undefined || error !== refused.refusal)
+            return false;
+        // A body we cannot send twice makes a retry a different request. Rare for
+        // MCP (JSON strings), but silently replaying half a stream would be worse
+        // than surfacing the refusal.
+        if (!this.replayable)
+            return false;
+        const { rule } = refused;
+        if (this.attemptNo >= rule.maxAttempts)
+            return false;
+        // The stated wait whole, else the schedule under `maxDelayMs`.
+        const waitMs = rule.backoffMs(this.attemptNo, error);
+        // The rail on Retry-After: never let a server talk us into a wait that
+        // breaks the caller's budget. It stops the series; it never shortens the
+        // wait. Past the deadline, the runner stops it the same way (`no-time-left`).
+        if (this.waitedMs + waitMs > rule.maxWaitMs)
+            return false;
+        // A joined rule's own, sooner deadline. The owner's is the runner's to hold.
+        if (rule.maxElapsedMs < this.owner.maxElapsedMs &&
+            this.elapsedAfter(waitMs) > rule.maxElapsedMs) {
+            return false;
+        }
+        this.plannedWaitMs = waitMs;
+        return true;
+    }
+    elapsedAfter(waitMs) {
+        return Date.now() - this.startedAt + waitMs;
+    }
+    /** Each record as the runner ends an attempt: a retry is counted and reported to its rule. */
+    report(record) {
+        const refused = this.latest;
+        if (record.next !== 'retry' || refused === undefined)
+            return;
+        const waitMs = record.delayMs ?? 0;
+        this.waitedMs += waitMs;
+        const { rule, verdict } = refused;
+        rule.onRetry?.({
+            kind: rule.kind,
+            attempt: record.attempt + 1,
+            maxAttempts: rule.maxAttempts,
+            waitMs,
+            ...(verdict.retryAfterMs !== undefined && { retryAfterMs: verdict.retryAfterMs }),
+            url: originOf(this.input),
+            ...(rule.endpointLabel !== undefined && { endpoint: rule.endpointLabel }),
+        });
+    }
+    /** How the call ends when the series did not answer. */
+    settle(error) {
+        // The caller's cancellation wins: the call ends with their reason, and the
+        // refusal nobody is waiting for any more is released.
+        if (this.signal?.aborted) {
+            this.supersede();
+            throw abortErrorOf(this.signal);
+        }
+        // The series ended on a refusal — attempts spent, a ceiling reached, no
+        // time left. The server's answer is delivered as it sent it.
+        if (this.latest !== undefined && error === this.latest.refusal)
+            return this.latest.response;
+        throw error;
+    }
+    supersede() {
+        if (this.latest !== undefined)
+            discardBody(this.latest.response);
+        this.latest = undefined;
+    }
 }
+/**
+ * A response a rule recognised as a refusal made before anything ran, thrown so
+ * the attempt runner decides on it. It carries only what an attempt record may
+ * keep: a fixed sentence, its kind as `code`, a 429's status and the wait the
+ * server stated. Never the server's text, the request or the response — the
+ * series holds the response, not the error.
+ */
+class RetryableRefusal extends Error {
+    name = 'RetryableRefusal';
+    code;
+    /** A throttle's status, so footprintjs's `errorCategory` reads it as rate-limited. */
+    status;
+    retryAfterMs;
+    constructor(kind, verdict) {
+        super(REFUSAL_SENTENCES[kind]);
+        this.code = kind;
+        this.status = kind === 'throttle' ? 429 : undefined;
+        this.retryAfterMs = verdict.retryAfterMs;
+    }
+}
+const REFUSAL_SENTENCES = {
+    throttle: 'The server refused the request with HTTP 429 before running it.',
+    'session-busy': 'AgentCore Runtime refused the request while its session was starting or stopping, before running it.',
+};
 // ─── Helpers ─────────────────────────────────────────────────────────
+/** Reads one rule's numeric options, refusing by name what the schedule cannot mean. */
+class OptionReader {
+    where;
+    constructor(where) {
+        this.where = where;
+    }
+    /** A number that is not NaN (`Infinity` allowed) — the clamps already applied. */
+    atLeast(name, value) {
+        if (typeof value !== 'number' || Number.isNaN(value))
+            this.refuse(name, 'a number');
+        return value;
+    }
+    /** A number > 0; `Infinity` is none. */
+    positive(name, value) {
+        if (!(typeof value === 'number' && value > 0))
+            this.refuse(name, 'a number > 0');
+        return value;
+    }
+    /** A number ≥ 0; `Infinity` is none. */
+    nonNegative(name, value) {
+        if (!(typeof value === 'number' && value >= 0))
+            this.refuse(name, 'a number ≥ 0');
+        return value;
+    }
+    /** A finite number ≥ `min`. */
+    finite(name, value, min) {
+        if (!(typeof value === 'number' && Number.isFinite(value) && value >= min)) {
+            this.refuse(name, `a finite number ≥ ${min}`);
+        }
+        return value;
+    }
+    jitter(value) {
+        if (value === 'none' || value === 'equal' || value === 'full')
+            return value;
+        return this.refuse('jitter', "'none', 'equal' or 'full'");
+    }
+    /** A caller's label: 1–128 characters, no control character. Never echoed in a refusal. */
+    label(value) {
+        if (typeof value === 'string' &&
+            value.length >= 1 &&
+            value.length <= 128 &&
+            !hasControl(value)) {
+            return value;
+        }
+        return this.refuse('endpointLabel', 'a string of 1–128 characters with no control character');
+    }
+    refuse(name, wanted) {
+        throw new TypeError(`${this.where}: \`${name}\` must be ${wanted}.`);
+    }
+}
 /**
  * `Retry-After` in either legal form: delta-seconds (`"2"`) or an HTTP-date
  * (`"Wed, 21 Oct 2026 07:28:00 GMT"`). Anything else is treated as absent so a
@@ -178,15 +512,6 @@ export function parseRetryAfter(value) {
         return undefined;
     return Math.max(0, when - Date.now());
 }
-/**
- * Exponential backoff with equal jitter — half fixed, half random. The fixed
- * half keeps the wait meaningful; the random half stops a fleet of agents that
- * were all throttled at the same instant from retrying at the same instant.
- */
-function backoffMs(attempt) {
-    const ceiling = BASE_BACKOFF_MS * Math.pow(2, attempt - 1);
-    return Math.round(ceiling / 2 + Math.random() * (ceiling / 2));
-}
 /** Can this exact request be sent again? A stream body cannot be rewound. */
 function isReplayable(input, init) {
     // Defensive: the declared type says otherwise, but a `Request` carries its
@@ -215,8 +540,28 @@ function discardBody(response) {
         // A body that refuses to cancel is not worth failing a retry over.
     }
 }
-/** The endpoint, for the `onRetry` report. Never a credential. */
-function describeUrl(input) {
-    return typeof input === 'string' ? input : input.toString();
+/**
+ * The endpoint's ORIGIN, for the `onRetry` report: scheme, host and port. The
+ * path, user info, query and fragment are all dropped — a token, a credential
+ * or a customer id can ride in any of them. A URL that does not parse has no
+ * origin to report: the empty string.
+ */
+function originOf(input) {
+    try {
+        const url = new URL(typeof input === 'string' ? input : input.toString());
+        return url.host === '' ? '' : `${url.protocol}//${url.host}`;
+    }
+    catch {
+        return '';
+    }
+}
+/** Whether `text` holds a control character (C0, DEL or C1). */
+function hasControl(text) {
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if (code < 0x20 || (code >= 0x7f && code <= 0x9f))
+            return true;
+    }
+    return false;
 }
 //# sourceMappingURL=throttleRetry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"throttleRetry.js","sourceRoot":"","sources":["../../../src/mcp/throttleRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAgExC,wEAAwE;AAExE,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,2DAA2D;AAC3D,MAAM,eAAe,GAAG,GAAG,CAAC;AAQ5B,+EAA+E;AAC/E,SAAS,aAAa,CAAC,MAAmC;IACxD,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,IAAI,GAAyB,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACzF,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAClE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,mBAAmB,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAkCD,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,QAAkB;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1E,OAAO,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;AAC5D,CAAC;AAED,wEAAwE;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAgC,EAChC,MAAmC;IAEnC,OAAO,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAgC,EAChC,MAAmC,EACnC,MAAqB;IAErB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,IAAI,GAAkB,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAEtF,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,OAAO,IAAI,QAAQ,CAAC,WAAW;gBAAE,OAAO,QAAQ,CAAC;YACrD,sEAAsE;YACtE,wEAAwE;YACxE,oCAAoC;YACpC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC;gBAAE,OAAO,QAAQ,CAAC;YAChD,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO;gBAAE,OAAO,QAAQ,CAAC;YAE3C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,QAAQ,CAAC;YAE3C,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;YACjC,MAAM,MAAM,GAAG,YAAY,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;YAClD,uEAAuE;YACvE,8BAA8B;YAC9B,IAAI,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,SAAS;gBAAE,OAAO,QAAQ,CAAC;YAE/D,iEAAiE;YACjE,2DAA2D;YAC3D,WAAW,CAAC,QAAQ,CAAC,CAAC;YAEtB,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,EAAE,OAAO,GAAG,CAAC;gBACpB,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,MAAM;gBACN,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;gBACnD,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC;aACxB,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAClC,WAAW,IAAI,MAAM,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,OAAO,GAAG,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,6EAA6E;AAC7E,SAAS,YAAY,CAAC,KAAmB,EAAE,IAAkB;IAC3D,2EAA2E;IAC3E,mEAAmE;IACnE,IAAI,OAAO,OAAO,KAAK,WAAW,IAAK,KAAiB,YAAY,OAAO;QAAE,OAAO,KAAK,CAAC;IAC1F,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;IACxB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,OAAO,eAAe,KAAK,WAAW,IAAI,IAAI,YAAY,eAAe;QAAE,OAAO,IAAI,CAAC;IAC3F,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI;QAAE,OAAO,IAAI,CAAC;IACrE,IAAI,IAAI,YAAY,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oEAAoE;AACpE,SAAS,WAAW,CAAC,QAAkB;IACrC,IAAI,CAAC;QACH,KAAK,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,SAAS,WAAW,CAAC,KAAmB;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"throttleRetry.js","sourceRoot":"","sources":["../../../src/mcp/throttleRetry.ts"],"names":[],"mappings":"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"}

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

@@ -180,11 +180,13 @@ export interface McpClientOptions {
      * What happens when the server says "too many requests" (HTTP 429). New in
      * 8.11.0, and **on by default**.
      *
-     * Default: retry up to 3 times, waiting as long as the server's
-     * `Retry-After` header asks (and, when it sends none, a jittered backoff),
-     * never longer than 10 seconds of waiting in total across one call. Set
-     * `false` to let a throttled call fail immediately, or pass an object to
-     * tune the ceilings and to learn when it happens:
+     * Default: up to 3 attempts, waiting as long as the server's `Retry-After`
+     * header asks (and, when it sends none, a backoff of 200 ms doubling, with
+     * equal jitter), never longer than 10 seconds of waiting in total across one
+     * call. Set `false` to let a throttled call fail immediately, or pass an
+     * object to tune the ceilings and the backoff (`baseDelayMs`, `multiplier`,
+     * `jitter`, `maxDelayMs`, a `maxElapsedMs` deadline) and to learn when it
+     * happens:
      *
      * ```ts
      * const gateway = await mcpClient({
@@ -192,12 +194,19 @@ export interface McpClientOptions {
      *   transport: gatewayTransport({ url, credentials }),
      *   retryOnThrottle: {
      *     maxAttempts: 5,
-     *     onRetry: ({ attempt, waitMs, retryAfterMs }) =>
-     *       log.warn({ attempt, waitMs, retryAfterMs }, 'gateway throttled'),
+     *     onRetry: ({ kind, attempt, waitMs, retryAfterMs }) =>
+     *       log.warn({ kind, attempt, waitMs, retryAfterMs }, 'gateway throttled'),
      *   },
      * });
      * ```
      *
+     * Each call is ONE retry series (footprintjs's attempt runner). When the
+     * transport's own fetch already retries — `agentCoreRuntimeMcpTransport`'s
+     * session-busy retry — this 429 retry joins that series instead of wrapping
+     * it: one attempt count, one waiting total and one deadline per call, with
+     * the transport's `retry` values as the call's overall limits and these as
+     * limits on the 429 retries inside them.
+     *
      * **Why this is on by default.** A 429 is a *pre-execution rejection* — the
      * rate limiter refused the request at the edge and the server never ran the
      * tool, so a retry cannot double-execute anything. That is not true of a