@anthropic-ai/sdk 0.40.0 → 0.41.0

package/resources/models.js

@@ -6,20 +6,32 @@ const resource_1 = require("../resource.js");
 const core_1 = require("../core.js");
 const pagination_1 = require("../pagination.js");
 class Models extends resource_1.APIResource {
-    /**
-     * Get a specific model.
-     *
-     * The Models API response can be used to determine information about a specific
-     * model or resolve a model alias to a model ID.
-     */
-    retrieve(modelId, options) {
-        return this._client.get(`/v1/models/${modelId}`, options);
+    retrieve(modelId, params = {}, options) {
+        if ((0, core_1.isRequestOptions)(params)) {
+            return this.retrieve(modelId, {}, params);
+        }
+        const { betas } = params;
+        return this._client.get(`/v1/models/${modelId}`, {
+            ...options,
+            headers: {
+                ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
+                ...options?.headers,
+            },
+        });
     }
-    list(query = {}, options) {
-        if ((0, core_1.isRequestOptions)(query)) {
-            return this.list({}, query);
+    list(params = {}, options) {
+        if ((0, core_1.isRequestOptions)(params)) {
+            return this.list({}, params);
         }
-        return this._client.getAPIList('/v1/models', ModelInfosPage, { query, ...options });
+        const { betas, ...query } = params;
+        return this._client.getAPIList('/v1/models', ModelInfosPage, {
+            query,
+            ...options,
+            headers: {
+                ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
+                ...options?.headers,
+            },
+        });
     }
 }
 exports.Models = Models;

package/resources/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6CAA0C;AAC1C,qCAA2C;AAE3C,iDAAsD;AAEtD,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,OAAe,EAAE,OAA6B;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAUD,IAAI,CACF,QAA+C,EAAE,EACjD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;CACF;AA5BD,wBA4BC;AAED,MAAa,cAAe,SAAQ,iBAAe;CAAG;AAAtD,wCAAsD;AA6BtD,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6CAA0C;AAC1C,qCAA2C;AAG3C,iDAAsD;AAEtD,MAAa,MAAO,SAAQ,sBAAW;IAarC,QAAQ,CACN,OAAe,EACf,SAAoD,EAAE,EACtD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,MAAM,CAAC,EAAE;YAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;SAC3C;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,EAAE;YAC/C,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;IACL,CAAC;IAUD,IAAI,CACF,SAAgD,EAAE,EAClD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,MAAM,CAAC,EAAE;YAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;SAC9B;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE;YAC3D,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAxDD,wBAwDC;AAED,MAAa,cAAe,SAAQ,iBAAe;CAAG;AAAtD,wCAAsD;AAyCtD,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC"}

package/resources/models.mjs

@@ -3,20 +3,32 @@ import { APIResource } from "../resource.mjs";
 import { isRequestOptions } from "../core.mjs";
 import { Page } from "../pagination.mjs";
 export class Models extends APIResource {
-    /**
-     * Get a specific model.
-     *
-     * The Models API response can be used to determine information about a specific
-     * model or resolve a model alias to a model ID.
-     */
-    retrieve(modelId, options) {
-        return this._client.get(`/v1/models/${modelId}`, options);
+    retrieve(modelId, params = {}, options) {
+        if (isRequestOptions(params)) {
+            return this.retrieve(modelId, {}, params);
+        }
+        const { betas } = params;
+        return this._client.get(`/v1/models/${modelId}`, {
+            ...options,
+            headers: {
+                ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
+                ...options?.headers,
+            },
+        });
     }
-    list(query = {}, options) {
-        if (isRequestOptions(query)) {
-            return this.list({}, query);
+    list(params = {}, options) {
+        if (isRequestOptions(params)) {
+            return this.list({}, params);
         }
-        return this._client.getAPIList('/v1/models', ModelInfosPage, { query, ...options });
+        const { betas, ...query } = params;
+        return this._client.getAPIList('/v1/models', ModelInfosPage, {
+            query,
+            ...options,
+            headers: {
+                ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
+                ...options?.headers,
+            },
+        });
     }
 }
 export class ModelInfosPage extends Page {

package/resources/models.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"models.mjs","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAEpB,EAAE,IAAI,EAAmB;AAEhC,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,OAAe,EAAE,OAA6B;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAUD,IAAI,CACF,QAA+C,EAAE,EACjD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,IAAe;CAAG;AA6BtD,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC"}
+{"version":3,"file":"models.mjs","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAGpB,EAAE,IAAI,EAAmB;AAEhC,MAAM,OAAO,MAAO,SAAQ,WAAW;IAarC,QAAQ,CACN,OAAe,EACf,SAAoD,EAAE,EACtD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE;YAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;SAC3C;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,EAAE;YAC/C,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;IACL,CAAC;IAUD,IAAI,CACF,SAAgD,EAAE,EAClD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE;YAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;SAC9B;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE;YAC3D,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,IAAe;CAAG;AAyCtD,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC"}

package/src/index.ts

@@ -14,7 +14,7 @@ import {
   CompletionCreateParamsStreaming,
   Completions,
 } from "./resources/completions.js";
-import { ModelInfo, ModelInfosPage, ModelListParams, Models } from "./resources/models.js";
+import { ModelInfo, ModelInfosPage, ModelListParams, ModelRetrieveParams, Models } from "./resources/models.js";
 import {
   AnthropicBeta,
   Beta,
@@ -40,8 +40,10 @@ import {
   CitationContentBlockLocationParam,
   CitationPageLocation,
   CitationPageLocationParam,
+  CitationWebSearchResultLocationParam,
   CitationsConfigParam,
   CitationsDelta,
+  CitationsWebSearchResultLocation,
   ContentBlock,
   ContentBlockDeltaEvent,
   ContentBlockParam,
@@ -80,6 +82,9 @@ import {
   RawMessageStreamEvent,
   RedactedThinkingBlock,
   RedactedThinkingBlockParam,
+  ServerToolUsage,
+  ServerToolUseBlock,
+  ServerToolUseBlockParam,
   SignatureDelta,
   StopReason,
   TextBlock,
@@ -108,6 +113,15 @@ import {
   URLImageSource,
   URLPDFSource,
   Usage,
+  WebSearchResultBlock,
+  WebSearchResultBlockParam,
+  WebSearchTool20250305,
+  WebSearchToolRequestError,
+  WebSearchToolResultBlock,
+  WebSearchToolResultBlockContent,
+  WebSearchToolResultBlockParam,
+  WebSearchToolResultBlockParamContent,
+  WebSearchToolResultError,
 } from "./resources/messages/messages.js";
 
 export interface ClientOptions {
@@ -354,8 +368,10 @@ export declare namespace Anthropic {
     type CitationContentBlockLocationParam as CitationContentBlockLocationParam,
     type CitationPageLocation as CitationPageLocation,
     type CitationPageLocationParam as CitationPageLocationParam,
+    type CitationWebSearchResultLocationParam as CitationWebSearchResultLocationParam,
     type CitationsConfigParam as CitationsConfigParam,
     type CitationsDelta as CitationsDelta,
+    type CitationsWebSearchResultLocation as CitationsWebSearchResultLocation,
     type ContentBlock as ContentBlock,
     type ContentBlockParam as ContentBlockParam,
     type ContentBlockSource as ContentBlockSource,
@@ -381,6 +397,9 @@ export declare namespace Anthropic {
     type RawMessageStreamEvent as RawMessageStreamEvent,
     type RedactedThinkingBlock as RedactedThinkingBlock,
     type RedactedThinkingBlockParam as RedactedThinkingBlockParam,
+    type ServerToolUsage as ServerToolUsage,
+    type ServerToolUseBlock as ServerToolUseBlock,
+    type ServerToolUseBlockParam as ServerToolUseBlockParam,
     type SignatureDelta as SignatureDelta,
     type StopReason as StopReason,
     type TextBlock as TextBlock,
@@ -409,6 +428,15 @@ export declare namespace Anthropic {
     type URLImageSource as URLImageSource,
     type URLPDFSource as URLPDFSource,
     type Usage as Usage,
+    type WebSearchResultBlock as WebSearchResultBlock,
+    type WebSearchResultBlockParam as WebSearchResultBlockParam,
+    type WebSearchTool20250305 as WebSearchTool20250305,
+    type WebSearchToolRequestError as WebSearchToolRequestError,
+    type WebSearchToolResultBlock as WebSearchToolResultBlock,
+    type WebSearchToolResultBlockContent as WebSearchToolResultBlockContent,
+    type WebSearchToolResultBlockParam as WebSearchToolResultBlockParam,
+    type WebSearchToolResultBlockParamContent as WebSearchToolResultBlockParamContent,
+    type WebSearchToolResultError as WebSearchToolResultError,
     type MessageStreamEvent as MessageStreamEvent,
     type MessageStartEvent as MessageStartEvent,
     type MessageDeltaEvent as MessageDeltaEvent,
@@ -427,6 +455,7 @@ export declare namespace Anthropic {
     Models as Models,
     type ModelInfo as ModelInfo,
     ModelInfosPage as ModelInfosPage,
+    type ModelRetrieveParams as ModelRetrieveParams,
     type ModelListParams as ModelListParams,
   };
 

package/src/lib/BetaMessageStream.ts

@@ -530,6 +530,15 @@ export class BetaMessageStream implements AsyncIterable<BetaMessageStreamEvent>
         snapshot.stop_reason = event.delta.stop_reason;
         snapshot.stop_sequence = event.delta.stop_sequence;
         snapshot.usage.output_tokens = event.usage.output_tokens;
+
+        // Update other usage fields if they exist in the event
+        if (event.usage.input_tokens) {
+          snapshot.usage.input_tokens = event.usage.input_tokens;
+        }
+        snapshot.usage.cache_creation_input_tokens = event.usage.cache_creation_input_tokens;
+        snapshot.usage.cache_read_input_tokens = event.usage.cache_read_input_tokens;
+        snapshot.usage.server_tool_use = event.usage.server_tool_use;
+
         return snapshot;
       case 'content_block_start':
         snapshot.content.push(event.content_block);

package/src/lib/MessageStream.ts

@@ -530,6 +530,15 @@ export class MessageStream implements AsyncIterable<MessageStreamEvent> {
         snapshot.stop_reason = event.delta.stop_reason;
         snapshot.stop_sequence = event.delta.stop_sequence;
         snapshot.usage.output_tokens = event.usage.output_tokens;
+
+        // Update other usage fields if they exist in the event
+        if (event.usage.input_tokens) {
+          snapshot.usage.input_tokens = event.usage.input_tokens;
+        }
+        snapshot.usage.cache_creation_input_tokens = event.usage.cache_creation_input_tokens;
+        snapshot.usage.cache_read_input_tokens = event.usage.cache_read_input_tokens;
+        snapshot.usage.server_tool_use = event.usage.server_tool_use;
+
         return snapshot;
       case 'content_block_start':
         snapshot.content.push(event.content_block);

package/src/resources/beta/beta.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from "../../resource.js";
 import * as ModelsAPI from "./models.js";
-import { BetaModelInfo, BetaModelInfosPage, ModelListParams, Models } from "./models.js";
+import { BetaModelInfo, BetaModelInfosPage, ModelListParams, ModelRetrieveParams, Models } from "./models.js";
 import * as MessagesAPI from "./messages/messages.js";
 import {
   BetaBase64ImageSource,
@@ -15,8 +15,10 @@ import {
   BetaCitationContentBlockLocationParam,
   BetaCitationPageLocation,
   BetaCitationPageLocationParam,
+  BetaCitationWebSearchResultLocationParam,
   BetaCitationsConfigParam,
   BetaCitationsDelta,
+  BetaCitationsWebSearchResultLocation,
   BetaContentBlock,
   BetaContentBlockParam,
   BetaContentBlockSource,
@@ -39,6 +41,9 @@ import {
   BetaRawMessageStreamEvent,
   BetaRedactedThinkingBlock,
   BetaRedactedThinkingBlockParam,
+  BetaServerToolUsage,
+  BetaServerToolUseBlock,
+  BetaServerToolUseBlockParam,
   BetaSignatureDelta,
   BetaStopReason,
   BetaTextBlock,
@@ -71,6 +76,15 @@ import {
   BetaURLImageSource,
   BetaURLPDFSource,
   BetaUsage,
+  BetaWebSearchResultBlock,
+  BetaWebSearchResultBlockParam,
+  BetaWebSearchTool20250305,
+  BetaWebSearchToolRequestError,
+  BetaWebSearchToolResultBlock,
+  BetaWebSearchToolResultBlockContent,
+  BetaWebSearchToolResultBlockParam,
+  BetaWebSearchToolResultBlockParamContent,
+  BetaWebSearchToolResultError,
   MessageCountTokensParams,
   MessageCreateParams,
   MessageCreateParamsNonStreaming,
@@ -189,6 +203,7 @@ export declare namespace Beta {
     Models as Models,
     type BetaModelInfo as BetaModelInfo,
     BetaModelInfosPage as BetaModelInfosPage,
+    type ModelRetrieveParams as ModelRetrieveParams,
     type ModelListParams as ModelListParams,
   };
 
@@ -204,8 +219,10 @@ export declare namespace Beta {
     type BetaCitationContentBlockLocationParam as BetaCitationContentBlockLocationParam,
     type BetaCitationPageLocation as BetaCitationPageLocation,
     type BetaCitationPageLocationParam as BetaCitationPageLocationParam,
+    type BetaCitationWebSearchResultLocationParam as BetaCitationWebSearchResultLocationParam,
     type BetaCitationsConfigParam as BetaCitationsConfigParam,
     type BetaCitationsDelta as BetaCitationsDelta,
+    type BetaCitationsWebSearchResultLocation as BetaCitationsWebSearchResultLocation,
     type BetaContentBlock as BetaContentBlock,
     type BetaContentBlockParam as BetaContentBlockParam,
     type BetaContentBlockSource as BetaContentBlockSource,
@@ -228,6 +245,9 @@ export declare namespace Beta {
     type BetaRawMessageStreamEvent as BetaRawMessageStreamEvent,
     type BetaRedactedThinkingBlock as BetaRedactedThinkingBlock,
     type BetaRedactedThinkingBlockParam as BetaRedactedThinkingBlockParam,
+    type BetaServerToolUsage as BetaServerToolUsage,
+    type BetaServerToolUseBlock as BetaServerToolUseBlock,
+    type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,
     type BetaSignatureDelta as BetaSignatureDelta,
     type BetaStopReason as BetaStopReason,
     type BetaTextBlock as BetaTextBlock,
@@ -260,6 +280,15 @@ export declare namespace Beta {
     type BetaURLImageSource as BetaURLImageSource,
     type BetaURLPDFSource as BetaURLPDFSource,
     type BetaUsage as BetaUsage,
+    type BetaWebSearchResultBlock as BetaWebSearchResultBlock,
+    type BetaWebSearchResultBlockParam as BetaWebSearchResultBlockParam,
+    type BetaWebSearchTool20250305 as BetaWebSearchTool20250305,
+    type BetaWebSearchToolRequestError as BetaWebSearchToolRequestError,
+    type BetaWebSearchToolResultBlock as BetaWebSearchToolResultBlock,
+    type BetaWebSearchToolResultBlockContent as BetaWebSearchToolResultBlockContent,
+    type BetaWebSearchToolResultBlockParam as BetaWebSearchToolResultBlockParam,
+    type BetaWebSearchToolResultBlockParamContent as BetaWebSearchToolResultBlockParamContent,
+    type BetaWebSearchToolResultError as BetaWebSearchToolResultError,
     type MessageCreateParams as MessageCreateParams,
     type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
     type MessageCreateParamsStreaming as MessageCreateParamsStreaming,

package/src/resources/beta/index.ts

@@ -15,7 +15,13 @@ export {
   type BetaPermissionError,
   type BetaRateLimitError,
 } from "./beta.js";
-export { BetaModelInfosPage, Models, type BetaModelInfo, type ModelListParams } from "./models.js";
+export {
+  BetaModelInfosPage,
+  Models,
+  type BetaModelInfo,
+  type ModelRetrieveParams,
+  type ModelListParams,
+} from "./models.js";
 export {
   Messages,
   type BetaBase64ImageSource,
@@ -28,8 +34,10 @@ export {
   type BetaCitationContentBlockLocationParam,
   type BetaCitationPageLocation,
   type BetaCitationPageLocationParam,
+  type BetaCitationWebSearchResultLocationParam,
   type BetaCitationsConfigParam,
   type BetaCitationsDelta,
+  type BetaCitationsWebSearchResultLocation,
   type BetaContentBlock,
   type BetaContentBlockParam,
   type BetaContentBlockSource,
@@ -52,6 +60,9 @@ export {
   type BetaRawMessageStreamEvent,
   type BetaRedactedThinkingBlock,
   type BetaRedactedThinkingBlockParam,
+  type BetaServerToolUsage,
+  type BetaServerToolUseBlock,
+  type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
   type BetaStopReason,
   type BetaTextBlock,
@@ -84,6 +95,15 @@ export {
   type BetaURLImageSource,
   type BetaURLPDFSource,
   type BetaUsage,
+  type BetaWebSearchResultBlock,
+  type BetaWebSearchResultBlockParam,
+  type BetaWebSearchTool20250305,
+  type BetaWebSearchToolRequestError,
+  type BetaWebSearchToolResultBlock,
+  type BetaWebSearchToolResultBlockContent,
+  type BetaWebSearchToolResultBlockParam,
+  type BetaWebSearchToolResultBlockParamContent,
+  type BetaWebSearchToolResultError,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,

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

@@ -20,6 +20,25 @@ export class Batches extends APIResource {
    *
    * Learn more about the Message Batches API in our
    * [user guide](/en/docs/build-with-claude/batch-processing)
+   *
+   * @example
+   * ```ts
+   * const betaMessageBatch =
+   *   await client.beta.messages.batches.create({
+   *     requests: [
+   *       {
+   *         custom_id: 'my-custom-id-1',
+   *         params: {
+   *           max_tokens: 1024,
+   *           messages: [
+   *             { content: 'Hello, world', role: 'user' },
+   *           ],
+   *           model: 'claude-3-7-sonnet-20250219',
+   *         },
+   *       },
+   *     ],
+   *   });
+   * ```
    */
   create(params: BatchCreateParams, options?: Core.RequestOptions): Core.APIPromise<BetaMessageBatch> {
     const { betas, ...body } = params;
@@ -40,6 +59,14 @@ export class Batches extends APIResource {
    *
    * Learn more about the Message Batches API in our
    * [user guide](/en/docs/build-with-claude/batch-processing)
+   *
+   * @example
+   * ```ts
+   * const betaMessageBatch =
+   *   await client.beta.messages.batches.retrieve(
+   *     'message_batch_id',
+   *   );
+   * ```
    */
   retrieve(
     messageBatchId: string,
@@ -71,6 +98,14 @@ export class Batches extends APIResource {
    *
    * Learn more about the Message Batches API in our
    * [user guide](/en/docs/build-with-claude/batch-processing)
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const betaMessageBatch of client.beta.messages.batches.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     params?: BatchListParams,
@@ -103,6 +138,14 @@ export class Batches extends APIResource {
    *
    * Learn more about the Message Batches API in our
    * [user guide](/en/docs/build-with-claude/batch-processing)
+   *
+   * @example
+   * ```ts
+   * const betaDeletedMessageBatch =
+   *   await client.beta.messages.batches.delete(
+   *     'message_batch_id',
+   *   );
+   * ```
    */
   delete(
     messageBatchId: string,
@@ -141,6 +184,14 @@ export class Batches extends APIResource {
    *
    * Learn more about the Message Batches API in our
    * [user guide](/en/docs/build-with-claude/batch-processing)
+   *
+   * @example
+   * ```ts
+   * const betaMessageBatch =
+   *   await client.beta.messages.batches.cancel(
+   *     'message_batch_id',
+   *   );
+   * ```
    */
   cancel(
     messageBatchId: string,
@@ -175,6 +226,14 @@ export class Batches extends APIResource {
    *
    * Learn more about the Message Batches API in our
    * [user guide](/en/docs/build-with-claude/batch-processing)
+   *
+   * @example
+   * ```ts
+   * const betaMessageBatchIndividualResponse =
+   *   await client.beta.messages.batches.results(
+   *     'message_batch_id',
+   *   );
+   * ```
    */
   async results(
     messageBatchId: string,

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

@@ -31,8 +31,10 @@ export {
   type BetaCitationContentBlockLocationParam,
   type BetaCitationPageLocation,
   type BetaCitationPageLocationParam,
+  type BetaCitationWebSearchResultLocationParam,
   type BetaCitationsConfigParam,
   type BetaCitationsDelta,
+  type BetaCitationsWebSearchResultLocation,
   type BetaContentBlock,
   type BetaContentBlockParam,
   type BetaContentBlockSource,
@@ -55,6 +57,9 @@ export {
   type BetaRawMessageStreamEvent,
   type BetaRedactedThinkingBlock,
   type BetaRedactedThinkingBlockParam,
+  type BetaServerToolUsage,
+  type BetaServerToolUseBlock,
+  type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
   type BetaStopReason,
   type BetaTextBlock,
@@ -87,6 +92,15 @@ export {
   type BetaURLImageSource,
   type BetaURLPDFSource,
   type BetaUsage,
+  type BetaWebSearchResultBlock,
+  type BetaWebSearchResultBlockParam,
+  type BetaWebSearchTool20250305,
+  type BetaWebSearchToolRequestError,
+  type BetaWebSearchToolResultBlock,
+  type BetaWebSearchToolResultBlockContent,
+  type BetaWebSearchToolResultBlockParam,
+  type BetaWebSearchToolResultBlockParamContent,
+  type BetaWebSearchToolResultError,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,