@tanstack/ai-anthropic 0.7.5 → 0.8.0

package/src/tools/bash-tool.ts

@@ -2,18 +2,25 @@ import type {
   BetaToolBash20241022,
   BetaToolBash20250124,
 } from '@anthropic-ai/sdk/resources/beta'
-import type { Tool } from '@tanstack/ai'
+import type { ProviderTool, Tool } from '@tanstack/ai'
 
-export type BashTool = BetaToolBash20241022 | BetaToolBash20250124
+export type BashToolConfig = BetaToolBash20241022 | BetaToolBash20250124
 
-export function convertBashToolToAdapterFormat(tool: Tool): BashTool {
-  const metadata = tool.metadata as BashTool
+/** @deprecated Renamed to `BashToolConfig`. Will be removed in a future release. */
+export type BashTool = BashToolConfig
+
+export type AnthropicBashTool = ProviderTool<'anthropic', 'bash'>
+
+export function convertBashToolToAdapterFormat(tool: Tool): BashToolConfig {
+  const metadata = tool.metadata as BashToolConfig
   return metadata
 }
-export function bashTool(config: BashTool): Tool {
+
+export function bashTool(config: BashToolConfig): AnthropicBashTool {
+  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.
   return {
     name: 'bash',
     description: '',
     metadata: config,
-  }
+  } as unknown as AnthropicBashTool
 }

package/src/tools/code-execution-tool.ts

@@ -2,23 +2,34 @@ import type {
   BetaCodeExecutionTool20250522,
   BetaCodeExecutionTool20250825,
 } from '@anthropic-ai/sdk/resources/beta'
-import type { Tool } from '@tanstack/ai'
+import type { ProviderTool, Tool } from '@tanstack/ai'
 
-export type CodeExecutionTool =
+export type CodeExecutionToolConfig =
   | BetaCodeExecutionTool20250522
   | BetaCodeExecutionTool20250825
 
+/** @deprecated Renamed to `CodeExecutionToolConfig`. Will be removed in a future release. */
+export type CodeExecutionTool = CodeExecutionToolConfig
+
+export type AnthropicCodeExecutionTool = ProviderTool<
+  'anthropic',
+  'code_execution'
+>
+
 export function convertCodeExecutionToolToAdapterFormat(
   tool: Tool,
-): CodeExecutionTool {
-  const metadata = tool.metadata as CodeExecutionTool
+): CodeExecutionToolConfig {
+  const metadata = tool.metadata as CodeExecutionToolConfig
   return metadata
 }
 
-export function codeExecutionTool(config: CodeExecutionTool): Tool {
+export function codeExecutionTool(
+  config: CodeExecutionToolConfig,
+): AnthropicCodeExecutionTool {
+  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.
   return {
     name: 'code_execution',
     description: '',
     metadata: config,
-  }
+  } as unknown as AnthropicCodeExecutionTool
 }

package/src/tools/computer-use-tool.ts

@@ -2,23 +2,31 @@ import type {
   BetaToolComputerUse20241022,
   BetaToolComputerUse20250124,
 } from '@anthropic-ai/sdk/resources/beta'
-import type { Tool } from '@tanstack/ai'
+import type { ProviderTool, Tool } from '@tanstack/ai'
 
-export type ComputerUseTool =
+export type ComputerUseToolConfig =
   | BetaToolComputerUse20241022
   | BetaToolComputerUse20250124
 
+/** @deprecated Renamed to `ComputerUseToolConfig`. Will be removed in a future release. */
+export type ComputerUseTool = ComputerUseToolConfig
+
+export type AnthropicComputerUseTool = ProviderTool<'anthropic', 'computer_use'>
+
 export function convertComputerUseToolToAdapterFormat(
   tool: Tool,
-): ComputerUseTool {
-  const metadata = tool.metadata as ComputerUseTool
+): ComputerUseToolConfig {
+  const metadata = tool.metadata as ComputerUseToolConfig
   return metadata
 }
 
-export function computerUseTool(config: ComputerUseTool): Tool {
+export function computerUseTool(
+  config: ComputerUseToolConfig,
+): AnthropicComputerUseTool {
+  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.
   return {
     name: 'computer',
     description: '',
     metadata: config,
-  }
+  } as unknown as AnthropicComputerUseTool
 }

package/src/tools/custom-tool.ts

@@ -1,7 +1,7 @@
 import type { JSONSchema, SchemaInput, Tool } from '@tanstack/ai'
 import type { CacheControl } from '../text/text-provider-options'
 
-export interface CustomTool {
+export interface CustomToolConfig {
   /**
    * The name of the tool.
    */
@@ -23,11 +23,13 @@ export interface CustomTool {
   cache_control?: CacheControl | null
 }
 
-export function convertCustomToolToAdapterFormat(tool: Tool): CustomTool {
+/** @deprecated Renamed to `CustomToolConfig`. Will be removed in a future release. */
+export type CustomTool = CustomToolConfig
+
+export function convertCustomToolToAdapterFormat(tool: Tool): CustomToolConfig {
   const metadata =
     (tool.metadata as { cacheControl?: CacheControl | null } | undefined) || {}
 
-  // Tool schemas are already converted to JSON Schema in the ai layer
   const jsonSchema = (tool.inputSchema ?? {
     type: 'object',
     properties: {},

package/src/tools/index.ts

@@ -7,6 +7,55 @@ import type { TextEditorTool } from './text-editor-tool'
 import type { WebFetchTool } from './web-fetch-tool'
 import type { WebSearchTool } from './web-search-tool'
 
+export {
+  bashTool,
+  type AnthropicBashTool,
+  type BashToolConfig,
+  type BashTool,
+} from './bash-tool'
+export {
+  codeExecutionTool,
+  type AnthropicCodeExecutionTool,
+  type CodeExecutionToolConfig,
+  type CodeExecutionTool,
+} from './code-execution-tool'
+export {
+  computerUseTool,
+  type AnthropicComputerUseTool,
+  type ComputerUseToolConfig,
+  type ComputerUseTool,
+} from './computer-use-tool'
+export {
+  customTool,
+  type CustomToolConfig,
+  type CustomTool,
+} from './custom-tool'
+export {
+  memoryTool,
+  type AnthropicMemoryTool,
+  type MemoryToolConfig,
+  type MemoryTool,
+} from './memory-tool'
+export {
+  textEditorTool,
+  type AnthropicTextEditorTool,
+  type TextEditorToolConfig,
+  type TextEditorTool,
+} from './text-editor-tool'
+export {
+  webFetchTool,
+  type AnthropicWebFetchTool,
+  type WebFetchToolConfig,
+  type WebFetchTool,
+} from './web-fetch-tool'
+export {
+  webSearchTool,
+  type AnthropicWebSearchTool,
+  type WebSearchToolConfig,
+  type WebSearchTool,
+} from './web-search-tool'
+
+// Keep the discriminated union defined inline (no barrel exports).
 export type AnthropicTool =
   | BashTool
   | CodeExecutionTool
@@ -16,15 +65,3 @@ export type AnthropicTool =
   | TextEditorTool
   | WebFetchTool
   | WebSearchTool
-
-// Export individual tool types
-export type {
-  // BashTool,
-  // CodeExecutionTool,
-  // ComputerUseTool,
-  CustomTool,
-  // MemoryTool,
-  // TextEditorTool,
-  // WebFetchTool,
-  // WebSearchTool,
-}

package/src/tools/memory-tool.ts

@@ -1,20 +1,26 @@
 import type { BetaMemoryTool20250818 } from '@anthropic-ai/sdk/resources/beta'
-import type { Tool } from '@tanstack/ai'
+import type { ProviderTool, Tool } from '@tanstack/ai'
 
-export type MemoryTool = BetaMemoryTool20250818
+export type MemoryToolConfig = BetaMemoryTool20250818
 
-export function convertMemoryToolToAdapterFormat(tool: Tool): MemoryTool {
-  const metadata = tool.metadata as Omit<MemoryTool, 'type'>
+/** @deprecated Renamed to `MemoryToolConfig`. Will be removed in a future release. */
+export type MemoryTool = MemoryToolConfig
+
+export type AnthropicMemoryTool = ProviderTool<'anthropic', 'memory'>
+
+export function convertMemoryToolToAdapterFormat(tool: Tool): MemoryToolConfig {
+  const metadata = tool.metadata as Omit<MemoryToolConfig, 'type'>
   return {
     type: 'memory_20250818',
     ...metadata,
   }
 }
 
-export function memoryTool(config?: MemoryTool): Tool {
+export function memoryTool(config?: MemoryToolConfig): AnthropicMemoryTool {
+  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.
   return {
     name: 'memory',
     description: '',
     metadata: config,
-  }
+  } as unknown as AnthropicMemoryTool
 }

package/src/tools/text-editor-tool.ts

@@ -3,26 +3,34 @@ import type {
   ToolTextEditor20250429,
   ToolTextEditor20250728,
 } from '@anthropic-ai/sdk/resources/messages'
-import type { Tool } from '@tanstack/ai'
+import type { ProviderTool, Tool } from '@tanstack/ai'
 
-export type TextEditorTool =
+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 function convertTextEditorToolToAdapterFormat(
   tool: Tool,
-): TextEditorTool {
-  const metadata = tool.metadata as TextEditorTool
+): TextEditorToolConfig {
+  const metadata = tool.metadata as TextEditorToolConfig
   return {
     ...metadata,
   }
 }
 
-export function textEditorTool<T extends TextEditorTool>(config: T): Tool {
+export function textEditorTool<T extends TextEditorToolConfig>(
+  config: T,
+): AnthropicTextEditorTool {
+  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.
   return {
     name: 'str_replace_editor',
     description: '',
     metadata: config,
-  }
+  } as unknown as AnthropicTextEditorTool
 }

package/src/tools/web-fetch-tool.ts

@@ -1,10 +1,17 @@
 import type { BetaWebFetchTool20250910 } from '@anthropic-ai/sdk/resources/beta'
-import type { Tool } from '@tanstack/ai'
+import type { ProviderTool, Tool } from '@tanstack/ai'
 
-export type WebFetchTool = BetaWebFetchTool20250910
+export type WebFetchToolConfig = BetaWebFetchTool20250910
 
-export function convertWebFetchToolToAdapterFormat(tool: Tool): WebFetchTool {
-  const metadata = tool.metadata as Omit<WebFetchTool, 'type' | 'name'>
+/** @deprecated Renamed to `WebFetchToolConfig`. Will be removed in a future release. */
+export type WebFetchTool = WebFetchToolConfig
+
+export type AnthropicWebFetchTool = ProviderTool<'anthropic', 'web_fetch'>
+
+export function convertWebFetchToolToAdapterFormat(
+  tool: Tool,
+): WebFetchToolConfig {
+  const metadata = tool.metadata as Omit<WebFetchToolConfig, 'type' | 'name'>
   return {
     name: 'web_fetch',
     type: 'web_fetch_20250910',
@@ -13,11 +20,12 @@ export function convertWebFetchToolToAdapterFormat(tool: Tool): WebFetchTool {
 }
 
 export function webFetchTool(
-  config?: Omit<WebFetchTool, 'type' | 'name'>,
-): Tool {
+  config?: Omit<WebFetchToolConfig, 'type' | 'name'>,
+): AnthropicWebFetchTool {
+  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.
   return {
     name: 'web_fetch',
     description: '',
     metadata: config,
-  }
+  } as unknown as AnthropicWebFetchTool
 }

package/src/tools/web-search-tool.ts

@@ -1,10 +1,15 @@
 import type { WebSearchTool20250305 } from '@anthropic-ai/sdk/resources/messages'
 import type { CacheControl } from '../text/text-provider-options'
-import type { Tool } from '@tanstack/ai'
+import type { ProviderTool, Tool } from '@tanstack/ai'
 
-export type WebSearchTool = WebSearchTool20250305
+export type WebSearchToolConfig = WebSearchTool20250305
 
-const validateDomains = (tool: WebSearchTool) => {
+/** @deprecated Renamed to `WebSearchToolConfig`. Will be removed in a future release. */
+export type WebSearchTool = WebSearchToolConfig
+
+export type AnthropicWebSearchTool = ProviderTool<'anthropic', 'web_search'>
+
+const validateDomains = (tool: WebSearchToolConfig) => {
   if (tool.allowed_domains && tool.blocked_domains) {
     throw new Error(
       'allowed_domains and blocked_domains cannot be used together.',
@@ -12,7 +17,7 @@ const validateDomains = (tool: WebSearchTool) => {
   }
 }
 
-const validateUserLocation = (tool: WebSearchTool) => {
+const validateUserLocation = (tool: WebSearchToolConfig) => {
   const userLocation = tool.user_location
   if (userLocation) {
     if (
@@ -45,7 +50,9 @@ const validateUserLocation = (tool: WebSearchTool) => {
   }
 }
 
-export function convertWebSearchToolToAdapterFormat(tool: Tool): WebSearchTool {
+export function convertWebSearchToolToAdapterFormat(
+  tool: Tool,
+): WebSearchToolConfig {
   const metadata = tool.metadata as {
     allowedDomains?: Array<string> | null
     blockedDomains?: Array<string> | null
@@ -70,12 +77,15 @@ export function convertWebSearchToolToAdapterFormat(tool: Tool): WebSearchTool {
   }
 }
 
-export function webSearchTool(config: WebSearchTool): Tool {
+export function webSearchTool(
+  config: WebSearchToolConfig,
+): AnthropicWebSearchTool {
   validateDomains(config)
   validateUserLocation(config)
+  // Phantom-brand cast: '~provider'/'~toolKind' are type-only and never assigned at runtime.
   return {
     name: 'web_search',
     description: '',
     metadata: config,
-  }
+  } as unknown as AnthropicWebSearchTool
 }