ai-retry 0.8.0 → 0.9.0

package/README.md

@@ -251,12 +251,16 @@ Errors are tracked per unique model (provider + modelId). That means on the firs
 
 There are several built-in dynamic retryables available for common use cases:
 
+> [!TIP]
+> You are missing a retryable for your use case? [Open an issue](https://github.com/zirkelc/ai-retry/issues/new) and let's discuss it!
+
 - [`contentFilterTriggered`](./src/retryables/content-filter-triggered.ts): Content filter was triggered based on the prompt or completion.
 - [`requestTimeout`](./src/retryables/request-timeout.ts): Request timeout occurred.
 - [`requestNotRetryable`](./src/retryables/request-not-retryable.ts): Request failed with a non-retryable error.
 - [`retryAfterDelay`](./src/retryables/retry-after-delay.ts): Retry with delay and exponential backoff and respect `retry-after` headers.
 - [`serviceOverloaded`](./src/retryables/service-overloaded.ts): Response with status code 529 (service overloaded).
   - Use this retryable to handle Anthropic's overloaded errors.
+- [`serviceUnavailable`](./src/retryables/service-unavailable.ts): Response with status code 503 (service unavailable).
 
 #### Content Filter
 
@@ -324,6 +328,21 @@ const retryableModel = createRetryable({
 });
 ```
 
+#### Service Unavailable
+
+Handle service unavailable errors (status code 503) by switching to a different provider.
+
+```typescript
+import { serviceUnavailable } from 'ai-retry/retryables';
+
+const retryableModel = createRetryable({
+  model: azure('gpt-4'),
+  retries: [
+    serviceUnavailable(openai('gpt-4')), // Switch to OpenAI if Azure is unavailable
+  ],
+});
+```
+
 #### Request Not Retryable
 
 Handle cases where the base model fails with a non-retryable error.

package/dist/retryables/index.d.ts

@@ -39,4 +39,11 @@ declare function retryAfterDelay<MODEL extends LanguageModelV2 | EmbeddingModelV
  */
 declare function serviceOverloaded<MODEL extends LanguageModelV2 | EmbeddingModelV2>(model: MODEL, options?: RetryableOptions<MODEL>): Retryable<MODEL>;
 //#endregion
-export { contentFilterTriggered, requestNotRetryable, requestTimeout, retryAfterDelay, serviceOverloaded };
+//#region src/retryables/service-unavailable.d.ts
+/**
+ * Fallback to a different model if the provider returns a service unavailable error.
+ * This retryable handles HTTP status code 503 (Service Unavailable).
+ */
+declare function serviceUnavailable<MODEL extends LanguageModelV2 | EmbeddingModelV2>(model: MODEL, options?: RetryableOptions<MODEL>): Retryable<MODEL>;
+//#endregion
+export { contentFilterTriggered, requestNotRetryable, requestTimeout, retryAfterDelay, serviceOverloaded, serviceUnavailable };

package/dist/retryables/index.js

@@ -152,4 +152,24 @@ function serviceOverloaded(model, options) {
 }
 
 //#endregion
-export { contentFilterTriggered, requestNotRetryable, requestTimeout, retryAfterDelay, serviceOverloaded };
+//#region src/retryables/service-unavailable.ts
+/**
+* Fallback to a different model if the provider returns a service unavailable error.
+* This retryable handles HTTP status code 503 (Service Unavailable).
+*/
+function serviceUnavailable(model, options) {
+	return (context) => {
+		const { current } = context;
+		if (isErrorAttempt(current)) {
+			const { error } = current;
+			if (APICallError.isInstance(error) && error.statusCode === 503) return {
+				model,
+				maxAttempts: 1,
+				...options
+			};
+		}
+	};
+}
+
+//#endregion
+export { contentFilterTriggered, requestNotRetryable, requestTimeout, retryAfterDelay, serviceOverloaded, serviceUnavailable };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-retry",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "AI SDK Retry",
   "main": "./dist/index.js",
   "module": "./dist/index.js",