@ai-sdk/anthropic 3.0.123 → 3.0.125

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @ai-sdk/anthropic
 
+## 3.0.125
+
+### Patch Changes
+
+- 358683e: feat(anthropic): add Claude Sonnet 5.5 support
+
+  - add the `claude-sonnet-5-5` model ID to `@ai-sdk/anthropic` and `@ai-sdk/google-vertex`, `anthropic.claude-sonnet-5-5` and `us.anthropic.claude-sonnet-5-5` to `@ai-sdk/amazon-bedrock`, and `anthropic/claude-sonnet-5.5` to `@ai-sdk/gateway`
+  - add the `between_tools` thinking type (`thinking: { type: 'between_tools' }`), the lowest thinking setting on `claude-sonnet-5-5`; `xhigh` and `max` effort are lowered to `high` with a warning because the API rejects them with `between_tools`
+  - `claude-sonnet-5-5` rejects disabled thinking: `thinking: { type: 'disabled' }` is replaced with `between_tools` thinking (with a warning), and budget-based thinking is converted to adaptive thinking
+  - `claude-sonnet-5-5` rejects forced tool use: `required` and named tool choices fall back to `auto`, and `structuredOutputMode: 'jsonTool'` falls back to native structured outputs, each with a warning
+
+- eeabdce: Normalize dangling programmatic tool caller references in conversation history after pruning. Before a subsequent user message, omit caller metadata whose source code execution call is missing and emit a warning, preserving the retained tool calls and results. Keep caller metadata unchanged for active tool continuations.
+
+## 3.0.124
+
+### Patch Changes
+
+- Updated dependencies [29dc427]
+  - @ai-sdk/provider-utils@4.0.56
+
 ## 3.0.123
 
 ### Patch Changes

package/dist/index.d.mts

@@ -195,7 +195,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' | 'claude-opus-4-8' | 'claude-opus-5' | 'claude-opus-5-5' | 'claude-fable-5' | 'claude-fable-5-1' | '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-opus-5-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-sonnet-5-5' | (string & {});
 /**
  * Anthropic provider options for system messages.
  */
@@ -242,6 +242,8 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
         budgetTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"disabled">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"between_tools">;
     }, z.core.$strip>]>, z.ZodObject<{
         blockBinding: z.ZodObject<{
             prefixMismatchBehavior: z.ZodEnum<{

package/dist/index.d.ts

@@ -195,7 +195,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' | 'claude-opus-4-8' | 'claude-opus-5' | 'claude-opus-5-5' | 'claude-fable-5' | 'claude-fable-5-1' | '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-opus-5-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-sonnet-5-5' | (string & {});
 /**
  * Anthropic provider options for system messages.
  */
@@ -242,6 +242,8 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
         budgetTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"disabled">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"between_tools">;
     }, z.core.$strip>]>, z.ZodObject<{
         blockBinding: z.ZodObject<{
             prefixMismatchBehavior: z.ZodEnum<{

package/dist/index.js

@@ -32,7 +32,7 @@ var import_provider4 = require("@ai-sdk/provider");
 var import_provider_utils27 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "3.0.123" : "0.0.0-test";
+var VERSION = true ? "3.0.125" : "0.0.0-test";
 
 // src/anthropic-messages-language-model.ts
 var import_provider3 = require("@ai-sdk/provider");
@@ -948,6 +948,9 @@ var anthropicLanguageModelOptions = import_v43.z.object({
    * `claude-fable-5-1`) reject `enabled` and `disabled`. For those models the
    * provider drops the unsupported setting, emits a warning, and sends an
    * adaptive thinking request. Use `effort` to control how much they think.
+   *
+   * `claude-sonnet-5-5` supports `between_tools`, its lowest thinking setting,
+   * and the provider uses it in place of `disabled` for that model.
    */
   thinking: import_v43.z.union([
     import_v43.z.discriminatedUnion("type", [
@@ -976,6 +979,14 @@ var anthropicLanguageModelOptions = import_v43.z.object({
       }),
       import_v43.z.object({
         type: import_v43.z.literal("disabled")
+      }),
+      import_v43.z.object({
+        /**
+         * for `claude-sonnet-5-5`: no upfront thinking, but progress notes
+         * between tool calls are returned as summarized thinking blocks.
+         * Only supported at `low`, `medium`, and `high` effort.
+         */
+        type: import_v43.z.literal("between_tools")
       })
     ]),
     /**
@@ -2402,6 +2413,7 @@ async function convertToAnthropicMessagesPrompt({
   const validator = cacheControlValidator || new CacheControlValidator();
   let system = void 0;
   const messages = [];
+  let lastUserMessageIndex = -1;
   async function shouldEnableCitations(providerMetadata) {
     var _a2, _b2;
     const anthropicOptions = await (0, import_provider_utils15.parseProviderOptions)({
@@ -2513,6 +2525,9 @@ async function convertToAnthropicMessagesPrompt({
           const { role, content } = message;
           switch (role) {
             case "user": {
+              if (content.length > 0) {
+                lastUserMessageIndex = messages.length;
+              }
               for (let j = 0; j < content.length; j++) {
                 const part = content[j];
                 const isLastPart = j === content.length - 1;
@@ -3297,6 +3312,42 @@ async function convertToAnthropicMessagesPrompt({
       }
     }
   }
+  const codeExecutionToolCallIds = /* @__PURE__ */ new Set();
+  for (const message of messages) {
+    if (message.role !== "assistant") {
+      continue;
+    }
+    for (const part of message.content) {
+      if (part.type === "server_tool_use" && part.name === "code_execution") {
+        codeExecutionToolCallIds.add(part.id);
+      }
+    }
+  }
+  const warnedToolCallIds = /* @__PURE__ */ new Set();
+  for (let i = 0; i < lastUserMessageIndex; i++) {
+    const message = messages[i];
+    if (message.role !== "assistant") {
+      continue;
+    }
+    for (const part of message.content) {
+      if (!("caller" in part)) {
+        continue;
+      }
+      const caller = part.caller;
+      if (caller == null || caller.type === "direct" || codeExecutionToolCallIds.has(caller.tool_id)) {
+        continue;
+      }
+      const toolCallId = "id" in part ? part.id : part.tool_use_id;
+      delete part.caller;
+      if (!warnedToolCallIds.has(toolCallId)) {
+        warnedToolCallIds.add(toolCallId);
+        warnings.push({
+          type: "other",
+          message: `Omitted caller metadata for tool ${toolCallId} because source code execution tool ${caller.tool_id} is missing from the conversation history.`
+        });
+      }
+    }
+  }
   return {
     prompt: { system, messages },
     betas
@@ -3740,6 +3791,7 @@ var AnthropicMessagesLanguageModel = class {
       rejectsThinkingDisabledAboveHighEffort,
       rejectsThinkingDisabled,
       rejectsForcedToolUse,
+      supportsBetweenToolsThinking,
       isKnownModel
     } = getModelCapabilities(this.modelId);
     if (!isKnownModel && maxOutputTokens == null) {
@@ -3841,7 +3893,14 @@ var AnthropicMessagesLanguageModel = class {
     if (rejectsThinkingDisabled && (anthropicOptions == null ? void 0 : anthropicOptions.thinking) != null) {
       const requestedThinking = anthropicOptions.thinking;
       const requestedType = "type" in requestedThinking ? requestedThinking.type : void 0;
-      if (requestedType === "disabled") {
+      if (requestedType === "disabled" && supportsBetweenToolsThinking) {
+        warnings.push({
+          type: "unsupported",
+          feature: "providerOptions.anthropic.thinking",
+          details: `thinking cannot be disabled for ${this.modelId}. Using 'between_tools' thinking, the lowest thinking setting, instead.`
+        });
+        anthropicOptions.thinking = { type: "between_tools" };
+      } else if (requestedType === "disabled") {
         warnings.push({
           type: "unsupported",
           feature: "providerOptions.anthropic.thinking",
@@ -3867,7 +3926,15 @@ var AnthropicMessagesLanguageModel = class {
       });
       anthropicOptions.effort = "high";
     }
-    const isThinking = thinkingType === "enabled" || thinkingType === "adaptive";
+    if (thinkingType === "between_tools" && (anthropicOptions.effort === "xhigh" || anthropicOptions.effort === "max")) {
+      warnings.push({
+        type: "unsupported",
+        feature: "providerOptions.anthropic.effort",
+        details: `effort '${anthropicOptions.effort}' is not supported with 'between_tools' thinking. The effort has been lowered to 'high'.`
+      });
+      anthropicOptions.effort = "high";
+    }
+    const isThinking = thinkingType === "enabled" || thinkingType === "adaptive" || thinkingType === "between_tools";
     const sendThinking = isThinking || thinkingType === "disabled";
     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;
@@ -5703,7 +5770,18 @@ var AnthropicMessagesLanguageModel = class {
   }
 };
 function getModelCapabilities(modelId) {
-  if (modelId.includes("claude-opus-5-5")) {
+  if (modelId.includes("claude-sonnet-5-5")) {
+    return {
+      maxOutputTokens: 128e3,
+      supportsStructuredOutput: true,
+      rejectsSamplingParameters: true,
+      rejectsThinkingDisabledAboveHighEffort: true,
+      rejectsThinkingDisabled: true,
+      rejectsForcedToolUse: true,
+      supportsBetweenToolsThinking: true,
+      isKnownModel: true
+    };
+  } else if (modelId.includes("claude-opus-5-5")) {
     return {
       maxOutputTokens: 128e3,
       supportsStructuredOutput: true,
@@ -5711,6 +5789,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: true,
       rejectsThinkingDisabled: true,
       rejectsForcedToolUse: true,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-opus-5")) {
@@ -5721,6 +5800,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: true,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-fable-5-1")) {
@@ -5731,6 +5811,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: true,
       rejectsForcedToolUse: true,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-fable-5")) {
@@ -5741,6 +5822,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: true,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-opus-4-8") || modelId.includes("claude-opus-4-7") || modelId.includes("claude-sonnet-5")) {
@@ -5751,6 +5833,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-sonnet-4-6") || modelId.includes("claude-opus-4-6")) {
@@ -5761,6 +5844,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-sonnet-4-5") || modelId.includes("claude-opus-4-5") || modelId.includes("claude-haiku-4-5")) {
@@ -5771,6 +5855,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-opus-4-1")) {
@@ -5781,6 +5866,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-sonnet-4-")) {
@@ -5791,6 +5877,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-opus-4-")) {
@@ -5801,6 +5888,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (modelId.includes("claude-3-haiku")) {
@@ -5811,6 +5899,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: true
     };
   } else if (/claude-(?:instant(?:-|$)|v?2(?=$|[-.:])|3(?=$|[-.]))/.test(modelId)) {
@@ -5821,6 +5910,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: false
     };
   } else if (modelId.includes("claude-")) {
@@ -5831,6 +5921,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: true,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: false
     };
   } else {
@@ -5841,6 +5932,7 @@ function getModelCapabilities(modelId) {
       rejectsThinkingDisabledAboveHighEffort: false,
       rejectsThinkingDisabled: false,
       rejectsForcedToolUse: false,
+      supportsBetweenToolsThinking: false,
       isKnownModel: false
     };
   }