@ai-sdk/anthropic 2.0.100 → 2.0.101

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' | 'claude-opus-5' | 'claude-fable-5' | 'claude-sonnet-5' | (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-opus-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-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' | 'claude-opus-5' | 'claude-fable-5' | 'claude-sonnet-5' | (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-opus-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | (string & {});
 
 type AnthropicMessagesConfig = {
     provider: string;

package/dist/internal/index.js

@@ -660,6 +660,19 @@ var anthropicFilePartProviderOptions = import_v43.z.object({
   context: import_v43.z.string().optional()
 });
 var anthropicSystemMessageProviderOptions = import_v43.z.object({
+  /**
+   * Controls when a mid-conversation system message is cleared.
+   *
+   * The value is forwarded to Anthropic as `clear_at`. The required
+   * `mid-conversation-system-clear-at-2026-08-21` beta is added automatically.
+   */
+  clearAt: import_v43.z.literal("next_user_message").optional(),
+  /**
+   * Overrides the effort for the turn following this mid-conversation system
+   * message. The required `mid-conversation-effort-2026-08-01` beta is added
+   * automatically.
+   */
+  effort: import_v43.z.enum(["low", "medium", "high", "xhigh", "max"]).optional(),
   /**
    * Mid-conversation tool changes. Adds or removes tools from the
    * conversation's tool set between turns without invalidating the prompt
@@ -687,6 +700,14 @@ var anthropicSystemMessageProviderOptions = import_v43.z.object({
     ])
   ).optional()
 });
+var anthropicThinkingBlockBinding = import_v43.z.object({
+  /**
+   * Controls behavior when a replayed thinking block does not match its
+   * conversation prefix. The `drop_block` behavior drops the mismatched block
+   * instead of returning an invalid signature error.
+   */
+  prefixMismatchBehavior: import_v43.z.literal("drop_block")
+});
 var anthropicProviderOptions = import_v43.z.object({
   /**
    * Whether to send reasoning to the model.
@@ -698,8 +719,8 @@ var anthropicProviderOptions = import_v43.z.object({
    * Determines how structured outputs are generated.
    *
    * - `outputFormat`: Use the `output_format` parameter to specify the structured output format.
-   * - `jsonTool`: Use a special JSON response tool to specify the structured output format (default).
-   * - `auto`: Use 'outputFormat' when supported, otherwise use 'jsonTool'.
+   * - `jsonTool`: Use a special JSON response tool to specify the structured output format (default for most models).
+   * - `auto`: Use 'outputFormat' when supported, otherwise use 'jsonTool' (default for Fable 5.1).
    */
   structuredOutputMode: import_v43.z.enum(["outputFormat", "jsonTool", "auto"]).optional(),
   /**
@@ -708,7 +729,7 @@ var anthropicProviderOptions = import_v43.z.object({
    * When enabled, responses include thinking content blocks showing Claude's thinking process before the final answer.
    * Requires a minimum budget of 1,024 tokens and counts towards the `max_tokens` limit.
    */
-  thinking: import_v43.z.discriminatedUnion("type", [
+  thinking: import_v43.z.union([
     import_v43.z.object({
       /** for Sonnet 4.6, Opus 4.6, and newer models */
       type: import_v43.z.literal("adaptive"),
@@ -716,16 +737,34 @@ var anthropicProviderOptions = import_v43.z.object({
        * Controls whether thinking content is included in the response.
        * - `"omitted"`: Thinking blocks are present but text is empty (default for Opus 4.7+).
        * - `"summarized"`: Thinking content is returned. Required to see reasoning output.
+       * - `"updates"`: Thinking summaries are emitted between tool calls.
+       */
+      display: import_v43.z.enum(["omitted", "summarized", "updates"]).optional(),
+      /**
+       * Controls handling for thinking blocks whose conversation prefix no
+       * longer matches. Forwarded as `block_binding`.
        */
-      display: import_v43.z.enum(["omitted", "summarized"]).optional()
+      blockBinding: anthropicThinkingBlockBinding.optional()
     }),
     import_v43.z.object({
       /** for models before Opus 4.6, except Sonnet 4.6 still supports it */
       type: import_v43.z.literal("enabled"),
-      budgetTokens: import_v43.z.number().optional()
+      budgetTokens: import_v43.z.number().optional(),
+      /**
+       * Controls handling for thinking blocks whose conversation prefix no
+       * longer matches. Forwarded as `block_binding`.
+       */
+      blockBinding: anthropicThinkingBlockBinding.optional()
     }),
     import_v43.z.object({
       type: import_v43.z.literal("disabled")
+    }),
+    import_v43.z.object({
+      /**
+       * Configure prefix mismatch handling without changing the model's
+       * default thinking mode.
+       */
+      blockBinding: anthropicThinkingBlockBinding
     })
   ]).optional(),
   /**
@@ -1468,7 +1507,7 @@ async function convertToAnthropicMessagesPrompt({
   warnings,
   cacheControlValidator
 }) {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
   const betas = /* @__PURE__ */ new Set();
   const blocks = groupIntoBlocks(prompt);
   const validator = cacheControlValidator || new CacheControlValidator();
@@ -1502,6 +1541,8 @@ async function convertToAnthropicMessagesPrompt({
       case "system": {
         const content = [];
         let toolChangeCount = 0;
+        let clearAt = void 0;
+        let effort = void 0;
         for (const { content: text, providerOptions } of block.messages) {
           const systemMessageOptions = await (0, import_provider_utils9.parseProviderOptions)({
             provider: "anthropic",
@@ -1509,7 +1550,9 @@ async function convertToAnthropicMessagesPrompt({
             schema: anthropicSystemMessageProviderOptions
           });
           const toolChanges = (_a = systemMessageOptions == null ? void 0 : systemMessageOptions.toolChanges) != null ? _a : [];
-          if (text !== "" || toolChanges.length === 0) {
+          clearAt = (_b = systemMessageOptions == null ? void 0 : systemMessageOptions.clearAt) != null ? _b : clearAt;
+          effort = (_c = systemMessageOptions == null ? void 0 : systemMessageOptions.effort) != null ? _c : effort;
+          if (text !== "" || toolChanges.length === 0 && (systemMessageOptions == null ? void 0 : systemMessageOptions.clearAt) == null && (systemMessageOptions == null ? void 0 : systemMessageOptions.effort) == null) {
             content.push({
               type: "text",
               text,
@@ -1530,22 +1573,34 @@ async function convertToAnthropicMessagesPrompt({
             });
           }
         }
-        if (i === 0 || system == null && toolChangeCount === 0) {
-          if (toolChangeCount > 0) {
+        const hasMidConversationOptions = toolChangeCount > 0 || clearAt != null || effort != null;
+        if (i === 0 || system == null && !hasMidConversationOptions) {
+          if (hasMidConversationOptions) {
             warnings.push({
               type: "other",
-              message: "tool changes on the initial system message are not supported by Anthropic. Configure the initial tool set via the tools option instead. The tool changes have been ignored."
+              message: "mid-conversation Anthropic system message options on the initial system message are not supported. The options have been ignored."
             });
           }
           system = content.filter(
             (part) => part.type === "text"
           );
         } else {
-          messages.push({ role: "system", content });
+          messages.push({
+            role: "system",
+            content,
+            ...clearAt != null && { clear_at: clearAt },
+            ...effort != null && { output_config: { effort } }
+          });
           betas.add("mid-conversation-system-2026-04-07");
           if (toolChangeCount > 0) {
             betas.add("mid-conversation-tool-changes-2026-07-01");
           }
+          if (clearAt != null) {
+            betas.add("mid-conversation-system-clear-at-2026-08-21");
+          }
+          if (effort != null) {
+            betas.add("mid-conversation-effort-2026-08-01");
+          }
         }
         break;
       }
@@ -1558,10 +1613,10 @@ async function convertToAnthropicMessagesPrompt({
               for (let j = 0; j < content.length; j++) {
                 const part = content[j];
                 const isLastPart = j === content.length - 1;
-                const cacheControl = (_b = validator.getCacheControl(part.providerOptions, {
+                const cacheControl = (_d = validator.getCacheControl(part.providerOptions, {
                   type: "user message part",
                   canCache: true
-                })) != null ? _b : isLastPart ? validator.getCacheControl(message.providerOptions, {
+                })) != null ? _d : isLastPart ? validator.getCacheControl(message.providerOptions, {
                   type: "user message",
                   canCache: true
                 }) : void 0;
@@ -1606,7 +1661,7 @@ async function convertToAnthropicMessagesPrompt({
                           media_type: "application/pdf",
                           data: (0, import_provider_utils9.convertToBase64)(part.data)
                         },
-                        title: (_c = metadata.title) != null ? _c : part.filename,
+                        title: (_e = metadata.title) != null ? _e : part.filename,
                         ...metadata.context && { context: metadata.context },
                         ...enableCitations && {
                           citations: { enabled: true }
@@ -1630,7 +1685,7 @@ async function convertToAnthropicMessagesPrompt({
                           media_type: "text/plain",
                           data: convertToString(part.data)
                         },
-                        title: (_d = metadata.title) != null ? _d : part.filename,
+                        title: (_f = metadata.title) != null ? _f : part.filename,
                         ...metadata.context && { context: metadata.context },
                         ...enableCitations && {
                           citations: { enabled: true }
@@ -1652,10 +1707,10 @@ async function convertToAnthropicMessagesPrompt({
               for (let i2 = 0; i2 < content.length; i2++) {
                 const part = content[i2];
                 const isLastPart = i2 === content.length - 1;
-                const cacheControl = (_e = validator.getCacheControl(part.providerOptions, {
+                const cacheControl = (_g = validator.getCacheControl(part.providerOptions, {
                   type: "tool result part",
                   canCache: true
-                })) != null ? _e : isLastPart ? validator.getCacheControl(message.providerOptions, {
+                })) != null ? _g : isLastPart ? validator.getCacheControl(message.providerOptions, {
                   type: "tool result message",
                   canCache: true
                 }) : void 0;
@@ -1737,16 +1792,16 @@ async function convertToAnthropicMessagesPrompt({
           for (let k = 0; k < content.length; k++) {
             const part = content[k];
             const isLastContentPart = k === content.length - 1;
-            const cacheControl = (_f = validator.getCacheControl(part.providerOptions, {
+            const cacheControl = (_h = validator.getCacheControl(part.providerOptions, {
               type: "assistant message part",
               canCache: true
-            })) != null ? _f : isLastContentPart ? validator.getCacheControl(message.providerOptions, {
+            })) != null ? _h : isLastContentPart ? validator.getCacheControl(message.providerOptions, {
               type: "assistant message",
               canCache: true
             }) : void 0;
             switch (part.type) {
               case "text": {
-                const textMetadata = (_g = part.providerOptions) == null ? void 0 : _g.anthropic;
+                const textMetadata = (_i = part.providerOptions) == null ? void 0 : _i.anthropic;
                 if ((textMetadata == null ? void 0 : textMetadata.type) === "compaction") {
                   anthropicContent.push({
                     type: "compaction",
@@ -2315,7 +2370,7 @@ var AnthropicMessagesLanguageModel = class {
     toolChoice,
     providerOptions
   }) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    var _a, _b, _c, _d, _e;
     const warnings = [];
     if (frequencyPenalty != null) {
       warnings.push({
@@ -2404,7 +2459,7 @@ var AnthropicMessagesLanguageModel = class {
       }
     }
     const isAnthropicModel = isKnownModel || this.modelId.includes("claude-");
-    const structureOutputMode = (_a = anthropicOptions == null ? void 0 : anthropicOptions.structuredOutputMode) != null ? _a : "jsonTool";
+    const structureOutputMode = (_a = anthropicOptions == null ? void 0 : anthropicOptions.structuredOutputMode) != null ? _a : this.modelId.includes("claude-fable-5-1") ? "auto" : "jsonTool";
     const useStructuredOutput = structureOutputMode === "outputFormat" || structureOutputMode === "auto" && supportsStructuredOutput;
     const jsonResponseToolName = getJsonResponseToolName(tools);
     const jsonResponseTool = (responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null && !useStructuredOutput ? {
@@ -2427,7 +2482,9 @@ var AnthropicMessagesLanguageModel = class {
       warnings,
       cacheControlValidator
     });
-    if (rejectsThinkingDisabledAboveHighEffort && ((_c = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _c.type) === "disabled" && (anthropicOptions.effort === "xhigh" || anthropicOptions.effort === "max")) {
+    const thinkingOptions = anthropicOptions == null ? void 0 : anthropicOptions.thinking;
+    const thinkingType = thinkingOptions != null && "type" in thinkingOptions ? thinkingOptions.type : void 0;
+    if (rejectsThinkingDisabledAboveHighEffort && thinkingType === "disabled" && anthropicOptions != null && (anthropicOptions.effort === "xhigh" || anthropicOptions.effort === "max")) {
       warnings.push({
         type: "unsupported-setting",
         setting: "providerOptions.anthropic.effort",
@@ -2435,10 +2492,10 @@ var AnthropicMessagesLanguageModel = class {
       });
       anthropicOptions.effort = "high";
     }
-    const thinkingType = (_d = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _d.type;
     const isThinking = thinkingType === "enabled" || thinkingType === "adaptive";
-    let thinkingBudget = thinkingType === "enabled" ? (_e = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _e.budgetTokens : void 0;
-    const thinkingDisplay = thinkingType === "adaptive" ? (_f = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _f.display : void 0;
+    let thinkingBudget = thinkingOptions != null && "budgetTokens" in thinkingOptions ? thinkingOptions.budgetTokens : void 0;
+    const thinkingDisplay = thinkingOptions != null && "display" in thinkingOptions ? thinkingOptions.display : void 0;
+    const thinkingBlockBinding = thinkingOptions != null && "blockBinding" in thinkingOptions ? thinkingOptions.blockBinding : void 0;
     const maxTokens = maxOutputTokens != null ? maxOutputTokens : maxOutputTokensForModel;
     const baseArgs = {
       // model id:
@@ -2450,11 +2507,16 @@ var AnthropicMessagesLanguageModel = class {
       top_p: topP,
       stop_sequences: stopSequences,
       // provider specific settings:
-      ...isThinking && {
+      ...(isThinking || thinkingBlockBinding != null) && {
         thinking: {
-          type: thinkingType,
+          ...thinkingType != null && { type: thinkingType },
           ...thinkingBudget != null && { budget_tokens: thinkingBudget },
-          ...thinkingDisplay != null && { display: thinkingDisplay }
+          ...thinkingDisplay != null && { display: thinkingDisplay },
+          ...thinkingBlockBinding != null && {
+            block_binding: {
+              prefix_mismatch_behavior: thinkingBlockBinding.prefixMismatchBehavior
+            }
+          }
         }
       },
       ...((anthropicOptions == null ? void 0 : anthropicOptions.effort) || (anthropicOptions == null ? void 0 : anthropicOptions.taskBudget) || useStructuredOutput && (responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null) && {
@@ -2491,14 +2553,14 @@ var AnthropicMessagesLanguageModel = class {
       ...(anthropicOptions == null ? void 0 : anthropicOptions.cacheControl) && {
         cache_control: anthropicOptions.cacheControl
       },
-      ...((_g = anthropicOptions == null ? void 0 : anthropicOptions.metadata) == null ? void 0 : _g.userId) != null && {
+      ...((_c = anthropicOptions == null ? void 0 : anthropicOptions.metadata) == null ? void 0 : _c.userId) != null && {
         metadata: { user_id: anthropicOptions.metadata.userId }
       },
       // container with agent skills:
       ...(anthropicOptions == null ? void 0 : anthropicOptions.container) && {
         container: {
           id: anthropicOptions.container.id,
-          skills: (_h = anthropicOptions.container.skills) == null ? void 0 : _h.map((skill) => ({
+          skills: (_d = anthropicOptions.container.skills) == null ? void 0 : _d.map((skill) => ({
             type: skill.type,
             skill_id: skill.skillId,
             version: skill.version
@@ -2624,6 +2686,12 @@ var AnthropicMessagesLanguageModel = class {
     if (anthropicOptions == null ? void 0 : anthropicOptions.effort) {
       betas.add("effort-2025-11-24");
     }
+    if (thinkingDisplay === "updates") {
+      betas.add("thinking-display-updates-2026-08-18");
+    }
+    if (thinkingBlockBinding != null) {
+      betas.add("thinking-binding-controls-2026-08-01");
+    }
     if (anthropicOptions == null ? void 0 : anthropicOptions.taskBudget) {
       betas.add("task-budgets-2026-03-13");
     }
@@ -2635,7 +2703,7 @@ var AnthropicMessagesLanguageModel = class {
     } else if ((anthropicOptions == null ? void 0 : anthropicOptions.fallbacks) && anthropicOptions.fallbacks.length > 0) {
       betas.add("server-side-fallback-2026-06-01");
     }
-    if (useStructuredOutput) {
+    if (useStructuredOutput && (responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null) {
       betas.add("structured-outputs-2025-11-13");
     }
     const contextManagement = anthropicOptions == null ? void 0 : anthropicOptions.contextManagement;
@@ -2675,7 +2743,7 @@ var AnthropicMessagesLanguageModel = class {
         ...betas,
         ...toolsBetas,
         ...userSuppliedBetas,
-        ...(_i = anthropicOptions == null ? void 0 : anthropicOptions.anthropicBeta) != null ? _i : []
+        ...(_e = anthropicOptions == null ? void 0 : anthropicOptions.anthropicBeta) != null ? _e : []
       ]),
       jsonResponseToolName: jsonResponseTool != null ? jsonResponseToolName : void 0
     };
@@ -3735,7 +3803,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: true,
       isKnownModel: true
     };
-  } else if (modelId.includes("claude-opus-4-8") || modelId.includes("claude-opus-4-7") || modelId.includes("claude-fable-5") || modelId.includes("claude-sonnet-5")) {
+  } else if (modelId.includes("claude-opus-4-8") || modelId.includes("claude-opus-4-7") || modelId.includes("claude-fable-5-1") || modelId.includes("claude-fable-5") || modelId.includes("claude-sonnet-5")) {
     return {
       maxOutputTokens: 128e3,
       supportsStructuredOutput: true,