agentfootprint 9.129.0 → 9.131.0

package/dist/types/resilience/withRetry.d.ts

@@ -18,6 +18,12 @@
  * Default policy:
  *   • maxAttempts: 3 (initial + 2 retries)
  *   • backoff:     exponential — 200ms, 400ms, 800ms
+ *   • stated wait: when the failure says how long to wait (`retryAfterMs`,
+ *                  or `retryAfterSeconds` — see statedWait.ts), the wait is
+ *                  max(the schedule's delay, the stated wait), capped at
+ *                  `maxDelayMs` so a hostile header cannot stall a run. The
+ *                  adapter that knows its wire reads the header or the
+ *                  gateway's wording; this decorator never parses prose.
  *   • shouldRetry: rejects 4xx-class errors (client mistakes don't
  *                  benefit from retry), AbortError, and any error that
  *                  declares `retryable: false`; retries 5xx, network
@@ -44,13 +50,18 @@ export interface WithRetryOptions {
     readonly initialDelayMs?: number;
     /** Multiplier between attempts. Default 2 (200ms → 400ms → 800ms). */
     readonly backoffFactor?: number;
-    /** Maximum delay cap in ms. Default 10_000. */
+    /**
+     * Maximum delay cap in ms. Default 10_000. Caps a STATED wait too: a failure
+     * that says "retry after 60 s" waits `maxDelayMs` at most. Raise it to honour
+     * longer stated waits.
+     */
     readonly maxDelayMs?: number;
     /**
      * Predicate to decide whether an error is worth retrying. Default
      * skips AbortError, HTTP 4xx (except 429) and an error that declares
      * `retryable: false`; retries everything else. Override
-     * to add provider-specific signals (e.g., 429 with Retry-After).
+     * to add provider-specific signals. (A stated wait — Retry-After — needs no
+     * predicate: it sets how long to wait, see the policy notes above.)
      */
     readonly shouldRetry?: (error: unknown, attempt: number) => boolean;
     /**

package/dist/types/resilience/withRetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withRetry.d.ts","sourceRoot":"","sources":["../../../src/resilience/withRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAGV,WAAW,EAGZ,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACpE;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAyH5F;AA2CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAW1E"}
+{"version":3,"file":"withRetry.d.ts","sourceRoot":"","sources":["../../../src/resilience/withRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAGV,WAAW,EAGZ,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACpE;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAkI5F;AA2CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAW1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "9.129.0",
+  "version": "9.131.0",
   "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
   "license": "MIT",
   "type": "commonjs",