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

chore: release main

Author: gcemaj

.release-please-manifest.json

@@ -1,5 +1,5 @@
 {
-  ".": "0.55.1",
-  "packages/vertex-sdk": "0.11.5",
-  "packages/bedrock-sdk": "0.22.3"
+  ".": "0.56.0",
+  "packages/vertex-sdk": "0.12.0",
+  "packages/bedrock-sdk": "0.22.4"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-a7b84017aa1126ad99443296dcd81ab2b53f1c346014b92096226cf993f30502.yml
-openapi_spec_hash: 58d4e72c7906bd8a680ab17b99de6215
-config_hash: a70fca044c61bcbf321355acc81c541d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-59aad2898ad5b11d8c367967ca73213a83bb46f1ca20cd006ee00fc8010c5e65.yml
+openapi_spec_hash: 6dcdf2b065d61612f4403a1786c3bee2
+config_hash: 29170d4f110e44c786b2ce308d7b6410

CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.56.0 (2025-07-03)
+
+Full Changelog: [sdk-v0.55.1...sdk-v0.56.0](https://github.com/anthropics/anthropic-sdk-typescript/compare/sdk-v0.55.1...sdk-v0.56.0)
+
+### Features
+
+* **api:** add support for Search Result Content Blocks ([2910b28](https://github.com/anthropics/anthropic-sdk-typescript/commit/2910b280ef8ab8888dbad59e2ab97c63565879cb))
+* **tests:** add fixture-based streaming tests and improve test coverage ([00424bc](https://github.com/anthropics/anthropic-sdk-typescript/commit/00424bc033895c20f2f73d9311c85dabfe0e9a9f))
+* **vertex:** add AuthClient interface support for improved auth flexibility ([b6f86e2](https://github.com/anthropics/anthropic-sdk-typescript/commit/b6f86e29396f5521eeaae43d43084a76e3e518fe))
+
+
+### Bug Fixes
+
+* avoid console usage ([e5ab01d](https://github.com/anthropics/anthropic-sdk-typescript/commit/e5ab01dd3f0a9a9904b000f4599a05f4200e1f67))
+* **bedrock:** fix bedrock logger ([f183bc9](https://github.com/anthropics/anthropic-sdk-typescript/commit/f183bc97bc5a83b0e00053740caa387a1c98c322))
+
+
+### Chores
+
+* add docs to RequestOptions type ([38cb967](https://github.com/anthropics/anthropic-sdk-typescript/commit/38cb9676c929e86a1048bd086c5c26129aeea46d))
+* **api:** update BetaCitationSearchResultLocation ([760be6b](https://github.com/anthropics/anthropic-sdk-typescript/commit/760be6be14ae6b10004841aa97db2b3871ac15aa))
+
+
+### Documentation
+
+* model in examples ([9385376](https://github.com/anthropics/anthropic-sdk-typescript/commit/9385376d8352040bccf9563ab985438b55dbbdae))
+* more beta updates ([7d8b8ac](https://github.com/anthropics/anthropic-sdk-typescript/commit/7d8b8ac2f219c0a64beeecfdd4f2be90c5786201))
+* update model in readme ([b1799f7](https://github.com/anthropics/anthropic-sdk-typescript/commit/b1799f7efa15938ecc00e2a65d90ecb03da9dda0))
+* update models and non-beta batches ([5305cdb](https://github.com/anthropics/anthropic-sdk-typescript/commit/5305cdbd65e6b1b7b8c460c1cea845b23fddc770))
+
 ## 0.55.1 (2025-06-30)
 
 Full Changelog: [sdk-v0.55.0...sdk-v0.55.1](https://github.com/anthropics/anthropic-sdk-typescript/compare/sdk-v0.55.0...sdk-v0.55.1)

README.md

@@ -27,7 +27,7 @@ const client = new Anthropic({
 const message = await client.messages.create({
   max_tokens: 1024,
   messages: [{ role: 'user', content: 'Hello, Claude' }],
-  model: 'claude-3-5-sonnet-latest',
+  model: 'claude-sonnet-4-20250514',
 });
 
 console.log(message.content);
@@ -45,7 +45,7 @@ const client = new Anthropic();
 const stream = await client.messages.create({
   max_tokens: 1024,
   messages: [{ role: 'user', content: 'Hello, Claude' }],
-  model: 'claude-3-5-sonnet-latest',
+  model: 'claude-sonnet-4-20250514',
   stream: true,
 });
 for await (const messageStreamEvent of stream) {
@@ -71,7 +71,7 @@ const client = new Anthropic({
 const params: Anthropic.MessageCreateParams = {
   max_tokens: 1024,
   messages: [{ role: 'user', content: 'Hello, Claude' }],
-  model: 'claude-3-5-sonnet-latest',
+  model: 'claude-sonnet-4-20250514',
 };
 const message: Anthropic.Message = await client.messages.create(params);
 ```
@@ -100,7 +100,7 @@ const anthropic = new Anthropic();
 async function main() {
   const stream = anthropic.messages
     .stream({
-      model: 'claude-3-5-sonnet-latest',
+      model: 'claude-sonnet-4-20250514',
       max_tokens: 1024,
       messages: [
         {
@@ -126,27 +126,27 @@ Alternatively, you can use `client.messages.create({ ..., stream: true })` which
 
 ## Message Batches
 
-This SDK provides beta support for the [Message Batches API](https://docs.anthropic.com/en/docs/build-with-claude/message-batches) under the `client.beta.messages.batches` namespace.
+This SDK provides support for the [Message Batches API](https://docs.anthropic.com/en/docs/build-with-claude/message-batches) under the `client.messages.batches` namespace.
 
 ### Creating a batch
 
 Message Batches takes an array of requests, where each object has a `custom_id` identifier, and the exact same request `params` as the standard Messages API:
 
 ```ts
-await anthropic.beta.messages.batches.create({
+await anthropic.messages.batches.create({
   requests: [
     {
       custom_id: 'my-first-request',
       params: {
-        model: 'claude-3-5-sonnet-latest',
+        model: 'claude-sonnet-4-20250514',
         max_tokens: 1024,
         messages: [{ role: 'user', content: 'Hello, world' }],
       },
     },
     {
       custom_id: 'my-second-request',
       params: {
-        model: 'claude-3-5-sonnet-latest',
+        model: 'claude-sonnet-4-20250514',
         max_tokens: 1024,
         messages: [{ role: 'user', content: 'Hi again, friend' }],
       },
@@ -160,7 +160,7 @@ await anthropic.beta.messages.batches.create({
 Once a Message Batch has been processed, indicated by `.processing_status === 'ended'`, you can access the results with `.batches.results()`
 
 ```ts
-const results = await anthropic.beta.messages.batches.results(batch_id);
+const results = await anthropic.messages.batches.results(batch_id);
 for await (const entry of results) {
   if (entry.result.type === 'succeeded') {
     console.log(entry.result.message.content);
@@ -233,7 +233,7 @@ const message = await client.messages
   .create({
     max_tokens: 1024,
     messages: [{ role: 'user', content: 'Hello, Claude' }],
-    model: 'claude-3-5-sonnet-latest',
+    model: 'claude-sonnet-4-20250514',
   })
   .catch(async (err) => {
     if (err instanceof Anthropic.APIError) {
@@ -269,7 +269,7 @@ All object responses in the SDK provide a `_request_id` property which is added
 const message = await client.messages.create({
   max_tokens: 1024,
   messages: [{ role: 'user', content: 'Hello, Claude' }],
-  model: 'claude-3-5-sonnet-latest',
+  model: 'claude-sonnet-4-20250514',
 });
 console.log(message._request_id); // req_018EeWyXxfu5pfWkrYcMdjWG
 ```
@@ -290,7 +290,7 @@ const client = new Anthropic({
 });
 
 // Or, configure per-request:
-await client.messages.create({ max_tokens: 1024, messages: [{ role: 'user', content: 'Hello, Claude' }], model: 'claude-3-5-sonnet-latest' }, {
+await client.messages.create({ max_tokens: 1024, messages: [{ role: 'user', content: 'Hello, Claude' }], model: 'claude-sonnet-4-20250514' }, {
   maxRetries: 5,
 });
 ```
@@ -318,7 +318,7 @@ const client = new Anthropic({
 });
 
 // Override per-request:
-await client.messages.create({ max_tokens: 1024, messages: [{ role: 'user', content: 'Hello, Claude' }], model: 'claude-3-5-sonnet-latest' }, {
+await client.messages.create({ max_tokens: 1024, messages: [{ role: 'user', content: 'Hello, Claude' }], model: 'claude-sonnet-4-20250514' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -352,22 +352,22 @@ List methods in the Anthropic API are paginated.
 You can use the `for await … of` syntax to iterate through items across all pages:
 
 ```ts
-async function fetchAllBetaMessageBatches(params) {
-  const allBetaMessageBatches = [];
+async function fetchAllMessageBatches(params) {
+  const allMessageBatches = [];
   // Automatically fetches more pages as needed.
-  for await (const betaMessageBatch of client.beta.messages.batches.list({ limit: 20 })) {
-    allBetaMessageBatches.push(betaMessageBatch);
+  for await (const messageBatch of client.messages.batches.list({ limit: 20 })) {
+    allMessageBatches.push(messageBatch);
   }
-  return allBetaMessageBatches;
+  return allMessageBatches;
 }
 ```
 
 Alternatively, you can request a single page at a time:
 
 ```ts
-let page = await client.beta.messages.batches.list({ limit: 20 });
-for (const betaMessageBatch of page.data) {
-  console.log(betaMessageBatch);
+let page = await client.messages.batches.list({ limit: 20 });
+for (const messageBatch of page.data) {
+  console.log(messageBatch);
 }
 
 // Convenience methods are provided for manually paginating:
@@ -394,7 +394,7 @@ const message = await client.messages.create(
   {
     max_tokens: 1024,
     messages: [{ role: 'user', content: 'Hello, Claude' }],
-    model: 'claude-3-5-sonnet-latest',
+    model: 'claude-sonnet-4-20250514',
   },
   { headers: { 'anthropic-version': 'My-Custom-Value' } },
 );
@@ -418,7 +418,7 @@ const response = await client.messages
   .create({
     max_tokens: 1024,
     messages: [{ role: 'user', content: 'Hello, Claude' }],
-    model: 'claude-3-5-sonnet-latest',
+    model: 'claude-sonnet-4-20250514',
   })
   .asResponse();
 console.log(response.headers.get('X-My-Header'));
@@ -428,7 +428,7 @@ const { data: message, response: raw } = await client.messages
   .create({
     max_tokens: 1024,
     messages: [{ role: 'user', content: 'Hello, Claude' }],
-    model: 'claude-3-5-sonnet-latest',
+    model: 'claude-sonnet-4-20250514',
   })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));

api.md

@@ -191,6 +191,8 @@ 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">BetaCitationSearchResultLocation</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationSearchResultLocationParam</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>
@@ -241,6 +243,7 @@ Types:
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaRequestMCPServerToolConfiguration</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaRequestMCPServerURLDefinition</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaRequestMCPToolResultBlockParam</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaSearchResultBlockParam</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>

examples/batch-results.ts

@@ -10,7 +10,7 @@ async function main() {
 
   console.log(`fetching results for ${batch_id}`);
 
-  const results = await anthropic.beta.messages.batches.results(batch_id);
+  const results = await anthropic.messages.batches.results(batch_id);
 
   for await (const result of results) {
     console.log(result);

examples/cancellation.ts

@@ -16,7 +16,7 @@ async function main() {
   const question = 'Hey Claude! How can I recursively list all files in a directory in Rust?';
 
   const stream = await client.messages.create({
-    model: 'claude-3-5-sonnet-latest',
+    model: 'claude-sonnet-4-20250514',
     stream: true,
     max_tokens: 500,
     messages: [{ role: 'user', content: question }],

examples/count-tokens.ts

@@ -12,7 +12,7 @@ async function main() {
         content: 'Hey Claude!?',
       },
     ],
-    model: 'claude-3-5-sonnet-latest',
+    model: 'claude-sonnet-4-20250514',
   });
   console.dir(result);
 }

examples/demo.ts

@@ -12,7 +12,7 @@ async function main() {
         content: 'Hey Claude!?',
       },
     ],
-    model: 'claude-3-5-sonnet-latest',
+    model: 'claude-sonnet-4-20250514',
     max_tokens: 1024,
   });
   console.dir(result);

examples/mcp.ts

@@ -7,7 +7,7 @@ const anthropic = new Anthropic(); // gets API Key from environment variable ANT
 const main = async () => {
   const stream = anthropic.beta.messages.stream(
     {
-      model: 'claude-3-7-sonnet-20250219',
+      model: 'claude-sonnet-4-20250514',
       max_tokens: 1000,
       mcp_servers: [
         {