@anthropic-ai/sdk 0.40.1 → 0.50.1

package/src/resources/beta/beta.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from "../../resource.js";
-import * as ModelsAPI from "./models.js";
-import { BetaModelInfo, BetaModelInfosPage, ModelListParams, Models } from "./models.js";
-import * as MessagesAPI from "./messages/messages.js";
+import { APIResource } from '../../core/resource';
+import * as ModelsAPI from './models';
+import { BetaModelInfo, BetaModelInfosPage, ModelListParams, ModelRetrieveParams, Models } from './models';
+import * as MessagesAPI from './messages/messages';
 import {
   BetaBase64ImageSource,
   BetaBase64PDFBlock,
@@ -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,12 +76,21 @@ import {
   BetaURLImageSource,
   BetaURLPDFSource,
   BetaUsage,
+  BetaWebSearchResultBlock,
+  BetaWebSearchResultBlockParam,
+  BetaWebSearchTool20250305,
+  BetaWebSearchToolRequestError,
+  BetaWebSearchToolResultBlock,
+  BetaWebSearchToolResultBlockContent,
+  BetaWebSearchToolResultBlockParam,
+  BetaWebSearchToolResultBlockParamContent,
+  BetaWebSearchToolResultError,
   MessageCountTokensParams,
   MessageCreateParams,
   MessageCreateParamsNonStreaming,
   MessageCreateParamsStreaming,
   Messages,
-} from "./messages/messages.js";
+} from './messages/messages';
 
 export class Beta extends APIResource {
   models: ModelsAPI.Models = new ModelsAPI.Models(this._client);
@@ -166,7 +180,6 @@ export interface BetaRateLimitError {
 }
 
 Beta.Models = Models;
-Beta.BetaModelInfosPage = BetaModelInfosPage;
 Beta.Messages = Messages;
 
 export declare namespace Beta {
@@ -188,7 +201,8 @@ export declare namespace Beta {
   export {
     Models as Models,
     type BetaModelInfo as BetaModelInfo,
-    BetaModelInfosPage as BetaModelInfosPage,
+    type BetaModelInfosPage as BetaModelInfosPage,
+    type ModelRetrieveParams as ModelRetrieveParams,
     type ModelListParams as ModelListParams,
   };
 
@@ -204,8 +218,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 +244,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 +279,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

@@ -14,8 +14,7 @@ export {
   type BetaOverloadedError,
   type BetaPermissionError,
   type BetaRateLimitError,
-} from "./beta.js";
-export { BetaModelInfosPage, Models, type BetaModelInfo, type ModelListParams } from "./models.js";
+} from './beta';
 export {
   Messages,
   type BetaBase64ImageSource,
@@ -28,8 +27,10 @@ export {
   type BetaCitationContentBlockLocationParam,
   type BetaCitationPageLocation,
   type BetaCitationPageLocationParam,
+  type BetaCitationWebSearchResultLocationParam,
   type BetaCitationsConfigParam,
   type BetaCitationsDelta,
+  type BetaCitationsWebSearchResultLocation,
   type BetaContentBlock,
   type BetaContentBlockParam,
   type BetaContentBlockSource,
@@ -52,6 +53,9 @@ export {
   type BetaRawMessageStreamEvent,
   type BetaRedactedThinkingBlock,
   type BetaRedactedThinkingBlockParam,
+  type BetaServerToolUsage,
+  type BetaServerToolUseBlock,
+  type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
   type BetaStopReason,
   type BetaTextBlock,
@@ -84,8 +88,24 @@ 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,
   type MessageCountTokensParams,
-} from "./messages/index.js";
+} from './messages/index';
+export {
+  Models,
+  type BetaModelInfo,
+  type ModelRetrieveParams,
+  type ModelListParams,
+  type BetaModelInfosPage,
+} from './models';

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

@@ -1,14 +1,15 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from "../../../resource.js";
-import { isRequestOptions } from "../../../core.js";
-import { APIPromise } from "../../../core.js";
-import * as Core from "../../../core.js";
-import * as BetaAPI from "../beta.js";
-import * as BetaMessagesAPI from "./messages.js";
-import { Page, type PageParams } from "../../../pagination.js";
-import { JSONLDecoder } from "../../../internal/decoders/jsonl.js";
-import { AnthropicError } from "../../../error.js";
+import { APIResource } from '../../../core/resource';
+import * as BetaAPI from '../beta';
+import { APIPromise } from '../../../core/api-promise';
+import * as BetaMessagesAPI from './messages';
+import { Page, type PageParams, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { JSONLDecoder } from '../../../internal/decoders/jsonl';
+import { AnthropicError } from '../../../error';
+import { path } from '../../../internal/utils/path';
 
 export class Batches extends APIResource {
   /**
@@ -20,16 +21,35 @@ export class Batches extends APIResource {
    *
    * Learn more about the Message Batches API in our
    * [user guide](/en/docs/build-with-claude/batch-processing)
-   */
-  create(params: BatchCreateParams, options?: Core.RequestOptions): Core.APIPromise<BetaMessageBatch> {
+   *
+   * @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?: RequestOptions): APIPromise<BetaMessageBatch> {
     const { betas, ...body } = params;
     return this._client.post('/v1/messages/batches?beta=true', {
       body,
       ...options,
-      headers: {
-        'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
-        ...options?.headers,
-      },
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
+        options?.headers,
+      ]),
     });
   }
 
@@ -40,28 +60,27 @@ 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,
-    params?: BatchRetrieveParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<BetaMessageBatch>;
-  retrieve(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<BetaMessageBatch>;
-  retrieve(
-    messageBatchId: string,
-    params: BatchRetrieveParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<BetaMessageBatch> {
-    if (isRequestOptions(params)) {
-      return this.retrieve(messageBatchId, {}, params);
-    }
-    const { betas } = params;
-    return this._client.get(`/v1/messages/batches/${messageBatchId}?beta=true`, {
+    messageBatchID: string,
+    params: BatchRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaMessageBatch> {
+    const { betas } = params ?? {};
+    return this._client.get(path`/v1/messages/batches/${messageBatchID}?beta=true`, {
       ...options,
-      headers: {
-        'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
-        ...options?.headers,
-      },
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
+        options?.headers,
+      ]),
     });
   }
 
@@ -71,27 +90,27 @@ 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,
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<BetaMessageBatchesPage, BetaMessageBatch>;
-  list(options?: Core.RequestOptions): Core.PagePromise<BetaMessageBatchesPage, BetaMessageBatch>;
-  list(
-    params: BatchListParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<BetaMessageBatchesPage, BetaMessageBatch> {
-    if (isRequestOptions(params)) {
-      return this.list({}, params);
-    }
-    const { betas, ...query } = params;
-    return this._client.getAPIList('/v1/messages/batches?beta=true', BetaMessageBatchesPage, {
+    params: BatchListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BetaMessageBatchesPage, BetaMessageBatch> {
+    const { betas, ...query } = params ?? {};
+    return this._client.getAPIList('/v1/messages/batches?beta=true', Page<BetaMessageBatch>, {
       query,
       ...options,
-      headers: {
-        'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
-        ...options?.headers,
-      },
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
+        options?.headers,
+      ]),
     });
   }
 
@@ -103,28 +122,27 @@ 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,
-    params?: BatchDeleteParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<BetaDeletedMessageBatch>;
-  delete(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<BetaDeletedMessageBatch>;
-  delete(
-    messageBatchId: string,
-    params: BatchDeleteParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<BetaDeletedMessageBatch> {
-    if (isRequestOptions(params)) {
-      return this.delete(messageBatchId, {}, params);
-    }
-    const { betas } = params;
-    return this._client.delete(`/v1/messages/batches/${messageBatchId}?beta=true`, {
+    messageBatchID: string,
+    params: BatchDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaDeletedMessageBatch> {
+    const { betas } = params ?? {};
+    return this._client.delete(path`/v1/messages/batches/${messageBatchID}?beta=true`, {
       ...options,
-      headers: {
-        'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
-        ...options?.headers,
-      },
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
+        options?.headers,
+      ]),
     });
   }
 
@@ -141,28 +159,27 @@ 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,
-    params?: BatchCancelParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<BetaMessageBatch>;
-  cancel(messageBatchId: string, options?: Core.RequestOptions): Core.APIPromise<BetaMessageBatch>;
-  cancel(
-    messageBatchId: string,
-    params: BatchCancelParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<BetaMessageBatch> {
-    if (isRequestOptions(params)) {
-      return this.cancel(messageBatchId, {}, params);
-    }
-    const { betas } = params;
-    return this._client.post(`/v1/messages/batches/${messageBatchId}/cancel?beta=true`, {
+    messageBatchID: string,
+    params: BatchCancelParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaMessageBatch> {
+    const { betas } = params ?? {};
+    return this._client.post(path`/v1/messages/batches/${messageBatchID}/cancel?beta=true`, {
       ...options,
-      headers: {
-        'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
-        ...options?.headers,
-      },
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
+        options?.headers,
+      ]),
     });
   }
 
@@ -175,41 +192,38 @@ 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,
-    params: BatchResultsParams | undefined,
-    options?: Core.RequestOptions,
-  ): Promise<JSONLDecoder<BetaMessageBatchIndividualResponse>>;
-  async results(
-    messageBatchId: string,
-    options?: Core.RequestOptions,
-  ): Promise<JSONLDecoder<BetaMessageBatchIndividualResponse>>;
-  async results(
-    messageBatchId: string,
-    params: BatchResultsParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
+    messageBatchID: string,
+    params: BatchResultsParams | undefined = {},
+    options?: RequestOptions,
   ): Promise<JSONLDecoder<BetaMessageBatchIndividualResponse>> {
-    if (isRequestOptions(params)) {
-      return this.results(messageBatchId, {}, params);
-    }
-
-    const batch = await this.retrieve(messageBatchId);
+    const batch = await this.retrieve(messageBatchID);
     if (!batch.results_url) {
       throw new AnthropicError(
         `No batch \`results_url\`; Has it finished processing? ${batch.processing_status} - ${batch.id}`,
       );
     }
 
-    const { betas } = params;
+    const { betas } = params ?? {};
     return this._client
       .get(batch.results_url, {
         ...options,
-        headers: {
-          'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
-          Accept: 'application/binary',
-          ...options?.headers,
-        },
+        headers: buildHeaders([
+          {
+            'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
+            Accept: 'application/binary',
+          },
+          options?.headers,
+        ]),
         stream: true,
         __binaryResponse: true,
       })
@@ -219,7 +233,7 @@ export class Batches extends APIResource {
   }
 }
 
-export class BetaMessageBatchesPage extends Page<BetaMessageBatch> {}
+export type BetaMessageBatchesPage = Page<BetaMessageBatch>;
 
 export interface BetaDeletedMessageBatch {
   /**
@@ -466,8 +480,6 @@ export interface BatchResultsParams {
   betas?: Array<BetaAPI.AnthropicBeta>;
 }
 
-Batches.BetaMessageBatchesPage = BetaMessageBatchesPage;
-
 export declare namespace Batches {
   export {
     type BetaDeletedMessageBatch as BetaDeletedMessageBatch,
@@ -479,7 +491,7 @@ export declare namespace Batches {
     type BetaMessageBatchRequestCounts as BetaMessageBatchRequestCounts,
     type BetaMessageBatchResult as BetaMessageBatchResult,
     type BetaMessageBatchSucceededResult as BetaMessageBatchSucceededResult,
-    BetaMessageBatchesPage as BetaMessageBatchesPage,
+    type BetaMessageBatchesPage as BetaMessageBatchesPage,
     type BatchCreateParams as BatchCreateParams,
     type BatchRetrieveParams as BatchRetrieveParams,
     type BatchListParams as BatchListParams,

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

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
-  BetaMessageBatchesPage,
   Batches,
   type BetaDeletedMessageBatch,
   type BetaMessageBatch,
@@ -18,7 +17,8 @@ export {
   type BatchDeleteParams,
   type BatchCancelParams,
   type BatchResultsParams,
-} from "./batches.js";
+  type BetaMessageBatchesPage,
+} from './batches';
 export {
   Messages,
   type BetaBase64ImageSource,
@@ -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,9 +92,18 @@ 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,
   type MessageCountTokensParams,
   type BetaMessageStreamParams,
-} from "./messages.js";
+} from './messages';