feat(api): add support for Search Result Content Blocks

Author: stainless-app[bot]

.stats.yml

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

api.md

@@ -241,6 +241,9 @@ 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">BetaSearchResultLocationCitation</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaSearchResultLocationCitationParam</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>

src/resources/beta/beta.ts

@@ -78,6 +78,9 @@ import {
   BetaRequestMCPServerToolConfiguration,
   BetaRequestMCPServerURLDefinition,
   BetaRequestMCPToolResultBlockParam,
+  BetaSearchResultBlockParam,
+  BetaSearchResultLocationCitation,
+  BetaSearchResultLocationCitationParam,
   BetaServerToolUsage,
   BetaServerToolUseBlock,
   BetaServerToolUseBlockParam,
@@ -315,6 +318,9 @@ export declare namespace Beta {
     type BetaRequestMCPServerToolConfiguration as BetaRequestMCPServerToolConfiguration,
     type BetaRequestMCPServerURLDefinition as BetaRequestMCPServerURLDefinition,
     type BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
+    type BetaSearchResultBlockParam as BetaSearchResultBlockParam,
+    type BetaSearchResultLocationCitation as BetaSearchResultLocationCitation,
+    type BetaSearchResultLocationCitationParam as BetaSearchResultLocationCitationParam,
     type BetaServerToolUsage as BetaServerToolUsage,
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,

src/resources/beta/index.ts

@@ -88,6 +88,9 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaSearchResultBlockParam,
+  type BetaSearchResultLocationCitation,
+  type BetaSearchResultLocationCitationParam,
   type BetaServerToolUsage,
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,

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',
    *         },
    *       },
    *     ],

src/resources/beta/messages/index.ts

@@ -81,6 +81,9 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaSearchResultBlockParam,
+  type BetaSearchResultLocationCitation,
+  type BetaSearchResultLocationCitationParam,
   type BetaServerToolUsage,
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,

src/resources/beta/messages/messages.ts

@@ -63,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',
    * });
    * ```
    */
@@ -299,7 +299,8 @@ export interface BetaCitationsDelta {
     | BetaCitationCharLocation
     | BetaCitationPageLocation
     | BetaCitationContentBlockLocation
-    | BetaCitationsWebSearchResultLocation;
+    | BetaCitationsWebSearchResultLocation
+    | BetaSearchResultLocationCitation;
 
   type: 'citations_delta';
 }
@@ -460,32 +461,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 {
@@ -646,6 +648,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.
@@ -768,15 +774,15 @@ export interface BetaRawContentBlockStartEvent {
    */
   content_block:
     | BetaTextBlock
+    | BetaThinkingBlock
+    | BetaRedactedThinkingBlock
     | BetaToolUseBlock
     | BetaServerToolUseBlock
     | BetaWebSearchToolResultBlock
     | BetaCodeExecutionToolResultBlock
     | BetaMCPToolUseBlock
     | BetaMCPToolResultBlock
-    | BetaContainerUploadBlock
-    | BetaThinkingBlock
-    | BetaRedactedThinkingBlock;
+    | BetaContainerUploadBlock;
 
   index: number;
 
@@ -913,6 +919,55 @@ 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 BetaSearchResultLocationCitation {
+  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 BetaSearchResultLocationCitationParam {
+  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 BetaServerToolUsage {
   /**
    * The number of web search tool requests.
@@ -991,13 +1046,15 @@ export type BetaTextCitation =
   | BetaCitationCharLocation
   | BetaCitationPageLocation
   | BetaCitationContentBlockLocation
-  | BetaCitationsWebSearchResultLocation;
+  | BetaCitationsWebSearchResultLocation
+  | BetaSearchResultLocationCitation;
 
 export type BetaTextCitationParam =
   | BetaCitationCharLocationParam
   | BetaCitationPageLocationParam
   | BetaCitationContentBlockLocationParam
-  | BetaCitationWebSearchResultLocationParam;
+  | BetaCitationWebSearchResultLocationParam
+  | BetaSearchResultLocationCitationParam;
 
 export interface BetaTextDelta {
   text: string;
@@ -1280,7 +1337,7 @@ export interface BetaToolResultBlockParam {
    */
   cache_control?: BetaCacheControlEphemeral | null;
 
-  content?: string | Array<BetaTextBlockParam | BetaImageBlockParam>;
+  content?: string | Array<BetaTextBlockParam | BetaImageBlockParam | BetaSearchResultBlockParam>;
 
   is_error?: boolean;
 }
@@ -1335,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;
@@ -1669,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>;
 
@@ -1774,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.
@@ -1985,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>;
 
@@ -2037,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.
@@ -2102,15 +2171,15 @@ export interface MessageCountTokensParams {
    */
   tools?: Array<
     | BetaTool
-    | BetaToolComputerUse20241022
     | BetaToolBash20241022
-    | BetaToolTextEditor20241022
-    | BetaToolComputerUse20250124
     | BetaToolBash20250124
+    | BetaCodeExecutionTool20250522
+    | BetaToolComputerUse20241022
+    | BetaToolComputerUse20250124
+    | BetaToolTextEditor20241022
     | BetaToolTextEditor20250124
     | BetaToolTextEditor20250429
     | BetaWebSearchTool20250305
-    | BetaCodeExecutionTool20250522
   >;
 
   /**
@@ -2183,6 +2252,9 @@ export declare namespace Messages {
     type BetaRequestMCPServerToolConfiguration as BetaRequestMCPServerToolConfiguration,
     type BetaRequestMCPServerURLDefinition as BetaRequestMCPServerURLDefinition,
     type BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
+    type BetaSearchResultBlockParam as BetaSearchResultBlockParam,
+    type BetaSearchResultLocationCitation as BetaSearchResultLocationCitation,
+    type BetaSearchResultLocationCitationParam as BetaSearchResultLocationCitationParam,
     type BetaServerToolUsage as BetaServerToolUsage,
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,

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',
    *       },
    *     },
    *   ],