@ai-sdk/anthropic 3.0.19 → 3.0.21

package/src/anthropic-messages-language-model.test.ts

@@ -3020,6 +3020,104 @@ describe('AnthropicMessagesLanguageModel', () => {
           expect(result.content).toMatchSnapshot();
         });
       });
+
+      describe('deferred result - bm25 variant', () => {
+        it('should correctly map tool_search_tool_result when result comes without server_tool_use in same response', async () => {
+          prepareJsonFixtureResponse('anthropic-tool-search-deferred-bm25.2');
+
+          const result = await provider('claude-sonnet-4-5').doGenerate({
+            prompt: [
+              {
+                role: 'user',
+                content: [
+                  {
+                    type: 'text',
+                    text: 'What is the weather in San Francisco?',
+                  },
+                ],
+              },
+            ],
+            tools: [
+              {
+                type: 'provider',
+                id: 'anthropic.tool_search_bm25_20251119',
+                name: 'tool_search',
+                args: {},
+              },
+              {
+                type: 'function',
+                name: 'get_weather',
+                description: 'Get the current weather at a specific location',
+                inputSchema: {
+                  type: 'object',
+                  properties: {
+                    location: { type: 'string' },
+                  },
+                },
+                providerOptions: {
+                  anthropic: { deferLoading: true },
+                },
+              },
+            ],
+          });
+
+          // The tool result should be correctly mapped to 'tool_search' (the user's custom name)
+          // even though serverToolCalls map is empty (no server_tool_use in this response)
+          const toolResult = result.content.find(
+            part => part.type === 'tool-result',
+          );
+          expect(toolResult).toBeDefined();
+          expect(toolResult?.toolName).toBe('tool_search');
+        });
+      });
+
+      describe('deferred result - regex variant', () => {
+        it('should correctly map tool_search_tool_result when result comes without server_tool_use in same response', async () => {
+          prepareJsonFixtureResponse('anthropic-tool-search-deferred-regex.2');
+
+          const result = await provider('claude-sonnet-4-5').doGenerate({
+            prompt: [
+              {
+                role: 'user',
+                content: [
+                  {
+                    type: 'text',
+                    text: 'Find weather data in NYC',
+                  },
+                ],
+              },
+            ],
+            tools: [
+              {
+                type: 'provider',
+                id: 'anthropic.tool_search_regex_20251119',
+                name: 'tool_search',
+                args: {},
+              },
+              {
+                type: 'function',
+                name: 'get_temp_data',
+                description: 'For a location',
+                inputSchema: {
+                  type: 'object',
+                  properties: {
+                    location: { type: 'string' },
+                  },
+                },
+                providerOptions: {
+                  anthropic: { deferLoading: true },
+                },
+              },
+            ],
+          });
+
+          const toolResult = result.content.find(
+            part => part.type === 'tool-result',
+          );
+          expect(toolResult).toBeDefined();
+          expect(toolResult?.toolName).toBe('tool_search');
+        });
+      });
     });
 
     describe('mcp servers', () => {
@@ -6845,6 +6943,106 @@ describe('AnthropicMessagesLanguageModel', () => {
           ).toMatchSnapshot();
         });
       });
+
+      describe('deferred result - bm25 variant', () => {
+        it('should correctly map tool_search_tool_result when result comes without server_tool_use in same response', async () => {
+          prepareChunksFixtureResponse('anthropic-tool-search-deferred-bm25');
+
+          const result = await provider('claude-sonnet-4-5').doStream({
+            prompt: [
+              {
+                role: 'user',
+                content: [
+                  {
+                    type: 'text',
+                    text: 'What is the weather in San Francisco?',
+                  },
+                ],
+              },
+            ],
+            tools: [
+              {
+                type: 'provider',
+                id: 'anthropic.tool_search_bm25_20251119',
+                name: 'tool_search',
+                args: {},
+              },
+              {
+                type: 'function',
+                name: 'get_weather',
+                description: 'Get the current weather at a specific location',
+                inputSchema: {
+                  type: 'object',
+                  properties: {
+                    location: { type: 'string' },
+                  },
+                },
+                providerOptions: {
+                  anthropic: { deferLoading: true },
+                },
+              },
+            ],
+          });
+
+          const chunks = await convertReadableStreamToArray(result.stream);
+
+          const toolResultChunk = chunks.find(
+            chunk => chunk.type === 'tool-result',
+          );
+          expect(toolResultChunk).toBeDefined();
+          expect(toolResultChunk?.toolName).toBe('tool_search');
+        });
+      });
+
+      describe('deferred result - regex variant', () => {
+        it('should correctly map tool_search_tool_result when result comes without server_tool_use in same response', async () => {
+          prepareChunksFixtureResponse('anthropic-tool-search-deferred-regex');
+
+          const result = await provider('claude-sonnet-4-5').doStream({
+            prompt: [
+              {
+                role: 'user',
+                content: [
+                  {
+                    type: 'text',
+                    text: 'Find weather data in NYC',
+                  },
+                ],
+              },
+            ],
+            tools: [
+              {
+                type: 'provider',
+                id: 'anthropic.tool_search_regex_20251119',
+                name: 'tool_search',
+                args: {},
+              },
+              {
+                type: 'function',
+                name: 'get_temp_data',
+                description: 'For a location',
+                inputSchema: {
+                  type: 'object',
+                  properties: {
+                    location: { type: 'string' },
+                  },
+                },
+                providerOptions: {
+                  anthropic: { deferLoading: true },
+                },
+              },
+            ],
+          });
+
+          const chunks = await convertReadableStreamToArray(result.stream);
+
+          const toolResultChunk = chunks.find(
+            chunk => chunk.type === 'tool-result',
+          );
+          expect(toolResultChunk).toBeDefined();
+          expect(toolResultChunk?.toolName).toBe('tool_search');
+        });
+      });
     });
 
     it('should throw an api error when the server is returning a 529 overloaded error', async () => {

package/src/anthropic-messages-language-model.ts

@@ -987,8 +987,25 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
 
         // tool search tool results:
         case 'tool_search_tool_result': {
-          const providerToolName =
-            serverToolCalls[part.tool_use_id] ?? 'tool_search_tool_regex';
+          let providerToolName = serverToolCalls[part.tool_use_id];
+
+          if (providerToolName == null) {
+            const bm25CustomName = toolNameMapping.toCustomToolName(
+              'tool_search_tool_bm25',
+            );
+            const regexCustomName = toolNameMapping.toCustomToolName(
+              'tool_search_tool_regex',
+            );
+
+            if (bm25CustomName !== 'tool_search_tool_bm25') {
+              providerToolName = 'tool_search_tool_bm25';
+            } else if (regexCustomName !== 'tool_search_tool_regex') {
+              providerToolName = 'tool_search_tool_regex';
+            } else {
+              providerToolName = 'tool_search_tool_regex';
+            }
+          }
+
           if (part.content.type === 'tool_search_tool_search_result') {
             content.push({
               type: 'tool-result',
@@ -1480,9 +1497,25 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
 
                 // tool search tool results:
                 case 'tool_search_tool_result': {
-                  const providerToolName =
-                    serverToolCalls[part.tool_use_id] ??
-                    'tool_search_tool_regex';
+                  let providerToolName = serverToolCalls[part.tool_use_id];
+
+                  if (providerToolName == null) {
+                    const bm25CustomName = toolNameMapping.toCustomToolName(
+                      'tool_search_tool_bm25',
+                    );
+                    const regexCustomName = toolNameMapping.toCustomToolName(
+                      'tool_search_tool_regex',
+                    );
+
+                    if (bm25CustomName !== 'tool_search_tool_bm25') {
+                      providerToolName = 'tool_search_tool_bm25';
+                    } else if (regexCustomName !== 'tool_search_tool_regex') {
+                      providerToolName = 'tool_search_tool_regex';
+                    } else {
+                      providerToolName = 'tool_search_tool_regex';
+                    }
+                  }
+
                   if (part.content.type === 'tool_search_tool_search_result') {
                     controller.enqueue({
                       type: 'tool-result',

package/src/tool/tool-search-bm25_20251119.ts

@@ -64,6 +64,7 @@ const factory = createProviderToolFactoryWithOutputSchema<
   id: 'anthropic.tool_search_bm25_20251119',
   inputSchema: toolSearchBm25_20251119InputSchema,
   outputSchema: toolSearchBm25_20251119OutputSchema,
+  supportsDeferredResults: true,
 });
 
 /**

package/src/tool/tool-search-regex_20251119.ts

@@ -76,6 +76,7 @@ const factory = createProviderToolFactoryWithOutputSchema<
   id: 'anthropic.tool_search_regex_20251119',
   inputSchema: toolSearchRegex_20251119InputSchema,
   outputSchema: toolSearchRegex_20251119OutputSchema,
+  supportsDeferredResults: true,
 });
 
 /**