@ai-sdk/anthropic 3.0.80 → 3.0.82

package/dist/internal/index.d.mts

@@ -2,7 +2,7 @@ import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateRes
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
-type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | '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' | (string & {});
+type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | '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;
@@ -70,7 +70,7 @@ declare const anthropicTools: {
      * Supported executor models: Claude Haiku 4.5, Sonnet 4.6, Opus 4.6,
      * Opus 4.7. The advisor must be at least as capable as the executor.
      *
-     * @param model - The advisor model ID (required), e.g. `"claude-opus-4-7"`.
+     * @param model - The advisor model ID (required), e.g. `"claude-opus-4-8"`.
      * @param maxUses - Maximum advisor calls per request (per-request cap).
      * @param caching - Enables prompt caching for the advisor's transcript
      * across calls within a conversation. Worthwhile from ~3 advisor calls

package/dist/internal/index.d.ts

@@ -2,7 +2,7 @@ import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateRes
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
-type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | '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' | (string & {});
+type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | '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;
@@ -70,7 +70,7 @@ declare const anthropicTools: {
      * Supported executor models: Claude Haiku 4.5, Sonnet 4.6, Opus 4.6,
      * Opus 4.7. The advisor must be at least as capable as the executor.
      *
-     * @param model - The advisor model ID (required), e.g. `"claude-opus-4-7"`.
+     * @param model - The advisor model ID (required), e.g. `"claude-opus-4-8"`.
      * @param maxUses - Maximum advisor calls per request (per-request cap).
      * @param caching - Enables prompt caching for the advisor's transcript
      * across calls within a conversation. Worthwhile from ~3 advisor calls

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({
@@ -337,34 +343,37 @@ var anthropicMessagesResponseSchema = (0, import_provider_utils2.lazySchema)(
                 error_code: import_v42.z.string()
               })
             ])
+          }),
+          // 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(),
         cache_creation_input_tokens: import_v42.z.number().nullish(),
         cache_read_input_tokens: import_v42.z.number().nullish(),
         iterations: import_v42.z.array(
-          import_v42.z.union([
-            import_v42.z.object({
-              type: import_v42.z.union([import_v42.z.literal("compaction"), import_v42.z.literal("message")]),
-              input_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()
-            }),
-            import_v42.z.object({
-              type: import_v42.z.literal("advisor_message"),
-              model: import_v42.z.string(),
-              input_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()
-            })
-          ])
+          import_v42.z.object({
+            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(),
+            cache_creation_input_tokens: import_v42.z.number().nullish(),
+            cache_read_input_tokens: import_v42.z.number().nullish()
+          })
         ).nullish()
       }),
       container: import_v42.z.object({
@@ -699,6 +708,11 @@ var anthropicMessagesChunkSchema = (0, import_provider_utils2.lazySchema)(
                 error_code: import_v42.z.string()
               })
             ])
+          }),
+          // 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")
           })
         ])
       }),
@@ -772,6 +786,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(),
@@ -793,26 +808,19 @@ var anthropicMessagesChunkSchema = (0, import_provider_utils2.lazySchema)(
           cache_creation_input_tokens: import_v42.z.number().nullish(),
           cache_read_input_tokens: import_v42.z.number().nullish(),
           iterations: import_v42.z.array(
-            import_v42.z.union([
-              import_v42.z.object({
-                type: import_v42.z.union([
-                  import_v42.z.literal("compaction"),
-                  import_v42.z.literal("message")
-                ]),
-                input_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()
-              }),
-              import_v42.z.object({
-                type: import_v42.z.literal("advisor_message"),
-                model: import_v42.z.string(),
-                input_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()
-              })
-            ])
+            import_v42.z.object({
+              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(),
+              cache_creation_input_tokens: import_v42.z.number().nullish(),
+              cache_read_input_tokens: import_v42.z.number().nullish()
+            })
           ).nullish()
         }),
         context_management: import_v42.z.object({
@@ -1016,6 +1024,31 @@ var anthropicLanguageModelOptions = 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(),
   /**
    * A set of beta features to enable.
    * Allow a provider to receive the full `betas` set if it needs it.
@@ -1770,12 +1803,15 @@ function convertAnthropicMessagesUsage({
   usage,
   rawUsage
 }) {
-  var _a, _b;
+  var _a, _b, _c;
   const cacheCreationTokens = (_a = usage.cache_creation_input_tokens) != null ? _a : 0;
   const cacheReadTokens = (_b = usage.cache_read_input_tokens) != null ? _b : 0;
   let inputTokens;
   let outputTokens;
-  if (usage.iterations && usage.iterations.length > 0) {
+  const servedByFallback = (_c = usage.iterations) == null ? void 0 : _c.some(
+    (iter) => iter.type === "fallback_message"
+  );
+  if (usage.iterations && usage.iterations.length > 0 && !servedByFallback) {
     const executorIterations = usage.iterations.filter(
       (iter) => iter.type === "compaction" || iter.type === "message"
     );
@@ -2202,19 +2238,20 @@ async function convertToAnthropicMessagesPrompt({
     const type = block.type;
     switch (type) {
       case "system": {
-        if (system != null) {
-          throw new import_provider2.UnsupportedFunctionalityError({
-            functionality: "Multiple system messages that are separated by user/assistant messages"
-          });
-        }
-        system = block.messages.map(({ content, providerOptions }) => ({
+        const content = block.messages.map(({ content: content2, providerOptions }) => ({
           type: "text",
-          text: content,
+          text: content2,
           cache_control: validator.getCacheControl(providerOptions, {
             type: "system message",
             canCache: true
           })
         }));
+        if (system == null) {
+          system = content;
+        } else {
+          messages.push({ role: "system", content });
+          betas.add("mid-conversation-system-2026-04-07");
+        }
         break;
       }
       case "user": {
@@ -3444,6 +3481,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
       },
@@ -3620,6 +3660,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");
+    }
     const defaultEagerInputStreaming = stream && ((_i = anthropicOptions == null ? void 0 : anthropicOptions.toolStreaming) != null ? _i : true);
     const {
       tools: anthropicTools2,
@@ -4142,6 +4185,12 @@ 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;
+        }
       }
     }
     return {
@@ -4164,24 +4213,16 @@ var AnthropicMessagesLanguageModel = class {
       warnings,
       providerMetadata: (() => {
         var _a2, _b2, _c2, _d2, _e2;
+        const stopDetails = mapAnthropicStopDetails(response.stop_details);
         const anthropicMetadata = {
           usage: response.usage,
           cacheCreationInputTokens: (_a2 = response.usage.cache_creation_input_tokens) != null ? _a2 : null,
           stopSequence: (_b2 = response.stop_sequence) != null ? _b2 : null,
+          ...stopDetails != null ? { stopDetails } : {},
           iterations: response.usage.iterations ? response.usage.iterations.map(
-            (iter) => iter.type === "advisor_message" ? {
-              type: iter.type,
-              model: iter.model,
-              inputTokens: iter.input_tokens,
-              outputTokens: iter.output_tokens,
-              ...iter.cache_creation_input_tokens ? {
-                cacheCreationInputTokens: iter.cache_creation_input_tokens
-              } : {},
-              ...iter.cache_read_input_tokens ? {
-                cacheReadInputTokens: iter.cache_read_input_tokens
-              } : {}
-            } : {
+            (iter) => ({
               type: iter.type,
+              ...iter.model != null ? { model: iter.model } : {},
               inputTokens: iter.input_tokens,
               outputTokens: iter.output_tokens,
               ...iter.cache_creation_input_tokens ? {
@@ -4190,7 +4231,7 @@ var AnthropicMessagesLanguageModel = class {
               ...iter.cache_read_input_tokens ? {
                 cacheReadInputTokens: iter.cache_read_input_tokens
               } : {}
-            }
+            })
           ) : null,
           container: response.container ? {
             expiresAt: response.container.expires_at,
@@ -4266,6 +4307,7 @@ var AnthropicMessagesLanguageModel = class {
     let rawUsage = void 0;
     let cacheCreationInputTokens = null;
     let stopSequence = null;
+    let stopDetails = void 0;
     let container = null;
     let isJsonResponseFromTool = false;
     let blockType = void 0;
@@ -4292,6 +4334,9 @@ var AnthropicMessagesLanguageModel = class {
             case "content_block_start": {
               const part = value.content_block;
               const contentBlockType = part.type;
+              if (contentBlockType === "fallback") {
+                return;
+              }
               blockType = contentBlockType;
               switch (contentBlockType) {
                 case "text": {
@@ -4965,6 +5010,7 @@ var AnthropicMessagesLanguageModel = class {
                 raw: (_k = value.delta.stop_reason) != null ? _k : void 0
               };
               stopSequence = (_l = value.delta.stop_sequence) != null ? _l : null;
+              stopDetails = mapAnthropicStopDetails(value.delta.stop_details);
               container = value.delta.container != null ? {
                 expiresAt: value.delta.container.expires_at,
                 id: value.delta.container.id,
@@ -4990,20 +5036,11 @@ var AnthropicMessagesLanguageModel = class {
                 usage: rawUsage != null ? rawUsage : null,
                 cacheCreationInputTokens,
                 stopSequence,
+                ...stopDetails != null ? { stopDetails } : {},
                 iterations: usage.iterations ? usage.iterations.map(
-                  (iter) => iter.type === "advisor_message" ? {
-                    type: iter.type,
-                    model: iter.model,
-                    inputTokens: iter.input_tokens,
-                    outputTokens: iter.output_tokens,
-                    ...iter.cache_creation_input_tokens ? {
-                      cacheCreationInputTokens: iter.cache_creation_input_tokens
-                    } : {},
-                    ...iter.cache_read_input_tokens ? {
-                      cacheReadInputTokens: iter.cache_read_input_tokens
-                    } : {}
-                  } : {
+                  (iter) => ({
                     type: iter.type,
+                    ...iter.model != null ? { model: iter.model } : {},
                     inputTokens: iter.input_tokens,
                     outputTokens: iter.output_tokens,
                     ...iter.cache_creation_input_tokens ? {
@@ -5012,7 +5049,7 @@ var AnthropicMessagesLanguageModel = class {
                     ...iter.cache_read_input_tokens ? {
                       cacheReadInputTokens: iter.cache_read_input_tokens
                     } : {}
-                  }
+                  })
                 ) : null,
                 container,
                 contextManagement
@@ -5076,7 +5113,7 @@ var AnthropicMessagesLanguageModel = class {
   }
 };
 function getModelCapabilities(modelId) {
-  if (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,
@@ -5177,6 +5214,17 @@ function mapAnthropicResponseContextManagement(contextManagement) {
     }).filter((edit) => edit !== void 0)
   } : null;
 }
+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_utils16 = require("@ai-sdk/provider-utils");
@@ -5494,7 +5542,7 @@ var anthropicTools = {
    * Supported executor models: Claude Haiku 4.5, Sonnet 4.6, Opus 4.6,
    * Opus 4.7. The advisor must be at least as capable as the executor.
    *
-   * @param model - The advisor model ID (required), e.g. `"claude-opus-4-7"`.
+   * @param model - The advisor model ID (required), e.g. `"claude-opus-4-8"`.
    * @param maxUses - Maximum advisor calls per request (per-request cap).
    * @param caching - Enables prompt caching for the advisor's transcript
    * across calls within a conversation. Worthwhile from ~3 advisor calls