ai-retry 1.7.2 → 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.d.mts

@@ -1,6 +1,6 @@
 import { k as RetryContext } from "../../../types-DYMm5YMu.mjs";
 import { n as Condition, t as StatusPattern } from "../../../error-CPbAtI-h.mjs";
-import * as _ai_sdk_provider21 from "@ai-sdk/provider";
+import * as _ai_sdk_provider13 from "@ai-sdk/provider";
 
 //#region src/experimental/embedding-model/retryables/index.d.ts
 /**
@@ -11,10 +11,10 @@ import * as _ai_sdk_provider21 from "@ai-sdk/provider";
  *     from 'ai-retry/experimental/embedding-model/retryables';
  */
 declare const error: {
-    <MODEL extends _ai_sdk_provider21.EmbeddingModelV3 = _ai_sdk_provider21.EmbeddingModelV3, E = unknown>(predicate: (err: E, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
-    isRetryable<MODEL extends _ai_sdk_provider21.EmbeddingModelV3 = _ai_sdk_provider21.EmbeddingModelV3>(flag?: boolean): Condition<MODEL>;
-    statusCode<MODEL extends _ai_sdk_provider21.EmbeddingModelV3 = _ai_sdk_provider21.EmbeddingModelV3>(...patterns: Array<number | RegExp>): Condition<MODEL>;
-    message<MODEL extends _ai_sdk_provider21.EmbeddingModelV3 = _ai_sdk_provider21.EmbeddingModelV3>(...patterns: Array<string | RegExp>): Condition<MODEL>;
-  }, httpStatus: <MODEL extends _ai_sdk_provider21.EmbeddingModelV3 = _ai_sdk_provider21.EmbeddingModelV3>(...patterns: Array<StatusPattern>) => Condition<MODEL>, timeout: <MODEL extends _ai_sdk_provider21.EmbeddingModelV3 = _ai_sdk_provider21.EmbeddingModelV3>() => Condition<MODEL>, aborted: <MODEL extends _ai_sdk_provider21.EmbeddingModelV3 = _ai_sdk_provider21.EmbeddingModelV3>() => Condition<MODEL>;
+    <MODEL extends _ai_sdk_provider13.EmbeddingModelV3 = _ai_sdk_provider13.EmbeddingModelV3, E = unknown>(predicate: (err: E, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
+    isRetryable<MODEL extends _ai_sdk_provider13.EmbeddingModelV3 = _ai_sdk_provider13.EmbeddingModelV3>(flag?: boolean): Condition<MODEL>;
+    statusCode<MODEL extends _ai_sdk_provider13.EmbeddingModelV3 = _ai_sdk_provider13.EmbeddingModelV3>(...patterns: Array<number | RegExp>): Condition<MODEL>;
+    message<MODEL extends _ai_sdk_provider13.EmbeddingModelV3 = _ai_sdk_provider13.EmbeddingModelV3>(...patterns: Array<string | RegExp>): Condition<MODEL>;
+  }, httpStatus: <MODEL extends _ai_sdk_provider13.EmbeddingModelV3 = _ai_sdk_provider13.EmbeddingModelV3>(...patterns: Array<StatusPattern>) => Condition<MODEL>, timeout: <MODEL extends _ai_sdk_provider13.EmbeddingModelV3 = _ai_sdk_provider13.EmbeddingModelV3>() => Condition<MODEL>, aborted: <MODEL extends _ai_sdk_provider13.EmbeddingModelV3 = _ai_sdk_provider13.EmbeddingModelV3>() => Condition<MODEL>;
 //#endregion
 export { aborted, error, httpStatus, timeout };

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-TcUPTMfl.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-TcUPTMfl.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.d.mts

@@ -1,6 +1,6 @@
 import { N as RetryableModelOptions, d as LanguageModel, o as GatewayLanguageModelId } from "../../types-DYMm5YMu.mjs";
 import "../../error-CPbAtI-h.mjs";
-import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../index-C9DEYXL_.mjs";
+import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../index-BygX0XfC.mjs";
 
 //#region src/experimental/language-model/index.d.ts
 declare function createRetryable(options: Omit<RetryableModelOptions<LanguageModel>, 'model'> & {

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-DBiDOfIF.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.d.mts

@@ -1,4 +1,4 @@
 import "../../../types-DYMm5YMu.mjs";
 import "../../../error-CPbAtI-h.mjs";
-import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../../index-C9DEYXL_.mjs";
+import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../../../index-BygX0XfC.mjs";
 export { aborted, error, finishReason, httpStatus, result, schemaInvalid, timeout };

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-DBiDOfIF.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-BygX0XfC.d.mts

@@ -0,0 +1,27 @@
+import { k as RetryContext, m as LanguageModelResult, x as ResolvableLanguageModel } from "./types-DYMm5YMu.mjs";
+import { n as Condition, t as StatusPattern } from "./error-CPbAtI-h.mjs";
+
+//#region src/experimental/internal/result.d.ts
+/**
+ * The unified finish reason produced by the AI SDK.
+ */
+type FinishReason = LanguageModelResult['finishReason']['unified'];
+//#endregion
+//#region src/experimental/language-model/retryables/index.d.ts
+/**
+ * Conditions are bound to `ResolvableLanguageModel` (instance or
+ * gateway string literal) so `.switch({ model: 'openai/gpt-5' })` is
+ * accepted alongside `.switch({ model: openai('gpt-4o') })`.
+ */
+declare const error: {
+    <MODEL extends ResolvableLanguageModel = ResolvableLanguageModel, E = unknown>(predicate: (err: E, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
+    isRetryable<MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>(flag?: boolean): Condition<MODEL>;
+    statusCode<MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>(...patterns: Array<number | RegExp>): Condition<MODEL>;
+    message<MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>(...patterns: Array<string | RegExp>): Condition<MODEL>;
+  }, httpStatus: <MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>(...patterns: Array<StatusPattern>) => Condition<MODEL>, timeout: <MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>() => Condition<MODEL>, aborted: <MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>() => Condition<MODEL>;
+declare const result: {
+    <MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>(predicate: (res: LanguageModelResult, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
+    finishReason<MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>(...reasons: Array<FinishReason>): Condition<MODEL>;
+  }, finishReason: <MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>(...reasons: Array<FinishReason>) => Condition<MODEL>, schemaInvalid: <MODEL extends ResolvableLanguageModel = ResolvableLanguageModel>() => Condition<MODEL>;
+//#endregion
+export { result as a, httpStatus as i, error as n, schemaInvalid as o, finishReason as r, timeout as s, aborted as t };

package/dist/index-CNEL_aJP.d.mts

@@ -0,0 +1,34 @@
+import { k as RetryContext, s as ImageModel } from "./types-DYMm5YMu.mjs";
+import { n as Condition, t as StatusPattern } from "./error-CPbAtI-h.mjs";
+import * as _ai_sdk_provider0 from "@ai-sdk/provider";
+
+//#region src/experimental/internal/no-image.d.ts
+/**
+ * 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
+//#region src/experimental/image-model/retryables/index.d.ts
+/**
+ * Experimental composable conditions bound to `ImageModel`. For use with
+ * `generateImage`.
+ *
+ *   import { error, noImage, ... }
+ *     from 'ai-retry/experimental/image-model/retryables';
+ */
+declare const error: {
+    <MODEL extends _ai_sdk_provider0.ImageModelV3 = _ai_sdk_provider0.ImageModelV3, E = unknown>(predicate: (err: E, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
+    isRetryable<MODEL extends _ai_sdk_provider0.ImageModelV3 = _ai_sdk_provider0.ImageModelV3>(flag?: boolean): Condition<MODEL>;
+    statusCode<MODEL extends _ai_sdk_provider0.ImageModelV3 = _ai_sdk_provider0.ImageModelV3>(...patterns: Array<number | RegExp>): Condition<MODEL>;
+    message<MODEL extends _ai_sdk_provider0.ImageModelV3 = _ai_sdk_provider0.ImageModelV3>(...patterns: Array<string | RegExp>): Condition<MODEL>;
+  }, httpStatus: <MODEL extends _ai_sdk_provider0.ImageModelV3 = _ai_sdk_provider0.ImageModelV3>(...patterns: Array<StatusPattern>) => Condition<MODEL>, timeout: <MODEL extends _ai_sdk_provider0.ImageModelV3 = _ai_sdk_provider0.ImageModelV3>() => Condition<MODEL>, aborted: <MODEL extends _ai_sdk_provider0.ImageModelV3 = _ai_sdk_provider0.ImageModelV3>() => Condition<MODEL>;
+//#endregion
+export { noImage as a, timeout as i, error as n, httpStatus as r, aborted as t };

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-DBiDOfIF.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) => {
@@ -80,6 +93,11 @@ function createResultAPI() {
 
 //#endregion
 //#region src/experimental/language-model/retryables/index.ts
+/**
+* Conditions are bound to `ResolvableLanguageModel` (instance or
+* gateway string literal) so `.switch({ model: 'openai/gpt-5' })` is
+* accepted alongside `.switch({ model: openai('gpt-4o') })`.
+*/
 const { error, httpStatus, timeout, aborted } = createErrorAPI();
 const { result, finishReason, schemaInvalid } = createResultAPI();
 

package/package.json

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

package/dist/index-C9DEYXL_.d.mts

@@ -1,30 +0,0 @@
-import { k as RetryContext, m as LanguageModelResult } from "./types-DYMm5YMu.mjs";
-import { n as Condition, t as StatusPattern } from "./error-CPbAtI-h.mjs";
-import * as _ai_sdk_provider0 from "@ai-sdk/provider";
-
-//#region src/experimental/internal/result.d.ts
-/**
- * The unified finish reason produced by the AI SDK.
- */
-type FinishReason = LanguageModelResult['finishReason']['unified'];
-//#endregion
-//#region src/experimental/language-model/retryables/index.d.ts
-/**
- * Experimental composable conditions bound to `LanguageModel`. For use
- * with `generateText`, `generateObject`, `streamText`, `streamObject`.
- *
- *   import { error, httpStatus, finishReason, ... }
- *     from 'ai-retry/experimental/language-model/retryables';
- */
-declare const error: {
-    <MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3, E = unknown>(predicate: (err: E, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
-    isRetryable<MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>(flag?: boolean): Condition<MODEL>;
-    statusCode<MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>(...patterns: Array<number | RegExp>): Condition<MODEL>;
-    message<MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>(...patterns: Array<string | RegExp>): Condition<MODEL>;
-  }, httpStatus: <MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>(...patterns: Array<StatusPattern>) => Condition<MODEL>, timeout: <MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>() => Condition<MODEL>, aborted: <MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>() => Condition<MODEL>;
-declare const result: {
-    <MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>(predicate: (res: LanguageModelResult, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
-    finishReason<MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>(...reasons: Array<FinishReason>): Condition<MODEL>;
-  }, finishReason: <MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>(...reasons: Array<FinishReason>) => Condition<MODEL>, schemaInvalid: <MODEL extends _ai_sdk_provider0.LanguageModelV3 = _ai_sdk_provider0.LanguageModelV3>() => Condition<MODEL>;
-//#endregion
-export { result as a, httpStatus as i, error as n, schemaInvalid as o, finishReason as r, timeout as s, aborted as t };

package/dist/index-TcUPTMfl.d.mts

@@ -1,30 +0,0 @@
-import { k as RetryContext, s as ImageModel } from "./types-DYMm5YMu.mjs";
-import { n as Condition, t as StatusPattern } from "./error-CPbAtI-h.mjs";
-import * as _ai_sdk_provider35 from "@ai-sdk/provider";
-
-//#region src/experimental/internal/no-image.d.ts
-/**
- * Match when image generation produced no images
- * (`NoImageGeneratedError`).
- *
- * @example
- * noImage().switch({ model: fallback })
- */
-declare function noImage<MODEL extends ImageModel = ImageModel>(): Condition<MODEL>;
-//#endregion
-//#region src/experimental/image-model/retryables/index.d.ts
-/**
- * Experimental composable conditions bound to `ImageModel`. For use with
- * `generateImage`.
- *
- *   import { error, noImage, ... }
- *     from 'ai-retry/experimental/image-model/retryables';
- */
-declare const error: {
-    <MODEL extends _ai_sdk_provider35.ImageModelV3 = _ai_sdk_provider35.ImageModelV3, E = unknown>(predicate: (err: E, ctx: RetryContext<MODEL>) => boolean | Promise<boolean>): Condition<MODEL>;
-    isRetryable<MODEL extends _ai_sdk_provider35.ImageModelV3 = _ai_sdk_provider35.ImageModelV3>(flag?: boolean): Condition<MODEL>;
-    statusCode<MODEL extends _ai_sdk_provider35.ImageModelV3 = _ai_sdk_provider35.ImageModelV3>(...patterns: Array<number | RegExp>): Condition<MODEL>;
-    message<MODEL extends _ai_sdk_provider35.ImageModelV3 = _ai_sdk_provider35.ImageModelV3>(...patterns: Array<string | RegExp>): Condition<MODEL>;
-  }, httpStatus: <MODEL extends _ai_sdk_provider35.ImageModelV3 = _ai_sdk_provider35.ImageModelV3>(...patterns: Array<StatusPattern>) => Condition<MODEL>, timeout: <MODEL extends _ai_sdk_provider35.ImageModelV3 = _ai_sdk_provider35.ImageModelV3>() => Condition<MODEL>, aborted: <MODEL extends _ai_sdk_provider35.ImageModelV3 = _ai_sdk_provider35.ImageModelV3>() => Condition<MODEL>;
-//#endregion
-export { noImage as a, timeout as i, error as n, httpStatus as r, aborted as t };