ai-retry 1.7.3 → 1.7.4

package/dist/{create-retryable-model-HLobeUXU.mjs → create-retryable-model-Bgf7SQFz.mjs}

@@ -1,4 +1,4 @@
-import { a as isModel, c as isStreamContentPart, i as isImageModel, n as isErrorAttempt, o as isObject, r as isGenerateResult, s as isResultAttempt, t as isEmbeddingModel } from "./guards-D8UJtxDK.mjs";
+import { a as isModel, c as isStreamContentPart, i as isImageModel, n as isErrorAttempt, o as isObject, r as isGenerateResult, s as isResultAttempt, t as isEmbeddingModel, u as isTimeoutError } from "./guards-D8UJtxDK.mjs";
 import { RetryError, gateway } from "ai";
 import { delay } from "@ai-sdk/provider-utils";
 import { getErrorMessage } from "@ai-sdk/provider";
@@ -199,16 +199,25 @@ function resolveProviderOptions(base, currentRetry, onRetryOverrides) {
 *
 * If `currentRetry.timeout` is set, a fresh `AbortSignal.timeout(...)` is
 * created. When the base signal is still alive, the fresh deadline is
-* composed with it via `AbortSignal.any` so the user can still cancel
-* mid-retry. When the base is already aborted, it is dropped so the retry
-* runs against the fresh deadline alone. Without a retry timeout, the base
-* is preserved unchanged.
+* composed with the base so user cancellation still propagates mid-retry,
+* but a base `TimeoutError` (`AbortSignal.timeout` used as a wall-clock
+* budget) is ignored so it cannot truncate the retry's own deadline. When
+* the base is already aborted with a `TimeoutError`, it is dropped; with any
+* other reason it propagates. Without a retry timeout, the base is preserved
+* unchanged.
 */
 function resolveAbortSignal(base, currentRetry) {
 	if (currentRetry?.timeout === void 0) return base;
 	const fresh = AbortSignal.timeout(currentRetry.timeout);
-	if (base !== void 0 && !base.aborted) return AbortSignal.any([base, fresh]);
-	return fresh;
+	if (base === void 0) return fresh;
+	if (base.aborted) return isTimeoutError(base.reason) ? fresh : base;
+	const controller = new AbortController();
+	fresh.addEventListener("abort", () => controller.abort(fresh.reason), { once: true });
+	base.addEventListener("abort", () => {
+		if (isTimeoutError(base.reason)) return;
+		controller.abort(base.reason);
+	}, { once: true });
+	return controller.signal;
 }
 /**
 * Merge call options for the upcoming language model retry attempt.

package/dist/{error-_63RHJTp.mjs → error-CaTT-xX8.mjs}

@@ -136,10 +136,13 @@ function createErrorAPI() {
 	* predicate runs only when the current attempt failed with an error;
 	* result attempts return false.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
 	* error<MODEL, APICallError>(
 	*   (e) => APICallError.isInstance(e) && e.statusCode === 418,
-	* )
+	* ).switch({ model: fallback })
 	*/
 	function error(predicate) {
 		return new Condition(async (ctx) => {
@@ -150,6 +153,9 @@ function createErrorAPI() {
 	/**
 	* Match when the error explicitly carries `isRetryable === flag`.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
 	* error.isRetryable(true).retry({ delay: 1000 })
 	* error.isRetryable(false).switch({ model: fallback })
@@ -161,9 +167,12 @@ function createErrorAPI() {
 	* Match by HTTP status code. Numbers match exactly; regular expressions
 	* match against the stringified code, useful for range checks.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
-	* error.statusCode(429, 503)
-	* error.statusCode(/^5\d\d$/)
+	* error.statusCode(429, 503).retry({ delay: 1000 })
+	* error.statusCode(/^5\d\d$/).switch({ model: fallback })
 	*/
 	error.statusCode = function statusCode(...patterns) {
 		return error((e) => {
@@ -179,10 +188,12 @@ function createErrorAPI() {
 	* message are lowercased before matching. Regular expressions match
 	* as written; use the `i` flag for case-insensitive regex matching.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
-	* error.message('overloaded')
-	* error.message(/rate.?limit/i)
-	* error.message('overloaded', /rate.?limit/i)
+	* error.message('overloaded').switch({ model: fallback })
+	* error.message(/rate.?limit/i).retry({ delay: 1000 })
 	*/
 	error.message = function message(...patterns) {
 		return error((e) => {
@@ -198,11 +209,12 @@ function createErrorAPI() {
 	* message. Mix any combination in a single call; matches when any
 	* pattern matches.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
-	* httpStatus(529)
-	* httpStatus(529, 'overloaded')
-	* httpStatus(/^5\d\d$/)
-	* httpStatus(529, 'overloaded', /rate.?limit/i)
+	* httpStatus(529).switch({ model: fallback })
+	* httpStatus(529, 'overloaded').retry({ delay: 1000 })
 	*/
 	function httpStatus(...patterns) {
 		const numbers = patterns.filter((p) => typeof p === "number");
@@ -218,8 +230,12 @@ function createErrorAPI() {
 	* which `AbortSignal.timeout()` produces when the timeout fires.
 	* Distinct from `aborted()`, which matches manual aborts.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
 	* timeout().switch({ model: fallback, timeout: 60_000 })
+	* timeout().retry({ delay: 1000 })
 	*/
 	function timeout() {
 		return error((err) => err instanceof Error && err.name === "TimeoutError");
@@ -229,6 +245,9 @@ function createErrorAPI() {
 	* `controller.abort()` produces. Distinct from `timeout()`, which
 	* matches `AbortSignal.timeout()` firing.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
 	* aborted().switch({ model: fallback })
 	*/

package/dist/experimental/embedding-model/index.mjs

@@ -1,5 +1,5 @@
-import { t as createRetryable$1 } from "../../create-retryable-model-HLobeUXU.mjs";
-import "../../error-_63RHJTp.mjs";
+import { t as createRetryable$1 } from "../../create-retryable-model-Bgf7SQFz.mjs";
+import "../../error-CaTT-xX8.mjs";
 import { aborted, error, httpStatus, timeout } from "./retryables/index.mjs";
 
 //#region src/experimental/embedding-model/index.ts

package/dist/experimental/embedding-model/retryables/index.mjs

@@ -1,4 +1,4 @@
-import { t as createErrorAPI } from "../../../error-_63RHJTp.mjs";
+import { t as createErrorAPI } from "../../../error-CaTT-xX8.mjs";
 
 //#region src/experimental/embedding-model/retryables/index.ts
 const { error, httpStatus, timeout, aborted } = createErrorAPI();

package/dist/experimental/image-model/index.d.mts

@@ -1,6 +1,6 @@
 import { N as RetryableModelOptions, s as ImageModel } from "../../types-DYMm5YMu.mjs";
 import "../../error-CPbAtI-h.mjs";
-import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../index-Dvxg4bnp.mjs";
+import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../index-CNEL_aJP.mjs";
 
 //#region src/experimental/image-model/index.d.ts
 declare function createRetryable<MODEL extends ImageModel>(options: RetryableModelOptions<MODEL>): ImageModel;

package/dist/experimental/image-model/index.mjs

@@ -1,6 +1,6 @@
-import { t as createRetryable$1 } from "../../create-retryable-model-HLobeUXU.mjs";
-import "../../error-_63RHJTp.mjs";
-import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../retryables-D0wMy6Qt.mjs";
+import { t as createRetryable$1 } from "../../create-retryable-model-Bgf7SQFz.mjs";
+import "../../error-CaTT-xX8.mjs";
+import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../retryables-CPAbu_M3.mjs";
 
 //#region src/experimental/image-model/index.ts
 /**

package/dist/experimental/image-model/retryables/index.d.mts

@@ -1,4 +1,4 @@
 import "../../../types-DYMm5YMu.mjs";
 import "../../../error-CPbAtI-h.mjs";
-import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../../index-Dvxg4bnp.mjs";
+import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../../index-CNEL_aJP.mjs";
 export { aborted, error, httpStatus, noImage, timeout };

package/dist/experimental/image-model/retryables/index.mjs

@@ -1,4 +1,4 @@
-import "../../../error-_63RHJTp.mjs";
-import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../../retryables-D0wMy6Qt.mjs";
+import "../../../error-CaTT-xX8.mjs";
+import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../../retryables-CPAbu_M3.mjs";
 
 export { aborted, error, httpStatus, noImage, timeout };

package/dist/experimental/language-model/index.mjs

@@ -1,6 +1,6 @@
-import { t as createRetryable$1 } from "../../create-retryable-model-HLobeUXU.mjs";
-import "../../error-_63RHJTp.mjs";
-import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../retryables-DxsSL0_E.mjs";
+import { t as createRetryable$1 } from "../../create-retryable-model-Bgf7SQFz.mjs";
+import "../../error-CaTT-xX8.mjs";
+import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../retryables-M5l_6w9k.mjs";
 
 //#region src/experimental/language-model/index.ts
 /**

package/dist/experimental/language-model/retryables/index.mjs

@@ -1,4 +1,4 @@
-import "../../../error-_63RHJTp.mjs";
-import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../../retryables-DxsSL0_E.mjs";
+import "../../../error-CaTT-xX8.mjs";
+import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../../retryables-M5l_6w9k.mjs";
 
 export { aborted, error, finishReason, httpStatus, result, schemaInvalid, timeout };

package/dist/{index-Dvxg4bnp.d.mts → index-CNEL_aJP.d.mts}

@@ -7,8 +7,12 @@ import * as _ai_sdk_provider0 from "@ai-sdk/provider";
  * Match when image generation produced no images
  * (`NoImageGeneratedError`).
  *
+ * **Important:** returns a `Condition`, not a `Retryable`. Call
+ * `.switch()` or `.retry()` to plug it into `retries: [...]`.
+ *
  * @example
  * noImage().switch({ model: fallback })
+ * noImage().retry({ maxAttempts: 3 })
  */
 declare function noImage<MODEL extends ImageModel = ImageModel>(): Condition<MODEL>;
 //#endregion

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { n as getModelKey, t as createRetryable } from "./create-retryable-model-HLobeUXU.mjs";
+import { n as getModelKey, t as createRetryable } from "./create-retryable-model-Bgf7SQFz.mjs";
 import { n as isErrorAttempt, s as isResultAttempt } from "./guards-D8UJtxDK.mjs";
 
 export { createRetryable, getModelKey, isErrorAttempt, isResultAttempt };

package/dist/{retryables-D0wMy6Qt.mjs → retryables-CPAbu_M3.mjs}

@@ -1,5 +1,5 @@
 import { n as isErrorAttempt } from "./guards-D8UJtxDK.mjs";
-import { n as Condition, t as createErrorAPI } from "./error-_63RHJTp.mjs";
+import { n as Condition, t as createErrorAPI } from "./error-CaTT-xX8.mjs";
 import { NoImageGeneratedError } from "ai";
 
 //#region src/experimental/internal/no-image.ts
@@ -7,8 +7,12 @@ import { NoImageGeneratedError } from "ai";
 * Match when image generation produced no images
 * (`NoImageGeneratedError`).
 *
+* **Important:** returns a `Condition`, not a `Retryable`. Call
+* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+*
 * @example
 * noImage().switch({ model: fallback })
+* noImage().retry({ maxAttempts: 3 })
 */
 function noImage() {
 	return new Condition(async (ctx) => {

package/dist/{retryables-DxsSL0_E.mjs → retryables-M5l_6w9k.mjs}

@@ -1,5 +1,5 @@
 import { s as isResultAttempt } from "./guards-D8UJtxDK.mjs";
-import { n as Condition, t as createErrorAPI } from "./error-_63RHJTp.mjs";
+import { n as Condition, t as createErrorAPI } from "./error-CaTT-xX8.mjs";
 import { safeParseJSON } from "@ai-sdk/provider-utils";
 import { fromJSONSchema } from "zod";
 
@@ -19,8 +19,12 @@ function createResultAPI() {
 	* The predicate runs only when the current attempt succeeded; error
 	* attempts return false.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
 	* result<MODEL>((res) => res.finishReason.unified === 'length')
+	*   .switch({ model: fallback })
 	*/
 	function result(predicate) {
 		return new Condition(async (ctx) => {
@@ -31,20 +35,25 @@ function createResultAPI() {
 	/**
 	* Match the result's finish reason against one of the given values.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
-	* result.finishReason('content-filter')
-	* result.finishReason('content-filter', 'length')
+	* result.finishReason('content-filter').switch({ model: fallback })
+	* result.finishReason('length').retry({ maxAttempts: 3 })
 	*/
 	result.finishReason = function finishReason(...reasons) {
 		return result((res) => reasons.includes(res.finishReason.unified));
 	};
 	/**
 	* Match the result's finish reason against one of the given values.
-	* Thin wrapper around `result.finishReason(...)`.
+	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
 	*
 	* @example
-	* finishReason('content-filter')
-	* finishReason('content-filter', 'length')
+	* finishReason('content-filter').switch({ model: fallback })
+	* finishReason('length').retry({ maxAttempts: 3 })
 	*/
 	function finishReason(...reasons) {
 		return result.finishReason(...reasons);
@@ -54,8 +63,12 @@ function createResultAPI() {
 	* is read from the call's `responseFormat`, which `Output.object()`
 	* sets automatically. No-op when no schema is configured.
 	*
+	* **Important:** returns a `Condition`, not a `Retryable`. Call
+	* `.switch()` or `.retry()` to plug it into `retries: [...]`.
+	*
 	* @example
 	* schemaInvalid().switch({ model: fallback })
+	* schemaInvalid().retry({ maxAttempts: 3 })
 	*/
 	function schemaInvalid() {
 		return result(async (res, ctx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-retry",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "description": "Retry and fallback mechanisms for AI SDK",
   "keywords": [
     "ai",