@ai-sdk/anthropic 3.0.35 → 3.0.36

package/docs/05-anthropic.mdx

@@ -745,6 +745,57 @@ const result = await generateText({
 
 Claude will construct regex patterns like `weather|temperature|forecast` to find matching tools.
 
+#### Custom Tool Search
+
+You can implement your own tool search logic (e.g., using embeddings or semantic search) by returning `tool-reference` content blocks via `toModelOutput`:
+
+```ts
+import { anthropic } from '@ai-sdk/anthropic';
+import { generateText, tool } from 'ai';
+import { z } from 'zod';
+
+const result = await generateText({
+  model: anthropic('claude-sonnet-4-5'),
+  prompt: 'What is the weather in San Francisco?',
+  tools: {
+    // Custom search tool
+    searchTools: tool({
+      description: 'Search for tools by keyword',
+      inputSchema: z.object({ query: z.string() }),
+      execute: async ({ query }) => {
+        // Your custom search logic (embeddings, fuzzy match, etc.)
+        const allTools = ['get_weather', 'get_forecast', 'get_temperature'];
+        return allTools.filter(name => name.includes(query.toLowerCase()));
+      },
+      toModelOutput: ({ output }) => ({
+        type: 'content',
+        value: (output as string[]).map(toolName => ({
+          type: 'custom' as const,
+          providerOptions: {
+            anthropic: {
+              type: 'tool-reference',
+              toolName,
+            },
+          },
+        })),
+      }),
+    }),
+
+    // Deferred tools
+    get_weather: tool({
+      description: 'Get the current weather',
+      inputSchema: z.object({ location: z.string() }),
+      execute: async ({ location }) => ({ location, temperature: 72 }),
+      providerOptions: {
+        anthropic: { deferLoading: true },
+      },
+    }),
+  },
+});
+```
+
+This sends `tool_reference` blocks to Anthropic, which loads the corresponding deferred tool schemas into Claude's context.
+
 ### MCP Connectors
 
 Anthropic supports connecting to [MCP servers](https://docs.claude.com/en/docs/agents-and-tools/mcp-connector) as part of their execution.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "3.0.35",
+  "version": "3.0.36",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/anthropic-messages-api.ts

@@ -164,6 +164,11 @@ type AnthropicNestedDocumentContent = Omit<
   cache_control?: never;
 };
 
+export interface AnthropicToolReferenceContent {
+  type: 'tool_reference';
+  tool_name: string;
+}
+
 export interface AnthropicToolResultContent {
   type: 'tool_result';
   tool_use_id: string;
@@ -173,6 +178,7 @@ export interface AnthropicToolResultContent {
         | AnthropicNestedTextContent
         | AnthropicNestedImageContent
         | AnthropicNestedDocumentContent
+        | AnthropicToolReferenceContent
       >;
   is_error: boolean | undefined;
   cache_control: AnthropicCacheControl | undefined;

package/src/convert-to-anthropic-messages-prompt.ts

@@ -355,6 +355,23 @@ export async function convertToAnthropicMessagesPrompt({
 
                             return undefined;
                           }
+                          case 'custom': {
+                            const anthropicOptions = contentPart.providerOptions
+                              ?.anthropic as
+                              | { type: string; toolName?: string }
+                              | undefined;
+                            if (anthropicOptions?.type === 'tool-reference') {
+                              return {
+                                type: 'tool_reference' as const,
+                                tool_name: anthropicOptions.toolName!,
+                              };
+                            }
+                            warnings.push({
+                              type: 'other',
+                              message: `unsupported custom tool content part`,
+                            });
+                            return undefined;
+                          }
                           default: {
                             warnings.push({
                               type: 'other',