Merge pull request #748 from anthropics/release-please--branches--main--changes--next

chore: release main

Author: kevinc13

.github/workflows/ci.yml

@@ -72,7 +72,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '20'
 
       - name: Bootstrap
         run: ./scripts/bootstrap

.github/workflows/publish-npm.yml

@@ -20,7 +20,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '20'
 
       - name: Install dependencies
         run: |

.release-please-manifest.json

@@ -1,5 +1,5 @@
 {
-  ".": "0.40.1",
+  ".": "0.41.0",
   "packages/vertex-sdk": "0.7.0",
   "packages/bedrock-sdk": "0.12.6"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-ea0576fceb17a0976feca9aa03aa426984d6fe1390f2bcdbf9de0212a81c8334.yml
-openapi_spec_hash: d2d7ec2a7a35a1ed2443c3b690c802c4
-config_hash: 9d5b992847099d8fe5a5c09e66adbe5f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-7015ea2d98991d6c2e7931c521e36448778fe868cc1b8a21173898d67b14b819.yml
+openapi_spec_hash: 2007ff815a3f39af8cebe1976d50f17d
+config_hash: 4d0dcf47d77eae22d34624d2ac0f0b46

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.41.0 (2025-05-07)
+
+Full Changelog: [sdk-v0.40.1...sdk-v0.41.0](https://github.com/anthropics/anthropic-sdk-typescript/compare/sdk-v0.40.1...sdk-v0.41.0)
+
+### Features
+
+* **api:** adds web search capabilities to the Claude API ([fae7e52](https://github.com/anthropics/anthropic-sdk-typescript/commit/fae7e521568d9659e376d13c4e4a6c320b13b1d4))
+
+
+### Chores
+
+* **ci:** bump node version for release workflows ([3502747](https://github.com/anthropics/anthropic-sdk-typescript/commit/350274792ed3d9b7ea237ee60876883373344016))
+
+
+### Documentation
+
+* add examples to tsdocs ([19a9285](https://github.com/anthropics/anthropic-sdk-typescript/commit/19a928512b1616f2cac9c82f02e7bd9a158dab95))
+* **readme:** fix typo ([735574e](https://github.com/anthropics/anthropic-sdk-typescript/commit/735574e23b7956cbfd0c05d0374079391d5d4e96))
+
 ## 0.40.1 (2025-04-28)
 
 Full Changelog: [sdk-v0.40.0...sdk-v0.40.1](https://github.com/anthropics/anthropic-sdk-typescript/compare/sdk-v0.40.0...sdk-v0.40.1)

README.md

@@ -220,7 +220,7 @@ async function main() {
 main();
 ```
 
-Error codes are as followed:
+Error codes are as follows:
 
 | Status Code | Error Type                 |
 | ----------- | -------------------------- |

api.md

@@ -29,8 +29,10 @@ Types:
 - <code><a href="./src/resources/messages/messages.ts">CitationContentBlockLocationParam</a></code>
 - <code><a href="./src/resources/messages/messages.ts">CitationPageLocation</a></code>
 - <code><a href="./src/resources/messages/messages.ts">CitationPageLocationParam</a></code>
+- <code><a href="./src/resources/messages/messages.ts">CitationWebSearchResultLocationParam</a></code>
 - <code><a href="./src/resources/messages/messages.ts">CitationsConfigParam</a></code>
 - <code><a href="./src/resources/messages/messages.ts">CitationsDelta</a></code>
+- <code><a href="./src/resources/messages/messages.ts">CitationsWebSearchResultLocation</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ContentBlock</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ContentBlockParam</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ContentBlockSource</a></code>
@@ -56,6 +58,9 @@ Types:
 - <code><a href="./src/resources/messages/messages.ts">RawMessageStreamEvent</a></code>
 - <code><a href="./src/resources/messages/messages.ts">RedactedThinkingBlock</a></code>
 - <code><a href="./src/resources/messages/messages.ts">RedactedThinkingBlockParam</a></code>
+- <code><a href="./src/resources/messages/messages.ts">ServerToolUsage</a></code>
+- <code><a href="./src/resources/messages/messages.ts">ServerToolUseBlock</a></code>
+- <code><a href="./src/resources/messages/messages.ts">ServerToolUseBlockParam</a></code>
 - <code><a href="./src/resources/messages/messages.ts">SignatureDelta</a></code>
 - <code><a href="./src/resources/messages/messages.ts">StopReason</a></code>
 - <code><a href="./src/resources/messages/messages.ts">TextBlock</a></code>
@@ -84,6 +89,15 @@ Types:
 - <code><a href="./src/resources/messages/messages.ts">URLImageSource</a></code>
 - <code><a href="./src/resources/messages/messages.ts">URLPDFSource</a></code>
 - <code><a href="./src/resources/messages/messages.ts">Usage</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchResultBlock</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchResultBlockParam</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchTool20250305</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchToolRequestError</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlock</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlockContent</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlockParam</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlockParamContent</a></code>
+- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultError</a></code>
 - <code><a href="./src/resources/messages/messages.ts">MessageStreamEvent</a></code>
 - <code><a href="./src/resources/messages/messages.ts">MessageStartEvent</a></code>
 - <code><a href="./src/resources/messages/messages.ts">MessageDeltaEvent</a></code>
@@ -129,7 +143,7 @@ Types:
 
 Methods:
 
-- <code title="get /v1/models/{model_id}">client.models.<a href="./src/resources/models.ts">retrieve</a>(modelId) -> ModelInfo</code>
+- <code title="get /v1/models/{model_id}">client.models.<a href="./src/resources/models.ts">retrieve</a>(modelId, { ...params }) -> ModelInfo</code>
 - <code title="get /v1/models">client.models.<a href="./src/resources/models.ts">list</a>({ ...params }) -> ModelInfosPage</code>
 
 # Beta
@@ -157,7 +171,7 @@ Types:
 
 Methods:
 
-- <code title="get /v1/models/{model_id}?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">retrieve</a>(modelId) -> BetaModelInfo</code>
+- <code title="get /v1/models/{model_id}?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">retrieve</a>(modelId, { ...params }) -> BetaModelInfo</code>
 - <code title="get /v1/models?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">list</a>({ ...params }) -> BetaModelInfosPage</code>
 
 ## Messages
@@ -174,8 +188,10 @@ Types:
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationContentBlockLocationParam</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationPageLocation</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationPageLocationParam</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationWebSearchResultLocationParam</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationsConfigParam</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationsDelta</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationsWebSearchResultLocation</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaContentBlock</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaContentBlockParam</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaContentBlockSource</a></code>
@@ -198,6 +214,9 @@ Types:
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaRawMessageStreamEvent</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaRedactedThinkingBlock</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaRedactedThinkingBlockParam</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaServerToolUsage</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaServerToolUseBlock</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaServerToolUseBlockParam</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaSignatureDelta</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaStopReason</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaTextBlock</a></code>
@@ -230,6 +249,15 @@ Types:
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaURLImageSource</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaURLPDFSource</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaUsage</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchResultBlock</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchResultBlockParam</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchTool20250305</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolRequestError</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlock</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlockContent</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlockParam</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlockParamContent</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultError</a></code>
 
 Methods:
 

examples/tools.ts

@@ -49,7 +49,7 @@ async function main() {
           {
             type: 'tool_result',
             tool_use_id: tool.id,
-            content: [{ type: 'text', text: 'The weather is 73f' }],
+            content: 'The weather is 73f',
           },
         ],
       },

examples/web-search-stream.ts

@@ -0,0 +1,64 @@
+#!/usr/bin/env -S npm run tsn -T
+
+import Anthropic from '@anthropic-ai/sdk';
+
+const client = new Anthropic();
+
+async function main() {
+  console.log('Claude with Web Search (Streaming)');
+  console.log('==================================');
+
+  // Create a stream with web search enabled
+  const stream = client.messages
+    .stream({
+      model: 'claude-3-5-sonnet-latest',
+      max_tokens: 1024,
+      messages: [
+        {
+          role: 'user',
+          content: "What's the weather in New York?",
+        },
+      ],
+      tools: [
+        {
+          name: 'web_search',
+          type: 'web_search_20250305',
+        },
+      ],
+    })
+    .on('text', (text) => {
+      // Print text as it arrives
+      process.stdout.write(text);
+    })
+    .on('streamEvent', (event) => {
+      // Track when web search is being used
+      if (event.type === 'content_block_start' && event.content_block.type === 'web_search_tool_result') {
+        process.stdout.write('\n[Web search started...]');
+      }
+    });
+
+  // Wait for the stream to complete
+  const message = await stream.finalMessage();
+
+  console.log('\n\nFinal usage statistics:');
+  console.log(`Input tokens: ${message.usage.input_tokens}`);
+  console.log(`Output tokens: ${message.usage.output_tokens}`);
+
+  if (message.usage.server_tool_use) {
+    console.log(`Web search requests: ${message.usage.server_tool_use.web_search_requests}`);
+  } else {
+    console.log('No web search requests recorded in usage');
+  }
+
+  // Display message content types for debugging
+  console.log('\nMessage Content Types:');
+  message.content.forEach((block, i) => {
+    console.log(`Content Block ${i + 1}: Type = ${block.type}`);
+  });
+
+  // Show full message for debugging
+  console.log('\nComplete message structure:');
+  console.dir(message, { depth: 4 });
+}
+
+main().catch(console.error);

examples/web-search.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env -S npm run tsn -T
+
+import Anthropic from '@anthropic-ai/sdk';
+
+const client = new Anthropic();
+
+async function main() {
+  console.log('Web Search Example');
+  console.log('=================');
+
+  // Create a message with web search enabled
+  const message = await client.messages.create({
+    model: 'claude-3-5-sonnet-latest',
+    max_tokens: 1024,
+    messages: [
+      {
+        role: 'user',
+        content:
+          "What's the current weather in San Francisco? Please search the web for up-to-date information.",
+      },
+    ],
+    tools: [
+      {
+        name: 'web_search',
+        type: 'web_search_20250305',
+      },
+    ],
+  });
+
+  // Print the full response
+  console.log('\nFull response:');
+  console.dir(message, { depth: 4 });
+
+  // Extract and print the content
+  console.log('\nResponse content:');
+  for (const contentBlock of message.content) {
+    if (contentBlock.type === 'text') {
+      console.log(contentBlock.text);
+    }
+  }
+
+  // Print usage information
+  console.log('\nUsage statistics:');
+  console.log(`Input tokens: ${message.usage.input_tokens}`);
+  console.log(`Output tokens: ${message.usage.output_tokens}`);
+
+  if (message.usage.server_tool_use) {
+    console.log(`Web search requests: ${message.usage.server_tool_use.web_search_requests}`);
+  }
+}
+
+main().catch(console.error);