@anthropic-ai/sdk 0.121.0 → 0.123.0

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

@@ -16,17 +16,17 @@ export class Versions extends APIResource {
    *
    * @example
    * ```ts
-   * const version = await client.beta.skills.versions.create(
-   *   'skill_id',
-   *   { files: [fs.createReadStream('path/to/file')] },
-   * );
+   * const betaSkillVersion =
+   *   await client.beta.skills.versions.create('skill_id', {
+   *     files: [fs.createReadStream('path/to/file')],
+   *   });
    * ```
    */
   create(
     skillID: string,
     params: VersionCreateParams,
     options?: RequestOptions,
-  ): APIPromise<VersionCreateResponse> {
+  ): APIPromise<BetaSkillVersion> {
     const { betas, ...body } = params;
     return this._client.post(
       path`/v1/skills/${skillID}/versions?beta=true`,
@@ -35,7 +35,7 @@ export class Versions extends APIResource {
           body,
           ...options,
           headers: buildHeaders([
-            { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+            { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
             options?.headers,
           ]),
         },
@@ -50,22 +50,22 @@ export class Versions extends APIResource {
    *
    * @example
    * ```ts
-   * const version = await client.beta.skills.versions.retrieve(
-   *   'version',
-   *   { skill_id: 'skill_id' },
-   * );
+   * const betaSkillVersion =
+   *   await client.beta.skills.versions.retrieve('version', {
+   *     skill_id: 'skill_id',
+   *   });
    * ```
    */
   retrieve(
     version: string,
     params: VersionRetrieveParams,
     options?: RequestOptions,
-  ): APIPromise<VersionRetrieveResponse> {
+  ): APIPromise<BetaSkillVersion> {
     const { skill_id, betas } = params;
     return this._client.get(path`/v1/skills/${skill_id}/versions/${version}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -77,7 +77,7 @@ export class Versions extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const versionListResponse of client.beta.skills.versions.list(
+   * for await (const betaSkillVersion of client.beta.skills.versions.list(
    *   'skill_id',
    * )) {
    *   // ...
@@ -88,16 +88,16 @@ export class Versions extends APIResource {
     skillID: string,
     params: VersionListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<VersionListResponsesPageCursor, VersionListResponse> {
+  ): PagePromise<BetaSkillVersionsPageCursor, BetaSkillVersion> {
     const { betas, ...query } = params ?? {};
     return this._client.getAPIList(
       path`/v1/skills/${skillID}/versions?beta=true`,
-      PageCursor<VersionListResponse>,
+      PageCursor<BetaSkillVersion>,
       {
         query,
         ...options,
         headers: buildHeaders([
-          { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+          { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
           options?.headers,
         ]),
       },
@@ -109,22 +109,22 @@ export class Versions extends APIResource {
    *
    * @example
    * ```ts
-   * const version = await client.beta.skills.versions.delete(
-   *   'version',
-   *   { skill_id: 'skill_id' },
-   * );
+   * const betaDeletedSkillVersion =
+   *   await client.beta.skills.versions.delete('version', {
+   *     skill_id: 'skill_id',
+   *   });
    * ```
    */
   delete(
     version: string,
     params: VersionDeleteParams,
     options?: RequestOptions,
-  ): APIPromise<VersionDeleteResponse> {
+  ): APIPromise<BetaDeletedSkillVersion> {
     const { skill_id, betas } = params;
     return this._client.delete(path`/v1/skills/${skill_id}/versions/${version}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -150,8 +150,8 @@ export class Versions extends APIResource {
       ...options,
       headers: buildHeaders([
         {
-          'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString(),
           Accept: 'application/binary',
+          ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
         },
         options?.headers,
       ]),
@@ -160,72 +160,32 @@ export class Versions extends APIResource {
   }
 }
 
-export type VersionListResponsesPageCursor = PageCursor<VersionListResponse>;
+export type BetaSkillVersionsPageCursor = PageCursor<BetaSkillVersion>;
 
-export interface VersionCreateResponse {
+export interface BetaDeletedSkillVersion {
   /**
-   * Unique identifier for the skill version.
-   *
-   * The format and length of IDs may change over time.
+   * Unique identifier for this Skill Version. The id addresses the version in paths
+   * and pins it in references.
    */
   id: string;
 
   /**
-   * ISO 8601 timestamp of when the skill version was created.
-   */
-  created_at: string;
-
-  /**
-   * Description of the skill version.
-   *
-   * This is extracted from the SKILL.md file in the skill upload.
-   */
-  description: string;
-
-  /**
-   * Directory name of the skill version.
-   *
-   * This is the top-level directory name that was extracted from the uploaded files.
-   */
-  directory: string;
-
-  /**
-   * Human-readable name of the skill version.
-   *
-   * This is extracted from the SKILL.md file in the skill upload.
-   */
-  name: string;
-
-  /**
-   * Identifier for the skill that this version belongs to.
-   */
-  skill_id: string;
-
-  /**
-   * Object type.
-   *
-   * For Skill Versions, this is always `"skill_version"`.
-   */
-  type: string;
-
-  /**
-   * Version identifier for the skill.
+   * Deleted object type.
    *
-   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+   * For Skill Versions, this is always `"skill_version_deleted"`.
    */
-  version: string;
+  type: 'skill_version_deleted';
 }
 
-export interface VersionRetrieveResponse {
+export interface BetaSkillVersion {
   /**
-   * Unique identifier for the skill version.
-   *
-   * The format and length of IDs may change over time.
+   * Unique identifier for this Skill Version. The id addresses the version in paths
+   * and pins it in references.
    */
   id: string;
 
   /**
-   * ISO 8601 timestamp of when the skill version was created.
+   * ISO 8601 timestamp of when the skill was created.
    */
   created_at: string;
 
@@ -237,76 +197,18 @@ export interface VersionRetrieveResponse {
   description: string;
 
   /**
-   * Directory name of the skill version.
-   *
-   * This is the top-level directory name that was extracted from the uploaded files.
-   */
-  directory: string;
-
-  /**
-   * Human-readable name of the skill version.
-   *
-   * This is extracted from the SKILL.md file in the skill upload.
+   * The Skill's immutable kebab-case slug, set at creation from the first upload's
+   * SKILL.md frontmatter `name` (or its enclosing directory). Every later upload
+   * must resolve to the same value. Also the top-level directory of the Skill's
+   * mounted files and the base name of a downloaded archive.
    */
   name: string;
 
   /**
-   * Identifier for the skill that this version belongs to.
-   */
-  skill_id: string;
-
-  /**
-   * Object type.
-   *
-   * For Skill Versions, this is always `"skill_version"`.
-   */
-  type: string;
-
-  /**
-   * Version identifier for the skill.
-   *
-   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
-   */
-  version: string;
-}
-
-export interface VersionListResponse {
-  /**
-   * Unique identifier for the skill version.
+   * Unique identifier for the skill.
    *
    * The format and length of IDs may change over time.
    */
-  id: string;
-
-  /**
-   * ISO 8601 timestamp of when the skill version was created.
-   */
-  created_at: string;
-
-  /**
-   * Description of the skill version.
-   *
-   * This is extracted from the SKILL.md file in the skill upload.
-   */
-  description: string;
-
-  /**
-   * Directory name of the skill version.
-   *
-   * This is the top-level directory name that was extracted from the uploaded files.
-   */
-  directory: string;
-
-  /**
-   * Human-readable name of the skill version.
-   *
-   * This is extracted from the SKILL.md file in the skill upload.
-   */
-  name: string;
-
-  /**
-   * Identifier for the skill that this version belongs to.
-   */
   skill_id: string;
 
   /**
@@ -314,30 +216,7 @@ export interface VersionListResponse {
    *
    * For Skill Versions, this is always `"skill_version"`.
    */
-  type: string;
-
-  /**
-   * Version identifier for the skill.
-   *
-   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
-   */
-  version: string;
-}
-
-export interface VersionDeleteResponse {
-  /**
-   * Version identifier for the skill.
-   *
-   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
-   */
-  id: string;
-
-  /**
-   * Deleted object type.
-   *
-   * For Skill Versions, this is always `"skill_version_deleted"`.
-   */
-  type: string;
+  type: 'skill_version';
 }
 
 export interface VersionCreateParams {
@@ -406,11 +285,9 @@ export interface VersionDownloadParams {
 
 export declare namespace Versions {
   export {
-    type VersionCreateResponse as VersionCreateResponse,
-    type VersionRetrieveResponse as VersionRetrieveResponse,
-    type VersionListResponse as VersionListResponse,
-    type VersionDeleteResponse as VersionDeleteResponse,
-    type VersionListResponsesPageCursor as VersionListResponsesPageCursor,
+    type BetaDeletedSkillVersion as BetaDeletedSkillVersion,
+    type BetaSkillVersion as BetaSkillVersion,
+    type BetaSkillVersionsPageCursor as BetaSkillVersionsPageCursor,
     type VersionCreateParams as VersionCreateParams,
     type VersionRetrieveParams as VersionRetrieveParams,
     type VersionListParams as VersionListParams,

package/src/resources/beta/user-profiles.ts

@@ -186,18 +186,16 @@ export interface BetaUserProfile {
   external_id?: string | null;
 
   /**
-   * Real-world name of the entity this profile represents (company or individual).
-   * For a resold-to company (`access_type` `passthrough`, or `relationship` `resold`
-   * under the `user-profiles-2026-03-24` header) this is that company's name.
+   * A timestamp in RFC 3339 format
    */
-  name?: string | null;
+  external_user_onboarded_at?: string | null;
 
   /**
-   * How the entity behind a user profile relates to the platform that owns the API
-   * key. `external`: an individual end-user of the platform. `resold`: a company the
-   * platform resells Claude access to. `internal`: the platform's own usage.
+   * Real-world name of the entity this profile represents (company or individual).
+   * For a company the platform resells Claude access to (`access_type`
+   * `passthrough`) this is that company's name.
    */
-  relationship?: 'external' | 'resold' | 'internal';
+  name?: string | null;
 }
 
 export interface BetaUserProfileEnrollmentURL {
@@ -240,6 +238,11 @@ export interface UserProfileCreateParams {
    */
   external_id?: string | null;
 
+  /**
+   * Body param: A timestamp in RFC 3339 format
+   */
+  external_user_onboarded_at?: string;
+
   /**
    * Body param: Free-form key-value data to attach to this user profile. Maximum 16
    * keys, with keys up to 64 characters and values up to 512 characters. Values must
@@ -249,20 +252,12 @@ export interface UserProfileCreateParams {
 
   /**
    * Body param: Optional for all profiles. Real-world name of the entity this
-   * profile represents (company or individual); for a resold-to company
-   * (`relationship` `resold` / `access_type` `passthrough`), that company's name
-   * where known. Maximum 255 characters.
+   * profile represents (company or individual); for a company the platform resells
+   * Claude access to (`access_type` `passthrough`), that company's name where known.
+   * Maximum 255 characters.
    */
   name?: string | null;
 
-  /**
-   * Body param: How the entity behind a user profile relates to the platform that
-   * owns the API key. `external`: an individual end-user of the platform. `resold`:
-   * a company the platform resells Claude access to. `internal`: the platform's own
-   * usage.
-   */
-  relationship?: 'external' | 'resold' | 'internal';
-
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -292,6 +287,11 @@ export interface UserProfileUpdateParams {
    */
   external_id?: string | null;
 
+  /**
+   * Body param: A timestamp in RFC 3339 format
+   */
+  external_user_onboarded_at?: string;
+
   /**
    * Body param: Key-value pairs to merge into the stored metadata. Keys provided
    * overwrite existing values. To remove a key, set its value to an empty string.
@@ -306,14 +306,6 @@ export interface UserProfileUpdateParams {
    */
   name?: string | null;
 
-  /**
-   * Body param: How the entity behind a user profile relates to the platform that
-   * owns the API key. `external`: an individual end-user of the platform. `resold`:
-   * a company the platform resells Claude access to. `internal`: the platform's own
-   * usage.
-   */
-  relationship?: 'external' | 'resold' | 'internal' | null;
-
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -326,6 +318,11 @@ export interface UserProfileListParams extends PageCursorParams {
    */
   order?: 'asc' | 'desc';
 
+  /**
+   * Query param: Query parameter for order_by
+   */
+  order_by?: 'created_at' | 'name';
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */

package/src/resources/beta/webhooks.ts

@@ -4,17 +4,27 @@ import { APIResource } from '../../core/resource';
 import { Webhook } from 'standardwebhooks';
 
 export class Webhooks extends APIResource {
-  unwrap(
-    body: string,
-    { headers, key }: { headers: Record<string, string>; key?: string },
-  ): UnwrapWebhookEvent {
-    if (headers !== undefined) {
-      const keyStr: string | null = key === undefined ? this._client.webhookKey : key;
-      if (keyStr === null) throw new Error('Webhook key must not be null in order to unwrap');
-      const wh = new Webhook(keyStr);
-      wh.verify(body, headers);
-    }
-    return JSON.parse(body) as UnwrapWebhookEvent;
+  /**
+   * Parses a webhook payload into an event without verifying its signature. Prefer
+   * `unwrap()` unless you have already verified the signature yourself.
+   */
+  parseUnverified(body: string): BetaWebhookEvent {
+    return JSON.parse(body) as BetaWebhookEvent;
+  }
+
+  /**
+   * Verifies the webhook signature from the `webhook-id`, `webhook-timestamp` and
+   * `webhook-signature` headers using your webhook signing key, then parses the
+   * payload into an event. Fails if the signature is missing or invalid.
+   */
+  unwrap(body: string, options: { headers: Record<string, string>; key?: string }): BetaWebhookEvent {
+    const headers = options?.headers;
+    if (headers == null) throw new Error('Webhook headers are required in order to verify the signature');
+    const keyStr: string | null = options.key === undefined ? this._client.webhookKey : options.key;
+    if (!keyStr) throw new Error('Webhook key must not be null or empty in order to unwrap');
+    const wh = new Webhook(keyStr);
+    wh.verify(body, headers);
+    return JSON.parse(body) as BetaWebhookEvent;
   }
 }
 
@@ -690,24 +700,10 @@ export interface BetaWebhookVaultDeletedEventData {
   workspace_id: string;
 }
 
-export interface UnwrapWebhookEvent {
-  /**
-   * Unique event identifier for idempotency.
-   */
-  id: string;
-
-  /**
-   * RFC 3339 timestamp when the event occurred.
-   */
-  created_at: string;
-
-  data: BetaWebhookEventData;
-
-  /**
-   * Object type. Always `event` for webhook payloads.
-   */
-  type: 'event';
-}
+/**
+ * @deprecated UnwrapWebhookEvent has been renamed to BetaWebhookEvent
+ */
+export type UnwrapWebhookEvent = BetaWebhookEvent;
 
 export declare namespace Webhooks {
   export {

package/src/resources/messages/messages.ts

@@ -949,10 +949,6 @@ export interface BrowserSwitchTabConfig {
 export interface BrowserToolset20260801 {
   type: 'browser_toolset_20260801';
 
-  allowed_callers?: Array<
-    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
-  >;
-
   /**
    * Create a cache control breakpoint at this content block.
    */
@@ -1960,10 +1956,6 @@ export interface ComputerScrollConfig {
 export interface ComputerToolset20260801 {
   type: 'computer_toolset_20260801';
 
-  allowed_callers?: Array<
-    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
-  >;
-
   /**
    * Create a cache control breakpoint at this content block.
    */
@@ -2664,6 +2656,8 @@ export interface Metadata {
  * details and options.
  */
 export type Model =
+  | 'claude-fable-5-1'
+  | 'claude-mythos-5-1'
   | 'claude-sonnet-5'
   | 'claude-fable-5'
   | 'claude-mythos-5'

package/src/tools/agent-toolset/fs-util.ts

@@ -5,11 +5,12 @@
  * and these helpers can be reused by every file tool.
  */
 
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { randomUUID } from 'node:crypto';
+import type { FileHandle } from 'node:fs/promises';
+import { crypto, fs as nodefs, path } from '../../internal/node';
 import { ToolError } from '../../lib/tools/ToolError';
 
+const fs = nodefs.promises;
+
 /** Mode for directories the file tools create — not world-writable under a 0 umask. */
 export const DIR_CREATE_MODE = 0o755;
 /** Mode for files the file tools create. */
@@ -140,8 +141,8 @@ export async function confineToRoot(
  */
 export async function atomicWriteFile(targetPath: string, content: string): Promise<void> {
   const dir = path.dirname(targetPath);
-  const tempPath = path.join(dir, `.tmp-${process.pid}-${randomUUID()}`);
-  let handle: fs.FileHandle | undefined;
+  const tempPath = path.join(dir, `.tmp-${process.pid}-${crypto.randomUUID()}`);
+  let handle: FileHandle | undefined;
   try {
     handle = await fs.open(tempPath, 'wx', FILE_CREATE_MODE);
     await handle.writeFile(content, 'utf-8');

package/src/tools/agent-toolset/memories.ts

@@ -10,8 +10,7 @@
  * it is reachable through the shimmed `node.ts` entry point.
  */
 
-import * as path from 'node:path';
-import { createHash } from 'node:crypto';
+import { crypto, path } from '../../internal/node';
 import type { Anthropic } from '../../client';
 import { AnthropicError } from '../../core/error';
 import { loggerFor, type Logger } from '../../internal/utils/log';
@@ -51,7 +50,10 @@ export const MARKER_PATH = '.anthropic-memory-store';
 const MARKER_VERSION = 1;
 
 function markerSha(memoryStoreId: string): string {
-  return createHash('sha256').update(`version ${MARKER_VERSION}\n${memoryStoreId}`, 'utf-8').digest('hex');
+  return crypto
+    .createHash('sha256')
+    .update(`version ${MARKER_VERSION}\n${memoryStoreId}`, 'utf-8')
+    .digest('hex');
 }
 
 /** How long a file must stay missing locally before its server delete goes out. */

package/src/tools/agent-toolset/node.browser.ts

@@ -96,10 +96,6 @@ export function setupSkills(_ctx: AgentToolContext): Promise<() => Promise<void>
   return nodeOnly('setupSkills');
 }
 
-export function resolveSkillVersion(_client: Anthropic, _skillId: string, _version: string): Promise<string> {
-  return nodeOnly('resolveSkillVersion');
-}
-
 export function extractSkillArchive(_resp: Response, _dest: string): Promise<void> {
   return nodeOnly('extractSkillArchive');
 }