@anthropic-ai/sdk 0.51.0 → 0.52.0

package/src/resources/beta/beta.ts

@@ -1,6 +1,18 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as FilesAPI from './files';
+import {
+  DeletedFile,
+  FileDeleteParams,
+  FileDownloadParams,
+  FileListParams,
+  FileMetadata,
+  FileMetadataPage,
+  FileRetrieveMetadataParams,
+  FileUploadParams,
+  Files,
+} from './files';
 import * as ModelsAPI from './models';
 import { BetaModelInfo, BetaModelInfosPage, ModelListParams, ModelRetrieveParams, Models } from './models';
 import * as MessagesAPI from './messages/messages';
@@ -9,6 +21,7 @@ import {
   BetaBase64PDFBlock,
   BetaBase64PDFSource,
   BetaCacheControlEphemeral,
+  BetaCacheCreation,
   BetaCitationCharLocation,
   BetaCitationCharLocationParam,
   BetaCitationContentBlockLocation,
@@ -19,12 +32,32 @@ import {
   BetaCitationsConfigParam,
   BetaCitationsDelta,
   BetaCitationsWebSearchResultLocation,
+  BetaCodeExecutionOutputBlock,
+  BetaCodeExecutionOutputBlockParam,
+  BetaCodeExecutionResultBlock,
+  BetaCodeExecutionResultBlockParam,
+  BetaCodeExecutionTool20250522,
+  BetaCodeExecutionToolResultBlock,
+  BetaCodeExecutionToolResultBlockContent,
+  BetaCodeExecutionToolResultBlockParam,
+  BetaCodeExecutionToolResultBlockParamContent,
+  BetaCodeExecutionToolResultError,
+  BetaCodeExecutionToolResultErrorCode,
+  BetaCodeExecutionToolResultErrorParam,
+  BetaContainer,
+  BetaContainerUploadBlock,
+  BetaContainerUploadBlockParam,
   BetaContentBlock,
   BetaContentBlockParam,
   BetaContentBlockSource,
   BetaContentBlockSourceContent,
+  BetaFileDocumentSource,
+  BetaFileImageSource,
   BetaImageBlockParam,
   BetaInputJSONDelta,
+  BetaMCPToolResultBlock,
+  BetaMCPToolUseBlock,
+  BetaMCPToolUseBlockParam,
   BetaMessage,
   BetaMessageDeltaUsage,
   BetaMessageParam,
@@ -41,6 +74,9 @@ import {
   BetaRawMessageStreamEvent,
   BetaRedactedThinkingBlock,
   BetaRedactedThinkingBlockParam,
+  BetaRequestMCPServerToolConfiguration,
+  BetaRequestMCPServerURLDefinition,
+  BetaRequestMCPToolResultBlockParam,
   BetaServerToolUsage,
   BetaServerToolUseBlock,
   BetaServerToolUseBlockParam,
@@ -70,6 +106,7 @@ import {
   BetaToolResultBlockParam,
   BetaToolTextEditor20241022,
   BetaToolTextEditor20250124,
+  BetaToolTextEditor20250429,
   BetaToolUnion,
   BetaToolUseBlock,
   BetaToolUseBlockParam,
@@ -85,6 +122,7 @@ import {
   BetaWebSearchToolResultBlockParam,
   BetaWebSearchToolResultBlockParamContent,
   BetaWebSearchToolResultError,
+  BetaWebSearchToolResultErrorCode,
   MessageCountTokensParams,
   MessageCreateParams,
   MessageCreateParamsNonStreaming,
@@ -95,6 +133,7 @@ import {
 export class Beta extends APIResource {
   models: ModelsAPI.Models = new ModelsAPI.Models(this._client);
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  files: FilesAPI.Files = new FilesAPI.Files(this._client);
 }
 
 export type AnthropicBeta =
@@ -106,7 +145,13 @@ export type AnthropicBeta =
   | 'pdfs-2024-09-25'
   | 'token-counting-2024-11-01'
   | 'token-efficient-tools-2025-02-19'
-  | 'output-128k-2025-02-19';
+  | 'output-128k-2025-02-19'
+  | 'files-api-2025-04-14'
+  | 'mcp-client-2025-04-04'
+  | 'dev-full-thinking-2025-05-14'
+  | 'interleaved-thinking-2025-05-14'
+  | 'code-execution-2025-05-22'
+  | 'extended-cache-ttl-2025-04-11';
 
 export interface BetaAPIError {
   message: string;
@@ -181,6 +226,7 @@ export interface BetaRateLimitError {
 
 Beta.Models = Models;
 Beta.Messages = Messages;
+Beta.Files = Files;
 
 export declare namespace Beta {
   export {
@@ -212,6 +258,7 @@ export declare namespace Beta {
     type BetaBase64PDFBlock as BetaBase64PDFBlock,
     type BetaBase64PDFSource as BetaBase64PDFSource,
     type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
+    type BetaCacheCreation as BetaCacheCreation,
     type BetaCitationCharLocation as BetaCitationCharLocation,
     type BetaCitationCharLocationParam as BetaCitationCharLocationParam,
     type BetaCitationContentBlockLocation as BetaCitationContentBlockLocation,
@@ -222,12 +269,32 @@ export declare namespace Beta {
     type BetaCitationsConfigParam as BetaCitationsConfigParam,
     type BetaCitationsDelta as BetaCitationsDelta,
     type BetaCitationsWebSearchResultLocation as BetaCitationsWebSearchResultLocation,
+    type BetaCodeExecutionOutputBlock as BetaCodeExecutionOutputBlock,
+    type BetaCodeExecutionOutputBlockParam as BetaCodeExecutionOutputBlockParam,
+    type BetaCodeExecutionResultBlock as BetaCodeExecutionResultBlock,
+    type BetaCodeExecutionResultBlockParam as BetaCodeExecutionResultBlockParam,
+    type BetaCodeExecutionTool20250522 as BetaCodeExecutionTool20250522,
+    type BetaCodeExecutionToolResultBlock as BetaCodeExecutionToolResultBlock,
+    type BetaCodeExecutionToolResultBlockContent as BetaCodeExecutionToolResultBlockContent,
+    type BetaCodeExecutionToolResultBlockParam as BetaCodeExecutionToolResultBlockParam,
+    type BetaCodeExecutionToolResultBlockParamContent as BetaCodeExecutionToolResultBlockParamContent,
+    type BetaCodeExecutionToolResultError as BetaCodeExecutionToolResultError,
+    type BetaCodeExecutionToolResultErrorCode as BetaCodeExecutionToolResultErrorCode,
+    type BetaCodeExecutionToolResultErrorParam as BetaCodeExecutionToolResultErrorParam,
+    type BetaContainer as BetaContainer,
+    type BetaContainerUploadBlock as BetaContainerUploadBlock,
+    type BetaContainerUploadBlockParam as BetaContainerUploadBlockParam,
     type BetaContentBlock as BetaContentBlock,
     type BetaContentBlockParam as BetaContentBlockParam,
     type BetaContentBlockSource as BetaContentBlockSource,
     type BetaContentBlockSourceContent as BetaContentBlockSourceContent,
+    type BetaFileDocumentSource as BetaFileDocumentSource,
+    type BetaFileImageSource as BetaFileImageSource,
     type BetaImageBlockParam as BetaImageBlockParam,
     type BetaInputJSONDelta as BetaInputJSONDelta,
+    type BetaMCPToolResultBlock as BetaMCPToolResultBlock,
+    type BetaMCPToolUseBlock as BetaMCPToolUseBlock,
+    type BetaMCPToolUseBlockParam as BetaMCPToolUseBlockParam,
     type BetaMessage as BetaMessage,
     type BetaMessageDeltaUsage as BetaMessageDeltaUsage,
     type BetaMessageParam as BetaMessageParam,
@@ -244,6 +311,9 @@ export declare namespace Beta {
     type BetaRawMessageStreamEvent as BetaRawMessageStreamEvent,
     type BetaRedactedThinkingBlock as BetaRedactedThinkingBlock,
     type BetaRedactedThinkingBlockParam as BetaRedactedThinkingBlockParam,
+    type BetaRequestMCPServerToolConfiguration as BetaRequestMCPServerToolConfiguration,
+    type BetaRequestMCPServerURLDefinition as BetaRequestMCPServerURLDefinition,
+    type BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
     type BetaServerToolUsage as BetaServerToolUsage,
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,
@@ -273,6 +343,7 @@ export declare namespace Beta {
     type BetaToolResultBlockParam as BetaToolResultBlockParam,
     type BetaToolTextEditor20241022 as BetaToolTextEditor20241022,
     type BetaToolTextEditor20250124 as BetaToolTextEditor20250124,
+    type BetaToolTextEditor20250429 as BetaToolTextEditor20250429,
     type BetaToolUnion as BetaToolUnion,
     type BetaToolUseBlock as BetaToolUseBlock,
     type BetaToolUseBlockParam as BetaToolUseBlockParam,
@@ -288,9 +359,22 @@ export declare namespace Beta {
     type BetaWebSearchToolResultBlockParam as BetaWebSearchToolResultBlockParam,
     type BetaWebSearchToolResultBlockParamContent as BetaWebSearchToolResultBlockParamContent,
     type BetaWebSearchToolResultError as BetaWebSearchToolResultError,
+    type BetaWebSearchToolResultErrorCode as BetaWebSearchToolResultErrorCode,
     type MessageCreateParams as MessageCreateParams,
     type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
     type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
     type MessageCountTokensParams as MessageCountTokensParams,
   };
+
+  export {
+    Files as Files,
+    type DeletedFile as DeletedFile,
+    type FileMetadata as FileMetadata,
+    type FileMetadataPage as FileMetadataPage,
+    type FileListParams as FileListParams,
+    type FileDeleteParams as FileDeleteParams,
+    type FileDownloadParams as FileDownloadParams,
+    type FileRetrieveMetadataParams as FileRetrieveMetadataParams,
+    type FileUploadParams as FileUploadParams,
+  };
 }

package/src/resources/beta/files.ts

@@ -0,0 +1,258 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as BetaAPI from './beta';
+import { APIPromise } from '../../core/api-promise';
+import { Page, type PageParams, PagePromise } from '../../core/pagination';
+import { type Uploadable } from '../../core/uploads';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { multipartFormRequestOptions } from '../../internal/uploads';
+import { path } from '../../internal/utils/path';
+
+export class Files extends APIResource {
+  /**
+   * List Files
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const fileMetadata of client.beta.files.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: FileListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<FileMetadataPage, FileMetadata> {
+    const { betas, ...query } = params ?? {};
+    return this._client.getAPIList('/v1/files', Page<FileMetadata>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Delete File
+   *
+   * @example
+   * ```ts
+   * const deletedFile = await client.beta.files.delete(
+   *   'file_id',
+   * );
+   * ```
+   */
+  delete(
+    fileID: string,
+    params: FileDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DeletedFile> {
+    const { betas } = params ?? {};
+    return this._client.delete(path`/v1/files/${fileID}`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Download File
+   *
+   * @example
+   * ```ts
+   * const response = await client.beta.files.download(
+   *   'file_id',
+   * );
+   *
+   * const content = await response.blob();
+   * console.log(content);
+   * ```
+   */
+  download(
+    fileID: string,
+    params: FileDownloadParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Response> {
+    const { betas } = params ?? {};
+    return this._client.get(path`/v1/files/${fileID}/content`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString(),
+          Accept: 'application/binary',
+        },
+        options?.headers,
+      ]),
+      __binaryResponse: true,
+    });
+  }
+
+  /**
+   * Get File Metadata
+   *
+   * @example
+   * ```ts
+   * const fileMetadata =
+   *   await client.beta.files.retrieveMetadata('file_id');
+   * ```
+   */
+  retrieveMetadata(
+    fileID: string,
+    params: FileRetrieveMetadataParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<FileMetadata> {
+    const { betas } = params ?? {};
+    return this._client.get(path`/v1/files/${fileID}`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Upload File
+   *
+   * @example
+   * ```ts
+   * const fileMetadata = await client.beta.files.upload({
+   *   file: fs.createReadStream('path/to/file'),
+   * });
+   * ```
+   */
+  upload(params: FileUploadParams, options?: RequestOptions): APIPromise<FileMetadata> {
+    const { betas, ...body } = params;
+    return this._client.post(
+      '/v1/files',
+      multipartFormRequestOptions(
+        {
+          body,
+          ...options,
+          headers: buildHeaders([
+            { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+            options?.headers,
+          ]),
+        },
+        this._client,
+      ),
+    );
+  }
+}
+
+export type FileMetadataPage = Page<FileMetadata>;
+
+export interface DeletedFile {
+  /**
+   * ID of the deleted file.
+   */
+  id: string;
+
+  /**
+   * Deleted object type.
+   *
+   * For file deletion, this is always `"file_deleted"`.
+   */
+  type?: 'file_deleted';
+}
+
+export interface FileMetadata {
+  /**
+   * Unique object identifier.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * RFC 3339 datetime string representing when the file was created.
+   */
+  created_at: string;
+
+  /**
+   * Original filename of the uploaded file.
+   */
+  filename: string;
+
+  /**
+   * MIME type of the file.
+   */
+  mime_type: string;
+
+  /**
+   * Size of the file in bytes.
+   */
+  size_bytes: number;
+
+  /**
+   * Object type.
+   *
+   * For files, this is always `"file"`.
+   */
+  type: 'file';
+
+  /**
+   * Whether the file can be downloaded.
+   */
+  downloadable?: boolean;
+}
+
+export interface FileListParams extends PageParams {
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface FileDeleteParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface FileDownloadParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface FileRetrieveMetadataParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface FileUploadParams {
+  /**
+   * Body param: The file to upload
+   */
+  file: Uploadable;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export declare namespace Files {
+  export {
+    type DeletedFile as DeletedFile,
+    type FileMetadata as FileMetadata,
+    type FileMetadataPage as FileMetadataPage,
+    type FileListParams as FileListParams,
+    type FileDeleteParams as FileDeleteParams,
+    type FileDownloadParams as FileDownloadParams,
+    type FileRetrieveMetadataParams as FileRetrieveMetadataParams,
+    type FileUploadParams as FileUploadParams,
+  };
+}

package/src/resources/beta/index.ts

@@ -15,12 +15,24 @@ export {
   type BetaPermissionError,
   type BetaRateLimitError,
 } from './beta';
+export {
+  Files,
+  type DeletedFile,
+  type FileMetadata,
+  type FileListParams,
+  type FileDeleteParams,
+  type FileDownloadParams,
+  type FileRetrieveMetadataParams,
+  type FileUploadParams,
+  type FileMetadataPage,
+} from './files';
 export {
   Messages,
   type BetaBase64ImageSource,
   type BetaBase64PDFBlock,
   type BetaBase64PDFSource,
   type BetaCacheControlEphemeral,
+  type BetaCacheCreation,
   type BetaCitationCharLocation,
   type BetaCitationCharLocationParam,
   type BetaCitationContentBlockLocation,
@@ -31,12 +43,32 @@ export {
   type BetaCitationsConfigParam,
   type BetaCitationsDelta,
   type BetaCitationsWebSearchResultLocation,
+  type BetaCodeExecutionOutputBlock,
+  type BetaCodeExecutionOutputBlockParam,
+  type BetaCodeExecutionResultBlock,
+  type BetaCodeExecutionResultBlockParam,
+  type BetaCodeExecutionTool20250522,
+  type BetaCodeExecutionToolResultBlock,
+  type BetaCodeExecutionToolResultBlockContent,
+  type BetaCodeExecutionToolResultBlockParam,
+  type BetaCodeExecutionToolResultBlockParamContent,
+  type BetaCodeExecutionToolResultError,
+  type BetaCodeExecutionToolResultErrorCode,
+  type BetaCodeExecutionToolResultErrorParam,
+  type BetaContainer,
+  type BetaContainerUploadBlock,
+  type BetaContainerUploadBlockParam,
   type BetaContentBlock,
   type BetaContentBlockParam,
   type BetaContentBlockSource,
   type BetaContentBlockSourceContent,
+  type BetaFileDocumentSource,
+  type BetaFileImageSource,
   type BetaImageBlockParam,
   type BetaInputJSONDelta,
+  type BetaMCPToolResultBlock,
+  type BetaMCPToolUseBlock,
+  type BetaMCPToolUseBlockParam,
   type BetaMessage,
   type BetaMessageDeltaUsage,
   type BetaMessageParam,
@@ -53,6 +85,9 @@ export {
   type BetaRawMessageStreamEvent,
   type BetaRedactedThinkingBlock,
   type BetaRedactedThinkingBlockParam,
+  type BetaRequestMCPServerToolConfiguration,
+  type BetaRequestMCPServerURLDefinition,
+  type BetaRequestMCPToolResultBlockParam,
   type BetaServerToolUsage,
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,
@@ -82,6 +117,7 @@ export {
   type BetaToolResultBlockParam,
   type BetaToolTextEditor20241022,
   type BetaToolTextEditor20250124,
+  type BetaToolTextEditor20250429,
   type BetaToolUnion,
   type BetaToolUseBlock,
   type BetaToolUseBlockParam,
@@ -97,6 +133,7 @@ export {
   type BetaWebSearchToolResultBlockParam,
   type BetaWebSearchToolResultBlockParamContent,
   type BetaWebSearchToolResultError,
+  type BetaWebSearchToolResultErrorCode,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,

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

@@ -25,6 +25,7 @@ export {
   type BetaBase64PDFBlock,
   type BetaBase64PDFSource,
   type BetaCacheControlEphemeral,
+  type BetaCacheCreation,
   type BetaCitationCharLocation,
   type BetaCitationCharLocationParam,
   type BetaCitationContentBlockLocation,
@@ -35,12 +36,32 @@ export {
   type BetaCitationsConfigParam,
   type BetaCitationsDelta,
   type BetaCitationsWebSearchResultLocation,
+  type BetaCodeExecutionOutputBlock,
+  type BetaCodeExecutionOutputBlockParam,
+  type BetaCodeExecutionResultBlock,
+  type BetaCodeExecutionResultBlockParam,
+  type BetaCodeExecutionTool20250522,
+  type BetaCodeExecutionToolResultBlock,
+  type BetaCodeExecutionToolResultBlockContent,
+  type BetaCodeExecutionToolResultBlockParam,
+  type BetaCodeExecutionToolResultBlockParamContent,
+  type BetaCodeExecutionToolResultError,
+  type BetaCodeExecutionToolResultErrorCode,
+  type BetaCodeExecutionToolResultErrorParam,
+  type BetaContainer,
+  type BetaContainerUploadBlock,
+  type BetaContainerUploadBlockParam,
   type BetaContentBlock,
   type BetaContentBlockParam,
   type BetaContentBlockSource,
   type BetaContentBlockSourceContent,
+  type BetaFileDocumentSource,
+  type BetaFileImageSource,
   type BetaImageBlockParam,
   type BetaInputJSONDelta,
+  type BetaMCPToolResultBlock,
+  type BetaMCPToolUseBlock,
+  type BetaMCPToolUseBlockParam,
   type BetaMessage,
   type BetaMessageDeltaUsage,
   type BetaMessageParam,
@@ -57,6 +78,9 @@ export {
   type BetaRawMessageStreamEvent,
   type BetaRedactedThinkingBlock,
   type BetaRedactedThinkingBlockParam,
+  type BetaRequestMCPServerToolConfiguration,
+  type BetaRequestMCPServerURLDefinition,
+  type BetaRequestMCPToolResultBlockParam,
   type BetaServerToolUsage,
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,
@@ -86,6 +110,7 @@ export {
   type BetaToolResultBlockParam,
   type BetaToolTextEditor20241022,
   type BetaToolTextEditor20250124,
+  type BetaToolTextEditor20250429,
   type BetaToolUnion,
   type BetaToolUseBlock,
   type BetaToolUseBlockParam,
@@ -101,6 +126,7 @@ export {
   type BetaWebSearchToolResultBlockParam,
   type BetaWebSearchToolResultBlockParamContent,
   type BetaWebSearchToolResultError,
+  type BetaWebSearchToolResultErrorCode,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,