@ai-sdk/anthropic 3.0.115 → 3.0.117

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

package/dist/internal/index.js

@@ -860,6 +860,21 @@ var anthropicFilePartProviderOptions = import_v43.z.object({
   context: import_v43.z.string().optional()
 });
 var anthropicSystemMessageProviderOptions = import_v43.z.object({
+  /**
+   * Clears this mid-conversation system message after the current turn.
+   *
+   * Requires the `mid-conversation-system-clear-at-2026-08-21` beta,
+   * which is added automatically.
+   */
+  clearAt: import_v43.z.literal("next_user_message").optional(),
+  /**
+   * Overrides the effort level for the turn following this
+   * mid-conversation system message.
+   *
+   * Requires the `mid-conversation-effort-2026-08-01` beta,
+   * which 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
@@ -887,6 +902,9 @@ var anthropicSystemMessageProviderOptions = import_v43.z.object({
     ])
   ).optional()
 });
+var anthropicThinkingBlockBinding = import_v43.z.object({
+  prefixMismatchBehavior: import_v43.z.literal("drop_block")
+});
 var anthropicLanguageModelOptions = import_v43.z.object({
   /**
    * Whether to send reasoning to the model.
@@ -908,24 +926,41 @@ var anthropicLanguageModelOptions = 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", [
-    import_v43.z.object({
-      /** for Sonnet 4.6, Opus 4.6, and newer models */
-      type: import_v43.z.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: import_v43.z.enum(["omitted", "summarized"]).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()
-    }),
+  thinking: import_v43.z.union([
+    import_v43.z.discriminatedUnion("type", [
+      import_v43.z.object({
+        /** for Sonnet 4.6, Opus 4.6, and newer models */
+        type: import_v43.z.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.
+         * - `"updates"`: Thinking updates are returned between tool calls.
+         */
+        display: import_v43.z.enum(["omitted", "summarized", "updates"]).optional(),
+        /**
+         * Controls how thinking blocks are bound to an assistant prefix.
+         *
+         * Requires the `thinking-binding-controls-2026-08-01` beta,
+         * which is added automatically.
+         */
+        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()
+      }),
+      import_v43.z.object({
+        type: import_v43.z.literal("disabled")
+      })
+    ]),
+    /**
+     * Configures prefix mismatch recovery without changing the model's
+     * default thinking mode.
+     */
     import_v43.z.object({
-      type: import_v43.z.literal("disabled")
+      blockBinding: anthropicThinkingBlockBinding
     })
   ]).optional(),
   /**
@@ -2245,8 +2280,9 @@ async function convertToAnthropicMessagesPrompt({
     const type = block.type;
     switch (type) {
       case "system": {
-        const content = [];
+        const systemMessages = [];
         let toolChangeCount = 0;
+        let hasMidConversationOptions = false;
         for (const { content: text, providerOptions } of block.messages) {
           const systemMessageOptions = await (0, import_provider_utils14.parseProviderOptions)({
             provider: "anthropic",
@@ -2254,7 +2290,10 @@ async function convertToAnthropicMessagesPrompt({
             schema: anthropicSystemMessageProviderOptions
           });
           const toolChanges = (_a = systemMessageOptions == null ? void 0 : systemMessageOptions.toolChanges) != null ? _a : [];
-          if (text !== "" || toolChanges.length === 0) {
+          const clearAt = systemMessageOptions == null ? void 0 : systemMessageOptions.clearAt;
+          const effort = systemMessageOptions == null ? void 0 : systemMessageOptions.effort;
+          const content = [];
+          if (text !== "" || toolChanges.length === 0 && clearAt == null && effort == null) {
             content.push({
               type: "text",
               text,
@@ -2274,23 +2313,44 @@ async function convertToAnthropicMessagesPrompt({
               }
             });
           }
+          hasMidConversationOptions || (hasMidConversationOptions = clearAt != null || effort != null);
+          systemMessages.push({
+            role: "system",
+            content,
+            ...clearAt != null && { clear_at: clearAt },
+            ...effort != null && { output_config: { effort } }
+          });
         }
-        if (i === 0 || system == null && toolChangeCount === 0) {
+        if (i === 0 || system == null && toolChangeCount === 0 && !hasMidConversationOptions) {
           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"
+          if (hasMidConversationOptions) {
+            warnings.push({
+              type: "other",
+              message: "clearAt and effort on the initial system message are not supported by Anthropic. Configure these options on a mid-conversation system message instead. The options have been ignored."
+            });
+          }
+          system = systemMessages.flatMap(
+            (message) => message.content.filter(
+              (part) => part.type === "text"
+            )
           );
         } else {
-          messages.push({ role: "system", content });
+          messages.push(...systemMessages);
           betas.add("mid-conversation-system-2026-04-07");
           if (toolChangeCount > 0) {
             betas.add("mid-conversation-tool-changes-2026-07-01");
           }
+          if (systemMessages.some((message) => message.clear_at != null)) {
+            betas.add("mid-conversation-system-clear-at-2026-08-21");
+          }
+          if (systemMessages.some((message) => message.output_config != null)) {
+            betas.add("mid-conversation-effort-2026-08-01");
+          }
         }
         break;
       }
@@ -3406,7 +3466,7 @@ var AnthropicMessagesLanguageModel = class {
     providerOptions,
     stream
   }) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    var _a, _b, _c, _d, _e, _f, _g;
     const warnings = [];
     if (frequencyPenalty != null) {
       warnings.push({ type: "unsupported", feature: "frequencyPenalty" });
@@ -3549,7 +3609,9 @@ var AnthropicMessagesLanguageModel = class {
       cacheControlValidator,
       toolNameMapping
     });
-    if (rejectsThinkingDisabledAboveHighEffort && ((_e = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _e.type) === "disabled" && (anthropicOptions.effort === "xhigh" || anthropicOptions.effort === "max")) {
+    const thinking = anthropicOptions == null ? void 0 : anthropicOptions.thinking;
+    const thinkingType = thinking != null && "type" in thinking ? thinking.type : void 0;
+    if (rejectsThinkingDisabledAboveHighEffort && thinkingType === "disabled" && (anthropicOptions.effort === "xhigh" || anthropicOptions.effort === "max")) {
       warnings.push({
         type: "unsupported",
         feature: "providerOptions.anthropic.effort",
@@ -3557,11 +3619,12 @@ var AnthropicMessagesLanguageModel = class {
       });
       anthropicOptions.effort = "high";
     }
-    const thinkingType = (_f = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _f.type;
     const isThinking = thinkingType === "enabled" || thinkingType === "adaptive";
     const sendThinking = isThinking || thinkingType === "disabled";
-    let thinkingBudget = thinkingType === "enabled" ? (_g = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _g.budgetTokens : void 0;
-    const thinkingDisplay = thinkingType === "adaptive" ? (_h = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _h.display : void 0;
+    let thinkingBudget = thinkingType === "enabled" && thinking != null && "budgetTokens" in thinking ? thinking.budgetTokens : void 0;
+    const thinkingDisplay = thinkingType === "adaptive" && thinking != null && "display" in thinking ? thinking.display : void 0;
+    const thinkingBlockBinding = thinking != null && "blockBinding" in thinking ? thinking.blockBinding : void 0;
+    const sendThinkingConfig = sendThinking || thinkingBlockBinding != null;
     const maxTokens = maxOutputTokens != null ? maxOutputTokens : maxOutputTokensForModel;
     const baseArgs = {
       // model id:
@@ -3573,11 +3636,16 @@ var AnthropicMessagesLanguageModel = class {
       top_p: topP,
       stop_sequences: stopSequences,
       // provider specific settings:
-      ...sendThinking && {
+      ...sendThinkingConfig && {
         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) && {
@@ -3614,7 +3682,7 @@ var AnthropicMessagesLanguageModel = class {
       ...(anthropicOptions == null ? void 0 : anthropicOptions.cacheControl) && {
         cache_control: anthropicOptions.cacheControl
       },
-      ...((_i = anthropicOptions == null ? void 0 : anthropicOptions.metadata) == null ? void 0 : _i.userId) != null && {
+      ...((_e = anthropicOptions == null ? void 0 : anthropicOptions.metadata) == null ? void 0 : _e.userId) != null && {
         metadata: { user_id: anthropicOptions.metadata.userId }
       },
       // mcp servers:
@@ -3784,6 +3852,12 @@ var AnthropicMessagesLanguageModel = class {
     if (anthropicOptions == null ? void 0 : anthropicOptions.taskBudget) {
       betas.add("task-budgets-2026-03-13");
     }
+    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.speed) === "fast") {
       betas.add("fast-mode-2026-02-01");
     }
@@ -3792,7 +3866,7 @@ var AnthropicMessagesLanguageModel = class {
     } else if ((anthropicOptions == null ? void 0 : anthropicOptions.fallbacks) && anthropicOptions.fallbacks.length > 0) {
       betas.add("server-side-fallback-2026-06-01");
     }
-    const defaultEagerInputStreaming = stream && ((_j = anthropicOptions == null ? void 0 : anthropicOptions.toolStreaming) != null ? _j : true);
+    const defaultEagerInputStreaming = stream && ((_f = anthropicOptions == null ? void 0 : anthropicOptions.toolStreaming) != null ? _f : true);
     const {
       tools: anthropicTools2,
       toolChoice: anthropicToolChoice,
@@ -3831,7 +3905,7 @@ var AnthropicMessagesLanguageModel = class {
         ...betas,
         ...toolsBetas,
         ...userSuppliedBetas,
-        ...(_k = anthropicOptions == null ? void 0 : anthropicOptions.anthropicBeta) != null ? _k : []
+        ...(_g = anthropicOptions == null ? void 0 : anthropicOptions.anthropicBeta) != null ? _g : []
       ]),
       usesJsonResponseTool: jsonResponseTool != null,
       toolNameMapping,