ai-retry 2.0.0-beta.0 → 2.0.0-beta.1

package/README.md

@@ -715,11 +715,11 @@ const retryableModel = createRetryableModel({
 > [!NOTE]
 > Experimental: span names and attributes may change in patch versions.
 
-`ai-retry` can emit [OpenTelemetry](https://opentelemetry.io/) spans for each request and every retry attempt. Spans are created on the active OpenTelemetry context, so they nest automatically under the AI SDK's own spans (e.g. `ai.generateText.doGenerate`) when you also enable `experimental_telemetry` on `generateText` / `streamText`. A single trace then shows the individual attempts — which model each used, why it was retried, and the backoff between them — that the SDK's own span otherwise hides.
+`ai-retry` can emit [OpenTelemetry](https://opentelemetry.io/) spans for each request and every retry attempt. Spans are created on the active OpenTelemetry context, so they nest automatically under the AI SDK's own spans (e.g. `ai.generateText.doGenerate`) when that integration is active — in AI SDK v7 that means installing [`@ai-sdk/otel`](https://ai-sdk.dev/docs/ai-sdk-core/telemetry) and registering it with `registerTelemetry(new OpenTelemetry())`. A single trace then shows the individual attempts — which model each used, why it was retried, and the backoff between them — that the SDK's own span otherwise hides. Retry telemetry works on its own too: it talks to OpenTelemetry directly, so it does not require `@ai-sdk/otel`.
 
 #### Setup
 
-Telemetry uses the optional peer dependency `@opentelemetry/api` (already present if you use the AI SDK). Register an OpenTelemetry SDK once at startup, then opt in per model:
+Telemetry uses the optional peer dependency `@opentelemetry/api`. In AI SDK v7 it is no longer a transitive dependency of `ai`, so install `@ai-sdk/otel` (which brings it in) or `@opentelemetry/api` directly. Register an OpenTelemetry SDK once at startup, then opt in per model:
 
 ```typescript
 import { createRetryableModel } from 'ai-retry/language-model';
@@ -727,11 +727,14 @@ import { createRetryableModel } from 'ai-retry/language-model';
 const retryableModel = createRetryableModel({
   model: openai('gpt-4o'),
   retries: [anthropic('claude-sonnet-4-5')],
-  experimental_telemetry: { isEnabled: true },
+  telemetry: { isEnabled: true },
 });
 ```
 
-The settings mirror the AI SDK's `experimental_telemetry` shape:
+> [!NOTE]
+> `telemetry` replaces the now-deprecated `experimental_telemetry` option. The old name still works as an alias; when both are set, `telemetry` wins.
+
+The settings resemble the AI SDK's `telemetry` shape, but stay opt-in and keep a `tracer` field (which the AI SDK moved into `@ai-sdk/otel`):
 
 ```ts
 interface RetryTelemetrySettings {
@@ -844,6 +847,8 @@ interface RetryableModelOptions<
   retries: Array<Retryable<MODEL> | MODEL>;
   disabled?: boolean | (() => boolean);
   reset?: Reset;
+  telemetry?: RetryTelemetrySettings;
+  /** @deprecated use `telemetry` */
   experimental_telemetry?: RetryTelemetrySettings;
   onError?: (context: RetryContext<MODEL>) => void;
   onRetry?: (
@@ -860,7 +865,7 @@ interface RetryableModelOptions<
 - `retries` — array of conditions (`.switch(...)` / `.retry(...)` outputs), models, or retry objects to try on failure.
 - `disabled` — disable all retry logic. `boolean` or `() => boolean`. Default `false`.
 - `reset` — controls when to reset back to the base model after a successful retry. Default `'after-request'`.
-- `experimental_telemetry` — OpenTelemetry instrumentation. See [Telemetry](#telemetry).
+- `telemetry` — OpenTelemetry instrumentation. See [Telemetry](#telemetry). (`experimental_telemetry` is a deprecated alias.)
 - `onError` — fires when an error occurs.
 - `onRetry` — fires before a retry attempt. May return `OnRetryOverrides` (or a promise of one) to override `options.*` for that attempt only. See [Dynamic call options](#dynamic-call-options).
 - `onSuccess` — fires after a successful request.

package/dist/{create-retryable-model-CmfSxgGj.mjs → create-retryable-model-CCvLZL7h.mjs}

@@ -1,4 +1,4 @@
-import { a as prepareRetryError, c as resolveImageModel, f as calculateExponentialBackoff, o as findRetryModel, p as BaseRetryableModel, r as mergeImageModelCallOptions, t as createRetryTelemetry, u as countModelAttempts } from "./telemetry-bNsaXZUI.mjs";
+import { a as prepareRetryError, c as resolveImageModel, f as calculateExponentialBackoff, o as findRetryModel, p as BaseRetryableModel, r as mergeImageModelCallOptions, t as createRetryTelemetry, u as countModelAttempts } from "./telemetry-B0Pblnhb.mjs";
 import { o as isModel } from "./guards-CKn5dl__.mjs";
 import { delay } from "@ai-sdk/provider-utils";
 
@@ -180,7 +180,7 @@ var RetryableImageModel = class extends BaseRetryableModel {
 		* If retries are disabled, bypass retry machinery entirely
 		*/
 		if (this.isDisabled()) return this.currentModel.doGenerate(callOptions);
-		const recorder = await createRetryTelemetry(this.options.experimental_telemetry, {
+		const recorder = await createRetryTelemetry(this.telemetrySettings, {
 			operation: "doGenerate",
 			genAiOperation: "generate_content",
 			provider: startModel.provider,

package/dist/{create-retryable-model-kbZjWNJ0.mjs → create-retryable-model-D4v2D0iX.mjs}

@@ -1,4 +1,4 @@
-import { a as prepareRetryError, f as calculateExponentialBackoff, i as mergeLanguageModelCallOptions, l as resolveLanguageModel, o as findRetryModel, p as BaseRetryableModel, t as createRetryTelemetry, u as countModelAttempts } from "./telemetry-bNsaXZUI.mjs";
+import { a as prepareRetryError, f as calculateExponentialBackoff, i as mergeLanguageModelCallOptions, l as resolveLanguageModel, o as findRetryModel, p as BaseRetryableModel, t as createRetryTelemetry, u as countModelAttempts } from "./telemetry-B0Pblnhb.mjs";
 import { i as isGenerateResult, l as isStreamContentPart, o as isModel, r as isErrorAttempt } from "./guards-CKn5dl__.mjs";
 import { delay } from "@ai-sdk/provider-utils";
 
@@ -242,7 +242,7 @@ var RetryableLanguageModel = class extends BaseRetryableModel {
 		* If retries are disabled, bypass retry machinery entirely
 		*/
 		if (this.isDisabled()) return this.currentModel.doGenerate(callOptions);
-		const recorder = await createRetryTelemetry(this.options.experimental_telemetry, {
+		const recorder = await createRetryTelemetry(this.telemetrySettings, {
 			operation: "doGenerate",
 			genAiOperation: "chat",
 			provider: startModel.provider,
@@ -296,7 +296,7 @@ var RetryableLanguageModel = class extends BaseRetryableModel {
 		* If retries are disabled, bypass retry machinery entirely
 		*/
 		if (this.isDisabled()) return this.currentModel.doStream(callOptions);
-		const recorder = await createRetryTelemetry(this.options.experimental_telemetry, {
+		const recorder = await createRetryTelemetry(this.telemetrySettings, {
 			operation: "doStream",
 			genAiOperation: "chat",
 			provider: startModel.provider,

package/dist/{create-retryable-model-CHCZ0fQk.mjs → create-retryable-model-ushVtD_m.mjs}

@@ -1,4 +1,4 @@
-import { a as prepareRetryError, f as calculateExponentialBackoff, n as mergeEmbeddingModelCallOptions, o as findRetryModel, p as BaseRetryableModel, s as resolveEmbeddingModel, t as createRetryTelemetry, u as countModelAttempts } from "./telemetry-bNsaXZUI.mjs";
+import { a as prepareRetryError, f as calculateExponentialBackoff, n as mergeEmbeddingModelCallOptions, o as findRetryModel, p as BaseRetryableModel, s as resolveEmbeddingModel, t as createRetryTelemetry, u as countModelAttempts } from "./telemetry-B0Pblnhb.mjs";
 import { o as isModel } from "./guards-CKn5dl__.mjs";
 import { delay } from "@ai-sdk/provider-utils";
 
@@ -183,7 +183,7 @@ var RetryableEmbeddingModel = class extends BaseRetryableModel {
 		* If retries are disabled, bypass retry machinery entirely
 		*/
 		if (this.isDisabled()) return this.currentModel.doEmbed(callOptions);
-		const recorder = await createRetryTelemetry(this.options.experimental_telemetry, {
+		const recorder = await createRetryTelemetry(this.telemetrySettings, {
 			operation: "doEmbed",
 			genAiOperation: "embeddings",
 			provider: startModel.provider,

package/dist/embedding-model/conditions/index.d.mts

@@ -1,5 +1,5 @@
-import { F as RetryContext, T as ResolvableEmbeddingModel } from "../../types-BrvhJykE.mjs";
-import { a as Condition, i as StatusPattern, n as not, r as and, t as or } from "../../or-MbQSVByG.mjs";
+import { F as RetryContext, T as ResolvableEmbeddingModel } from "../../types-DzfKbxXv.mjs";
+import { a as Condition, i as StatusPattern, n as not, r as and, t as or } from "../../or-CMOEoNU-.mjs";
 
 //#region src/embedding-model/conditions/index.d.ts
 declare const error: {

package/dist/embedding-model/index.d.mts

@@ -1,5 +1,5 @@
-import { B as RetryableModelOptions, T as ResolvableEmbeddingModel, r as EmbeddingModel } from "../types-BrvhJykE.mjs";
-import { n as not, r as and, t as or } from "../or-MbQSVByG.mjs";
+import { B as RetryableModelOptions, T as ResolvableEmbeddingModel, r as EmbeddingModel } from "../types-DzfKbxXv.mjs";
+import { n as not, r as and, t as or } from "../or-CMOEoNU-.mjs";
 import { aborted, error, httpStatus, timeout } from "./conditions/index.mjs";
 
 //#region src/embedding-model/create-retryable-model.d.ts

package/dist/embedding-model/index.mjs

@@ -1,5 +1,5 @@
-import "../telemetry-bNsaXZUI.mjs";
-import { t as createRetryableModel } from "../create-retryable-model-CHCZ0fQk.mjs";
+import "../telemetry-B0Pblnhb.mjs";
+import { t as createRetryableModel } from "../create-retryable-model-ushVtD_m.mjs";
 import { i as or, n as and, t as not } from "../not-6hBRaJRl.mjs";
 import { aborted, error, httpStatus, timeout } from "./conditions/index.mjs";
 

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

@@ -1,4 +1,4 @@
-import "../../types-BrvhJykE.mjs";
-import { n as not, r as and, t as or } from "../../or-MbQSVByG.mjs";
-import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../index-ChhH9SEc.mjs";
+import "../../types-DzfKbxXv.mjs";
+import { n as not, r as and, t as or } from "../../or-CMOEoNU-.mjs";
+import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../../index-bEq1CHFY.mjs";
 export { aborted, and, error, httpStatus, noImage, not, or, timeout };

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

@@ -1,6 +1,6 @@
-import { B as RetryableModelOptions, E as ResolvableImageModel, d as ImageModel } from "../types-BrvhJykE.mjs";
-import { n as not, r as and, t as or } from "../or-MbQSVByG.mjs";
-import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../index-ChhH9SEc.mjs";
+import { B as RetryableModelOptions, E as ResolvableImageModel, d as ImageModel } from "../types-DzfKbxXv.mjs";
+import { n as not, r as and, t as or } from "../or-CMOEoNU-.mjs";
+import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../index-bEq1CHFY.mjs";
 
 //#region src/image-model/create-retryable-model.d.ts
 /**

package/dist/image-model/index.mjs

@@ -1,5 +1,5 @@
-import "../telemetry-bNsaXZUI.mjs";
-import { t as createRetryableModel } from "../create-retryable-model-CmfSxgGj.mjs";
+import "../telemetry-B0Pblnhb.mjs";
+import { t as createRetryableModel } from "../create-retryable-model-CCvLZL7h.mjs";
 import { i as or, n as and, t as not } from "../not-6hBRaJRl.mjs";
 import { a as noImage, i as timeout, n as error, r as httpStatus, t as aborted } from "../conditions-CfeJD4K4.mjs";
 

package/dist/{index-Bo_FxEjD.d.mts → index-5jhZQN3C.d.mts}

@@ -1,5 +1,5 @@
-import { D as ResolvableLanguageModel, F as RetryContext, v as LanguageModelResult } from "./types-BrvhJykE.mjs";
-import { a as Condition, i as StatusPattern } from "./or-MbQSVByG.mjs";
+import { D as ResolvableLanguageModel, F as RetryContext, v as LanguageModelResult } from "./types-DzfKbxXv.mjs";
+import { a as Condition, i as StatusPattern } from "./or-CMOEoNU-.mjs";
 
 //#region src/internal/conditions/result.d.ts
 /**

package/dist/{index-ChhH9SEc.d.mts → index-bEq1CHFY.d.mts}

@@ -1,5 +1,5 @@
-import { E as ResolvableImageModel, F as RetryContext } from "./types-BrvhJykE.mjs";
-import { a as Condition, i as StatusPattern } from "./or-MbQSVByG.mjs";
+import { E as ResolvableImageModel, F as RetryContext } from "./types-DzfKbxXv.mjs";
+import { a as Condition, i as StatusPattern } from "./or-CMOEoNU-.mjs";
 
 //#region src/internal/conditions/no-image.d.ts
 /**

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as Result, B as RetryableModelOptions, C as ProviderOptions, D as ResolvableLanguageModel, E as ResolvableImageModel, F as RetryContext, H as SuccessAttempt, I as RetryErrorAttempt, L as RetryResultAttempt, M as Retry, N as RetryAttempt, O as ResolvableModel, P as RetryCallOptions, R as RetryTelemetrySettings, S as OnRetryOverrides, T as ResolvableEmbeddingModel, U as SuccessContext, V as RetryableOptions, _ as LanguageModelGenerate, a as EmbeddingModelEmbed, b as LanguageModelStream, c as GatewayEmbeddingModelId, d as ImageModel, f as ImageModelCallOptions, g as LanguageModelCallOptions, h as LanguageModel, i as EmbeddingModelCallOptions, j as Retries, k as ResolvedModel, l as GatewayImageModelId, m as ImageModelRetryCallOptions, n as CallOptions, o as EmbeddingModelRetryCallOptions, p as ImageModelGenerate, r as EmbeddingModel, s as FailureContext, t as AnyResolvableModel, u as GatewayLanguageModelId, v as LanguageModelResult, w as Reset, x as LanguageModelStreamPart, y as LanguageModelRetryCallOptions, z as Retryable } from "./types-BrvhJykE.mjs";
+import { A as Result, B as RetryableModelOptions, C as ProviderOptions, D as ResolvableLanguageModel, E as ResolvableImageModel, F as RetryContext, H as SuccessAttempt, I as RetryErrorAttempt, L as RetryResultAttempt, M as Retry, N as RetryAttempt, O as ResolvableModel, P as RetryCallOptions, R as RetryTelemetrySettings, S as OnRetryOverrides, T as ResolvableEmbeddingModel, U as SuccessContext, V as RetryableOptions, _ as LanguageModelGenerate, a as EmbeddingModelEmbed, b as LanguageModelStream, c as GatewayEmbeddingModelId, d as ImageModel, f as ImageModelCallOptions, g as LanguageModelCallOptions, h as LanguageModel, i as EmbeddingModelCallOptions, j as Retries, k as ResolvedModel, l as GatewayImageModelId, m as ImageModelRetryCallOptions, n as CallOptions, o as EmbeddingModelRetryCallOptions, p as ImageModelGenerate, r as EmbeddingModel, s as FailureContext, t as AnyResolvableModel, u as GatewayLanguageModelId, v as LanguageModelResult, w as Reset, x as LanguageModelStreamPart, y as LanguageModelRetryCallOptions, z as Retryable } from "./types-DzfKbxXv.mjs";
 import "@ai-sdk/provider";
 
 //#region src/internal/create-retryable-model.d.ts

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { d as getModelKey, l as resolveLanguageModel } from "./telemetry-bNsaXZUI.mjs";
+import { d as getModelKey, l as resolveLanguageModel } from "./telemetry-B0Pblnhb.mjs";
 import { a as isImageModel, c as isResultAttempt, n as isEmbeddingModel, o as isModel, r as isErrorAttempt } from "./guards-CKn5dl__.mjs";
-import { t as createRetryableModel$1 } from "./create-retryable-model-CHCZ0fQk.mjs";
-import { t as createRetryableModel$2 } from "./create-retryable-model-CmfSxgGj.mjs";
-import { t as createRetryableModel$3 } from "./create-retryable-model-kbZjWNJ0.mjs";
+import { t as createRetryableModel$1 } from "./create-retryable-model-ushVtD_m.mjs";
+import { t as createRetryableModel$2 } from "./create-retryable-model-CCvLZL7h.mjs";
+import { t as createRetryableModel$3 } from "./create-retryable-model-D4v2D0iX.mjs";
 
 //#region src/internal/create-retryable-model.ts
 function createRetryableModel(options) {

package/dist/language-model/conditions/index.d.mts

@@ -1,4 +1,4 @@
-import "../../types-BrvhJykE.mjs";
-import { n as not, r as and, t as or } from "../../or-MbQSVByG.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-Bo_FxEjD.mjs";
+import "../../types-DzfKbxXv.mjs";
+import { n as not, r as and, t as or } from "../../or-CMOEoNU-.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-5jhZQN3C.mjs";
 export { aborted, and, error, finishReason, httpStatus, not, or, result, schemaInvalid, timeout };

package/dist/language-model/index.d.mts

@@ -1,6 +1,6 @@
-import { B as RetryableModelOptions, D as ResolvableLanguageModel, h as LanguageModel } from "../types-BrvhJykE.mjs";
-import { n as not, r as and, t as or } from "../or-MbQSVByG.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-Bo_FxEjD.mjs";
+import { B as RetryableModelOptions, D as ResolvableLanguageModel, h as LanguageModel } from "../types-DzfKbxXv.mjs";
+import { n as not, r as and, t as or } from "../or-CMOEoNU-.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-5jhZQN3C.mjs";
 
 //#region src/language-model/create-retryable-model.d.ts
 /**

package/dist/language-model/index.mjs

@@ -1,5 +1,5 @@
-import "../telemetry-bNsaXZUI.mjs";
-import { t as createRetryableModel } from "../create-retryable-model-kbZjWNJ0.mjs";
+import "../telemetry-B0Pblnhb.mjs";
+import { t as createRetryableModel } from "../create-retryable-model-D4v2D0iX.mjs";
 import { i as or, n as and, t as not } from "../not-6hBRaJRl.mjs";
 import { a as result, i as httpStatus, n as error, o as schemaInvalid, r as finishReason, s as timeout, t as aborted } from "../conditions-DAetW5_1.mjs";
 

package/dist/{or-MbQSVByG.d.mts → or-CMOEoNU-.d.mts}

@@ -1,4 +1,4 @@
-import { F as RetryContext, M as Retry, t as AnyResolvableModel, z as Retryable } from "./types-BrvhJykE.mjs";
+import { F as RetryContext, M as Retry, t as AnyResolvableModel, z as Retryable } from "./types-DzfKbxXv.mjs";
 
 //#region src/internal/conditions/condition.d.ts
 /**

package/dist/retryables/index.d.mts

@@ -1,4 +1,4 @@
-import { D as ResolvableLanguageModel, E as ResolvableImageModel, V as RetryableOptions, t as AnyResolvableModel, z as Retryable } from "../types-BrvhJykE.mjs";
+import { D as ResolvableLanguageModel, E as ResolvableImageModel, V as RetryableOptions, t as AnyResolvableModel, z as Retryable } from "../types-DzfKbxXv.mjs";
 
 //#region src/retryables/content-filter-triggered.d.ts
 /**

package/dist/{telemetry-bNsaXZUI.mjs → telemetry-B0Pblnhb.mjs}

@@ -73,6 +73,13 @@ var BaseRetryableModel = class {
 		};
 	}
 	/**
+	* Resolve the telemetry settings, preferring `telemetry` over the deprecated
+	* `experimental_telemetry` alias.
+	*/
+	get telemetrySettings() {
+		return this.options.telemetry ?? this.options.experimental_telemetry;
+	}
+	/**
 	* Check if retries are disabled
 	*/
 	isDisabled() {

package/dist/{types-BrvhJykE.d.mts → types-DzfKbxXv.d.mts}

@@ -149,13 +149,20 @@ type FailureContext<MODEL extends ResolvableLanguageModel | EmbeddingModel | Ima
 /**
  * Telemetry configuration for retry instrumentation.
  *
- * Mirrors the AI SDK's `experimental_telemetry` shape so the two can be
- * configured the same way. When enabled, each request emits an OpenTelemetry
- * span for the operation with a child span per attempt. Spans created here
- * nest under any active span (e.g. the AI SDK's `ai.generateText.doGenerate`)
- * via OpenTelemetry context propagation.
+ * Talks to OpenTelemetry directly and independently of the AI SDK: when
+ * enabled, each request emits a span for the operation with a child span per
+ * attempt. Spans created here nest under any active span (e.g. the AI SDK's
+ * `ai.generateText.doGenerate`, when that integration is registered) via
+ * OpenTelemetry context propagation.
  *
- * Requires the optional peer dependency `@opentelemetry/api` to be installed.
+ * The shape resembles the AI SDK's `telemetry` settings but is opt-in and
+ * deliberately keeps a `tracer` field (which the AI SDK moved to its
+ * `@ai-sdk/otel` integration), so retry spans work without adopting that
+ * integration.
+ *
+ * Requires the optional peer dependency `@opentelemetry/api` to be installed
+ * (in AI SDK v7 it is no longer a transitive dependency of `ai`; install
+ * `@ai-sdk/otel` or `@opentelemetry/api` directly).
  */
 interface RetryTelemetrySettings {
   /**
@@ -197,6 +204,11 @@ interface RetryableModelOptions<MODEL extends LanguageModel | EmbeddingModel | I
    * Telemetry configuration. When enabled, emits OpenTelemetry spans for
    * retry operations and attempts. Requires `@opentelemetry/api`.
    */
+  telemetry?: RetryTelemetrySettings;
+  /**
+   * @deprecated Use `telemetry` instead. Kept as an alias for compatibility;
+   * when both are set, `telemetry` takes precedence.
+   */
   experimental_telemetry?: RetryTelemetrySettings;
   onError?: (context: RetryContext<MODEL>) => void;
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-retry",
-  "version": "2.0.0-beta.0",
+  "version": "2.0.0-beta.1",
   "description": "Retry and fallback mechanisms for AI SDK",
   "keywords": [
     "ai",