@ai-sdk/anthropic 3.0.80 → 3.0.82

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-sdk/anthropic
 
+## 3.0.82
+
+### Patch Changes
+
+- 2a91a17: feat(provider/anthropic): add support for `claude-fable-5` and the `fallbacks` API parameter
+
+## 3.0.81
+
+### Patch Changes
+
+- 4084fcd: feat(provider/anthropic): add support for `claude-opus-4-8`
+
 ## 3.0.80
 
 ### Patch Changes

package/dist/index.d.mts

@@ -11,34 +11,21 @@ import { FetchFunction } from '@ai-sdk/provider-utils';
  * - `compaction`: a context compaction step (billed at executor rates).
  * - `message`: an executor sampling iteration (billed at executor rates).
  * - `advisor_message`: an advisor sub-inference (billed at the advisor
- *   model's rates; `model` carries the advisor model ID). Advisor token
- *   usage is NOT rolled into the top-level usage totals because it bills
- *   at a different rate; inspect this array directly for advisor billing.
+ *   model's rates). Advisor token usage is NOT rolled into the top-level
+ *   usage totals because it bills at a different rate; inspect this array
+ *   directly for advisor billing.
+ * - `fallback_message`: a server-side fallback attempt that served the turn.
+ *   Inspect this array for exact per-model attribution on a turn that fell
+ *   back.
  */
 type AnthropicUsageIteration = {
-    type: 'compaction' | 'message';
+    type: 'compaction' | 'message' | 'advisor_message' | 'fallback_message';
     /**
-     * Number of input tokens consumed in this iteration.
-     */
-    inputTokens: number;
-    /**
-     * Number of output tokens generated in this iteration.
-     */
-    outputTokens: number;
-    /**
-     * Number of cache-creation input tokens consumed in this iteration.
-     */
-    cacheCreationInputTokens?: number;
-    /**
-     * Number of cache-read input tokens consumed in this iteration.
-     */
-    cacheReadInputTokens?: number;
-} | {
-    type: 'advisor_message';
-    /**
-     * The advisor model that produced this iteration.
+     * The model that produced this iteration. Populated for the per-model
+     * attribution cases (the fallback chain and advisor sub-inferences) and
+     * absent otherwise.
      */
-    model: string;
+    model?: string;
     /**
      * Number of input tokens consumed in this iteration.
      */
@@ -48,15 +35,11 @@ type AnthropicUsageIteration = {
      */
     outputTokens: number;
     /**
-     * Number of cache-creation input tokens consumed by this advisor
-     * sub-inference. Nonzero when advisor-side caching is enabled and
-     * the advisor writes a fresh cache entry.
+     * Number of cache-creation input tokens consumed in this iteration.
      */
     cacheCreationInputTokens?: number;
     /**
-     * Number of cache-read input tokens consumed by this advisor
-     * sub-inference. Nonzero on the second and later advisor calls
-     * when advisor-side caching is enabled.
+     * Number of cache-read input tokens consumed in this iteration.
      */
     cacheReadInputTokens?: number;
 };
@@ -64,6 +47,38 @@ interface AnthropicMessageMetadata {
     usage: JSONObject;
     cacheCreationInputTokens: number | null;
     stopSequence: string | null;
+    /**
+     * Details about why the request stopped. Present only when the API returns
+     * a `refusal` stop reason together with a `stop_details` object (a
+     * classifier block or a model refusal).
+     *
+     * Branch on the finish reason (`content-filter`), not on this object: the
+     * API may return a refusal with no details at all, so this field can be
+     * absent even on a refusal and should not be relied upon being present.
+     */
+    stopDetails?: {
+        /**
+         * The kind of stop detail. `'refusal'` for classifier blocks and model
+         * refusals.
+         */
+        type: string;
+        /**
+         * The classifier category that triggered the block, e.g. `'cyber'` or
+         * `'bio'`. Absent for model refusals and other cases.
+         */
+        category?: string;
+        /**
+         * Human-readable explanation of why the request was blocked. May be
+         * absent even on a refusal.
+         */
+        explanation?: string;
+        /**
+         * The canonical id of a model to retry directly. Populated only when the
+         * request included fallbacks and the fallback attempt could not be made
+         * (e.g. the fallback model was rate limited or overloaded).
+         */
+        recommendedModel?: string;
+    };
     /**
      * Usage breakdown by iteration when compaction is triggered.
      *
@@ -169,7 +184,7 @@ interface AnthropicMessageMetadata {
     } | null;
 }
 
-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 & {});
 declare const anthropicLanguageModelOptions: z.ZodObject<{
     sendReasoning: z.ZodOptional<z.ZodBoolean>;
     structuredOutputMode: z.ZodOptional<z.ZodEnum<{
@@ -236,6 +251,16 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
         us: "us";
         global: "global";
     }>>;
+    fallbacks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        thinking: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        output_config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        speed: z.ZodOptional<z.ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+    }, z.core.$strip>>>;
     anthropicBeta: z.ZodOptional<z.ZodArray<z.ZodString>>;
     contextManagement: z.ZodOptional<z.ZodObject<{
         edits: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -305,7 +330,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/index.d.ts

@@ -11,34 +11,21 @@ import { FetchFunction } from '@ai-sdk/provider-utils';
  * - `compaction`: a context compaction step (billed at executor rates).
  * - `message`: an executor sampling iteration (billed at executor rates).
  * - `advisor_message`: an advisor sub-inference (billed at the advisor
- *   model's rates; `model` carries the advisor model ID). Advisor token
- *   usage is NOT rolled into the top-level usage totals because it bills
- *   at a different rate; inspect this array directly for advisor billing.
+ *   model's rates). Advisor token usage is NOT rolled into the top-level
+ *   usage totals because it bills at a different rate; inspect this array
+ *   directly for advisor billing.
+ * - `fallback_message`: a server-side fallback attempt that served the turn.
+ *   Inspect this array for exact per-model attribution on a turn that fell
+ *   back.
  */
 type AnthropicUsageIteration = {
-    type: 'compaction' | 'message';
+    type: 'compaction' | 'message' | 'advisor_message' | 'fallback_message';
     /**
-     * Number of input tokens consumed in this iteration.
-     */
-    inputTokens: number;
-    /**
-     * Number of output tokens generated in this iteration.
-     */
-    outputTokens: number;
-    /**
-     * Number of cache-creation input tokens consumed in this iteration.
-     */
-    cacheCreationInputTokens?: number;
-    /**
-     * Number of cache-read input tokens consumed in this iteration.
-     */
-    cacheReadInputTokens?: number;
-} | {
-    type: 'advisor_message';
-    /**
-     * The advisor model that produced this iteration.
+     * The model that produced this iteration. Populated for the per-model
+     * attribution cases (the fallback chain and advisor sub-inferences) and
+     * absent otherwise.
      */
-    model: string;
+    model?: string;
     /**
      * Number of input tokens consumed in this iteration.
      */
@@ -48,15 +35,11 @@ type AnthropicUsageIteration = {
      */
     outputTokens: number;
     /**
-     * Number of cache-creation input tokens consumed by this advisor
-     * sub-inference. Nonzero when advisor-side caching is enabled and
-     * the advisor writes a fresh cache entry.
+     * Number of cache-creation input tokens consumed in this iteration.
      */
     cacheCreationInputTokens?: number;
     /**
-     * Number of cache-read input tokens consumed by this advisor
-     * sub-inference. Nonzero on the second and later advisor calls
-     * when advisor-side caching is enabled.
+     * Number of cache-read input tokens consumed in this iteration.
      */
     cacheReadInputTokens?: number;
 };
@@ -64,6 +47,38 @@ interface AnthropicMessageMetadata {
     usage: JSONObject;
     cacheCreationInputTokens: number | null;
     stopSequence: string | null;
+    /**
+     * Details about why the request stopped. Present only when the API returns
+     * a `refusal` stop reason together with a `stop_details` object (a
+     * classifier block or a model refusal).
+     *
+     * Branch on the finish reason (`content-filter`), not on this object: the
+     * API may return a refusal with no details at all, so this field can be
+     * absent even on a refusal and should not be relied upon being present.
+     */
+    stopDetails?: {
+        /**
+         * The kind of stop detail. `'refusal'` for classifier blocks and model
+         * refusals.
+         */
+        type: string;
+        /**
+         * The classifier category that triggered the block, e.g. `'cyber'` or
+         * `'bio'`. Absent for model refusals and other cases.
+         */
+        category?: string;
+        /**
+         * Human-readable explanation of why the request was blocked. May be
+         * absent even on a refusal.
+         */
+        explanation?: string;
+        /**
+         * The canonical id of a model to retry directly. Populated only when the
+         * request included fallbacks and the fallback attempt could not be made
+         * (e.g. the fallback model was rate limited or overloaded).
+         */
+        recommendedModel?: string;
+    };
     /**
      * Usage breakdown by iteration when compaction is triggered.
      *
@@ -169,7 +184,7 @@ interface AnthropicMessageMetadata {
     } | null;
 }
 
-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 & {});
 declare const anthropicLanguageModelOptions: z.ZodObject<{
     sendReasoning: z.ZodOptional<z.ZodBoolean>;
     structuredOutputMode: z.ZodOptional<z.ZodEnum<{
@@ -236,6 +251,16 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
         us: "us";
         global: "global";
     }>>;
+    fallbacks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        thinking: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        output_config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        speed: z.ZodOptional<z.ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+    }, z.core.$strip>>>;
     anthropicBeta: z.ZodOptional<z.ZodArray<z.ZodString>>;
     contextManagement: z.ZodOptional<z.ZodObject<{
         edits: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -305,7 +330,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/index.js

@@ -32,7 +32,7 @@ var import_provider4 = require("@ai-sdk/provider");
 var import_provider_utils26 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "3.0.80" : "0.0.0-test";
+var VERSION = true ? "3.0.82" : "0.0.0-test";
 
 // src/anthropic-messages-language-model.ts
 var import_provider3 = require("@ai-sdk/provider");
@@ -60,6 +60,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({
@@ -345,34 +351,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({
@@ -707,6 +716,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")
           })
         ])
       }),
@@ -780,6 +794,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(),
@@ -801,26 +816,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({
@@ -1024,6 +1032,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.
@@ -1778,12 +1811,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"
     );
@@ -2210,19 +2246,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": {
@@ -3452,6 +3489,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
       },
@@ -3628,6 +3668,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,
@@ -4150,6 +4193,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 {
@@ -4172,14 +4221,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" ? {
+            (iter) => ({
               type: iter.type,
-              model: iter.model,
+              ...iter.model != null ? { model: iter.model } : {},
               inputTokens: iter.input_tokens,
               outputTokens: iter.output_tokens,
               ...iter.cache_creation_input_tokens ? {
@@ -4188,17 +4239,7 @@ var AnthropicMessagesLanguageModel = class {
               ...iter.cache_read_input_tokens ? {
                 cacheReadInputTokens: iter.cache_read_input_tokens
               } : {}
-            } : {
-              type: iter.type,
-              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
-              } : {}
-            }
+            })
           ) : null,
           container: response.container ? {
             expiresAt: response.container.expires_at,
@@ -4274,6 +4315,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;
@@ -4300,6 +4342,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": {
@@ -4973,6 +5018,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,
@@ -4998,20 +5044,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 ? {
@@ -5020,7 +5057,7 @@ var AnthropicMessagesLanguageModel = class {
                     ...iter.cache_read_input_tokens ? {
                       cacheReadInputTokens: iter.cache_read_input_tokens
                     } : {}
-                  }
+                  })
                 ) : null,
                 container,
                 contextManagement
@@ -5084,7 +5121,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,
@@ -5185,6 +5222,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");
@@ -5502,7 +5550,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