@tanstack/ai-anthropic 0.7.5 → 0.8.0

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

@@ -1,6 +1,6 @@
 import { SchemaInput, Tool } from '@tanstack/ai';
 import { CacheControl } from '../text/text-provider-options.js';
-export interface CustomTool {
+export interface CustomToolConfig {
     /**
      * The name of the tool.
      */
@@ -20,5 +20,7 @@ export interface CustomTool {
     };
     cache_control?: CacheControl | null;
 }
-export declare function convertCustomToolToAdapterFormat(tool: Tool): CustomTool;
+/** @deprecated Renamed to `CustomToolConfig`. Will be removed in a future release. */
+export type CustomTool = CustomToolConfig;
+export declare function convertCustomToolToAdapterFormat(tool: Tool): CustomToolConfig;
 export declare function customTool(name: string, description: string, inputSchema: SchemaInput, cacheControl?: CacheControl | null): Tool;

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

@@ -17,7 +17,18 @@ function convertCustomToolToAdapterFormat(tool) {
     cache_control: metadata.cacheControl || null
   };
 }
+function customTool(name, description, inputSchema, cacheControl) {
+  return {
+    name,
+    description,
+    inputSchema,
+    metadata: {
+      cacheControl
+    }
+  };
+}
 export {
-  convertCustomToolToAdapterFormat
+  convertCustomToolToAdapterFormat,
+  customTool
 };
 //# sourceMappingURL=custom-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"custom-tool.js","sources":["../../../src/tools/custom-tool.ts"],"sourcesContent":["import type { JSONSchema, SchemaInput, Tool } from '@tanstack/ai'\nimport type { CacheControl } from '../text/text-provider-options'\n\nexport interface CustomTool {\n  /**\n   * The name of the tool.\n   */\n  name: string\n  type: 'custom'\n  /**\n   * A brief description of what the tool does. Tool descriptions should be as detailed as possible. The more information that the model has about what the tool is and how to use it, the better it will perform. You can use natural language descriptions to reinforce important aspects of the tool input JSON schema.\n   */\n  description: string\n  /**\n   * This defines the shape of the input that your tool accepts and that the model will produce.\n   */\n  input_schema: {\n    type: 'object'\n    properties: Record<string, any> | null\n    required?: Array<string> | null\n  }\n\n  cache_control?: CacheControl | null\n}\n\nexport function convertCustomToolToAdapterFormat(tool: Tool): CustomTool {\n  const metadata =\n    (tool.metadata as { cacheControl?: CacheControl | null } | undefined) || {}\n\n  // Tool schemas are already converted to JSON Schema in the ai layer\n  const jsonSchema = (tool.inputSchema ?? {\n    type: 'object',\n    properties: {},\n    required: [],\n  }) as JSONSchema\n\n  const inputSchema = {\n    type: 'object' as const,\n    properties: jsonSchema.properties || null,\n    required: jsonSchema.required || null,\n  }\n\n  return {\n    name: tool.name,\n    type: 'custom',\n    description: tool.description,\n    input_schema: inputSchema,\n    cache_control: metadata.cacheControl || null,\n  }\n}\n\nexport function customTool(\n  name: string,\n  description: string,\n  inputSchema: SchemaInput,\n  cacheControl?: CacheControl | null,\n): Tool {\n  return {\n    name,\n    description,\n    inputSchema,\n    metadata: {\n      cacheControl,\n    },\n  }\n}\n"],"names":[],"mappings":"AAyBO,SAAS,iCAAiC,MAAwB;AACvE,QAAM,WACH,KAAK,YAAmE,CAAA;AAG3E,QAAM,aAAc,KAAK,eAAe;AAAA,IAEtC,YAAY,CAAA;AAAA,IACZ,UAAU,CAAA;AAAA,EAAC;AAGb,QAAM,cAAc;AAAA,IAClB,MAAM;AAAA,IACN,YAAY,WAAW,cAAc;AAAA,IACrC,UAAU,WAAW,YAAY;AAAA,EAAA;AAGnC,SAAO;AAAA,IACL,MAAM,KAAK;AAAA,IACX,MAAM;AAAA,IACN,aAAa,KAAK;AAAA,IAClB,cAAc;AAAA,IACd,eAAe,SAAS,gBAAgB;AAAA,EAAA;AAE5C;"}
+{"version":3,"file":"custom-tool.js","sources":["../../../src/tools/custom-tool.ts"],"sourcesContent":["import type { JSONSchema, SchemaInput, Tool } from '@tanstack/ai'\nimport type { CacheControl } from '../text/text-provider-options'\n\nexport interface CustomToolConfig {\n  /**\n   * The name of the tool.\n   */\n  name: string\n  type: 'custom'\n  /**\n   * A brief description of what the tool does. Tool descriptions should be as detailed as possible. The more information that the model has about what the tool is and how to use it, the better it will perform. You can use natural language descriptions to reinforce important aspects of the tool input JSON schema.\n   */\n  description: string\n  /**\n   * This defines the shape of the input that your tool accepts and that the model will produce.\n   */\n  input_schema: {\n    type: 'object'\n    properties: Record<string, any> | null\n    required?: Array<string> | null\n  }\n\n  cache_control?: CacheControl | null\n}\n\n/** @deprecated Renamed to `CustomToolConfig`. Will be removed in a future release. */\nexport type CustomTool = CustomToolConfig\n\nexport function convertCustomToolToAdapterFormat(tool: Tool): CustomToolConfig {\n  const metadata =\n    (tool.metadata as { cacheControl?: CacheControl | null } | undefined) || {}\n\n  const jsonSchema = (tool.inputSchema ?? {\n    type: 'object',\n    properties: {},\n    required: [],\n  }) as JSONSchema\n\n  const inputSchema = {\n    type: 'object' as const,\n    properties: jsonSchema.properties || null,\n    required: jsonSchema.required || null,\n  }\n\n  return {\n    name: tool.name,\n    type: 'custom',\n    description: tool.description,\n    input_schema: inputSchema,\n    cache_control: metadata.cacheControl || null,\n  }\n}\n\nexport function customTool(\n  name: string,\n  description: string,\n  inputSchema: SchemaInput,\n  cacheControl?: CacheControl | null,\n): Tool {\n  return {\n    name,\n    description,\n    inputSchema,\n    metadata: {\n      cacheControl,\n    },\n  }\n}\n"],"names":[],"mappings":"AA4BO,SAAS,iCAAiC,MAA8B;AAC7E,QAAM,WACH,KAAK,YAAmE,CAAA;AAE3E,QAAM,aAAc,KAAK,eAAe;AAAA,IAEtC,YAAY,CAAA;AAAA,IACZ,UAAU,CAAA;AAAA,EAAC;AAGb,QAAM,cAAc;AAAA,IAClB,MAAM;AAAA,IACN,YAAY,WAAW,cAAc;AAAA,IACrC,UAAU,WAAW,YAAY;AAAA,EAAA;AAGnC,SAAO;AAAA,IACL,MAAM,KAAK;AAAA,IACX,MAAM;AAAA,IACN,aAAa,KAAK;AAAA,IAClB,cAAc;AAAA,IACd,eAAe,SAAS,gBAAgB;AAAA,EAAA;AAE5C;AAEO,SAAS,WACd,MACA,aACA,aACA,cACM;AACN,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,MACR;AAAA,IAAA;AAAA,EACF;AAEJ;"}

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

@@ -6,5 +6,12 @@ import { MemoryTool } from './memory-tool.js';
 import { TextEditorTool } from './text-editor-tool.js';
 import { WebFetchTool } from './web-fetch-tool.js';
 import { WebSearchTool } from './web-search-tool.js';
+export { bashTool, type AnthropicBashTool, type BashToolConfig, type BashTool, } from './bash-tool.js';
+export { codeExecutionTool, type AnthropicCodeExecutionTool, type CodeExecutionToolConfig, type CodeExecutionTool, } from './code-execution-tool.js';
+export { computerUseTool, type AnthropicComputerUseTool, type ComputerUseToolConfig, type ComputerUseTool, } from './computer-use-tool.js';
+export { customTool, type CustomToolConfig, type CustomTool, } from './custom-tool.js';
+export { memoryTool, type AnthropicMemoryTool, type MemoryToolConfig, type MemoryTool, } from './memory-tool.js';
+export { textEditorTool, type AnthropicTextEditorTool, type TextEditorToolConfig, type TextEditorTool, } from './text-editor-tool.js';
+export { webFetchTool, type AnthropicWebFetchTool, type WebFetchToolConfig, type WebFetchTool, } from './web-fetch-tool.js';
+export { webSearchTool, type AnthropicWebSearchTool, type WebSearchToolConfig, type WebSearchTool, } from './web-search-tool.js';
 export type AnthropicTool = BashTool | CodeExecutionTool | ComputerUseTool | CustomTool | MemoryTool | TextEditorTool | WebFetchTool | WebSearchTool;
-export type { CustomTool, };

package/dist/esm/tools/index.js

@@ -0,0 +1,19 @@
+import { bashTool } from "./bash-tool.js";
+import { codeExecutionTool } from "./code-execution-tool.js";
+import { computerUseTool } from "./computer-use-tool.js";
+import { customTool } from "./custom-tool.js";
+import { memoryTool } from "./memory-tool.js";
+import { textEditorTool } from "./text-editor-tool.js";
+import { webFetchTool } from "./web-fetch-tool.js";
+import { webSearchTool } from "./web-search-tool.js";
+export {
+  bashTool,
+  codeExecutionTool,
+  computerUseTool,
+  customTool,
+  memoryTool,
+  textEditorTool,
+  webFetchTool,
+  webSearchTool
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

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

@@ -1,5 +1,8 @@
 import { BetaMemoryTool20250818 } from '@anthropic-ai/sdk/resources/beta';
-import { Tool } from '@tanstack/ai';
-export type MemoryTool = BetaMemoryTool20250818;
-export declare function convertMemoryToolToAdapterFormat(tool: Tool): MemoryTool;
-export declare function memoryTool(config?: MemoryTool): Tool;
+import { ProviderTool, Tool } from '@tanstack/ai';
+export type MemoryToolConfig = BetaMemoryTool20250818;
+/** @deprecated Renamed to `MemoryToolConfig`. Will be removed in a future release. */
+export type MemoryTool = MemoryToolConfig;
+export type AnthropicMemoryTool = ProviderTool<'anthropic', 'memory'>;
+export declare function convertMemoryToolToAdapterFormat(tool: Tool): MemoryToolConfig;
+export declare function memoryTool(config?: MemoryToolConfig): AnthropicMemoryTool;

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

@@ -5,7 +5,15 @@ function convertMemoryToolToAdapterFormat(tool) {
     ...metadata
   };
 }
+function memoryTool(config) {
+  return {
+    name: "memory",
+    description: "",
+    metadata: config
+  };
+}
 export {
-  convertMemoryToolToAdapterFormat
+  convertMemoryToolToAdapterFormat,
+  memoryTool
 };
 //# sourceMappingURL=memory-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"memory-tool.js","sources":["../../../src/tools/memory-tool.ts"],"sourcesContent":["import type { BetaMemoryTool20250818 } from '@anthropic-ai/sdk/resources/beta'\nimport type { Tool } from '@tanstack/ai'\n\nexport type MemoryTool = BetaMemoryTool20250818\n\nexport function convertMemoryToolToAdapterFormat(tool: Tool): MemoryTool {\n  const metadata = tool.metadata as Omit<MemoryTool, 'type'>\n  return {\n    type: 'memory_20250818',\n    ...metadata,\n  }\n}\n\nexport function memoryTool(config?: MemoryTool): Tool {\n  return {\n    name: 'memory',\n    description: '',\n    metadata: config,\n  }\n}\n"],"names":[],"mappings":"AAKO,SAAS,iCAAiC,MAAwB;AACvE,QAAM,WAAW,KAAK;AACtB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;"}
+{"version":3,"file":"memory-tool.js","sources":["../../../src/tools/memory-tool.ts"],"sourcesContent":["import type { BetaMemoryTool20250818 } from '@anthropic-ai/sdk/resources/beta'\nimport type { ProviderTool, Tool } from '@tanstack/ai'\n\nexport type MemoryToolConfig = BetaMemoryTool20250818\n\n/** @deprecated Renamed to `MemoryToolConfig`. Will be removed in a future release. */\nexport type MemoryTool = MemoryToolConfig\n\nexport type AnthropicMemoryTool = ProviderTool<'anthropic', 'memory'>\n\nexport function convertMemoryToolToAdapterFormat(tool: Tool): MemoryToolConfig {\n  const metadata = tool.metadata as Omit<MemoryToolConfig, 'type'>\n  return {\n    type: 'memory_20250818',\n    ...metadata,\n  }\n}\n\nexport function memoryTool(config?: MemoryToolConfig): AnthropicMemoryTool {\n  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.\n  return {\n    name: 'memory',\n    description: '',\n    metadata: config,\n  } as unknown as AnthropicMemoryTool\n}\n"],"names":[],"mappings":"AAUO,SAAS,iCAAiC,MAA8B;AAC7E,QAAM,WAAW,KAAK;AACtB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAEO,SAAS,WAAW,QAAgD;AAEzE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EAAA;AAEd;"}

package/dist/esm/tools/text-editor-tool.d.ts

@@ -1,5 +1,8 @@
 import { ToolTextEditor20250124, ToolTextEditor20250429, ToolTextEditor20250728 } from '@anthropic-ai/sdk/resources/messages';
-import { Tool } from '@tanstack/ai';
-export type TextEditorTool = ToolTextEditor20250124 | ToolTextEditor20250429 | ToolTextEditor20250728;
-export declare function convertTextEditorToolToAdapterFormat(tool: Tool): TextEditorTool;
-export declare function textEditorTool<T extends TextEditorTool>(config: T): Tool;
+import { ProviderTool, Tool } from '@tanstack/ai';
+export type TextEditorToolConfig = ToolTextEditor20250124 | ToolTextEditor20250429 | ToolTextEditor20250728;
+/** @deprecated Renamed to `TextEditorToolConfig`. Will be removed in a future release. */
+export type TextEditorTool = TextEditorToolConfig;
+export type AnthropicTextEditorTool = ProviderTool<'anthropic', 'text_editor'>;
+export declare function convertTextEditorToolToAdapterFormat(tool: Tool): TextEditorToolConfig;
+export declare function textEditorTool<T extends TextEditorToolConfig>(config: T): AnthropicTextEditorTool;

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

@@ -4,7 +4,15 @@ function convertTextEditorToolToAdapterFormat(tool) {
     ...metadata
   };
 }
+function textEditorTool(config) {
+  return {
+    name: "str_replace_editor",
+    description: "",
+    metadata: config
+  };
+}
 export {
-  convertTextEditorToolToAdapterFormat
+  convertTextEditorToolToAdapterFormat,
+  textEditorTool
 };
 //# sourceMappingURL=text-editor-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"text-editor-tool.js","sources":["../../../src/tools/text-editor-tool.ts"],"sourcesContent":["import type {\n  ToolTextEditor20250124,\n  ToolTextEditor20250429,\n  ToolTextEditor20250728,\n} from '@anthropic-ai/sdk/resources/messages'\nimport type { Tool } from '@tanstack/ai'\n\nexport type TextEditorTool =\n  | ToolTextEditor20250124\n  | ToolTextEditor20250429\n  | ToolTextEditor20250728\n\nexport function convertTextEditorToolToAdapterFormat(\n  tool: Tool,\n): TextEditorTool {\n  const metadata = tool.metadata as TextEditorTool\n  return {\n    ...metadata,\n  }\n}\n\nexport function textEditorTool<T extends TextEditorTool>(config: T): Tool {\n  return {\n    name: 'str_replace_editor',\n    description: '',\n    metadata: config,\n  }\n}\n"],"names":[],"mappings":"AAYO,SAAS,qCACd,MACgB;AAChB,QAAM,WAAW,KAAK;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,EAAA;AAEP;"}
+{"version":3,"file":"text-editor-tool.js","sources":["../../../src/tools/text-editor-tool.ts"],"sourcesContent":["import 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  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.\n  return {\n    name: 'str_replace_editor',\n    description: '',\n    metadata: config,\n  } as unknown as AnthropicTextEditorTool\n}\n"],"names":[],"mappings":"AAiBO,SAAS,qCACd,MACsB;AACtB,QAAM,WAAW,KAAK;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,EAAA;AAEP;AAEO,SAAS,eACd,QACyB;AAEzB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EAAA;AAEd;"}

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

@@ -1,5 +1,8 @@
 import { BetaWebFetchTool20250910 } from '@anthropic-ai/sdk/resources/beta';
-import { Tool } from '@tanstack/ai';
-export type WebFetchTool = BetaWebFetchTool20250910;
-export declare function convertWebFetchToolToAdapterFormat(tool: Tool): WebFetchTool;
-export declare function webFetchTool(config?: Omit<WebFetchTool, 'type' | 'name'>): Tool;
+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

@@ -6,7 +6,15 @@ function convertWebFetchToolToAdapterFormat(tool) {
     ...metadata
   };
 }
+function webFetchTool(config) {
+  return {
+    name: "web_fetch",
+    description: "",
+    metadata: config
+  };
+}
 export {
-  convertWebFetchToolToAdapterFormat
+  convertWebFetchToolToAdapterFormat,
+  webFetchTool
 };
 //# sourceMappingURL=web-fetch-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"web-fetch-tool.js","sources":["../../../src/tools/web-fetch-tool.ts"],"sourcesContent":["import type { BetaWebFetchTool20250910 } from '@anthropic-ai/sdk/resources/beta'\nimport type { Tool } from '@tanstack/ai'\n\nexport type WebFetchTool = BetaWebFetchTool20250910\n\nexport function convertWebFetchToolToAdapterFormat(tool: Tool): WebFetchTool {\n  const metadata = tool.metadata as Omit<WebFetchTool, 'type' | 'name'>\n  return {\n    name: 'web_fetch',\n    type: 'web_fetch_20250910',\n    ...metadata,\n  }\n}\n\nexport function webFetchTool(\n  config?: Omit<WebFetchTool, 'type' | 'name'>,\n): Tool {\n  return {\n    name: 'web_fetch',\n    description: '',\n    metadata: config,\n  }\n}\n"],"names":[],"mappings":"AAKO,SAAS,mCAAmC,MAA0B;AAC3E,QAAM,WAAW,KAAK;AACtB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;"}
+{"version":3,"file":"web-fetch-tool.js","sources":["../../../src/tools/web-fetch-tool.ts"],"sourcesContent":["import 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  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.\n  return {\n    name: 'web_fetch',\n    description: '',\n    metadata: config,\n  } as unknown as AnthropicWebFetchTool\n}\n"],"names":[],"mappings":"AAUO,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;AAEvB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EAAA;AAEd;"}

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

@@ -1,5 +1,8 @@
 import { WebSearchTool20250305 } from '@anthropic-ai/sdk/resources/messages';
-import { Tool } from '@tanstack/ai';
-export type WebSearchTool = WebSearchTool20250305;
-export declare function convertWebSearchToolToAdapterFormat(tool: Tool): WebSearchTool;
-export declare function webSearchTool(config: WebSearchTool): Tool;
+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

@@ -1,3 +1,33 @@
+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 {
@@ -10,7 +40,17 @@ function convertWebSearchToolToAdapterFormat(tool) {
     cache_control: metadata.cacheControl || null
   };
 }
+function webSearchTool(config) {
+  validateDomains(config);
+  validateUserLocation(config);
+  return {
+    name: "web_search",
+    description: "",
+    metadata: config
+  };
+}
 export {
-  convertWebSearchToolToAdapterFormat
+  convertWebSearchToolToAdapterFormat,
+  webSearchTool
 };
 //# sourceMappingURL=web-search-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"web-search-tool.js","sources":["../../../src/tools/web-search-tool.ts"],"sourcesContent":["import type { WebSearchTool20250305 } from '@anthropic-ai/sdk/resources/messages'\nimport type { CacheControl } from '../text/text-provider-options'\nimport type { Tool } from '@tanstack/ai'\n\nexport type WebSearchTool = WebSearchTool20250305\n\nconst validateDomains = (tool: WebSearchTool) => {\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: WebSearchTool) => {\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(tool: Tool): WebSearchTool {\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  return {\n    name: 'web_search',\n    type: 'web_search_20250305',\n    allowed_domains: metadata.allowedDomains,\n    blocked_domains: metadata.blockedDomains,\n    max_uses: metadata.maxUses,\n    user_location: metadata.userLocation,\n    cache_control: metadata.cacheControl || null,\n  }\n}\n\nexport function webSearchTool(config: WebSearchTool): Tool {\n  validateDomains(config)\n  validateUserLocation(config)\n  return {\n    name: 'web_search',\n    description: '',\n    metadata: config,\n  }\n}\n"],"names":[],"mappings":"AA+CO,SAAS,oCAAoC,MAA2B;AAC7E,QAAM,WAAW,KAAK;AAatB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,iBAAiB,SAAS;AAAA,IAC1B,iBAAiB,SAAS;AAAA,IAC1B,UAAU,SAAS;AAAA,IACnB,eAAe,SAAS;AAAA,IACxB,eAAe,SAAS,gBAAgB;AAAA,EAAA;AAE5C;"}
+{"version":3,"file":"web-search-tool.js","sources":["../../../src/tools/web-search-tool.ts"],"sourcesContent":["import 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  return {\n    name: 'web_search',\n    type: 'web_search_20250305',\n    allowed_domains: metadata.allowedDomains,\n    blocked_domains: metadata.blockedDomains,\n    max_uses: metadata.maxUses,\n    user_location: metadata.userLocation,\n    cache_control: metadata.cacheControl || null,\n  }\n}\n\nexport function webSearchTool(\n  config: WebSearchToolConfig,\n): AnthropicWebSearchTool {\n  validateDomains(config)\n  validateUserLocation(config)\n  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.\n  return {\n    name: 'web_search',\n    description: '',\n    metadata: config,\n  } as unknown as AnthropicWebSearchTool\n}\n"],"names":[],"mappings":"AAWA,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;AAatB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,iBAAiB,SAAS;AAAA,IAC1B,iBAAiB,SAAS;AAAA,IAC1B,UAAU,SAAS;AAAA,IACnB,eAAe,SAAS;AAAA,IACxB,eAAe,SAAS,gBAAgB;AAAA,EAAA;AAE5C;AAEO,SAAS,cACd,QACwB;AACxB,kBAAgB,MAAM;AACtB,uBAAqB,MAAM;AAE3B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EAAA;AAEd;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-anthropic",
-  "version": "0.7.5",
+  "version": "0.8.0",
   "description": "Anthropic Claude adapter for TanStack AI",
   "author": "",
   "license": "MIT",
@@ -23,6 +23,10 @@
     ".": {
       "types": "./dist/esm/index.d.ts",
       "import": "./dist/esm/index.js"
+    },
+    "./tools": {
+      "types": "./dist/esm/tools/index.d.ts",
+      "import": "./dist/esm/tools/index.js"
     }
   },
   "files": [
@@ -34,12 +38,12 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.11.0"
+    "@tanstack/ai": "^0.12.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.11.0"
+    "@tanstack/ai": "0.12.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/text.ts

@@ -9,6 +9,7 @@ import {
 import type {
   ANTHROPIC_MODELS,
   AnthropicChatModelProviderOptionsByName,
+  AnthropicChatModelToolCapabilitiesByName,
   AnthropicModelInputModalitiesByName,
 } from '../model-meta'
 import type {
@@ -89,6 +90,11 @@ type ResolveInputModalities<TModel extends string> =
     ? AnthropicModelInputModalitiesByName[TModel]
     : readonly ['text', 'image', 'document']
 
+type ResolveToolCapabilities<TModel extends string> =
+  TModel extends keyof AnthropicChatModelToolCapabilitiesByName
+    ? NonNullable<AnthropicChatModelToolCapabilitiesByName[TModel]>
+    : readonly []
+
 // ===========================
 // Adapter Implementation
 // ===========================
@@ -101,14 +107,17 @@ type ResolveInputModalities<TModel extends string> =
  */
 export class AnthropicTextAdapter<
   TModel extends (typeof ANTHROPIC_MODELS)[number],
-  TProviderOptions extends object = ResolveProviderOptions<TModel>,
+  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
+  AnthropicMessageMetadataByModality,
+  TToolCapabilities
 > {
   readonly kind = 'text' as const
   readonly name = 'anthropic' as const
@@ -121,7 +130,7 @@ export class AnthropicTextAdapter<
   }
 
   async *chatStream(
-    options: TextOptions<AnthropicTextProviderOptions>,
+    options: TextOptions<TProviderOptions>,
   ): AsyncIterable<StreamChunk> {
     try {
       const requestParams = this.mapCommonOptionsToAnthropic(options)
@@ -160,7 +169,7 @@ export class AnthropicTextAdapter<
    * The outputSchema is already JSON Schema (converted in the ai layer).
    */
   async structuredOutput(
-    options: StructuredOutputOptions<AnthropicTextProviderOptions>,
+    options: StructuredOutputOptions<TProviderOptions>,
   ): Promise<StructuredOutputResult<unknown>> {
     const { chatOptions, outputSchema } = options
 

package/src/index.ts

@@ -24,9 +24,10 @@ export {
 // ============================================================================
 
 export type {
+  AnthropicChatModel,
   AnthropicChatModelProviderOptionsByName,
+  AnthropicChatModelToolCapabilitiesByName,
   AnthropicModelInputModalitiesByName,
-  AnthropicChatModel,
 } from './model-meta'
 export { ANTHROPIC_MODELS } from './model-meta'
 export type {

package/src/model-meta.ts

@@ -21,6 +21,15 @@ interface ModelMeta<
     extended_thinking?: boolean
     adaptive_thinking?: boolean
     priority_tier?: boolean
+    tools?: Array<
+      | 'web_search'
+      | 'web_fetch'
+      | 'code_execution'
+      | 'computer_use'
+      | 'bash'
+      | 'text_editor'
+      | 'memory'
+    >
   }
   context_window?: number
   max_output_tokens?: number
@@ -66,6 +75,15 @@ const CLAUDE_OPUS_4_6 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -96,6 +114,15 @@ const CLAUDE_OPUS_4_5 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -127,6 +154,15 @@ const CLAUDE_SONNET_4_6 = {
     extended_thinking: true,
     adaptive_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -157,6 +193,15 @@ const CLAUDE_SONNET_4_5 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -187,6 +232,15 @@ const CLAUDE_HAIKU_4_5 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -217,6 +271,15 @@ const CLAUDE_OPUS_4_1 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -247,6 +310,15 @@ const CLAUDE_SONNET_4 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -276,6 +348,15 @@ const CLAUDE_SONNET_3_7 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -306,6 +387,15 @@ const CLAUDE_OPUS_4 = {
     input: ['text', 'image', 'document'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -336,6 +426,7 @@ const CLAUDE_HAIKU_3_5 = {
     input: ['text', 'image', 'document'],
     extended_thinking: false,
     priority_tier: true,
+    tools: ['web_search', 'web_fetch'],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -366,6 +457,7 @@ const CLAUDE_HAIKU_3 = {
     input: ['text', 'image', 'document'],
     extended_thinking: false,
     priority_tier: false,
+    tools: ['web_search'],
   },
 } as const satisfies ModelMeta<
   AnthropicContainerOptions &
@@ -432,6 +524,15 @@ const CLAUDE_OPUS_4_6_FAST = {
     input: ['text', 'image'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
   pricing: {
     input: {
@@ -462,6 +563,15 @@ const CLAUDE_OPUS_4_7 = {
     input: ['text', 'image'],
     extended_thinking: true,
     priority_tier: true,
+    tools: [
+      'web_search',
+      'web_fetch',
+      'code_execution',
+      'computer_use',
+      'bash',
+      'text_editor',
+      'memory',
+    ],
   },
   pricing: {
     input: {
@@ -619,6 +729,22 @@ export type AnthropicChatModelProviderOptionsByName = {
     AnthropicSamplingOptions
 }
 
+export type AnthropicChatModelToolCapabilitiesByName = {
+  [CLAUDE_OPUS_4_6.id]: typeof CLAUDE_OPUS_4_6.supports.tools
+  [CLAUDE_OPUS_4_5.id]: typeof CLAUDE_OPUS_4_5.supports.tools
+  [CLAUDE_SONNET_4_6.id]: typeof CLAUDE_SONNET_4_6.supports.tools
+  [CLAUDE_SONNET_4_5.id]: typeof CLAUDE_SONNET_4_5.supports.tools
+  [CLAUDE_HAIKU_4_5.id]: typeof CLAUDE_HAIKU_4_5.supports.tools
+  [CLAUDE_OPUS_4_1.id]: typeof CLAUDE_OPUS_4_1.supports.tools
+  [CLAUDE_SONNET_4.id]: typeof CLAUDE_SONNET_4.supports.tools
+  [CLAUDE_SONNET_3_7.id]: typeof CLAUDE_SONNET_3_7.supports.tools
+  [CLAUDE_OPUS_4.id]: typeof CLAUDE_OPUS_4.supports.tools
+  [CLAUDE_HAIKU_3_5.id]: typeof CLAUDE_HAIKU_3_5.supports.tools
+  [CLAUDE_HAIKU_3.id]: typeof CLAUDE_HAIKU_3.supports.tools
+  [CLAUDE_OPUS_4_6_FAST.id]: typeof CLAUDE_OPUS_4_6_FAST.supports.tools
+  [CLAUDE_OPUS_4_7.id]: typeof CLAUDE_OPUS_4_7.supports.tools
+}
+
 /**
  * Type-only map from chat model name to its supported input modalities.
  * All Anthropic Claude models support text, image, and document (PDF) input.