@tanstack/ai-anthropic 0.18.13 → 0.19.3

package/dist/esm/adapters/files.d.ts

@@ -0,0 +1,25 @@
+import { BaseFilesAdapter, FileHandle, FileUploadInput } from '@tanstack/ai/adapters';
+import { AnthropicClientConfig } from '../utils/client.js';
+export interface AnthropicFilesConfig extends AnthropicClientConfig {
+}
+/**
+ * Anthropic Files adapter — uploads media to the Anthropic Files API (beta) and
+ * references it by `file_id`. Pair with `anthropicText()`: reference the
+ * returned handle in an image/document message via `fileSourceFromHandle`.
+ */
+export declare class AnthropicFilesAdapter extends BaseFilesAdapter<'anthropic'> {
+    readonly name: "anthropic";
+    private readonly client;
+    constructor(config: AnthropicFilesConfig);
+    upload(input: FileUploadInput): Promise<FileHandle<'anthropic'>>;
+    get(id: string): Promise<FileHandle<'anthropic'>>;
+    delete(id: string): Promise<void>;
+}
+/**
+ * Create an Anthropic Files adapter with an explicit API key.
+ */
+export declare function createAnthropicFiles(apiKey: string, config?: Omit<AnthropicFilesConfig, 'apiKey'>): AnthropicFilesAdapter;
+/**
+ * Create an Anthropic Files adapter, reading the API key from `ANTHROPIC_API_KEY`.
+ */
+export declare function anthropicFiles(config?: Omit<AnthropicFilesConfig, 'apiKey'>): AnthropicFilesAdapter;

package/dist/esm/adapters/files.js

@@ -0,0 +1,61 @@
+import { createAnthropicClient, getAnthropicApiKeyFromEnv } from "../utils/client.js";
+import { BaseFilesAdapter, normalizeFileUploadInput } from "@tanstack/ai/adapters";
+import { toFile } from "@anthropic-ai/sdk";
+//#region src/adapters/files.ts
+/** Beta header required for the Anthropic Files API. */
+var FILES_API_BETA = "files-api-2025-04-14";
+/**
+* Anthropic Files adapter — uploads media to the Anthropic Files API (beta) and
+* references it by `file_id`. Pair with `anthropicText()`: reference the
+* returned handle in an image/document message via `fileSourceFromHandle`.
+*/
+var AnthropicFilesAdapter = class extends BaseFilesAdapter {
+	name = "anthropic";
+	client;
+	constructor(config) {
+		super();
+		this.client = createAnthropicClient(config);
+	}
+	async upload(input) {
+		const { blob, mimeType, filename } = normalizeFileUploadInput(input);
+		const file = await toFile(blob, filename, { ...mimeType ? { type: mimeType } : {} });
+		return toFileHandle(await this.client.beta.files.upload({
+			file,
+			betas: [FILES_API_BETA]
+		}));
+	}
+	async get(id) {
+		return toFileHandle(await this.client.beta.files.retrieveMetadata(id, { betas: [FILES_API_BETA] }));
+	}
+	async delete(id) {
+		await this.client.beta.files.delete(id, { betas: [FILES_API_BETA] });
+	}
+};
+function toFileHandle(file) {
+	return {
+		id: file.id,
+		provider: "anthropic",
+		mimeType: file.mime_type,
+		sizeBytes: file.size_bytes,
+		filename: file.filename
+	};
+}
+/**
+* Create an Anthropic Files adapter with an explicit API key.
+*/
+function createAnthropicFiles(apiKey, config) {
+	return new AnthropicFilesAdapter({
+		...config,
+		apiKey
+	});
+}
+/**
+* Create an Anthropic Files adapter, reading the API key from `ANTHROPIC_API_KEY`.
+*/
+function anthropicFiles(config) {
+	return createAnthropicFiles(getAnthropicApiKeyFromEnv(), config);
+}
+//#endregion
+export { AnthropicFilesAdapter, anthropicFiles, createAnthropicFiles };
+
+//# sourceMappingURL=files.js.map

package/dist/esm/adapters/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","names":[],"sources":["../../../src/adapters/files.ts"],"sourcesContent":["import { toFile } from '@anthropic-ai/sdk'\nimport {\n  BaseFilesAdapter,\n  normalizeFileUploadInput,\n} from '@tanstack/ai/adapters'\nimport {\n  createAnthropicClient,\n  getAnthropicApiKeyFromEnv,\n} from '../utils/client'\nimport type Anthropic_SDK from '@anthropic-ai/sdk'\nimport type { FileMetadata } from '@anthropic-ai/sdk/resources/beta/files'\nimport type { FileHandle, FileUploadInput } from '@tanstack/ai/adapters'\nimport type { AnthropicClientConfig } from '../utils/client'\n\n/** Beta header required for the Anthropic Files API. */\nconst FILES_API_BETA = 'files-api-2025-04-14'\n\nexport interface AnthropicFilesConfig extends AnthropicClientConfig {}\n\n/**\n * Anthropic Files adapter — uploads media to the Anthropic Files API (beta) and\n * references it by `file_id`. Pair with `anthropicText()`: reference the\n * returned handle in an image/document message via `fileSourceFromHandle`.\n */\nexport class AnthropicFilesAdapter extends BaseFilesAdapter<'anthropic'> {\n  readonly name = 'anthropic' as const\n  private readonly client: Anthropic_SDK\n\n  constructor(config: AnthropicFilesConfig) {\n    super()\n    this.client = createAnthropicClient(config)\n  }\n\n  async upload(input: FileUploadInput): Promise<FileHandle<'anthropic'>> {\n    const { blob, mimeType, filename } = normalizeFileUploadInput(input)\n    const file = await toFile(blob, filename, {\n      ...(mimeType ? { type: mimeType } : {}),\n    })\n    const result = await this.client.beta.files.upload({\n      file,\n      betas: [FILES_API_BETA],\n    })\n    return toFileHandle(result)\n  }\n\n  async get(id: string): Promise<FileHandle<'anthropic'>> {\n    const result = await this.client.beta.files.retrieveMetadata(id, {\n      betas: [FILES_API_BETA],\n    })\n    return toFileHandle(result)\n  }\n\n  async delete(id: string): Promise<void> {\n    await this.client.beta.files.delete(id, { betas: [FILES_API_BETA] })\n  }\n}\n\nfunction toFileHandle(file: FileMetadata): FileHandle<'anthropic'> {\n  return {\n    id: file.id,\n    provider: 'anthropic',\n    mimeType: file.mime_type,\n    sizeBytes: file.size_bytes,\n    filename: file.filename,\n  }\n}\n\n/**\n * Create an Anthropic Files adapter with an explicit API key.\n */\nexport function createAnthropicFiles(\n  apiKey: string,\n  config?: Omit<AnthropicFilesConfig, 'apiKey'>,\n): AnthropicFilesAdapter {\n  return new AnthropicFilesAdapter({ ...config, apiKey })\n}\n\n/**\n * Create an Anthropic Files adapter, reading the API key from `ANTHROPIC_API_KEY`.\n */\nexport function anthropicFiles(\n  config?: Omit<AnthropicFilesConfig, 'apiKey'>,\n): AnthropicFilesAdapter {\n  return createAnthropicFiles(getAnthropicApiKeyFromEnv(), config)\n}\n"],"mappings":";;;;;AAeA,IAAM,iBAAiB;;;;;;AASvB,IAAa,wBAAb,cAA2C,iBAA8B;CACvE,OAAgB;CAChB;CAEA,YAAY,QAA8B;EACxC,MAAM;EACN,KAAK,SAAS,sBAAsB,MAAM;CAC5C;CAEA,MAAM,OAAO,OAA0D;EACrE,MAAM,EAAE,MAAM,UAAU,aAAa,yBAAyB,KAAK;EACnE,MAAM,OAAO,MAAM,OAAO,MAAM,UAAU,EACxC,GAAI,WAAW,EAAE,MAAM,SAAS,IAAI,CAAC,EACvC,CAAC;EAKD,OAAO,aAAa,MAJC,KAAK,OAAO,KAAK,MAAM,OAAO;GACjD;GACA,OAAO,CAAC,cAAc;EACxB,CAAC,CACyB;CAC5B;CAEA,MAAM,IAAI,IAA8C;EAItD,OAAO,aAAa,MAHC,KAAK,OAAO,KAAK,MAAM,iBAAiB,IAAI,EAC/D,OAAO,CAAC,cAAc,EACxB,CAAC,CACyB;CAC5B;CAEA,MAAM,OAAO,IAA2B;EACtC,MAAM,KAAK,OAAO,KAAK,MAAM,OAAO,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;CACrE;AACF;AAEA,SAAS,aAAa,MAA6C;CACjE,OAAO;EACL,IAAI,KAAK;EACT,UAAU;EACV,UAAU,KAAK;EACf,WAAW,KAAK;EAChB,UAAU,KAAK;CACjB;AACF;;;;AAKA,SAAgB,qBACd,QACA,QACuB;CACvB,OAAO,IAAI,sBAAsB;EAAE,GAAG;EAAQ;CAAO,CAAC;AACxD;;;;AAKA,SAAgB,eACd,QACuB;CACvB,OAAO,qBAAqB,0BAA0B,GAAG,MAAM;AACjE"}

package/dist/esm/adapters/text.d.ts

@@ -1,16 +1,22 @@
 import { BaseTextAdapter, StructuredOutputOptions, StructuredOutputResult } from '@tanstack/ai/adapters';
 import { ANTHROPIC_MODELS, AnthropicChatModelProviderOptionsByName, AnthropicChatModelToolCapabilitiesByName, AnthropicModelInputModalitiesByName } from '../model-meta.js';
 import { AnthropicBeta } from '@anthropic-ai/sdk/resources/beta/beta';
-import { AnyTool, Modality, AdapterYieldChunk, TextOptions } from '@tanstack/ai';
+import { AnyTool, Modality, ModelMessage, AdapterYieldChunk, TextOptions } from '@tanstack/ai';
 import { AnthropicSystemPromptMetadata, ExternalTextProviderOptions } from '../text/text-provider-options.js';
 import { AnthropicMessageMetadataByModality } from '../message-types.js';
 import { AnthropicClientConfig, AnthropicMessagesClient } from '../utils/client.js';
+/**
+ * True when any message carries a provider file-handle source, so the request
+ * must send the Files API beta header.
+ */
+export declare function messagesHaveFileSource(messages: Array<ModelMessage>): boolean;
 /**
  * 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 declare function computeAnthropicBetas(tools: Array<AnyTool> | undefined, modelOptions: {
@@ -19,7 +25,8 @@ export declare function computeAnthropicBetas(tools: Array<AnyTool> | undefined,
         budget_tokens?: number;
     };
     context_management?: unknown | null;
-} | undefined): Array<AnthropicBeta> | undefined;
+    mcp_servers?: ReadonlyArray<unknown>;
+} | undefined, hasFileSource?: boolean): Array<AnthropicBeta> | undefined;
 /**
  * Configuration for Anthropic text adapter
  */
@@ -52,6 +59,7 @@ type ResolveToolCapabilities<TModel extends string> = TModel extends keyof Anthr
 export declare class AnthropicTextAdapter<TModel extends (typeof ANTHROPIC_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends BaseTextAdapter<TModel, TProviderOptions, TInputModalities, AnthropicMessageMetadataByModality, TToolCapabilities, unknown, AnthropicSystemPromptMetadata> {
     readonly kind: "text";
     readonly name: "anthropic";
+    readonly supportsFileSources = true;
     private readonly client;
     constructor(config: AnthropicTextAdapterConfig, model: TModel);
     chatStream(options: TextOptions<TProviderOptions>): AsyncIterable<AdapterYieldChunk>;

package/dist/esm/adapters/text.js

@@ -5,7 +5,7 @@ import { validateTextProviderOptions } from "../text/text-provider-options.js";
 import { buildAnthropicUsage } from "../usage.js";
 import { createAnthropicClient, generateId, getAnthropicApiKeyFromEnv } from "../utils/client.js";
 import { ANTHROPIC_COMBINED_TOOLS_AND_SCHEMA_MODELS, getAnthropicDefaultMaxTokens } from "../model-meta.js";
-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";
 //#region src/adapters/text.ts
@@ -45,17 +45,27 @@ function buildServerToolResultBlock(toolUseId, meta) {
 	};
 }
 /**
+* True when any message carries a provider file-handle source, so the request
+* must send the Files API beta header.
+*/
+function messagesHaveFileSource(messages) {
+	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`).
 */
-function computeAnthropicBetas(tools, modelOptions) {
+function computeAnthropicBetas(tools, modelOptions, hasFileSource = false) {
 	const betas = /* @__PURE__ */ new Set();
+	if (hasFileSource) betas.add("files-api-2025-04-14");
 	if (modelOptions?.thinking?.type === "enabled" && typeof modelOptions.thinking.budget_tokens === "number" && modelOptions.thinking.budget_tokens > 0) betas.add("interleaved-thinking-2025-05-14");
 	if (modelOptions?.context_management != null) betas.add("context-management-2025-06-27");
+	if (modelOptions?.mcp_servers && modelOptions.mcp_servers.length > 0) betas.add("mcp-client-2025-04-04");
 	const codeExecTool = tools?.find((tool) => getAnthropicProviderToolKind(tool) === "code_execution");
 	if (codeExecTool) {
 		const cfgType = readCodeExecutionConfig(codeExecTool)?.type;
@@ -81,6 +91,7 @@ function asSdkAnthropicMessagesClient(client) {
 var AnthropicTextAdapter = class extends BaseTextAdapter {
 	kind = "text";
 	name = "anthropic";
+	supportsFileSources = true;
 	client;
 	constructor(config, model) {
 		super({}, model);
@@ -94,7 +105,7 @@ var AnthropicTextAdapter = class extends BaseTextAdapter {
 				provider: "anthropic",
 				model: this.model
 			});
-			const betas = computeAnthropicBetas(options.tools, options.modelOptions);
+			const betas = computeAnthropicBetas(options.tools, options.modelOptions, messagesHaveFileSource(options.messages));
 			const stream = await this.client.beta.messages.create({
 				...requestParams,
 				stream: true,
@@ -149,7 +160,7 @@ var AnthropicTextAdapter = class extends BaseTextAdapter {
 				provider: "anthropic",
 				model: this.model
 			});
-			const betas = computeAnthropicBetas(chatOptions.tools, chatOptions.modelOptions);
+			const betas = computeAnthropicBetas(chatOptions.tools, chatOptions.modelOptions, messagesHaveFileSource(chatOptions.messages));
 			const response = await this.client.beta.messages.create({
 				...requestParams,
 				stream: false,
@@ -287,32 +298,46 @@ var AnthropicTextAdapter = class extends BaseTextAdapter {
 			}
 			case "image": {
 				const metadata = part.metadata;
+				let imageSource;
+				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
+				};
+				else imageSource = {
+					type: "url",
+					url: part.source.value
+				};
 				return {
 					type: "image",
-					source: part.source.type === "data" ? {
-						type: "base64",
-						data: part.source.value,
-						media_type: part.source.mimeType
-					} : {
-						type: "url",
-						url: part.source.value
-					},
+					source: imageSource,
 					...metadata?.cache_control !== void 0 && { cache_control: metadata.cache_control }
 				};
 			}
 			case "document": {
 				const metadata = part.metadata;
 				const title = metadata?.title ?? metadata?.filename;
+				let docSource;
+				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
+				};
+				else docSource = {
+					type: "url",
+					url: part.source.value
+				};
 				return {
 					type: "document",
-					source: part.source.type === "data" ? {
-						type: "base64",
-						data: part.source.value,
-						media_type: part.source.mimeType
-					} : {
-						type: "url",
-						url: part.source.value
-					},
+					source: docSource,
 					...metadata?.cache_control !== void 0 && { cache_control: metadata.cache_control },
 					...metadata?.citations !== void 0 && { citations: metadata.citations },
 					...metadata?.context !== void 0 && { context: metadata.context },
@@ -873,6 +898,6 @@ function anthropicText(model, config) {
 	return createAnthropicChat(model, getAnthropicApiKeyFromEnv(), config);
 }
 //#endregion
-export { AnthropicTextAdapter, anthropicText, computeAnthropicBetas, createAnthropicChat, createAnthropicChatWithClient };
+export { AnthropicTextAdapter, anthropicText, computeAnthropicBetas, createAnthropicChat, createAnthropicChatWithClient, messagesHaveFileSource };
 
 //# sourceMappingURL=text.js.map