@tanstack/ai-anthropic 0.18.13 → 0.19.3

package/src/adapters/text.ts

@@ -1,4 +1,9 @@
-import { EventType, normalizeSystemPrompts } from '@tanstack/ai'
+import {
+  EventType,
+  fileReferenceFor,
+  isFileSource,
+  normalizeSystemPrompts,
+} from '@tanstack/ai'
 import { toRunErrorRawEvent } from '@tanstack/ai/adapter-internals'
 import { BaseTextAdapter } from '@tanstack/ai/adapters'
 import { convertToolsToProviderFormat } from '../tools/tool-converter'
@@ -30,20 +35,25 @@ import type {
 } from '@tanstack/ai/adapters'
 import type { InternalLogger } from '@tanstack/ai/adapter-internals'
 import type {
-  Base64ImageSource,
-  Base64PDFSource,
-  ContentBlockParam,
-  DocumentBlockParam,
-  ImageBlockParam,
   ServerToolUseBlockParam,
   TextBlockParam,
   ThinkingBlockParam,
   ToolUseBlockParam,
-  URLImageSource,
-  URLPDFSource,
   WebFetchToolResultBlockParam,
   WebSearchToolResultBlockParam,
 } from '@anthropic-ai/sdk/resources/messages'
+import type {
+  BetaBase64ImageSource,
+  BetaBase64PDFSource,
+  BetaContentBlockParam,
+  BetaFileDocumentSource,
+  BetaFileImageSource,
+  BetaImageBlockParam,
+  BetaRequestDocumentBlock,
+  BetaTextBlockParam,
+  BetaURLImageSource,
+  BetaURLPDFSource,
+} from '@anthropic-ai/sdk/resources/beta/messages'
 import type Anthropic_SDK from '@anthropic-ai/sdk'
 import type { AnthropicBeta } from '@anthropic-ai/sdk/resources/beta/beta'
 import type {
@@ -147,12 +157,27 @@ function buildServerToolResultBlock(
   }
 }
 
+/**
+ * True when any message carries a provider file-handle source, so the request
+ * must send the Files API beta header.
+ */
+export function messagesHaveFileSource(messages: Array<ModelMessage>): boolean {
+  return messages.some(
+    (message) =>
+      Array.isArray(message.content) &&
+      message.content.some(
+        (part) => 'source' in part && isFileSource(part.source),
+      ),
+  )
+}
+
 /**
  * Computes the `betas` array for a Messages request. Unions:
  * - `interleaved-thinking-2025-05-14` when interleaved thinking is enabled,
  * - `code-execution-2025-08-25` when a `code_execution` tool is present,
  * - `skills-2025-10-02` when that tool carries skills,
- * - `context-management-2025-06-27` when `context_management` is set.
+ * - `context-management-2025-06-27` when `context_management` is set,
+ * - `files-api-2025-04-14` when a message references an uploaded file handle.
  * Returns `undefined` when none apply (so the call site omits `betas`).
  */
 export function computeAnthropicBetas(
@@ -164,11 +189,15 @@ export function computeAnthropicBetas(
           budget_tokens?: number
         }
         context_management?: unknown | null
+        mcp_servers?: ReadonlyArray<unknown>
       }
     | undefined,
+  hasFileSource = false,
 ): Array<AnthropicBeta> | undefined {
   const betas = new Set<AnthropicBeta>()
 
+  if (hasFileSource) betas.add('files-api-2025-04-14')
+
   const useInterleavedThinking =
     modelOptions?.thinking?.type === 'enabled' &&
     typeof modelOptions.thinking.budget_tokens === 'number' &&
@@ -181,6 +210,15 @@ export function computeAnthropicBetas(
     betas.add('context-management-2025-06-27')
   }
 
+  // The MCP connector needs its beta header as well (same shape as #1074);
+  // an empty array is a typed "unset" — do not enable the beta.
+  // ponytail: 2025-04-04 matches the `mcp_servers` shape we type
+  // (`tool_configuration` on each server). 2025-11-20 needs an `mcp_toolset`
+  // in `tools` for every server, which this adapter does not send yet.
+  if (modelOptions?.mcp_servers && modelOptions.mcp_servers.length > 0) {
+    betas.add('mcp-client-2025-04-04')
+  }
+
   // Code-execution beta is version-aware: select from the FIRST code_execution
   // tool's config type.
   const codeExecTool = tools?.find(
@@ -301,6 +339,8 @@ export class AnthropicTextAdapter<
 > {
   override readonly kind = 'text' as const
   readonly name = 'anthropic' as const
+  // Consumes `file_id` sources issued by anthropicFiles() (Files API beta).
+  override readonly supportsFileSources = true
 
   private readonly client: SdkAnthropicMessagesClient
 
@@ -326,7 +366,11 @@ export class AnthropicTextAdapter<
 
       // `betas` is attached at the call site rather than in the shared mapper
       // because the beta set depends on both the tools and the modelOptions.
-      const betas = computeAnthropicBetas(options.tools, options.modelOptions)
+      const betas = computeAnthropicBetas(
+        options.tools,
+        options.modelOptions,
+        messagesHaveFileSource(options.messages),
+      )
 
       // `client.beta.messages` is Anthropic's permanent staging surface, not a
       // sunset path: it's a superset of `client.messages` that additionally
@@ -416,6 +460,7 @@ export class AnthropicTextAdapter<
       const betas = computeAnthropicBetas(
         chatOptions.tools,
         chatOptions.modelOptions,
+        messagesHaveFileSource(chatOptions.messages),
       )
       // Make non-streaming request with tool_choice forced to our structured output tool
       const response = await this.client.beta.messages.create(
@@ -657,7 +702,7 @@ export class AnthropicTextAdapter<
 
   private convertContentPartToAnthropic(
     part: ContentPart,
-  ): TextBlockParam | ImageBlockParam | DocumentBlockParam {
+  ): BetaTextBlockParam | BetaImageBlockParam | BetaRequestDocumentBlock {
     switch (part.type) {
       case 'text': {
         const metadata = part.metadata as AnthropicTextMetadata | undefined
@@ -670,21 +715,31 @@ export class AnthropicTextAdapter<
 
       case 'image': {
         const metadata = part.metadata as AnthropicImageMetadata | undefined
-        const imageSource: Base64ImageSource | URLImageSource =
-          part.source.type === 'data'
-            ? {
-                type: 'base64',
-                data: part.source.value,
-                media_type: part.source.mimeType as
-                  | 'image/jpeg'
-                  | 'image/png'
-                  | 'image/gif'
-                  | 'image/webp',
-              }
-            : {
-                type: 'url',
-                url: part.source.value,
-              }
+        let imageSource:
+          | BetaBase64ImageSource
+          | BetaURLImageSource
+          | BetaFileImageSource
+        if (isFileSource(part.source)) {
+          imageSource = {
+            type: 'file',
+            file_id: fileReferenceFor(part.source, this.name),
+          }
+        } else if (part.source.type === 'data') {
+          imageSource = {
+            type: 'base64',
+            data: part.source.value,
+            media_type: part.source.mimeType as
+              | 'image/jpeg'
+              | 'image/png'
+              | 'image/gif'
+              | 'image/webp',
+          }
+        } else {
+          imageSource = {
+            type: 'url',
+            url: part.source.value,
+          }
+        }
         return {
           type: 'image',
           source: imageSource,
@@ -696,17 +751,27 @@ export class AnthropicTextAdapter<
       case 'document': {
         const metadata = part.metadata as AnthropicDocumentMetadata | undefined
         const title = metadata?.title ?? metadata?.filename
-        const docSource: Base64PDFSource | URLPDFSource =
-          part.source.type === 'data'
-            ? {
-                type: 'base64',
-                data: part.source.value,
-                media_type: part.source.mimeType as 'application/pdf',
-              }
-            : {
-                type: 'url',
-                url: part.source.value,
-              }
+        let docSource:
+          | BetaBase64PDFSource
+          | BetaURLPDFSource
+          | BetaFileDocumentSource
+        if (isFileSource(part.source)) {
+          docSource = {
+            type: 'file',
+            file_id: fileReferenceFor(part.source, this.name),
+          }
+        } else if (part.source.type === 'data') {
+          docSource = {
+            type: 'base64',
+            data: part.source.value,
+            media_type: part.source.mimeType as 'application/pdf',
+          }
+        } else {
+          docSource = {
+            type: 'url',
+            url: part.source.value,
+          }
+        }
         return {
           type: 'document',
           source: docSource,
@@ -766,7 +831,7 @@ export class AnthropicTextAdapter<
       }
 
       if (role === 'assistant' && message.toolCalls?.length) {
-        const contentBlocks: Array<ContentBlockParam> = []
+        const contentBlocks: Array<BetaContentBlockParam> = []
 
         this.appendThinkingBlocks(contentBlocks, message.thinking)
 
@@ -828,7 +893,7 @@ export class AnthropicTextAdapter<
       }
 
       if (role === 'assistant') {
-        const contentBlocks: Array<ContentBlockParam> = []
+        const contentBlocks: Array<BetaContentBlockParam> = []
         this.appendThinkingBlocks(contentBlocks, message.thinking)
 
         if (Array.isArray(message.content)) {
@@ -880,7 +945,7 @@ export class AnthropicTextAdapter<
   }
 
   private appendThinkingBlocks(
-    contentBlocks: Array<ContentBlockParam>,
+    contentBlocks: Array<BetaContentBlockParam>,
     thinkingParts: ModelMessage['thinking'],
   ): void {
     if (!thinkingParts?.length) return

package/src/index.ts

@@ -22,6 +22,14 @@ export {
   type AnthropicSummarizeConfig,
   type AnthropicSummarizeModel,
 } from './adapters/summarize'
+
+// Files adapter - upload media to the Anthropic Files API (beta) by file_id
+export {
+  AnthropicFilesAdapter,
+  createAnthropicFiles,
+  anthropicFiles,
+  type AnthropicFilesConfig,
+} from './adapters/files'
 // ============================================================================
 // Type Exports
 // ============================================================================

package/src/model-meta.ts

@@ -608,7 +608,48 @@ const CLAUDE_FABLE_5_1 = {
     AnthropicOutputConfigOptions
 >
 
+const CLAUDE_OPUS_5_5 = {
+  name: 'claude-opus-5-5',
+  id: 'claude-opus-5-5',
+  context_window: 1_000_000,
+  max_output_tokens: 128_000,
+  supports: {
+    input: ['text', 'image', 'document'],
+    // No 'computer_use': this model accepts only `computer_toolset_20260801`,
+    // and `computerUseTool()` sends the older versions, which return a 400.
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
+  },
+  pricing: {
+    input: {
+      normal: 4,
+      cached: 0.2,
+    },
+    output: {
+      normal: 20,
+    },
+  },
+} as const satisfies ModelMeta<
+  AnthropicCacheControlOptions &
+    AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicAdaptiveOnlyThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions &
+    AnthropicOutputConfigOptions
+>
+
 export const ANTHROPIC_MODELS = [
+  CLAUDE_OPUS_5_5.id,
   CLAUDE_FABLE_5_1.id,
   CLAUDE_OPUS_5.id,
   CLAUDE_OPUS_5_FAST.id,
@@ -686,6 +727,7 @@ const ANTHROPIC_MODEL_MAX_OUTPUT_TOKENS: Record<string, number> = {
   [CLAUDE_OPUS_5.id]: CLAUDE_OPUS_5.max_output_tokens,
   [CLAUDE_OPUS_5_FAST.id]: CLAUDE_OPUS_5_FAST.max_output_tokens,
   [CLAUDE_FABLE_5_1.id]: CLAUDE_FABLE_5_1.max_output_tokens,
+  [CLAUDE_OPUS_5_5.id]: CLAUDE_OPUS_5_5.max_output_tokens,
 }
 
 /**
@@ -741,6 +783,7 @@ export const ANTHROPIC_COMBINED_TOOLS_AND_SCHEMA_MODELS = new Set<string>([
   CLAUDE_OPUS_5.id,
   CLAUDE_FABLE_5.id,
   CLAUDE_FABLE_5_1.id,
+  CLAUDE_OPUS_5_5.id,
   CLAUDE_SONNET_5.id,
   CLAUDE_SONNET_4_5.id,
   CLAUDE_SONNET_4_6.id,
@@ -891,6 +934,16 @@ export type AnthropicChatModelProviderOptionsByName = {
     AnthropicToolChoiceOptions &
     AnthropicMaxTokensOptions &
     AnthropicOutputConfigOptions
+  [CLAUDE_OPUS_5_5.id]: AnthropicCacheControlOptions &
+    AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicAdaptiveOnlyThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions &
+    AnthropicOutputConfigOptions
 }
 
 export type AnthropicChatModelToolCapabilitiesByName = {
@@ -907,6 +960,7 @@ export type AnthropicChatModelToolCapabilitiesByName = {
   [CLAUDE_OPUS_5.id]: typeof CLAUDE_OPUS_5.supports.tools
   [CLAUDE_OPUS_5_FAST.id]: typeof CLAUDE_OPUS_5_FAST.supports.tools
   [CLAUDE_FABLE_5_1.id]: typeof CLAUDE_FABLE_5_1.supports.tools
+  [CLAUDE_OPUS_5_5.id]: typeof CLAUDE_OPUS_5_5.supports.tools
 }
 
 /**
@@ -934,4 +988,5 @@ export type AnthropicModelInputModalitiesByName = {
   [CLAUDE_OPUS_5.id]: typeof CLAUDE_OPUS_5.supports.input
   [CLAUDE_OPUS_5_FAST.id]: typeof CLAUDE_OPUS_5_FAST.supports.input
   [CLAUDE_FABLE_5_1.id]: typeof CLAUDE_FABLE_5_1.supports.input
+  [CLAUDE_OPUS_5_5.id]: typeof CLAUDE_OPUS_5_5.supports.input
 }

package/src/text/text-provider-options.ts

@@ -1,15 +1,13 @@
 import type {
   BetaContextManagementConfig,
+  BetaMessageParam,
   BetaToolChoiceAny,
   BetaToolChoiceAuto,
   BetaToolChoiceTool,
 } from '@anthropic-ai/sdk/resources/beta/messages/messages'
 import type { CacheControlEphemeral } from '@anthropic-ai/sdk/resources'
 import type { AnthropicContainerSkill, AnthropicTool } from '../tools/index'
-import type {
-  MessageParam,
-  TextBlockParam,
-} from '@anthropic-ai/sdk/resources/messages'
+import type { TextBlockParam } from '@anthropic-ai/sdk/resources/messages'
 
 /**
  * Per-prompt metadata Anthropic understands on `systemPrompts` entries.
@@ -320,7 +318,7 @@ export type ExternalTextProviderOptions = AnthropicCacheControlOptions &
 export interface InternalTextProviderOptions extends ExternalTextProviderOptions {
   model: string
 
-  messages: Array<MessageParam>
+  messages: Array<BetaMessageParam>
 
   /**
    * The maximum number of tokens to generate before stopping.  This parameter only specifies the absolute maximum number of tokens to generate.