@anthropic-ai/sdk 0.55.1 → 0.57.0

package/src/client.ts

@@ -172,6 +172,8 @@ export interface ClientOptions {
    *
    * Note that request timeouts are retried by default, so in a worst-case scenario you may wait
    * much longer than this timeout before the promise succeeds or fails.
+   *
+   * @unit milliseconds
    */
   timeout?: number | undefined;
   /**
@@ -309,7 +311,7 @@ export class BaseAnthropic {
    * Create a new client instance re-using the same options given to the current client with optional overriding.
    */
   withOptions(options: Partial<ClientOptions>): this {
-    return new (this.constructor as any as new (props: ClientOptions) => typeof this)({
+    const client = new (this.constructor as any as new (props: ClientOptions) => typeof this)({
       ...this._options,
       baseURL: this.baseURL,
       maxRetries: this.maxRetries,
@@ -322,6 +324,7 @@ export class BaseAnthropic {
       authToken: this.authToken,
       ...options,
     });
+    return client;
   }
 
   /**
@@ -355,18 +358,18 @@ export class BaseAnthropic {
     );
   }
 
-  protected authHeaders(opts: FinalRequestOptions): NullableHeaders | undefined {
-    return buildHeaders([this.apiKeyAuth(opts), this.bearerAuth(opts)]);
+  protected async authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
+    return buildHeaders([await this.apiKeyAuth(opts), await this.bearerAuth(opts)]);
   }
 
-  protected apiKeyAuth(opts: FinalRequestOptions): NullableHeaders | undefined {
+  protected async apiKeyAuth(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
     if (this.apiKey == null) {
       return undefined;
     }
     return buildHeaders([{ 'X-Api-Key': this.apiKey }]);
   }
 
-  protected bearerAuth(opts: FinalRequestOptions): NullableHeaders | undefined {
+  protected async bearerAuth(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
     if (this.authToken == null) {
       return undefined;
     }
@@ -513,7 +516,9 @@ export class BaseAnthropic {
 
     await this.prepareOptions(options);
 
-    const { req, url, timeout } = this.buildRequest(options, { retryCount: maxRetries - retriesRemaining });
+    const { req, url, timeout } = await this.buildRequest(options, {
+      retryCount: maxRetries - retriesRemaining,
+    });
 
     await this.prepareRequest(req, { url, options });
 
@@ -595,7 +600,7 @@ export class BaseAnthropic {
     } with status ${response.status} in ${headersTime - startTime}ms`;
 
     if (!response.ok) {
-      const shouldRetry = this.shouldRetry(response);
+      const shouldRetry = await this.shouldRetry(response);
       if (retriesRemaining && shouldRetry) {
         const retryMessage = `retrying, ${retriesRemaining} attempts remaining`;
 
@@ -713,7 +718,7 @@ export class BaseAnthropic {
     }
   }
 
-  private shouldRetry(response: Response): boolean {
+  private async shouldRetry(response: Response): Promise<boolean> {
     // Note this is not a standard header.
     const shouldRetryHeader = response.headers.get('x-should-retry');
 
@@ -804,10 +809,10 @@ export class BaseAnthropic {
     return defaultTime;
   }
 
-  buildRequest(
+  async buildRequest(
     inputOptions: FinalRequestOptions,
     { retryCount = 0 }: { retryCount?: number } = {},
-  ): { req: FinalizedRequestInit; url: string; timeout: number } {
+  ): Promise<{ req: FinalizedRequestInit; url: string; timeout: number }> {
     const options = { ...inputOptions };
     const { method, path, query, defaultBaseURL } = options;
 
@@ -815,7 +820,7 @@ export class BaseAnthropic {
     if ('timeout' in options) validatePositiveInteger('timeout', options.timeout);
     options.timeout = options.timeout ?? this.timeout;
     const { bodyHeaders, body } = this.buildBody({ options });
-    const reqHeaders = this.buildHeaders({ options: inputOptions, method, bodyHeaders, retryCount });
+    const reqHeaders = await this.buildHeaders({ options: inputOptions, method, bodyHeaders, retryCount });
 
     const req: FinalizedRequestInit = {
       method,
@@ -831,7 +836,7 @@ export class BaseAnthropic {
     return { req, url, timeout: options.timeout };
   }
 
-  private buildHeaders({
+  private async buildHeaders({
     options,
     method,
     bodyHeaders,
@@ -841,7 +846,7 @@ export class BaseAnthropic {
     method: HTTPMethod;
     bodyHeaders: HeadersLike;
     retryCount: number;
-  }): Headers {
+  }): Promise<Headers> {
     let idempotencyHeaders: HeadersLike = {};
     if (this.idempotencyHeader && method !== 'get') {
       if (!options.idempotencyKey) options.idempotencyKey = this.defaultIdempotencyKey();
@@ -861,7 +866,7 @@ export class BaseAnthropic {
         : undefined),
         'anthropic-version': '2023-06-01',
       },
-      this.authHeaders(options),
+      await this.authHeaders(options),
       this._options.defaultHeaders,
       bodyHeaders,
       options.headers,

package/src/core/streaming.ts

@@ -6,6 +6,8 @@ import { ReadableStreamToAsyncIterable } from '../internal/shims';
 import { isAbortError } from '../internal/errors';
 import { safeJSON } from '../internal/utils/values';
 import { encodeUTF8 } from '../internal/utils/bytes';
+import { loggerFor } from '../internal/utils/log';
+import type { BaseAnthropic } from '../client';
 
 import { APIError } from './error';
 
@@ -19,16 +21,24 @@ export type ServerSentEvent = {
 
 export class Stream<Item> implements AsyncIterable<Item> {
   controller: AbortController;
+  #client: BaseAnthropic | undefined;
 
   constructor(
     private iterator: () => AsyncIterator<Item>,
     controller: AbortController,
+    client?: BaseAnthropic,
   ) {
     this.controller = controller;
+    this.#client = client;
   }
 
-  static fromSSEResponse<Item>(response: Response, controller: AbortController): Stream<Item> {
+  static fromSSEResponse<Item>(
+    response: Response,
+    controller: AbortController,
+    client?: BaseAnthropic,
+  ): Stream<Item> {
     let consumed = false;
+    const logger = client ? loggerFor(client) : console;
 
     async function* iterator(): AsyncIterator<Item, any, undefined> {
       if (consumed) {
@@ -42,8 +52,8 @@ export class Stream<Item> implements AsyncIterable<Item> {
             try {
               yield JSON.parse(sse.data);
             } catch (e) {
-              console.error(`Could not parse message into JSON:`, sse.data);
-              console.error(`From chunk:`, sse.raw);
+              logger.error(`Could not parse message into JSON:`, sse.data);
+              logger.error(`From chunk:`, sse.raw);
               throw e;
             }
           }
@@ -59,8 +69,8 @@ export class Stream<Item> implements AsyncIterable<Item> {
             try {
               yield JSON.parse(sse.data);
             } catch (e) {
-              console.error(`Could not parse message into JSON:`, sse.data);
-              console.error(`From chunk:`, sse.raw);
+              logger.error(`Could not parse message into JSON:`, sse.data);
+              logger.error(`From chunk:`, sse.raw);
               throw e;
             }
           }
@@ -84,14 +94,18 @@ export class Stream<Item> implements AsyncIterable<Item> {
       }
     }
 
-    return new Stream(iterator, controller);
+    return new Stream(iterator, controller, client);
   }
 
   /**
    * Generates a Stream from a newline-separated ReadableStream
    * where each item is a JSON value.
    */
-  static fromReadableStream<Item>(readableStream: ReadableStream, controller: AbortController): Stream<Item> {
+  static fromReadableStream<Item>(
+    readableStream: ReadableStream,
+    controller: AbortController,
+    client?: BaseAnthropic,
+  ): Stream<Item> {
     let consumed = false;
 
     async function* iterLines(): AsyncGenerator<string, void, unknown> {
@@ -131,7 +145,7 @@ export class Stream<Item> implements AsyncIterable<Item> {
       }
     }
 
-    return new Stream(iterator, controller);
+    return new Stream(iterator, controller, client);
   }
 
   [Symbol.asyncIterator](): AsyncIterator<Item> {
@@ -161,8 +175,8 @@ export class Stream<Item> implements AsyncIterable<Item> {
     };
 
     return [
-      new Stream(() => teeIterator(left), this.controller),
-      new Stream(() => teeIterator(right), this.controller),
+      new Stream(() => teeIterator(left), this.controller, this.#client),
+      new Stream(() => teeIterator(right), this.controller, this.#client),
     ];
   }
 

package/src/internal/request-options.ts

@@ -10,17 +10,70 @@ import { type HeadersLike } from './headers';
 export type FinalRequestOptions = RequestOptions & { method: HTTPMethod; path: string };
 
 export type RequestOptions = {
+  /**
+   * The HTTP method for the request (e.g., 'get', 'post', 'put', 'delete').
+   */
   method?: HTTPMethod;
+
+  /**
+   * The URL path for the request.
+   *
+   * @example "/v1/foo"
+   */
   path?: string;
+
+  /**
+   * Query parameters to include in the request URL.
+   */
   query?: object | undefined | null;
+
+  /**
+   * The request body. Can be a string, JSON object, FormData, or other supported types.
+   */
   body?: unknown;
+
+  /**
+   * HTTP headers to include with the request. Can be a Headers object, plain object, or array of tuples.
+   */
   headers?: HeadersLike;
+
+  /**
+   * The maximum number of times that the client will retry a request in case of a
+   * temporary failure, like a network error or a 5XX error from the server.
+   *
+   * @default 2
+   */
   maxRetries?: number;
+
   stream?: boolean | undefined;
+
+  /**
+   * The maximum amount of time (in milliseconds) that the client should wait for a response
+   * from the server before timing out a single request.
+   *
+   * @unit milliseconds
+   */
   timeout?: number;
+
+  /**
+   * Additional `RequestInit` options to be passed to the underlying `fetch` call.
+   * These options will be merged with the client's default fetch options.
+   */
   fetchOptions?: MergedRequestInit;
+
+  /**
+   * An AbortSignal that can be used to cancel the request.
+   */
   signal?: AbortSignal | undefined | null;
+
+  /**
+   * A unique key for this request to enable idempotency.
+   */
   idempotencyKey?: string;
+
+  /**
+   * Override the default base URL for this specific request.
+   */
   defaultBaseURL?: string | undefined;
 
   __binaryResponse?: boolean | undefined;

package/src/resources/beta/beta.ts

@@ -28,6 +28,8 @@ import {
   BetaCitationContentBlockLocationParam,
   BetaCitationPageLocation,
   BetaCitationPageLocationParam,
+  BetaCitationSearchResultLocation,
+  BetaCitationSearchResultLocationParam,
   BetaCitationWebSearchResultLocationParam,
   BetaCitationsConfigParam,
   BetaCitationsDelta,
@@ -78,6 +80,7 @@ import {
   BetaRequestMCPServerToolConfiguration,
   BetaRequestMCPServerURLDefinition,
   BetaRequestMCPToolResultBlockParam,
+  BetaSearchResultBlockParam,
   BetaServerToolUsage,
   BetaServerToolUseBlock,
   BetaServerToolUseBlockParam,
@@ -265,6 +268,8 @@ export declare namespace Beta {
     type BetaCitationContentBlockLocationParam as BetaCitationContentBlockLocationParam,
     type BetaCitationPageLocation as BetaCitationPageLocation,
     type BetaCitationPageLocationParam as BetaCitationPageLocationParam,
+    type BetaCitationSearchResultLocation as BetaCitationSearchResultLocation,
+    type BetaCitationSearchResultLocationParam as BetaCitationSearchResultLocationParam,
     type BetaCitationWebSearchResultLocationParam as BetaCitationWebSearchResultLocationParam,
     type BetaCitationsConfigParam as BetaCitationsConfigParam,
     type BetaCitationsDelta as BetaCitationsDelta,
@@ -315,6 +320,7 @@ export declare namespace Beta {
     type BetaRequestMCPServerToolConfiguration as BetaRequestMCPServerToolConfiguration,
     type BetaRequestMCPServerURLDefinition as BetaRequestMCPServerURLDefinition,
     type BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
+    type BetaSearchResultBlockParam as BetaSearchResultBlockParam,
     type BetaServerToolUsage as BetaServerToolUsage,
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,

package/src/resources/beta/index.ts

@@ -38,6 +38,8 @@ export {
   type BetaCitationContentBlockLocationParam,
   type BetaCitationPageLocation,
   type BetaCitationPageLocationParam,
+  type BetaCitationSearchResultLocation,
+  type BetaCitationSearchResultLocationParam,
   type BetaCitationWebSearchResultLocationParam,
   type BetaCitationsConfigParam,
   type BetaCitationsDelta,
@@ -88,6 +90,7 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaSearchResultBlockParam,
   type BetaServerToolUsage,
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,

package/src/resources/beta/messages/batches.ts

@@ -34,7 +34,7 @@ export class Batches extends APIResource {
    *           messages: [
    *             { content: 'Hello, world', role: 'user' },
    *           ],
-   *           model: 'claude-3-7-sonnet-20250219',
+   *           model: 'claude-sonnet-4-20250514',
    *         },
    *       },
    *     ],

package/src/resources/beta/messages/index.ts

@@ -31,6 +31,8 @@ export {
   type BetaCitationContentBlockLocationParam,
   type BetaCitationPageLocation,
   type BetaCitationPageLocationParam,
+  type BetaCitationSearchResultLocation,
+  type BetaCitationSearchResultLocationParam,
   type BetaCitationWebSearchResultLocationParam,
   type BetaCitationsConfigParam,
   type BetaCitationsDelta,
@@ -81,6 +83,7 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaSearchResultBlockParam,
   type BetaServerToolUsage,
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,

package/src/resources/beta/messages/messages.ts

@@ -40,6 +40,7 @@ const DEPRECATED_MODELS: {
   'claude-instant-1.1-100k': 'November 6th, 2024',
   'claude-instant-1.2': 'November 6th, 2024',
   'claude-3-sonnet-20240229': 'July 21st, 2025',
+  'claude-3-opus-20240229': 'January 5th, 2026',
   'claude-2.1': 'July 21st, 2025',
   'claude-2.0': 'July 21st, 2025',
 };
@@ -62,7 +63,7 @@ export class Messages extends APIResource {
    * const betaMessage = await client.beta.messages.create({
    *   max_tokens: 1024,
    *   messages: [{ content: 'Hello, world', role: 'user' }],
-   *   model: 'claude-3-7-sonnet-20250219',
+   *   model: 'claude-sonnet-4-20250514',
    * });
    * ```
    */
@@ -277,6 +278,38 @@ export interface BetaCitationPageLocationParam {
   type: 'page_location';
 }
 
+export interface BetaCitationSearchResultLocation {
+  cited_text: string;
+
+  end_block_index: number;
+
+  search_result_index: number;
+
+  source: string;
+
+  start_block_index: number;
+
+  title: string | null;
+
+  type: 'search_result_location';
+}
+
+export interface BetaCitationSearchResultLocationParam {
+  cited_text: string;
+
+  end_block_index: number;
+
+  search_result_index: number;
+
+  source: string;
+
+  start_block_index: number;
+
+  title: string | null;
+
+  type: 'search_result_location';
+}
+
 export interface BetaCitationWebSearchResultLocationParam {
   cited_text: string;
 
@@ -298,7 +331,8 @@ export interface BetaCitationsDelta {
     | BetaCitationCharLocation
     | BetaCitationPageLocation
     | BetaCitationContentBlockLocation
-    | BetaCitationsWebSearchResultLocation;
+    | BetaCitationsWebSearchResultLocation
+    | BetaCitationSearchResultLocation;
 
   type: 'citations_delta';
 }
@@ -459,32 +493,33 @@ export interface BetaContainerUploadBlockParam {
  */
 export type BetaContentBlock =
   | BetaTextBlock
+  | BetaThinkingBlock
+  | BetaRedactedThinkingBlock
   | BetaToolUseBlock
   | BetaServerToolUseBlock
   | BetaWebSearchToolResultBlock
   | BetaCodeExecutionToolResultBlock
   | BetaMCPToolUseBlock
   | BetaMCPToolResultBlock
-  | BetaContainerUploadBlock
-  | BetaThinkingBlock
-  | BetaRedactedThinkingBlock;
+  | BetaContainerUploadBlock;
 
 /**
  * Regular text content.
  */
 export type BetaContentBlockParam =
-  | BetaServerToolUseBlockParam
-  | BetaWebSearchToolResultBlockParam
-  | BetaCodeExecutionToolResultBlockParam
-  | BetaMCPToolUseBlockParam
-  | BetaRequestMCPToolResultBlockParam
   | BetaTextBlockParam
   | BetaImageBlockParam
-  | BetaToolUseBlockParam
-  | BetaToolResultBlockParam
   | BetaRequestDocumentBlock
+  | BetaSearchResultBlockParam
   | BetaThinkingBlockParam
   | BetaRedactedThinkingBlockParam
+  | BetaToolUseBlockParam
+  | BetaToolResultBlockParam
+  | BetaServerToolUseBlockParam
+  | BetaWebSearchToolResultBlockParam
+  | BetaCodeExecutionToolResultBlockParam
+  | BetaMCPToolUseBlockParam
+  | BetaRequestMCPToolResultBlockParam
   | BetaContainerUploadBlockParam;
 
 export interface BetaContentBlockSource {
@@ -645,6 +680,10 @@ export interface BetaMessage {
    * - `"max_tokens"`: we exceeded the requested `max_tokens` or the model's maximum
    * - `"stop_sequence"`: one of your provided custom `stop_sequences` was generated
    * - `"tool_use"`: the model invoked one or more tools
+   * - `"pause_turn"`: we paused a long-running turn. You may provide the response
+   *   back as-is in a subsequent request to let the model continue.
+   * - `"refusal"`: when streaming classifiers intervene to handle potential policy
+   *   violations
    *
    * In non-streaming mode this value is always non-null. In streaming mode, it is
    * null in the `message_start` event and non-null otherwise.
@@ -767,15 +806,15 @@ export interface BetaRawContentBlockStartEvent {
    */
   content_block:
     | BetaTextBlock
+    | BetaThinkingBlock
+    | BetaRedactedThinkingBlock
     | BetaToolUseBlock
     | BetaServerToolUseBlock
     | BetaWebSearchToolResultBlock
     | BetaCodeExecutionToolResultBlock
     | BetaMCPToolUseBlock
     | BetaMCPToolResultBlock
-    | BetaContainerUploadBlock
-    | BetaThinkingBlock
-    | BetaRedactedThinkingBlock;
+    | BetaContainerUploadBlock;
 
   index: number;
 
@@ -912,6 +951,23 @@ export interface BetaRequestMCPToolResultBlockParam {
   is_error?: boolean;
 }
 
+export interface BetaSearchResultBlockParam {
+  content: Array<BetaTextBlockParam>;
+
+  source: string;
+
+  title: string;
+
+  type: 'search_result';
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  citations?: BetaCitationsConfigParam;
+}
+
 export interface BetaServerToolUsage {
   /**
    * The number of web search tool requests.
@@ -990,13 +1046,15 @@ export type BetaTextCitation =
   | BetaCitationCharLocation
   | BetaCitationPageLocation
   | BetaCitationContentBlockLocation
-  | BetaCitationsWebSearchResultLocation;
+  | BetaCitationsWebSearchResultLocation
+  | BetaCitationSearchResultLocation;
 
 export type BetaTextCitationParam =
   | BetaCitationCharLocationParam
   | BetaCitationPageLocationParam
   | BetaCitationContentBlockLocationParam
-  | BetaCitationWebSearchResultLocationParam;
+  | BetaCitationWebSearchResultLocationParam
+  | BetaCitationSearchResultLocationParam;
 
 export interface BetaTextDelta {
   text: string;
@@ -1279,7 +1337,7 @@ export interface BetaToolResultBlockParam {
    */
   cache_control?: BetaCacheControlEphemeral | null;
 
-  content?: string | Array<BetaTextBlockParam | BetaImageBlockParam>;
+  content?: string | Array<BetaTextBlockParam | BetaImageBlockParam | BetaSearchResultBlockParam>;
 
   is_error?: boolean;
 }
@@ -1334,15 +1392,15 @@ export interface BetaToolTextEditor20250429 {
 
 export type BetaToolUnion =
   | BetaTool
-  | BetaToolComputerUse20241022
   | BetaToolBash20241022
-  | BetaToolTextEditor20241022
-  | BetaToolComputerUse20250124
   | BetaToolBash20250124
+  | BetaCodeExecutionTool20250522
+  | BetaToolComputerUse20241022
+  | BetaToolComputerUse20250124
+  | BetaToolTextEditor20241022
   | BetaToolTextEditor20250124
   | BetaToolTextEditor20250429
-  | BetaWebSearchTool20250305
-  | BetaCodeExecutionTool20250522;
+  | BetaWebSearchTool20250305;
 
 export interface BetaToolUseBlock {
   id: string;
@@ -1668,7 +1726,7 @@ export interface MessageCreateParamsBase {
    * the top-level `system` parameter — there is no `"system"` role for input
    * messages in the Messages API.
    *
-   * There is a limit of 100000 messages in a single request.
+   * There is a limit of 100,000 messages in a single request.
    */
   messages: Array<BetaMessageParam>;
 
@@ -1773,6 +1831,12 @@ export interface MessageCreateParamsBase {
    * those tools using the tool input generated by the model and then optionally
    * return results back to the model using `tool_result` content blocks.
    *
+   * There are two types of tools: **client tools** and **server tools**. The
+   * behavior described below applies to client tools. For
+   * [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * see their individual documentation as each has its own behavior (e.g., the
+   * [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   *
    * Each tool definition includes:
    *
    * - `name`: Name of the tool.
@@ -1984,7 +2048,7 @@ export interface MessageCountTokensParams {
    * the top-level `system` parameter — there is no `"system"` role for input
    * messages in the Messages API.
    *
-   * There is a limit of 100000 messages in a single request.
+   * There is a limit of 100,000 messages in a single request.
    */
   messages: Array<BetaMessageParam>;
 
@@ -2036,6 +2100,12 @@ export interface MessageCountTokensParams {
    * those tools using the tool input generated by the model and then optionally
    * return results back to the model using `tool_result` content blocks.
    *
+   * There are two types of tools: **client tools** and **server tools**. The
+   * behavior described below applies to client tools. For
+   * [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * see their individual documentation as each has its own behavior (e.g., the
+   * [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   *
    * Each tool definition includes:
    *
    * - `name`: Name of the tool.
@@ -2101,15 +2171,15 @@ export interface MessageCountTokensParams {
    */
   tools?: Array<
     | BetaTool
-    | BetaToolComputerUse20241022
     | BetaToolBash20241022
-    | BetaToolTextEditor20241022
-    | BetaToolComputerUse20250124
     | BetaToolBash20250124
+    | BetaCodeExecutionTool20250522
+    | BetaToolComputerUse20241022
+    | BetaToolComputerUse20250124
+    | BetaToolTextEditor20241022
     | BetaToolTextEditor20250124
     | BetaToolTextEditor20250429
     | BetaWebSearchTool20250305
-    | BetaCodeExecutionTool20250522
   >;
 
   /**
@@ -2132,6 +2202,8 @@ export declare namespace Messages {
     type BetaCitationContentBlockLocationParam as BetaCitationContentBlockLocationParam,
     type BetaCitationPageLocation as BetaCitationPageLocation,
     type BetaCitationPageLocationParam as BetaCitationPageLocationParam,
+    type BetaCitationSearchResultLocation as BetaCitationSearchResultLocation,
+    type BetaCitationSearchResultLocationParam as BetaCitationSearchResultLocationParam,
     type BetaCitationWebSearchResultLocationParam as BetaCitationWebSearchResultLocationParam,
     type BetaCitationsConfigParam as BetaCitationsConfigParam,
     type BetaCitationsDelta as BetaCitationsDelta,
@@ -2182,6 +2254,7 @@ export declare namespace Messages {
     type BetaRequestMCPServerToolConfiguration as BetaRequestMCPServerToolConfiguration,
     type BetaRequestMCPServerURLDefinition as BetaRequestMCPServerURLDefinition,
     type BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
+    type BetaSearchResultBlockParam as BetaSearchResultBlockParam,
     type BetaServerToolUsage as BetaServerToolUsage,
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,

package/src/resources/messages/batches.ts

@@ -33,7 +33,7 @@ export class Batches extends APIResource {
    *         messages: [
    *           { content: 'Hello, world', role: 'user' },
    *         ],
-   *         model: 'claude-3-7-sonnet-20250219',
+   *         model: 'claude-sonnet-4-20250514',
    *       },
    *     },
    *   ],