@ai-sdk/anthropic 2.0.80 → 2.0.82

package/dist/internal/index.d.mts

@@ -2,7 +2,7 @@ import { LanguageModelV2, JSONSchema7, SharedV2ProviderMetadata, LanguageModelV2
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
-type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | (string & {});
+type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-fable-5' | (string & {});
 
 type AnthropicMessagesConfig = {
     provider: string;

package/dist/internal/index.d.ts

@@ -2,7 +2,7 @@ import { LanguageModelV2, JSONSchema7, SharedV2ProviderMetadata, LanguageModelV2
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
-type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | (string & {});
+type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-fable-5' | (string & {});
 
 type AnthropicMessagesConfig = {
     provider: string;

package/dist/internal/index.js

@@ -52,6 +52,12 @@ var anthropicFailedResponseHandler = (0, import_provider_utils.createJsonErrorRe
 // src/anthropic-messages-api.ts
 var import_provider_utils2 = require("@ai-sdk/provider-utils");
 var import_v42 = require("zod/v4");
+var anthropicStopDetailsSchema = import_v42.z.object({
+  type: import_v42.z.string(),
+  category: import_v42.z.string().nullish(),
+  explanation: import_v42.z.string().nullish(),
+  recommended_model: import_v42.z.string().nullish()
+});
 var anthropicMessagesResponseSchema = (0, import_provider_utils2.lazySchema)(
   () => (0, import_provider_utils2.zodSchema)(
     import_v42.z.object({
@@ -239,11 +245,18 @@ var anthropicMessagesResponseSchema = (0, import_provider_utils2.lazySchema)(
                 old_start: import_v42.z.number().nullable()
               })
             ])
+          }),
+          // Server-side fallback marker. Parsed so the response validates, but
+          // dropped from the content output (the AI SDK has no model-hop
+          // primitive). The hop remains observable via usage.iterations.
+          import_v42.z.object({
+            type: import_v42.z.literal("fallback")
           })
         ])
       ),
       stop_reason: import_v42.z.string().nullish(),
       stop_sequence: import_v42.z.string().nullish(),
+      stop_details: anthropicStopDetailsSchema.nullish(),
       usage: import_v42.z.looseObject({
         input_tokens: import_v42.z.number(),
         output_tokens: import_v42.z.number(),
@@ -251,9 +264,17 @@ var anthropicMessagesResponseSchema = (0, import_provider_utils2.lazySchema)(
         cache_read_input_tokens: import_v42.z.number().nullish(),
         iterations: import_v42.z.array(
           import_v42.z.object({
-            type: import_v42.z.union([import_v42.z.literal("compaction"), import_v42.z.literal("message")]),
+            type: import_v42.z.union([
+              import_v42.z.literal("compaction"),
+              import_v42.z.literal("message"),
+              import_v42.z.literal("advisor_message"),
+              import_v42.z.literal("fallback_message")
+            ]),
+            model: import_v42.z.string().nullish(),
             input_tokens: import_v42.z.number(),
-            output_tokens: import_v42.z.number()
+            output_tokens: import_v42.z.number(),
+            cache_creation_input_tokens: import_v42.z.number().nullish(),
+            cache_read_input_tokens: import_v42.z.number().nullish()
           })
         ).nullish()
       }),
@@ -459,6 +480,11 @@ var anthropicMessagesChunkSchema = (0, import_provider_utils2.lazySchema)(
                 old_start: import_v42.z.number().nullable()
               })
             ])
+          }),
+          // Server-side fallback marker; dropped from content output (see the
+          // response schema). The hop remains observable via usage.iterations.
+          import_v42.z.object({
+            type: import_v42.z.literal("fallback")
           })
         ])
       }),
@@ -532,6 +558,7 @@ var anthropicMessagesChunkSchema = (0, import_provider_utils2.lazySchema)(
         delta: import_v42.z.object({
           stop_reason: import_v42.z.string().nullish(),
           stop_sequence: import_v42.z.string().nullish(),
+          stop_details: anthropicStopDetailsSchema.nullish(),
           container: import_v42.z.object({
             expires_at: import_v42.z.string(),
             id: import_v42.z.string(),
@@ -554,9 +581,17 @@ var anthropicMessagesChunkSchema = (0, import_provider_utils2.lazySchema)(
           cache_read_input_tokens: import_v42.z.number().nullish(),
           iterations: import_v42.z.array(
             import_v42.z.object({
-              type: import_v42.z.union([import_v42.z.literal("compaction"), import_v42.z.literal("message")]),
+              type: import_v42.z.union([
+                import_v42.z.literal("compaction"),
+                import_v42.z.literal("message"),
+                import_v42.z.literal("advisor_message"),
+                import_v42.z.literal("fallback_message")
+              ]),
+              model: import_v42.z.string().nullish(),
               input_tokens: import_v42.z.number(),
-              output_tokens: import_v42.z.number()
+              output_tokens: import_v42.z.number(),
+              cache_creation_input_tokens: import_v42.z.number().nullish(),
+              cache_read_input_tokens: import_v42.z.number().nullish()
             })
           ).nullish()
         }),
@@ -731,6 +766,31 @@ var anthropicProviderOptions = import_v43.z.object({
    * See https://platform.claude.com/docs/en/build-with-claude/data-residency
    */
   inferenceGeo: import_v43.z.enum(["us", "global"]).optional(),
+  /**
+   * Server-side fallback chain.
+   *
+   * When the primary model's safety classifiers block a turn, the API
+   * automatically retries it on the next model in the chain, server-side. A
+   * `content-filter` finish reason means the entire chain refused.
+   *
+   * Each entry is merged into the request as a direct request to that entry's
+   * model, so it must be formatted accordingly: `model` is required, and an
+   * entry may additionally override `max_tokens`, `thinking`, `output_config`,
+   * and `speed` for that attempt only (`speed` additionally requires the speed
+   * beta). The value is passed through to the API as-is.
+   *
+   * The required `server-side-fallback-2026-06-01` beta is added automatically
+   * when this option is set.
+   */
+  fallbacks: import_v43.z.array(
+    import_v43.z.object({
+      model: import_v43.z.string(),
+      max_tokens: import_v43.z.number().int().optional(),
+      thinking: import_v43.z.record(import_v43.z.string(), import_v43.z.unknown()).optional(),
+      output_config: import_v43.z.record(import_v43.z.string(), import_v43.z.unknown()).optional(),
+      speed: import_v43.z.enum(["fast", "standard"]).optional()
+    })
+  ).optional(),
   /**
    * Context management configuration for automatic context window management.
    * Enables features like automatic compaction and clearing of tool uses/thinking blocks.
@@ -2291,6 +2351,9 @@ var AnthropicMessagesLanguageModel = class {
       ...(anthropicOptions == null ? void 0 : anthropicOptions.inferenceGeo) && {
         inference_geo: anthropicOptions.inferenceGeo
       },
+      ...(anthropicOptions == null ? void 0 : anthropicOptions.fallbacks) && anthropicOptions.fallbacks.length > 0 && {
+        fallbacks: anthropicOptions.fallbacks
+      },
       ...(anthropicOptions == null ? void 0 : anthropicOptions.cacheControl) && {
         cache_control: anthropicOptions.cacheControl
       },
@@ -2433,6 +2496,9 @@ var AnthropicMessagesLanguageModel = class {
     if ((anthropicOptions == null ? void 0 : anthropicOptions.speed) === "fast") {
       betas.add("fast-mode-2026-02-01");
     }
+    if ((anthropicOptions == null ? void 0 : anthropicOptions.fallbacks) && anthropicOptions.fallbacks.length > 0) {
+      betas.add("server-side-fallback-2026-06-01");
+    }
     if (useStructuredOutput) {
       betas.add("structured-outputs-2025-11-13");
     }
@@ -2532,7 +2598,7 @@ var AnthropicMessagesLanguageModel = class {
     });
   }
   async doGenerate(options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     const { args, warnings, betas, usesJsonResponseTool } = await this.getArgs({
       ...options,
       userSuppliedBetas: await this.getBetasFromHeaders(options.headers)
@@ -2772,11 +2838,20 @@ var AnthropicMessagesLanguageModel = class {
           });
           break;
         }
+        // Server-side fallback marker: the AI SDK has no content primitive for
+        // a model hop, so drop it. The hop is still observable via
+        // usage.iterations.
+        case "fallback": {
+          break;
+        }
       }
     }
     let inputTokens;
     let outputTokens;
-    if (response.usage.iterations && response.usage.iterations.length > 0) {
+    const servedByFallback = (_b = response.usage.iterations) == null ? void 0 : _b.some(
+      (iter) => iter.type === "fallback_message"
+    );
+    if (response.usage.iterations && response.usage.iterations.length > 0 && !servedByFallback) {
       const totals = response.usage.iterations.reduce(
         (acc, iter) => ({
           input: acc.input + iter.input_tokens,
@@ -2790,6 +2865,7 @@ var AnthropicMessagesLanguageModel = class {
       inputTokens = response.usage.input_tokens;
       outputTokens = response.usage.output_tokens;
     }
+    const stopDetails = mapAnthropicStopDetails(response.stop_details);
     return {
       content,
       finishReason: mapAnthropicStopReason({
@@ -2800,12 +2876,12 @@ var AnthropicMessagesLanguageModel = class {
         inputTokens,
         outputTokens,
         totalTokens: inputTokens + outputTokens,
-        cachedInputTokens: (_b = response.usage.cache_read_input_tokens) != null ? _b : void 0
+        cachedInputTokens: (_c = response.usage.cache_read_input_tokens) != null ? _c : void 0
       },
       request: { body: args },
       response: {
-        id: (_c = response.id) != null ? _c : void 0,
-        modelId: (_d = response.model) != null ? _d : void 0,
+        id: (_d = response.id) != null ? _d : void 0,
+        modelId: (_e = response.model) != null ? _e : void 0,
         headers: responseHeaders,
         body: rawResponse
       },
@@ -2813,21 +2889,23 @@ var AnthropicMessagesLanguageModel = class {
       providerMetadata: {
         anthropic: {
           usage: response.usage,
-          cacheCreationInputTokens: (_e = response.usage.cache_creation_input_tokens) != null ? _e : null,
-          stopSequence: (_f = response.stop_sequence) != null ? _f : null,
+          cacheCreationInputTokens: (_f = response.usage.cache_creation_input_tokens) != null ? _f : null,
+          stopSequence: (_g = response.stop_sequence) != null ? _g : null,
+          ...stopDetails != null ? { stopDetails } : {},
           iterations: response.usage.iterations ? response.usage.iterations.map((iter) => ({
             type: iter.type,
+            ...iter.model != null ? { model: iter.model } : {},
             inputTokens: iter.input_tokens,
             outputTokens: iter.output_tokens
           })) : null,
           container: response.container ? {
             expiresAt: response.container.expires_at,
             id: response.container.id,
-            skills: (_h = (_g = response.container.skills) == null ? void 0 : _g.map((skill) => ({
+            skills: (_i = (_h = response.container.skills) == null ? void 0 : _h.map((skill) => ({
               type: skill.type,
               skillId: skill.skill_id,
               version: skill.version
-            }))) != null ? _h : null
+            }))) != null ? _i : null
           } : null,
           contextManagement: response.context_management ? {
             appliedEdits: response.context_management.applied_edits.map(
@@ -2888,6 +2966,7 @@ var AnthropicMessagesLanguageModel = class {
     let rawUsage = void 0;
     let cacheCreationInputTokens = null;
     let stopSequence = null;
+    let stopDetails = void 0;
     let container = null;
     let iterations = null;
     let contextManagement = null;
@@ -2899,7 +2978,7 @@ var AnthropicMessagesLanguageModel = class {
           controller.enqueue({ type: "stream-start", warnings });
         },
         transform(chunk, controller) {
-          var _a2, _b2, _c, _d, _e, _f, _g, _h, _i, _j;
+          var _a2, _b2, _c, _d, _e, _f, _g, _h, _i, _j, _k;
           if (options.includeRawChunks) {
             controller.enqueue({ type: "raw", rawValue: chunk.rawValue });
           }
@@ -2914,6 +2993,9 @@ var AnthropicMessagesLanguageModel = class {
             }
             case "content_block_start": {
               const contentBlockType = value.content_block.type;
+              if (contentBlockType === "fallback") {
+                return;
+              }
               blockType = contentBlockType;
               switch (contentBlockType) {
                 case "text": {
@@ -3306,7 +3388,10 @@ var AnthropicMessagesLanguageModel = class {
               if (value.usage.iterations != null) {
                 iterations = value.usage.iterations;
               }
-              if (value.usage.iterations && value.usage.iterations.length > 0) {
+              const servedByFallback = (_f = value.usage.iterations) == null ? void 0 : _f.some(
+                (iter) => iter.type === "fallback_message"
+              );
+              if (value.usage.iterations && value.usage.iterations.length > 0 && !servedByFallback) {
                 const totals = value.usage.iterations.reduce(
                   (acc, iter) => ({
                     input: acc.input + iter.input_tokens,
@@ -3322,20 +3407,21 @@ var AnthropicMessagesLanguageModel = class {
                 }
                 usage.outputTokens = value.usage.output_tokens;
               }
-              usage.totalTokens = ((_f = usage.inputTokens) != null ? _f : 0) + ((_g = usage.outputTokens) != null ? _g : 0);
+              usage.totalTokens = ((_g = usage.inputTokens) != null ? _g : 0) + ((_h = usage.outputTokens) != null ? _h : 0);
               finishReason = mapAnthropicStopReason({
                 finishReason: value.delta.stop_reason,
                 isJsonResponseFromTool: usesJsonResponseTool
               });
-              stopSequence = (_h = value.delta.stop_sequence) != null ? _h : null;
+              stopDetails = mapAnthropicStopDetails(value.delta.stop_details);
+              stopSequence = (_i = value.delta.stop_sequence) != null ? _i : null;
               container = value.delta.container != null ? {
                 expiresAt: value.delta.container.expires_at,
                 id: value.delta.container.id,
-                skills: (_j = (_i = value.delta.container.skills) == null ? void 0 : _i.map((skill) => ({
+                skills: (_k = (_j = value.delta.container.skills) == null ? void 0 : _j.map((skill) => ({
                   type: skill.type,
                   skillId: skill.skill_id,
                   version: skill.version
-                }))) != null ? _j : null
+                }))) != null ? _k : null
               } : null;
               if (value.context_management != null) {
                 contextManagement = {
@@ -3380,8 +3466,10 @@ var AnthropicMessagesLanguageModel = class {
                     usage: rawUsage != null ? rawUsage : null,
                     cacheCreationInputTokens,
                     stopSequence,
+                    ...stopDetails != null ? { stopDetails } : {},
                     iterations: iterations ? iterations.map((iter) => ({
                       type: iter.type,
+                      ...iter.model != null ? { model: iter.model } : {},
                       inputTokens: iter.input_tokens,
                       outputTokens: iter.output_tokens
                     })) : null,
@@ -3437,7 +3525,7 @@ var AnthropicMessagesLanguageModel = class {
   }
 };
 function getModelCapabilities(modelId) {
-  if (modelId.includes("claude-opus-4-8") || modelId.includes("claude-opus-4-7")) {
+  if (modelId.includes("claude-opus-4-8") || modelId.includes("claude-opus-4-7") || modelId.includes("claude-fable-5")) {
     return {
       maxOutputTokens: 128e3,
       supportsStructuredOutput: true,
@@ -3502,6 +3590,17 @@ function getModelCapabilities(modelId) {
     };
   }
 }
+function mapAnthropicStopDetails(stopDetails) {
+  if (stopDetails == null) {
+    return void 0;
+  }
+  return {
+    type: stopDetails.type,
+    ...stopDetails.category != null ? { category: stopDetails.category } : {},
+    ...stopDetails.explanation != null ? { explanation: stopDetails.explanation } : {},
+    ...stopDetails.recommended_model != null ? { recommendedModel: stopDetails.recommended_model } : {}
+  };
+}
 
 // src/tool/bash_20241022.ts
 var import_provider_utils11 = require("@ai-sdk/provider-utils");