@tanstack/ai-anthropic 0.15.9 → 0.15.11

package/dist/esm/tools/text-editor-tool.js

@@ -0,0 +1,19 @@
+import { brandProviderTool } from "@tanstack/ai";
+function convertTextEditorToolToAdapterFormat(tool) {
+  const metadata = tool.metadata;
+  return {
+    ...metadata
+  };
+}
+function textEditorTool(config) {
+  return brandProviderTool({
+    name: "str_replace_editor",
+    description: "",
+    metadata: config
+  });
+}
+export {
+  convertTextEditorToolToAdapterFormat,
+  textEditorTool
+};
+//# sourceMappingURL=text-editor-tool.js.map

package/dist/esm/tools/text-editor-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-editor-tool.js","sources":["../../../src/tools/text-editor-tool.ts"],"sourcesContent":["import { brandProviderTool } from '@tanstack/ai'\nimport type {\n  ToolTextEditor20250124,\n  ToolTextEditor20250429,\n  ToolTextEditor20250728,\n} from '@anthropic-ai/sdk/resources/messages'\nimport type { ProviderTool, Tool } from '@tanstack/ai'\n\nexport type TextEditorToolConfig =\n  | ToolTextEditor20250124\n  | ToolTextEditor20250429\n  | ToolTextEditor20250728\n\n/** @deprecated Renamed to `TextEditorToolConfig`. Will be removed in a future release. */\nexport type TextEditorTool = TextEditorToolConfig\n\nexport type AnthropicTextEditorTool = ProviderTool<'anthropic', 'text_editor'>\n\nexport function convertTextEditorToolToAdapterFormat(\n  tool: Tool,\n): TextEditorToolConfig {\n  const metadata = tool.metadata as TextEditorToolConfig\n  return {\n    ...metadata,\n  }\n}\n\nexport function textEditorTool<T extends TextEditorToolConfig>(\n  config: T,\n): AnthropicTextEditorTool {\n  return brandProviderTool<AnthropicTextEditorTool>({\n    name: 'str_replace_editor',\n    description: '',\n    metadata: config,\n  })\n}\n"],"names":[],"mappings":";AAkBO,SAAS,qCACd,MACsB;AACtB,QAAM,WAAW,KAAK;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,EAAA;AAEP;AAEO,SAAS,eACd,QACyB;AACzB,SAAO,kBAA2C;AAAA,IAChD,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EAAA,CACX;AACH;"}

package/dist/esm/tools/tool-converter.d.ts

@@ -0,0 +1,27 @@
+import { AnthropicTool } from '.';
+import { Tool } from '@tanstack/ai';
+/**
+ * Converts standard Tool format to Anthropic-specific tool format
+ *
+ * @param tools - Array of standard Tool objects
+ * @returns Array of Anthropic-specific tool definitions
+ *
+ * @example
+ * ```typescript
+ * const tools: Tool[] = [{
+ *   type: "function",
+ *   function: {
+ *     name: "get_weather",
+ *     description: "Get weather for a location",
+ *     parameters: {
+ *       type: "object",
+ *       properties: { location: { type: "string" } },
+ *       required: ["location"]
+ *     }
+ *   }
+ * }];
+ *
+ * const anthropicTools = convertToolsToProviderFormat(tools);
+ * ```
+ */
+export declare function convertToolsToProviderFormat<TTool extends Tool>(tools: Array<TTool>): Array<AnthropicTool>;

package/dist/esm/tools/tool-converter.js

@@ -0,0 +1,35 @@
+import { convertBashToolToAdapterFormat } from "./bash-tool.js";
+import { convertCodeExecutionToolToAdapterFormat } from "./code-execution-tool.js";
+import { convertComputerUseToolToAdapterFormat } from "./computer-use-tool.js";
+import { convertCustomToolToAdapterFormat } from "./custom-tool.js";
+import { convertMemoryToolToAdapterFormat } from "./memory-tool.js";
+import { convertTextEditorToolToAdapterFormat } from "./text-editor-tool.js";
+import { convertWebFetchToolToAdapterFormat } from "./web-fetch-tool.js";
+import { convertWebSearchToolToAdapterFormat } from "./web-search-tool.js";
+function convertToolsToProviderFormat(tools) {
+  return tools.map((tool) => {
+    const name = tool.name;
+    switch (name) {
+      case "bash":
+        return convertBashToolToAdapterFormat(tool);
+      case "code_execution":
+        return convertCodeExecutionToolToAdapterFormat(tool);
+      case "computer":
+        return convertComputerUseToolToAdapterFormat(tool);
+      case "memory":
+        return convertMemoryToolToAdapterFormat(tool);
+      case "str_replace_editor":
+        return convertTextEditorToolToAdapterFormat(tool);
+      case "web_fetch":
+        return convertWebFetchToolToAdapterFormat(tool);
+      case "web_search":
+        return convertWebSearchToolToAdapterFormat(tool);
+      default:
+        return convertCustomToolToAdapterFormat(tool);
+    }
+  });
+}
+export {
+  convertToolsToProviderFormat
+};
+//# sourceMappingURL=tool-converter.js.map

package/dist/esm/tools/tool-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-converter.js","sources":["../../../src/tools/tool-converter.ts"],"sourcesContent":["import { convertBashToolToAdapterFormat } from './bash-tool'\nimport { convertCodeExecutionToolToAdapterFormat } from './code-execution-tool'\nimport { convertComputerUseToolToAdapterFormat } from './computer-use-tool'\nimport { convertCustomToolToAdapterFormat } from './custom-tool'\nimport { convertMemoryToolToAdapterFormat } from './memory-tool'\nimport { convertTextEditorToolToAdapterFormat } from './text-editor-tool'\nimport { convertWebFetchToolToAdapterFormat } from './web-fetch-tool'\nimport { convertWebSearchToolToAdapterFormat } from './web-search-tool'\nimport type { AnthropicTool } from '.'\nimport type { Tool } from '@tanstack/ai'\n\n/**\n * Converts standard Tool format to Anthropic-specific tool format\n *\n * @param tools - Array of standard Tool objects\n * @returns Array of Anthropic-specific tool definitions\n *\n * @example\n * ```typescript\n * const tools: Tool[] = [{\n *   type: \"function\",\n *   function: {\n *     name: \"get_weather\",\n *     description: \"Get weather for a location\",\n *     parameters: {\n *       type: \"object\",\n *       properties: { location: { type: \"string\" } },\n *       required: [\"location\"]\n *     }\n *   }\n * }];\n *\n * const anthropicTools = convertToolsToProviderFormat(tools);\n * ```\n */\nexport function convertToolsToProviderFormat<TTool extends Tool>(\n  tools: Array<TTool>,\n): Array<AnthropicTool> {\n  return tools.map((tool) => {\n    const name = tool.name\n\n    switch (name) {\n      case 'bash':\n        return convertBashToolToAdapterFormat(tool)\n      case 'code_execution':\n        return convertCodeExecutionToolToAdapterFormat(tool)\n      case 'computer':\n        return convertComputerUseToolToAdapterFormat(tool)\n      case 'memory':\n        return convertMemoryToolToAdapterFormat(tool)\n      case 'str_replace_editor':\n        return convertTextEditorToolToAdapterFormat(tool)\n      case 'web_fetch':\n        return convertWebFetchToolToAdapterFormat(tool)\n      case 'web_search':\n        return convertWebSearchToolToAdapterFormat(tool)\n      default:\n        return convertCustomToolToAdapterFormat(tool)\n    }\n  })\n}\n"],"names":[],"mappings":";;;;;;;;AAmCO,SAAS,6BACd,OACsB;AACtB,SAAO,MAAM,IAAI,CAAC,SAAS;AACzB,UAAM,OAAO,KAAK;AAElB,YAAQ,MAAA;AAAA,MACN,KAAK;AACH,eAAO,+BAA+B,IAAI;AAAA,MAC5C,KAAK;AACH,eAAO,wCAAwC,IAAI;AAAA,MACrD,KAAK;AACH,eAAO,sCAAsC,IAAI;AAAA,MACnD,KAAK;AACH,eAAO,iCAAiC,IAAI;AAAA,MAC9C,KAAK;AACH,eAAO,qCAAqC,IAAI;AAAA,MAClD,KAAK;AACH,eAAO,mCAAmC,IAAI;AAAA,MAChD,KAAK;AACH,eAAO,oCAAoC,IAAI;AAAA,MACjD;AACE,eAAO,iCAAiC,IAAI;AAAA,IAAA;AAAA,EAElD,CAAC;AACH;"}

package/dist/esm/tools/web-fetch-tool.d.ts

@@ -0,0 +1,8 @@
+import { BetaWebFetchTool20250910 } from '@anthropic-ai/sdk/resources/beta';
+import { ProviderTool, Tool } from '@tanstack/ai';
+export type WebFetchToolConfig = BetaWebFetchTool20250910;
+/** @deprecated Renamed to `WebFetchToolConfig`. Will be removed in a future release. */
+export type WebFetchTool = WebFetchToolConfig;
+export type AnthropicWebFetchTool = ProviderTool<'anthropic', 'web_fetch'>;
+export declare function convertWebFetchToolToAdapterFormat(tool: Tool): WebFetchToolConfig;
+export declare function webFetchTool(config?: Omit<WebFetchToolConfig, 'type' | 'name'>): AnthropicWebFetchTool;

package/dist/esm/tools/web-fetch-tool.js

@@ -0,0 +1,21 @@
+import { brandProviderTool } from "@tanstack/ai";
+function convertWebFetchToolToAdapterFormat(tool) {
+  const metadata = tool.metadata;
+  return {
+    name: "web_fetch",
+    type: "web_fetch_20250910",
+    ...metadata
+  };
+}
+function webFetchTool(config) {
+  return brandProviderTool({
+    name: "web_fetch",
+    description: "",
+    metadata: config
+  });
+}
+export {
+  convertWebFetchToolToAdapterFormat,
+  webFetchTool
+};
+//# sourceMappingURL=web-fetch-tool.js.map

package/dist/esm/tools/web-fetch-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch-tool.js","sources":["../../../src/tools/web-fetch-tool.ts"],"sourcesContent":["import { brandProviderTool } from '@tanstack/ai'\nimport type { BetaWebFetchTool20250910 } from '@anthropic-ai/sdk/resources/beta'\nimport type { ProviderTool, Tool } from '@tanstack/ai'\n\nexport type WebFetchToolConfig = BetaWebFetchTool20250910\n\n/** @deprecated Renamed to `WebFetchToolConfig`. Will be removed in a future release. */\nexport type WebFetchTool = WebFetchToolConfig\n\nexport type AnthropicWebFetchTool = ProviderTool<'anthropic', 'web_fetch'>\n\nexport function convertWebFetchToolToAdapterFormat(\n  tool: Tool,\n): WebFetchToolConfig {\n  const metadata = tool.metadata as Omit<WebFetchToolConfig, 'type' | 'name'>\n  return {\n    name: 'web_fetch',\n    type: 'web_fetch_20250910',\n    ...metadata,\n  }\n}\n\nexport function webFetchTool(\n  config?: Omit<WebFetchToolConfig, 'type' | 'name'>,\n): AnthropicWebFetchTool {\n  return brandProviderTool<AnthropicWebFetchTool>({\n    name: 'web_fetch',\n    description: '',\n    metadata: config,\n  })\n}\n"],"names":[],"mappings":";AAWO,SAAS,mCACd,MACoB;AACpB,QAAM,WAAW,KAAK;AACtB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAEO,SAAS,aACd,QACuB;AACvB,SAAO,kBAAyC;AAAA,IAC9C,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EAAA,CACX;AACH;"}

package/dist/esm/tools/web-search-tool.d.ts

@@ -0,0 +1,8 @@
+import { WebSearchTool20250305 } from '@anthropic-ai/sdk/resources/messages';
+import { ProviderTool, Tool } from '@tanstack/ai';
+export type WebSearchToolConfig = WebSearchTool20250305;
+/** @deprecated Renamed to `WebSearchToolConfig`. Will be removed in a future release. */
+export type WebSearchTool = WebSearchToolConfig;
+export type AnthropicWebSearchTool = ProviderTool<'anthropic', 'web_search'>;
+export declare function convertWebSearchToolToAdapterFormat(tool: Tool): WebSearchToolConfig;
+export declare function webSearchTool(config: WebSearchToolConfig): AnthropicWebSearchTool;

package/dist/esm/tools/web-search-tool.js

@@ -0,0 +1,63 @@
+import { brandProviderTool } from "@tanstack/ai";
+const validateDomains = (tool) => {
+  if (tool.allowed_domains && tool.blocked_domains) {
+    throw new Error(
+      "allowed_domains and blocked_domains cannot be used together."
+    );
+  }
+};
+const validateUserLocation = (tool) => {
+  const userLocation = tool.user_location;
+  if (userLocation) {
+    if (userLocation.city && (userLocation.city.length < 1 || userLocation.city.length > 255)) {
+      throw new Error(
+        "user_location.city must be between 1 and 255 characters."
+      );
+    }
+    if (userLocation.country && userLocation.country.length !== 2) {
+      throw new Error("user_location.country must be exactly 2 characters.");
+    }
+    if (userLocation.region && (userLocation.region.length < 1 || userLocation.region.length > 255)) {
+      throw new Error(
+        "user_location.region must be between 1 and 255 characters."
+      );
+    }
+    if (userLocation.timezone && (userLocation.timezone.length < 1 || userLocation.timezone.length > 255)) {
+      throw new Error(
+        "user_location.timezone must be between 1 and 255 characters."
+      );
+    }
+  }
+};
+function convertWebSearchToolToAdapterFormat(tool) {
+  const metadata = tool.metadata;
+  return {
+    name: "web_search",
+    type: "web_search_20250305",
+    ...metadata.allowedDomains !== void 0 && {
+      allowed_domains: metadata.allowedDomains
+    },
+    ...metadata.blockedDomains !== void 0 && {
+      blocked_domains: metadata.blockedDomains
+    },
+    ...metadata.maxUses !== void 0 && { max_uses: metadata.maxUses },
+    ...metadata.userLocation !== void 0 && {
+      user_location: metadata.userLocation
+    },
+    cache_control: metadata.cacheControl || null
+  };
+}
+function webSearchTool(config) {
+  validateDomains(config);
+  validateUserLocation(config);
+  return brandProviderTool({
+    name: "web_search",
+    description: "",
+    metadata: config
+  });
+}
+export {
+  convertWebSearchToolToAdapterFormat,
+  webSearchTool
+};
+//# sourceMappingURL=web-search-tool.js.map

package/dist/esm/tools/web-search-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-tool.js","sources":["../../../src/tools/web-search-tool.ts"],"sourcesContent":["import { brandProviderTool } from '@tanstack/ai'\nimport type { WebSearchTool20250305 } from '@anthropic-ai/sdk/resources/messages'\nimport type { CacheControl } from '../text/text-provider-options'\nimport type { ProviderTool, Tool } from '@tanstack/ai'\n\nexport type WebSearchToolConfig = WebSearchTool20250305\n\n/** @deprecated Renamed to `WebSearchToolConfig`. Will be removed in a future release. */\nexport type WebSearchTool = WebSearchToolConfig\n\nexport type AnthropicWebSearchTool = ProviderTool<'anthropic', 'web_search'>\n\nconst validateDomains = (tool: WebSearchToolConfig) => {\n  if (tool.allowed_domains && tool.blocked_domains) {\n    throw new Error(\n      'allowed_domains and blocked_domains cannot be used together.',\n    )\n  }\n}\n\nconst validateUserLocation = (tool: WebSearchToolConfig) => {\n  const userLocation = tool.user_location\n  if (userLocation) {\n    if (\n      userLocation.city &&\n      (userLocation.city.length < 1 || userLocation.city.length > 255)\n    ) {\n      throw new Error(\n        'user_location.city must be between 1 and 255 characters.',\n      )\n    }\n    if (userLocation.country && userLocation.country.length !== 2) {\n      throw new Error('user_location.country must be exactly 2 characters.')\n    }\n    if (\n      userLocation.region &&\n      (userLocation.region.length < 1 || userLocation.region.length > 255)\n    ) {\n      throw new Error(\n        'user_location.region must be between 1 and 255 characters.',\n      )\n    }\n    if (\n      userLocation.timezone &&\n      (userLocation.timezone.length < 1 || userLocation.timezone.length > 255)\n    ) {\n      throw new Error(\n        'user_location.timezone must be between 1 and 255 characters.',\n      )\n    }\n  }\n}\n\nexport function convertWebSearchToolToAdapterFormat(\n  tool: Tool,\n): WebSearchToolConfig {\n  const metadata = tool.metadata as {\n    allowedDomains?: Array<string> | null\n    blockedDomains?: Array<string> | null\n    maxUses?: number | null\n    userLocation?: {\n      type: 'approximate'\n      city?: string | null\n      country?: string | null\n      region?: string | null\n      timezone?: string | null\n    } | null\n    cacheControl?: CacheControl | null\n  }\n  // Vendor `WebSearchTool20250305` declares these fields as `T | null`\n  // (no `| undefined`) under exactOptionalPropertyTypes, so spread them\n  // conditionally rather than passing explicit `undefined`.\n  return {\n    name: 'web_search',\n    type: 'web_search_20250305',\n    ...(metadata.allowedDomains !== undefined && {\n      allowed_domains: metadata.allowedDomains,\n    }),\n    ...(metadata.blockedDomains !== undefined && {\n      blocked_domains: metadata.blockedDomains,\n    }),\n    ...(metadata.maxUses !== undefined && { max_uses: metadata.maxUses }),\n    ...(metadata.userLocation !== undefined && {\n      user_location: metadata.userLocation,\n    }),\n    cache_control: metadata.cacheControl || null,\n  }\n}\n\nexport function webSearchTool(\n  config: WebSearchToolConfig,\n): AnthropicWebSearchTool {\n  validateDomains(config)\n  validateUserLocation(config)\n  return brandProviderTool<AnthropicWebSearchTool>({\n    name: 'web_search',\n    description: '',\n    metadata: config,\n  })\n}\n"],"names":[],"mappings":";AAYA,MAAM,kBAAkB,CAAC,SAA8B;AACrD,MAAI,KAAK,mBAAmB,KAAK,iBAAiB;AAChD,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;AAEA,MAAM,uBAAuB,CAAC,SAA8B;AAC1D,QAAM,eAAe,KAAK;AAC1B,MAAI,cAAc;AAChB,QACE,aAAa,SACZ,aAAa,KAAK,SAAS,KAAK,aAAa,KAAK,SAAS,MAC5D;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AACA,QAAI,aAAa,WAAW,aAAa,QAAQ,WAAW,GAAG;AAC7D,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AACA,QACE,aAAa,WACZ,aAAa,OAAO,SAAS,KAAK,aAAa,OAAO,SAAS,MAChE;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AACA,QACE,aAAa,aACZ,aAAa,SAAS,SAAS,KAAK,aAAa,SAAS,SAAS,MACpE;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AACF;AAEO,SAAS,oCACd,MACqB;AACrB,QAAM,WAAW,KAAK;AAgBtB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,GAAI,SAAS,mBAAmB,UAAa;AAAA,MAC3C,iBAAiB,SAAS;AAAA,IAAA;AAAA,IAE5B,GAAI,SAAS,mBAAmB,UAAa;AAAA,MAC3C,iBAAiB,SAAS;AAAA,IAAA;AAAA,IAE5B,GAAI,SAAS,YAAY,UAAa,EAAE,UAAU,SAAS,QAAA;AAAA,IAC3D,GAAI,SAAS,iBAAiB,UAAa;AAAA,MACzC,eAAe,SAAS;AAAA,IAAA;AAAA,IAE1B,eAAe,SAAS,gBAAgB;AAAA,EAAA;AAE5C;AAEO,SAAS,cACd,QACwB;AACxB,kBAAgB,MAAM;AACtB,uBAAqB,MAAM;AAC3B,SAAO,kBAA0C;AAAA,IAC/C,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EAAA,CACX;AACH;"}

package/dist/esm/usage.d.ts

@@ -0,0 +1,25 @@
+import { TokenUsage } from '@tanstack/ai';
+import { default as Anthropic_SDK } from '@anthropic-ai/sdk';
+/**
+ * Anthropic-specific provider usage details.
+ * These fields are unique to Anthropic and placed in providerUsageDetails.
+ */
+export type AnthropicProviderUsageDetails = {
+    /**
+     * Server-side tool usage metrics.
+     * Available when using Anthropic's built-in tools like web search.
+     */
+    serverToolUse?: {
+        /** Number of web search requests made during the response */
+        webSearchRequests?: number;
+        /** Number of web fetch requests made during the response */
+        webFetchRequests?: number;
+    };
+};
+/**
+ * Build normalized TokenUsage from Anthropic's usage object.
+ * Handles cache tokens and server tool use metrics. Returns `undefined` when
+ * the provider reported no usage object, so callers omit the field rather than
+ * fabricating zeroed totals.
+ */
+export declare function buildAnthropicUsage(usage: Anthropic_SDK.Beta.BetaUsage | Anthropic_SDK.Beta.BetaMessageDeltaUsage | undefined | null): TokenUsage<AnthropicProviderUsageDetails> | undefined;

package/dist/esm/usage.js

@@ -0,0 +1,35 @@
+import { buildBaseUsage } from "@tanstack/ai";
+function buildAnthropicUsage(usage) {
+  if (!usage) return void 0;
+  const inputTokens = usage.input_tokens ?? 0;
+  const outputTokens = usage.output_tokens || 0;
+  const result = buildBaseUsage({
+    promptTokens: inputTokens,
+    completionTokens: outputTokens,
+    totalTokens: inputTokens + outputTokens
+  });
+  const cacheCreation = usage.cache_creation_input_tokens;
+  const cacheRead = usage.cache_read_input_tokens;
+  const promptTokensDetails = {
+    ...cacheCreation ? { cacheWriteTokens: cacheCreation } : {},
+    ...cacheRead ? { cachedTokens: cacheRead } : {}
+  };
+  if (Object.keys(promptTokensDetails).length > 0) {
+    result.promptTokensDetails = promptTokensDetails;
+  }
+  const serverToolUse = usage.server_tool_use;
+  const serverToolUseDetails = {
+    ...serverToolUse?.web_search_requests ? { webSearchRequests: serverToolUse.web_search_requests } : {},
+    ...serverToolUse?.web_fetch_requests ? { webFetchRequests: serverToolUse.web_fetch_requests } : {}
+  };
+  if (Object.keys(serverToolUseDetails).length > 0) {
+    result.providerUsageDetails = {
+      serverToolUse: serverToolUseDetails
+    };
+  }
+  return result;
+}
+export {
+  buildAnthropicUsage
+};
+//# sourceMappingURL=usage.js.map

package/dist/esm/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sources":["../../src/usage.ts"],"sourcesContent":["import { buildBaseUsage } from '@tanstack/ai'\nimport type { TokenUsage } from '@tanstack/ai'\nimport type Anthropic_SDK from '@anthropic-ai/sdk'\n\n/**\n * Anthropic-specific provider usage details.\n * These fields are unique to Anthropic and placed in providerUsageDetails.\n */\nexport type AnthropicProviderUsageDetails = {\n  /**\n   * Server-side tool usage metrics.\n   * Available when using Anthropic's built-in tools like web search.\n   */\n  serverToolUse?: {\n    /** Number of web search requests made during the response */\n    webSearchRequests?: number\n    /** Number of web fetch requests made during the response */\n    webFetchRequests?: number\n  }\n}\n\n/**\n * Build normalized TokenUsage from Anthropic's usage object.\n * Handles cache tokens and server tool use metrics. Returns `undefined` when\n * the provider reported no usage object, so callers omit the field rather than\n * fabricating zeroed totals.\n */\nexport function buildAnthropicUsage(\n  usage:\n    | Anthropic_SDK.Beta.BetaUsage\n    | Anthropic_SDK.Beta.BetaMessageDeltaUsage\n    | undefined\n    | null,\n): TokenUsage<AnthropicProviderUsageDetails> | undefined {\n  if (!usage) return undefined\n\n  const inputTokens = usage.input_tokens ?? 0\n  // `|| 0` (rather than `?? 0`) matches the sibling builders and stays defensive\n  // against a runtime-absent count without tripping no-unnecessary-condition\n  // (the SDK types output_tokens as a required number).\n  const outputTokens = usage.output_tokens || 0\n\n  const result = buildBaseUsage<AnthropicProviderUsageDetails>({\n    promptTokens: inputTokens,\n    completionTokens: outputTokens,\n    totalTokens: inputTokens + outputTokens,\n  })\n\n  // Add prompt token details for cache tokens. Only attach the details object\n  // when at least one field is present so we don't emit an empty `{}` (every\n  // other adapter guards with the same Object.keys check).\n  const cacheCreation = usage.cache_creation_input_tokens\n  const cacheRead = usage.cache_read_input_tokens\n\n  const promptTokensDetails = {\n    ...(cacheCreation ? { cacheWriteTokens: cacheCreation } : {}),\n    ...(cacheRead ? { cachedTokens: cacheRead } : {}),\n  }\n  if (Object.keys(promptTokensDetails).length > 0) {\n    result.promptTokensDetails = promptTokensDetails\n  }\n\n  // Add provider-specific usage details for server tool use, again only when\n  // the provider actually reported any server tool requests.\n  const serverToolUse = usage.server_tool_use\n  const serverToolUseDetails = {\n    ...(serverToolUse?.web_search_requests\n      ? { webSearchRequests: serverToolUse.web_search_requests }\n      : {}),\n    ...(serverToolUse?.web_fetch_requests\n      ? { webFetchRequests: serverToolUse.web_fetch_requests }\n      : {}),\n  }\n  if (Object.keys(serverToolUseDetails).length > 0) {\n    result.providerUsageDetails = {\n      serverToolUse: serverToolUseDetails,\n    } satisfies AnthropicProviderUsageDetails\n  }\n\n  return result\n}\n"],"names":[],"mappings":";AA2BO,SAAS,oBACd,OAKuD;AACvD,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,cAAc,MAAM,gBAAgB;AAI1C,QAAM,eAAe,MAAM,iBAAiB;AAE5C,QAAM,SAAS,eAA8C;AAAA,IAC3D,cAAc;AAAA,IACd,kBAAkB;AAAA,IAClB,aAAa,cAAc;AAAA,EAAA,CAC5B;AAKD,QAAM,gBAAgB,MAAM;AAC5B,QAAM,YAAY,MAAM;AAExB,QAAM,sBAAsB;AAAA,IAC1B,GAAI,gBAAgB,EAAE,kBAAkB,cAAA,IAAkB,CAAA;AAAA,IAC1D,GAAI,YAAY,EAAE,cAAc,cAAc,CAAA;AAAA,EAAC;AAEjD,MAAI,OAAO,KAAK,mBAAmB,EAAE,SAAS,GAAG;AAC/C,WAAO,sBAAsB;AAAA,EAC/B;AAIA,QAAM,gBAAgB,MAAM;AAC5B,QAAM,uBAAuB;AAAA,IAC3B,GAAI,eAAe,sBACf,EAAE,mBAAmB,cAAc,oBAAA,IACnC,CAAA;AAAA,IACJ,GAAI,eAAe,qBACf,EAAE,kBAAkB,cAAc,mBAAA,IAClC,CAAA;AAAA,EAAC;AAEP,MAAI,OAAO,KAAK,oBAAoB,EAAE,SAAS,GAAG;AAChD,WAAO,uBAAuB;AAAA,MAC5B,eAAe;AAAA,IAAA;AAAA,EAEnB;AAEA,SAAO;AACT;"}

package/dist/esm/utils/client.d.ts

@@ -0,0 +1,17 @@
+import { default as Anthropic_SDK, ClientOptions } from '@anthropic-ai/sdk';
+export interface AnthropicClientConfig extends ClientOptions {
+    apiKey: string;
+}
+/**
+ * Creates an Anthropic SDK client instance
+ */
+export declare function createAnthropicClient(config: AnthropicClientConfig): Anthropic_SDK;
+/**
+ * Gets Anthropic API key from environment variables
+ * @throws Error if ANTHROPIC_API_KEY is not found
+ */
+export declare function getAnthropicApiKeyFromEnv(): string;
+/**
+ * Generates a unique ID with a prefix
+ */
+export declare function generateId(prefix: string): string;

package/dist/esm/utils/client.js

@@ -0,0 +1,20 @@
+import Anthropic_SDK from "@anthropic-ai/sdk";
+import { generateId as generateId$1, getApiKeyFromEnv } from "@tanstack/ai-utils";
+function createAnthropicClient(config) {
+  return new Anthropic_SDK({
+    ...config,
+    apiKey: config.apiKey
+  });
+}
+function getAnthropicApiKeyFromEnv() {
+  return getApiKeyFromEnv("ANTHROPIC_API_KEY");
+}
+function generateId(prefix) {
+  return generateId$1(prefix);
+}
+export {
+  createAnthropicClient,
+  generateId,
+  getAnthropicApiKeyFromEnv
+};
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import Anthropic_SDK from '@anthropic-ai/sdk'\nimport { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { ClientOptions } from '@anthropic-ai/sdk'\n\nexport interface AnthropicClientConfig extends ClientOptions {\n  apiKey: string\n}\n\n/**\n * Creates an Anthropic SDK client instance\n */\nexport function createAnthropicClient(\n  config: AnthropicClientConfig,\n): Anthropic_SDK {\n  return new Anthropic_SDK({\n    ...config,\n    apiKey: config.apiKey,\n  })\n}\n\n/**\n * Gets Anthropic API key from environment variables\n * @throws Error if ANTHROPIC_API_KEY is not found\n */\nexport function getAnthropicApiKeyFromEnv(): string {\n  return getApiKeyFromEnv('ANTHROPIC_API_KEY')\n}\n\n/**\n * Generates a unique ID with a prefix\n */\nexport function generateId(prefix: string): string {\n  return _generateId(prefix)\n}\n"],"names":["_generateId"],"mappings":";;AAWO,SAAS,sBACd,QACe;AACf,SAAO,IAAI,cAAc;AAAA,IACvB,GAAG;AAAA,IACH,QAAQ,OAAO;AAAA,EAAA,CAChB;AACH;AAMO,SAAS,4BAAoC;AAClD,SAAO,iBAAiB,mBAAmB;AAC7C;AAKO,SAAS,WAAW,QAAwB;AACjD,SAAOA,aAAY,MAAM;AAC3B;"}

package/dist/esm/utils/index.d.ts

@@ -0,0 +1 @@
+export { createAnthropicClient, generateId, getAnthropicApiKeyFromEnv, type AnthropicClientConfig, } from './client.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-anthropic",
-  "version": "0.15.9",
+  "version": "0.15.11",
   "description": "Anthropic Claude adapter for TanStack AI chat, tool calling, thinking, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -49,16 +49,16 @@
   ],
   "dependencies": {
     "@anthropic-ai/sdk": "^0.97.1",
-    "@tanstack/ai-utils": "0.3.0"
+    "@tanstack/ai-utils": "0.3.1"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.36.0"
+    "@tanstack/ai": "^0.38.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.36.0"
+    "@tanstack/ai": "0.38.0"
   },
   "scripts": {
     "build": "vite build",