@anthropic-ai/sdk 0.121.0 → 0.122.0

package/src/resources/beta/beta.ts

@@ -103,7 +103,7 @@ import * as FilesAPI from './files';
 import {
   BetaDeletedFile,
   BetaFileMetadata,
-  BetaFileMetadataPage,
+  BetaFileMetadataPageCursor,
   BetaFileScope,
   FileDeleteParams,
   FileDownloadParams,
@@ -427,6 +427,7 @@ import {
   BetaComputerZoomConfig,
   BetaContainer,
   BetaContainerParams,
+  BetaContainerSkill,
   BetaContainerUploadBlock,
   BetaContainerUploadBlockParam,
   BetaContentBlock,
@@ -507,7 +508,6 @@ import {
   BetaServerToolUseBlock,
   BetaServerToolUseBlockParam,
   BetaSignatureDelta,
-  BetaSkill,
   BetaSkillParams,
   BetaStopReason,
   BetaTextBlock,
@@ -644,15 +644,14 @@ import {
 } from './sessions/sessions';
 import * as SkillsAPI from './skills/skills';
 import {
+  BetaDeletedSkill,
+  BetaSkill,
+  BetaSkillSource,
+  BetaSkillsPageCursor,
   SkillCreateParams,
-  SkillCreateResponse,
   SkillDeleteParams,
-  SkillDeleteResponse,
   SkillListParams,
-  SkillListResponse,
-  SkillListResponsesPageCursor,
   SkillRetrieveParams,
-  SkillRetrieveResponse,
   Skills,
 } from './skills/skills';
 import * as TunnelsAPI from './tunnels/tunnels';
@@ -1017,6 +1016,7 @@ export declare namespace Beta {
     type BetaComputerZoomConfig as BetaComputerZoomConfig,
     type BetaContainer as BetaContainer,
     type BetaContainerParams as BetaContainerParams,
+    type BetaContainerSkill as BetaContainerSkill,
     type BetaContainerUploadBlock as BetaContainerUploadBlock,
     type BetaContainerUploadBlockParam as BetaContainerUploadBlockParam,
     type BetaContentBlock as BetaContentBlock,
@@ -1099,7 +1099,6 @@ export declare namespace Beta {
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,
     type BetaSignatureDelta as BetaSignatureDelta,
-    type BetaSkill as BetaSkill,
     type BetaSkillParams as BetaSkillParams,
     type BetaStopReason as BetaStopReason,
     type BetaTextBlock as BetaTextBlock,
@@ -1430,7 +1429,7 @@ export declare namespace Beta {
     type BetaDeletedFile as BetaDeletedFile,
     type BetaFileMetadata as BetaFileMetadata,
     type BetaFileScope as BetaFileScope,
-    type BetaFileMetadataPage as BetaFileMetadataPage,
+    type BetaFileMetadataPageCursor as BetaFileMetadataPageCursor,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileDownloadParams as FileDownloadParams,
@@ -1440,11 +1439,10 @@ export declare namespace Beta {
 
   export {
     Skills as Skills,
-    type SkillCreateResponse as SkillCreateResponse,
-    type SkillRetrieveResponse as SkillRetrieveResponse,
-    type SkillListResponse as SkillListResponse,
-    type SkillDeleteResponse as SkillDeleteResponse,
-    type SkillListResponsesPageCursor as SkillListResponsesPageCursor,
+    type BetaDeletedSkill as BetaDeletedSkill,
+    type BetaSkill as BetaSkill,
+    type BetaSkillSource as BetaSkillSource,
+    type BetaSkillsPageCursor as BetaSkillsPageCursor,
     type SkillCreateParams as SkillCreateParams,
     type SkillRetrieveParams as SkillRetrieveParams,
     type SkillListParams as SkillListParams,

package/src/resources/beta/files.ts

@@ -3,7 +3,7 @@
 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 { PageCursor, type PageCursorParams, PagePromise } from '../../core/pagination';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -26,13 +26,13 @@ export class Files extends APIResource {
   list(
     params: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<BetaFileMetadataPage, BetaFileMetadata> {
+  ): PagePromise<BetaFileMetadataPageCursor, BetaFileMetadata> {
     const { betas, ...query } = params ?? {};
-    return this._client.getAPIList('/v1/files?beta=true', Page<BetaFileMetadata>, {
+    return this._client.getAPIList('/v1/files?beta=true', PageCursor<BetaFileMetadata>, {
       query,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -57,7 +57,7 @@ export class Files extends APIResource {
     return this._client.delete(path`/v1/files/${fileID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -86,8 +86,8 @@ export class Files extends APIResource {
       ...options,
       headers: buildHeaders([
         {
-          'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString(),
           Accept: 'application/binary',
+          ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
         },
         options?.headers,
       ]),
@@ -113,7 +113,7 @@ export class Files extends APIResource {
     return this._client.get(path`/v1/files/${fileID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -139,7 +139,7 @@ export class Files extends APIResource {
           body,
           ...options,
           headers: buildHeaders([
-            { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+            { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
             stainlessHelperHeaderFromFile(body.file),
             options?.headers,
           ]),
@@ -150,7 +150,7 @@ export class Files extends APIResource {
   }
 }
 
-export type BetaFileMetadataPage = Page<BetaFileMetadata>;
+export type BetaFileMetadataPageCursor = PageCursor<BetaFileMetadata>;
 
 export interface BetaDeletedFile {
   /**
@@ -206,6 +206,13 @@ export interface BetaFileMetadata {
    */
   downloadable?: boolean;
 
+  /**
+   * RFC 3339 datetime string representing when the file will expire and become
+   * unavailable for download. Null if the file does not expire. For files uploaded
+   * with `expires_in_seconds`, this is the upload time plus that value.
+   */
+  expires_at?: string | null;
+
   /**
    * The scope of this file, indicating the context in which it was created (e.g., a
    * session).
@@ -225,7 +232,16 @@ export interface BetaFileScope {
   type: 'session';
 }
 
-export interface FileListParams extends PageParams {
+export interface FileListParams extends PageCursorParams {
+  /**
+   * Query param: Restrict the result set to Files whose `id` is in this list. At
+   * most 100 entries (after de-duplication). Mutually exclusive with `page` and
+   * `limit`. When supplied, the response is always a single page (`next_page` is
+   * null). IDs that do not resolve to a visible File — including deleted Files — are
+   * silently omitted.
+   */
+  ids?: Array<string> | null;
+
   /**
    * Query param: Filter by scope ID. Only returns files associated with the
    * specified scope (e.g., a session ID).
@@ -265,6 +281,13 @@ export interface FileUploadParams {
    */
   file: Uploadable;
 
+  /**
+   * Body param: Seconds from upload until the file expires and its bytes become
+   * permanently unavailable. Must be between 3600 (one hour) and 7776000 (ninety
+   * days).
+   */
+  expires_in_seconds?: number;
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -276,7 +299,7 @@ export declare namespace Files {
     type BetaDeletedFile as BetaDeletedFile,
     type BetaFileMetadata as BetaFileMetadata,
     type BetaFileScope as BetaFileScope,
-    type BetaFileMetadataPage as BetaFileMetadataPage,
+    type BetaFileMetadataPageCursor as BetaFileMetadataPageCursor,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileDownloadParams as FileDownloadParams,

package/src/resources/beta/index.ts

@@ -214,7 +214,7 @@ export {
   type FileDownloadParams,
   type FileRetrieveMetadataParams,
   type FileUploadParams,
-  type BetaFileMetadataPage,
+  type BetaFileMetadataPageCursor,
 } from './files';
 export {
   MemoryStores,
@@ -357,6 +357,7 @@ export {
   type BetaComputerZoomConfig,
   type BetaContainer,
   type BetaContainerParams,
+  type BetaContainerSkill,
   type BetaContainerUploadBlock,
   type BetaContainerUploadBlockParam,
   type BetaContentBlock,
@@ -440,7 +441,6 @@ export {
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
-  type BetaSkill,
   type BetaSkillParams,
   type BetaStopReason,
   type BetaTextBlock,
@@ -595,15 +595,14 @@ export {
 } from './sessions/index';
 export {
   Skills,
-  type SkillCreateResponse,
-  type SkillRetrieveResponse,
-  type SkillListResponse,
-  type SkillDeleteResponse,
+  type BetaDeletedSkill,
+  type BetaSkill,
+  type BetaSkillSource,
   type SkillCreateParams,
   type SkillRetrieveParams,
   type SkillListParams,
   type SkillDeleteParams,
-  type SkillListResponsesPageCursor,
+  type BetaSkillsPageCursor,
 } from './skills/index';
 export {
   Tunnels,

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

@@ -148,6 +148,7 @@ export {
   type BetaComputerZoomConfig,
   type BetaContainer,
   type BetaContainerParams,
+  type BetaContainerSkill,
   type BetaContainerUploadBlock,
   type BetaContainerUploadBlockParam,
   type BetaContentBlock,
@@ -229,7 +230,6 @@ export {
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
-  type BetaSkill,
   type BetaSkillParams,
   type BetaStopReason,
   type BetaTextBlock,

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

@@ -2675,7 +2675,7 @@ export interface BetaContainer {
   /**
    * Skills loaded in the container
    */
-  skills: Array<BetaSkill> | null;
+  skills: Array<BetaContainerSkill> | null;
 }
 
 /**
@@ -2693,6 +2693,26 @@ export interface BetaContainerParams {
   skills?: Array<BetaSkillParams> | null;
 }
 
+/**
+ * A skill that was loaded in a container (response model).
+ */
+export interface BetaContainerSkill {
+  /**
+   * Skill ID
+   */
+  skill_id: string;
+
+  /**
+   * Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+   */
+  type: 'anthropic' | 'custom';
+
+  /**
+   * The resolved version: a skill version ID for custom skills.
+   */
+  version: string;
+}
+
 /**
  * Response model for a file uploaded to the container.
  */
@@ -4293,26 +4313,6 @@ export interface BetaSignatureDelta {
   type: 'signature_delta';
 }
 
-/**
- * A skill that was loaded in a container (response model).
- */
-export interface BetaSkill {
-  /**
-   * Skill ID
-   */
-  skill_id: string;
-
-  /**
-   * Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
-   */
-  type: 'anthropic' | 'custom';
-
-  /**
-   * The resolved version: a skill version ID for custom skills.
-   */
-  version: string;
-}
-
 /**
  * Specification for a skill to be loaded in a container (request model).
  */
@@ -6974,6 +6974,7 @@ export declare namespace Messages {
     type BetaComputerZoomConfig as BetaComputerZoomConfig,
     type BetaContainer as BetaContainer,
     type BetaContainerParams as BetaContainerParams,
+    type BetaContainerSkill as BetaContainerSkill,
     type BetaContainerUploadBlock as BetaContainerUploadBlock,
     type BetaContainerUploadBlockParam as BetaContainerUploadBlockParam,
     type BetaContentBlock as BetaContentBlock,
@@ -7057,7 +7058,6 @@ export declare namespace Messages {
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,
     type BetaSignatureDelta as BetaSignatureDelta,
-    type BetaSkill as BetaSkill,
     type BetaSkillParams as BetaSkillParams,
     type BetaStopReason as BetaStopReason,
     type BetaTextBlock as BetaTextBlock,

package/src/resources/beta/organization/rate-limits.ts

@@ -12,9 +12,8 @@ export class RateLimits extends APIResource {
    * API-surface category such as the Files API or Message Batches) and contains the
    * set of limiter values that apply to it.
    *
-   * This endpoint currently returns every matching entry in a single page regardless
-   * of `limit`; follow `next_page` so that clients keep working when pagination is
-   * enabled.
+   * When `limit` is omitted, every matching entry is returned in a single page; when
+   * `limit` truncates the result, follow `next_page` to fetch the remaining entries.
    *
    * @example
    * ```ts

package/src/resources/beta/organization/workspaces/rate-limits.ts

@@ -13,9 +13,8 @@ export class RateLimits extends APIResource {
    * Groups without overrides inherit the organization limits and are not listed; use
    * `GET /v1/organizations/rate_limits` to see those.
    *
-   * This endpoint currently returns every matching entry in a single page regardless
-   * of `limit`; follow `next_page` so that clients keep working when pagination is
-   * enabled.
+   * When `limit` is omitted, every matching entry is returned in a single page; when
+   * `limit` truncates the result, follow `next_page` to fetch the remaining entries.
    *
    * @example
    * ```ts

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

@@ -2,26 +2,23 @@
 
 export {
   Skills,
-  type SkillCreateResponse,
-  type SkillRetrieveResponse,
-  type SkillListResponse,
-  type SkillDeleteResponse,
+  type BetaDeletedSkill,
+  type BetaSkill,
+  type BetaSkillSource,
   type SkillCreateParams,
   type SkillRetrieveParams,
   type SkillListParams,
   type SkillDeleteParams,
-  type SkillListResponsesPageCursor,
+  type BetaSkillsPageCursor,
 } from './skills';
 export {
   Versions,
-  type VersionCreateResponse,
-  type VersionRetrieveResponse,
-  type VersionListResponse,
-  type VersionDeleteResponse,
+  type BetaDeletedSkillVersion,
+  type BetaSkillVersion,
   type VersionCreateParams,
   type VersionRetrieveParams,
   type VersionListParams,
   type VersionDeleteParams,
   type VersionDownloadParams,
-  type VersionListResponsesPageCursor,
+  type BetaSkillVersionsPageCursor,
 } from './versions';