@ai-sdk/anthropic 4.0.45 → 4.0.47

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "4.0.45",
+  "version": "4.0.47",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,8 +35,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.8",
-    "@ai-sdk/provider-utils": "5.0.33"
+    "@ai-sdk/provider": "4.0.10",
+    "@ai-sdk/provider-utils": "5.0.35"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.1",

package/src/anthropic-api.ts

@@ -416,7 +416,13 @@ export interface AnthropicMcpToolResultContent {
   type: 'mcp_tool_result';
   tool_use_id: string;
   is_error: boolean;
-  content: string | Array<{ type: 'text'; text: string }>;
+  content:
+    | string
+    | Array<{
+        type: 'text';
+        text: string;
+        citations?: Citation[] | null;
+      }>;
   cache_control: AnthropicCacheControl | undefined;
 }
 
@@ -655,6 +661,68 @@ const anthropicToolCallCallerSchema = z.union([
   }),
 ]);
 
+const anthropicCitationSchema = z.discriminatedUnion('type', [
+  z.object({
+    type: z.literal('web_search_result_location'),
+    cited_text: z.string(),
+    url: z.string(),
+    title: z.string().nullable(),
+    encrypted_index: z.string(),
+  }),
+  z.object({
+    type: z.literal('page_location'),
+    cited_text: z.string(),
+    document_index: z.number(),
+    document_title: z.string().nullable(),
+    start_page_number: z.number(),
+    end_page_number: z.number(),
+    file_id: z.string().nullish(),
+  }),
+  z.object({
+    type: z.literal('char_location'),
+    cited_text: z.string(),
+    document_index: z.number(),
+    document_title: z.string().nullable(),
+    start_char_index: z.number(),
+    end_char_index: z.number(),
+    file_id: z.string().nullish(),
+  }),
+  z.object({
+    type: z.literal('content_block_location'),
+    cited_text: z.string(),
+    document_index: z.number(),
+    document_title: z.string().nullable(),
+    start_block_index: z.number(),
+    end_block_index: z.number(),
+    file_id: z.string().nullable(),
+  }),
+  z.object({
+    type: z.literal('search_result_location'),
+    cited_text: z.string(),
+    search_result_index: z.number(),
+    source: z.string(),
+    title: z.string().nullable(),
+    start_block_index: z.number(),
+    end_block_index: z.number(),
+  }),
+]);
+
+const anthropicMcpToolResultContentSchema = z.union([
+  z.string(),
+  z.array(
+    z.union([
+      z.string(),
+      z.object({
+        type: z.literal('text'),
+        text: z.string(),
+        // MCP tool-result citations are opaque third-party pass-through data.
+        // Keep them permissive so new shapes do not reject whole responses.
+        citations: z.array(z.json()).nullable().optional(),
+      }),
+    ]),
+  ),
+]);
+
 // limited version of the schema, focussed on what is needed for the implementation
 // this approach limits breakages when the API changes and increases efficiency
 export const anthropicResponseSchema = lazySchema(() =>
@@ -668,35 +736,7 @@ export const anthropicResponseSchema = lazySchema(() =>
           z.object({
             type: z.literal('text'),
             text: z.string(),
-            citations: z
-              .array(
-                z.discriminatedUnion('type', [
-                  z.object({
-                    type: z.literal('web_search_result_location'),
-                    cited_text: z.string(),
-                    url: z.string(),
-                    title: z.string(),
-                    encrypted_index: z.string(),
-                  }),
-                  z.object({
-                    type: z.literal('page_location'),
-                    cited_text: z.string(),
-                    document_index: z.number(),
-                    document_title: z.string().nullable(),
-                    start_page_number: z.number(),
-                    end_page_number: z.number(),
-                  }),
-                  z.object({
-                    type: z.literal('char_location'),
-                    cited_text: z.string(),
-                    document_index: z.number(),
-                    document_title: z.string().nullable(),
-                    start_char_index: z.number(),
-                    end_char_index: z.number(),
-                  }),
-                ]),
-              )
-              .optional(),
+            citations: z.array(anthropicCitationSchema).nullable().optional(),
           }),
           z.object({
             type: z.literal('thinking'),
@@ -737,12 +777,7 @@ export const anthropicResponseSchema = lazySchema(() =>
             type: z.literal('mcp_tool_result'),
             tool_use_id: z.string(),
             is_error: z.boolean(),
-            content: z.array(
-              z.union([
-                z.string(),
-                z.object({ type: z.literal('text'), text: z.string() }),
-              ]),
-            ),
+            content: anthropicMcpToolResultContentSchema,
           }),
           z.object({
             type: z.literal('web_fetch_tool_result'),
@@ -752,7 +787,7 @@ export const anthropicResponseSchema = lazySchema(() =>
               z.object({
                 type: z.literal('web_fetch_result'),
                 url: z.string(),
-                retrieved_at: z.string(),
+                retrieved_at: z.string().nullable(),
                 content: z.object({
                   type: z.literal('document'),
                   title: z.string().nullable(),
@@ -786,7 +821,7 @@ export const anthropicResponseSchema = lazySchema(() =>
                 z.object({
                   type: z.literal('web_search_result'),
                   url: z.string(),
-                  title: z.string(),
+                  title: z.string().nullable(),
                   encrypted_content: z.string(),
                   page_age: z.string().nullish(),
                 }),
@@ -914,6 +949,10 @@ export const anthropicResponseSchema = lazySchema(() =>
               }),
             ]),
           }),
+          z.object({
+            type: z.literal('container_upload'),
+            file_id: z.string(),
+          }),
           // advisor results for advisor_20260301:
           z.object({
             type: z.literal('advisor_tool_result'),
@@ -1100,12 +1139,7 @@ export const anthropicChunkSchema = lazySchema(() =>
             type: z.literal('mcp_tool_result'),
             tool_use_id: z.string(),
             is_error: z.boolean(),
-            content: z.array(
-              z.union([
-                z.string(),
-                z.object({ type: z.literal('text'), text: z.string() }),
-              ]),
-            ),
+            content: anthropicMcpToolResultContentSchema,
           }),
           z.object({
             type: z.literal('web_fetch_tool_result'),
@@ -1115,7 +1149,7 @@ export const anthropicChunkSchema = lazySchema(() =>
               z.object({
                 type: z.literal('web_fetch_result'),
                 url: z.string(),
-                retrieved_at: z.string(),
+                retrieved_at: z.string().nullable(),
                 content: z.object({
                   type: z.literal('document'),
                   title: z.string().nullable(),
@@ -1149,7 +1183,7 @@ export const anthropicChunkSchema = lazySchema(() =>
                 z.object({
                   type: z.literal('web_search_result'),
                   url: z.string(),
-                  title: z.string(),
+                  title: z.string().nullable(),
                   encrypted_content: z.string(),
                   page_age: z.string().nullish(),
                 }),
@@ -1331,31 +1365,7 @@ export const anthropicChunkSchema = lazySchema(() =>
           }),
           z.object({
             type: z.literal('citations_delta'),
-            citation: z.discriminatedUnion('type', [
-              z.object({
-                type: z.literal('web_search_result_location'),
-                cited_text: z.string(),
-                url: z.string(),
-                title: z.string(),
-                encrypted_index: z.string(),
-              }),
-              z.object({
-                type: z.literal('page_location'),
-                cited_text: z.string(),
-                document_index: z.number(),
-                document_title: z.string().nullable(),
-                start_page_number: z.number(),
-                end_page_number: z.number(),
-              }),
-              z.object({
-                type: z.literal('char_location'),
-                cited_text: z.string(),
-                document_index: z.number(),
-                document_title: z.string().nullable(),
-                start_char_index: z.number(),
-                end_char_index: z.number(),
-              }),
-            ]),
+            citation: anthropicCitationSchema,
           }),
         ]),
       }),

package/src/anthropic-files.ts

@@ -49,6 +49,8 @@ export class AnthropicFiles implements FilesV4 {
     data,
     mediaType,
     filename,
+    abortSignal,
+    headers,
   }: FilesV4UploadFileCallOptions): Promise<FilesV4UploadFileResult> {
     const fileBytes = convertInlineFileDataToUint8Array(data);
 
@@ -63,14 +65,17 @@ export class AnthropicFiles implements FilesV4 {
 
     const { value: response } = await postFormDataToApi({
       url: `${this.config.baseURL}/files`,
-      headers: combineHeaders(this.config.headers(), {
-        'anthropic-beta': 'files-api-2025-04-14',
-      }),
+      headers: combineHeaders(
+        this.config.headers(),
+        { 'anthropic-beta': 'files-api-2025-04-14' },
+        headers,
+      ),
       formData,
       failedResponseHandler: anthropicFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
         anthropicUploadFileResponseSchema,
       ),
+      abortSignal,
       fetch: this.config.fetch,
     });
 

package/src/anthropic-language-model-options.ts

@@ -268,6 +268,9 @@ export const anthropicLanguageModelOptions = z.object({
    */
   speed: z.enum(['fast', 'standard']).optional(),
 
+  /** Selects Anthropic's service tier for the request. */
+  serviceTier: z.enum(['auto', 'standard_only']).optional(),
+
   /**
    * Controls where model inference runs for this request.
    *

package/src/anthropic-language-model.ts

@@ -118,7 +118,7 @@ function getAnthropicStreamErrorMetadata(type: string): {
   }
 }
 
-function createCitationSource(
+export function createCitationSource(
   citation: Citation,
   citationDocuments: Array<{
     title: string;
@@ -133,7 +133,7 @@ function createCitationSource(
       sourceType: 'url' as const,
       id: generateId(),
       url: citation.url,
-      title: citation.title,
+      title: citation.title ?? undefined,
       providerMetadata: {
         anthropic: {
           citedText: citation.cited_text,
@@ -226,7 +226,7 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
   readonly modelId: AnthropicModelId;
 
   protected readonly config: AnthropicLanguageModelConfig;
-  private readonly generateId: () => string;
+  protected readonly generateId: () => string;
 
   static [WORKFLOW_SERIALIZE](model: AnthropicLanguageModel) {
     return serializeModelOptions({
@@ -600,6 +600,9 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
       ...(anthropicOptions?.speed && {
         speed: anthropicOptions.speed,
       }),
+      ...(anthropicOptions?.serviceTier && {
+        service_tier: anthropicOptions.serviceTier,
+      }),
       ...(anthropicOptions?.inferenceGeo && {
         inference_geo: anthropicOptions.inferenceGeo,
       }),
@@ -1104,6 +1107,14 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
           });
           break;
         }
+        case 'container_upload': {
+          content.push({
+            type: 'custom',
+            kind: 'anthropic.container_upload',
+            providerMetadata: { anthropic: { fileId: part.file_id } },
+          });
+          break;
+        }
         case 'compaction': {
           content.push({
             type: 'text',
@@ -1301,7 +1312,7 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
               toolName: toolNameMapping.toCustomToolName('web_search'),
               result: part.content.map(result => ({
                 url: result.url,
-                title: result.title,
+                ...(result.title != null ? { title: result.title } : {}),
                 pageAge: result.page_age ?? null,
                 encryptedContent: result.encrypted_content,
                 type: result.type,
@@ -1315,7 +1326,7 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
                 sourceType: 'url',
                 id: this.generateId(),
                 url: result.url,
-                title: result.title,
+                ...(result.title != null ? { title: result.title } : {}),
                 providerMetadata: {
                   anthropic: {
                     pageAge: result.page_age ?? null,
@@ -2011,7 +2022,9 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
                       toolName: toolNameMapping.toCustomToolName('web_search'),
                       result: part.content.map(result => ({
                         url: result.url,
-                        title: result.title,
+                        ...(result.title != null
+                          ? { title: result.title }
+                          : {}),
                         pageAge: result.page_age ?? null,
                         encryptedContent: result.encrypted_content,
                         type: result.type,
@@ -2025,7 +2038,9 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
                         sourceType: 'url',
                         id: generateId(),
                         url: result.url,
-                        title: result.title,
+                        ...(result.title != null
+                          ? { title: result.title }
+                          : {}),
                         providerMetadata: {
                           anthropic: {
                             pageAge: result.page_age ?? null,
@@ -2921,7 +2936,7 @@ export function getModelCapabilities(modelId: string): {
   }
 }
 
-function hasWebTool20260209WithoutCodeExecution(
+export function hasWebTool20260209WithoutCodeExecution(
   tools: AnthropicTool[] | undefined,
 ): boolean {
   if (!tools) {
@@ -2938,7 +2953,12 @@ function hasWebTool20260209WithoutCodeExecution(
       hasWebTool20260209 = true;
       continue;
     }
-    if (tool.name === 'code_execution') {
+    if (
+      'type' in tool &&
+      (tool.type === 'code_execution_20250522' ||
+        tool.type === 'code_execution_20250825' ||
+        tool.type === 'code_execution_20260120')
+    ) {
       hasCodeExecutionTool = true;
       break;
     }