@ai-sdk/anthropic 4.0.79 → 4.0.81

package/docs/05-anthropic.mdx

@@ -742,6 +742,13 @@ room for both, the provider adds `budgetTokens` to `maxOutputTokens` when
 setting `max_tokens`. For known models, the combined value is capped at the
 model's maximum output token limit.
 
+With manual thinking (`thinking.type: 'enabled'`), a `required` or named
+`toolChoice` falls back to `auto` with a warning. For a named tool choice, only
+the selected tool is sent. This also applies when the top-level `reasoning`
+option enables manual thinking, including when structured output uses the
+internal JSON response tool. Tool use is no longer guaranteed: instruct the
+model to use the tool in your prompt and verify that a tool call was made.
+
 See [AI SDK UI: Chatbot](/docs/ai-sdk-ui/chatbot#reasoning) for more details
 on how to integrate reasoning into your chatbot.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "4.0.79",
+  "version": "4.0.81",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,8 +35,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.27",
-    "@ai-sdk/provider-utils": "5.0.59"
+    "@ai-sdk/provider": "4.0.28",
+    "@ai-sdk/provider-utils": "5.0.61"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.4",

package/src/anthropic-language-model.ts

@@ -255,6 +255,12 @@ export type AnthropicLanguageModelConfig = {
     args: Record<string, any>,
     betas: Set<string>,
   ) => Record<string, any>;
+  transformRequestHeaders?: (
+    headers: Record<string, string | undefined>,
+    providerOptions: LanguageModelV4CallOptions['providerOptions'],
+  ) =>
+    | Record<string, string | undefined>
+    | PromiseLike<Record<string, string | undefined>>;
   supportedUrls?: () => LanguageModelV4['supportedUrls'];
   generateId?: () => string;
   supportsNativeStructuredOutput?: boolean;
@@ -1067,7 +1073,8 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
             supportsStructuredOutput: false,
             supportsStrictTools,
             defaultEagerInputStreaming,
-            rejectsForcedToolUse,
+            rejectsForcedToolUse:
+              rejectsForcedToolUse || thinkingType === 'enabled',
           }
         : {
             tools: tools ?? [],
@@ -1077,7 +1084,8 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
             supportsStructuredOutput,
             supportsStrictTools,
             defaultEagerInputStreaming,
-            rejectsForcedToolUse,
+            rejectsForcedToolUse:
+              rejectsForcedToolUse || thinkingType === 'enabled',
           },
     );
 
@@ -1121,15 +1129,21 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
   private async getHeaders({
     betas,
     headers,
+    providerOptions,
   }: {
     betas: Set<string>;
     headers: Record<string, string | undefined> | undefined;
+    providerOptions: LanguageModelV4CallOptions['providerOptions'];
   }) {
-    return combineHeaders(
+    const combinedHeaders = combineHeaders(
       this.config.headers ? await resolve(this.config.headers) : undefined,
       headers,
       betas.size > 0 ? { 'anthropic-beta': Array.from(betas).join(',') } : {},
     );
+
+    return this.config.transformRequestHeaders
+      ? this.config.transformRequestHeaders(combinedHeaders, providerOptions)
+      : combinedHeaders;
   }
 
   private async getBetasFromHeaders(
@@ -1240,7 +1254,11 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
       rawValue: rawResponse,
     } = await postJsonToApi({
       url: this.buildRequestUrl(false),
-      headers: await this.getHeaders({ betas, headers: options.headers }),
+      headers: await this.getHeaders({
+        betas,
+        headers: options.headers,
+        providerOptions: options.providerOptions,
+      }),
       body: this.transformRequestBody(args, betas),
       failedResponseHandler: anthropicFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
@@ -1880,7 +1898,11 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
     const url = this.buildRequestUrl(true);
     const { responseHeaders, value: response } = await postJsonToApi({
       url,
-      headers: await this.getHeaders({ betas, headers: options.headers }),
+      headers: await this.getHeaders({
+        betas,
+        headers: options.headers,
+        providerOptions: options.providerOptions,
+      }),
       body: this.transformRequestBody(body, betas),
       failedResponseHandler: anthropicFailedResponseHandler,
       successfulResponseHandler:

package/src/anthropic-prepare-tools.ts

@@ -56,9 +56,9 @@ export async function prepareTools({
   defaultEagerInputStreaming?: boolean;
 
   /**
-   * Whether the model rejects forced tool use (`tool_choice` `any` or a
-   * named tool). When true, `required` and `tool` tool choices fall back to
-   * `auto` with a warning.
+   * Whether the model or thinking configuration rejects forced tool use
+   * (`tool_choice` `any` or a named tool). When true, `required` and `tool`
+   * tool choices fall back to `auto` with a warning.
    */
   rejectsForcedToolUse?: boolean;
 }): Promise<{
@@ -492,7 +492,7 @@ export async function prepareTools({
           type: 'unsupported',
           feature: 'toolChoice',
           details:
-            `toolChoice 'required' is not supported by this model because it rejects forced tool use. ` +
+            `toolChoice 'required' is not supported with this model or thinking configuration. ` +
             `Using 'auto' instead. Instruct the model to use a tool in the prompt and verify that a tool call was made.`,
         });
         return {
@@ -527,7 +527,7 @@ export async function prepareTools({
           type: 'unsupported',
           feature: 'toolChoice',
           details:
-            `toolChoice 'tool' is not supported by this model because it rejects forced tool use. ` +
+            `toolChoice 'tool' is not supported with this model or thinking configuration. ` +
             `Only the '${toolChoice.toolName}' tool is sent with 'auto' tool choice. ` +
             `Instruct the model to use the tool in the prompt and verify that a tool call was made.`,
         });

package/src/convert-to-anthropic-prompt.ts

@@ -550,6 +550,31 @@ export async function convertToAnthropicPrompt({
                               contentPart.mediaType,
                             );
 
+                            if (contentPart.data.type === 'reference') {
+                              const fileId = resolveProviderReference({
+                                reference: contentPart.data.reference,
+                                provider: 'anthropic',
+                              });
+                              betas.add('files-api-2025-04-14');
+
+                              if (topLevel === 'image') {
+                                return {
+                                  type: 'image' as const,
+                                  source: {
+                                    type: 'file' as const,
+                                    file_id: fileId,
+                                  },
+                                };
+                              }
+                              return {
+                                type: 'document' as const,
+                                source: {
+                                  type: 'file' as const,
+                                  file_id: fileId,
+                                },
+                              };
+                            }
+
                             if (contentPart.data.type === 'url') {
                               if (topLevel === 'image') {
                                 return {