@ai-sdk/anthropic 4.0.47 → 4.0.49

package/dist/internal/index.d.ts

@@ -26,6 +26,10 @@ type AnthropicCacheControl = {
 interface AnthropicSystemMessage {
     role: 'system';
     content: Array<AnthropicTextContent | AnthropicToolChangeContent>;
+    clear_at?: 'next_user_message';
+    output_config?: {
+        effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    };
 }
 /**
  * Mid-conversation tool change content block. Adds or removes a tool from the
@@ -753,7 +757,7 @@ type Citation = NonNullable<(InferSchema<typeof anthropicResponseSchema>['conten
     type: 'text';
 })['citations']>[number];
 
-type AnthropicModelId = '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-opus-5' | 'claude-fable-5' | 'claude-sonnet-5' | (string & {});
+type AnthropicModelId = '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-opus-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | (string & {});
 
 type AnthropicLanguageModelConfig = {
     provider: string;
@@ -890,9 +894,12 @@ declare class AnthropicLanguageModel implements LanguageModelV4 {
                 effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
             } | undefined;
             thinking?: {
-                display?: "omitted" | "summarized" | undefined;
+                block_binding?: {
+                    prefix_mismatch_behavior: "drop_block";
+                } | undefined;
+                display?: "omitted" | "summarized" | "updates" | undefined;
                 budget_tokens?: number | undefined;
-                type: "enabled" | "adaptive" | "disabled";
+                type?: "enabled" | "adaptive" | "disabled" | undefined;
             } | undefined;
             model: AnthropicModelId;
             max_tokens: number;

package/dist/internal/index.js

@@ -958,6 +958,20 @@ var anthropicFilePartProviderOptions = z4.object({
   context: z4.string().optional()
 });
 var anthropicSystemMessageProviderOptions = z4.object({
+  /**
+   * Controls when an ephemeral mid-conversation system message is cleared.
+   *
+   * Only supported on system messages that appear mid-conversation.
+   * The required `mid-conversation-system-clear-at-2026-08-21` beta is
+   * added automatically.
+   */
+  clearAt: z4.literal("next_user_message").optional(),
+  /**
+   * Sets the model effort for the turn that follows this mid-conversation
+   * system message. The required `mid-conversation-effort-2026-08-01` beta
+   * is added automatically.
+   */
+  effort: z4.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
@@ -1006,24 +1020,40 @@ var anthropicLanguageModelOptions = z4.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: z4.discriminatedUnion("type", [
-    z4.object({
-      /** for Sonnet 4.6, Opus 4.6, and newer models */
-      type: z4.literal("adaptive"),
-      /**
-       * 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.
-       */
-      display: z4.enum(["omitted", "summarized"]).optional()
-    }),
-    z4.object({
-      /** for models before Opus 4.6, except Sonnet 4.6 still supports it */
-      type: z4.literal("enabled"),
-      budgetTokens: z4.number().optional()
-    }),
+  thinking: z4.union([
+    z4.discriminatedUnion("type", [
+      z4.object({
+        /** for Sonnet 4.6, Opus 4.6, and newer models */
+        type: z4.literal("adaptive"),
+        /**
+         * 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.
+         * - `"updates"`: Thinking updates are returned between tool calls.
+         */
+        display: z4.enum(["omitted", "summarized", "updates"]).optional(),
+        /**
+         * Controls how thinking blocks are bound to an existing thinking
+         * prefix. Requires the `thinking-binding-controls-2026-08-01` beta.
+         */
+        blockBinding: z4.object({
+          prefixMismatchBehavior: z4.literal("drop_block")
+        }).optional()
+      }),
+      z4.object({
+        /** for models before Opus 4.6, except Sonnet 4.6 still supports it */
+        type: z4.literal("enabled"),
+        budgetTokens: z4.number().optional()
+      }),
+      z4.object({
+        type: z4.literal("disabled")
+      })
+    ]),
     z4.object({
-      type: z4.literal("disabled")
+      type: z4.never().optional(),
+      blockBinding: z4.object({
+        prefixMismatchBehavior: z4.literal("drop_block")
+      })
     })
   ]).optional(),
   /**
@@ -2440,8 +2470,7 @@ async function convertToAnthropicPrompt({
     const type = block.type;
     switch (type) {
       case "system": {
-        const content = [];
-        let toolChangeCount = 0;
+        const convertedMessages = [];
         for (const { content: text, providerOptions } of block.messages) {
           const systemMessageOptions = await parseProviderOptions({
             provider: "anthropic",
@@ -2449,7 +2478,8 @@ async function convertToAnthropicPrompt({
             schema: anthropicSystemMessageProviderOptions
           });
           const toolChanges = (_a = systemMessageOptions == null ? void 0 : systemMessageOptions.toolChanges) != null ? _a : [];
-          if (text !== "" || toolChanges.length === 0) {
+          const content = [];
+          if (text !== "" || toolChanges.length === 0 && (systemMessageOptions == null ? void 0 : systemMessageOptions.clearAt) == null && (systemMessageOptions == null ? void 0 : systemMessageOptions.effort) == null) {
             content.push({
               type: "text",
               text,
@@ -2460,7 +2490,6 @@ async function convertToAnthropicPrompt({
             });
           }
           for (const toolChange of toolChanges) {
-            toolChangeCount++;
             content.push({
               type: toolChange.type,
               tool: {
@@ -2469,22 +2498,60 @@ async function convertToAnthropicPrompt({
               }
             });
           }
+          convertedMessages.push({
+            content,
+            clearAt: systemMessageOptions == null ? void 0 : systemMessageOptions.clearAt,
+            effort: systemMessageOptions == null ? void 0 : systemMessageOptions.effort,
+            toolChangeCount: toolChanges.length
+          });
         }
-        if (i === 0 || system == null && toolChangeCount === 0) {
+        const toolChangeCount = convertedMessages.reduce(
+          (count, message) => count + message.toolChangeCount,
+          0
+        );
+        const hasInlineSystemOptions = convertedMessages.some(
+          (message) => message.clearAt != null || message.effort != null
+        );
+        if (i === 0 || system == null && toolChangeCount === 0 && !hasInlineSystemOptions) {
           if (toolChangeCount > 0) {
             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."
             });
           }
-          system = content.filter(
-            (part) => part.type === "text"
+          for (const message of convertedMessages) {
+            if (message.clearAt != null || message.effort != null) {
+              warnings.push({
+                type: "other",
+                message: "clearAt and effort on the initial system message are not supported by Anthropic. These options have been ignored."
+              });
+            }
+          }
+          system = convertedMessages.flatMap(
+            (message) => message.content.filter(
+              (part) => part.type === "text"
+            )
           );
         } else {
-          messages.push({ role: "system", content });
           betas.add("mid-conversation-system-2026-04-07");
-          if (toolChangeCount > 0) {
-            betas.add("mid-conversation-tool-changes-2026-07-01");
+          for (const message of convertedMessages) {
+            messages.push({
+              role: "system",
+              content: message.content,
+              ...message.clearAt != null && { clear_at: message.clearAt },
+              ...message.effort != null && {
+                output_config: { effort: message.effort }
+              }
+            });
+            if (message.toolChangeCount > 0) {
+              betas.add("mid-conversation-tool-changes-2026-07-01");
+            }
+            if (message.clearAt != null) {
+              betas.add("mid-conversation-system-clear-at-2026-08-21");
+            }
+            if (message.effort != null) {
+              betas.add("mid-conversation-effort-2026-08-01");
+            }
           }
         }
         break;
@@ -3905,7 +3972,8 @@ var AnthropicLanguageModel = class _AnthropicLanguageModel {
     }
     const thinkingType = (_g = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _g.type;
     const isThinking = thinkingType === "enabled" || thinkingType === "adaptive";
-    const sendThinking = isThinking || thinkingType === "disabled";
+    const thinkingBlockBinding = (anthropicOptions == null ? void 0 : anthropicOptions.thinking) != null && "blockBinding" in anthropicOptions.thinking ? anthropicOptions.thinking.blockBinding : void 0;
+    const sendThinking = isThinking || thinkingType === "disabled" || thinkingBlockBinding != null;
     let thinkingBudget = thinkingType === "enabled" ? (_h = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _h.budgetTokens : void 0;
     const thinkingDisplay = thinkingType === "adaptive" ? (_i = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _i.display : void 0;
     const maxTokens = maxOutputTokens != null ? maxOutputTokens : maxOutputTokensForModel;
@@ -3921,9 +3989,14 @@ var AnthropicLanguageModel = class _AnthropicLanguageModel {
       // provider specific settings:
       ...sendThinking && {
         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) && {
@@ -4139,6 +4212,12 @@ var AnthropicLanguageModel = class _AnthropicLanguageModel {
     if ((anthropicOptions == null ? void 0 : anthropicOptions.speed) === "fast") {
       betas.add("fast-mode-2026-02-01");
     }
+    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.fallbacks) === "default") {
       betas.add("server-side-fallback-2026-07-01");
     } else if ((anthropicOptions == null ? void 0 : anthropicOptions.fallbacks) && anthropicOptions.fallbacks.length > 0) {
@@ -5723,7 +5802,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       isKnownModel: true
     };
-  } else if (modelId.includes("claude-sonnet-4-")) {
+  } else if (/claude-sonnet-4(?:-|@)/.test(modelId)) {
     return {
       maxOutputTokens: 64e3,
       supportsStructuredOutput: false,
@@ -5733,7 +5812,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       isKnownModel: true
     };
-  } else if (modelId.includes("claude-opus-4-")) {
+  } else if (/claude-opus-4(?:-|@)/.test(modelId)) {
     return {
       maxOutputTokens: 32e3,
       supportsStructuredOutput: false,