@anthropic-ai/sdk 0.89.0 → 0.91.0

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

@@ -62,7 +62,7 @@ const DEPRECATED_MODELS: {
   'claude-3-7-sonnet-20250219': 'February 19th, 2026',
 };
 
-const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-opus-4-6'];
+const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-mythos-preview', 'claude-opus-4-6'];
 
 export class Messages extends APIResource {
   batches: BatchesAPI.Batches = new BatchesAPI.Batches(this._client);
@@ -113,7 +113,7 @@ export class Messages extends APIResource {
     }
 
     if (
-      body.model in MODELS_TO_WARN_WITH_THINKING_ENABLED &&
+      MODELS_TO_WARN_WITH_THINKING_ENABLED.includes(body.model) &&
       body.thinking &&
       body.thinking.type === 'enabled'
     ) {
@@ -1025,6 +1025,11 @@ export interface BetaCompactionBlock {
    */
   content: string | null;
 
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content: string | null;
+
   type: 'compaction';
 }
 
@@ -1049,11 +1054,21 @@ export interface BetaCompactionBlockParam {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content?: string | null;
 }
 
 export interface BetaCompactionContentBlockDelta {
   content: string | null;
 
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content: string | null;
+
   type: 'compaction_delta';
 }
 
@@ -1824,13 +1839,18 @@ export interface BetaOutputConfig {
   /**
    * All possible effort levels.
    */
-  effort?: 'low' | 'medium' | 'high' | 'max' | null;
+  effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
 
   /**
    * A schema to specify Claude's output format in responses. See
    * [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
    */
   format?: BetaJSONOutputFormat | null;
+
+  /**
+   * User-configurable total token budget across contexts.
+   */
+  task_budget?: BetaTokenTaskBudget | null;
 }
 
 export interface BetaPlainTextSource {
@@ -2453,6 +2473,27 @@ export interface BetaThinkingTurns {
   value: number;
 }
 
+/**
+ * User-configurable total token budget across contexts.
+ */
+export interface BetaTokenTaskBudget {
+  /**
+   * Total token budget across all contexts in the session.
+   */
+  total: number;
+
+  /**
+   * The budget type. Currently only 'tokens' is supported.
+   */
+  type: 'tokens';
+
+  /**
+   * Remaining tokens in the budget. Use this to track usage across contexts when
+   * implementing compaction client-side. Defaults to total if not provided.
+   */
+  remaining?: number | null;
+}
+
 export interface BetaTool {
   /**
    * [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
@@ -4008,6 +4049,12 @@ export interface MessageCreateParamsBase {
    */
   top_p?: number;
 
+  /**
+   * Body param: The user profile ID to attribute this request to. Use when acting on
+   * behalf of a party other than your organization.
+   */
+  user_profile_id?: string | null;
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -4455,6 +4502,7 @@ export declare namespace Messages {
     type BetaThinkingConfigParam as BetaThinkingConfigParam,
     type BetaThinkingDelta as BetaThinkingDelta,
     type BetaThinkingTurns as BetaThinkingTurns,
+    type BetaTokenTaskBudget as BetaTokenTaskBudget,
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
     type BetaToolBash20250124 as BetaToolBash20250124,

package/src/resources/beta/models.ts

@@ -132,6 +132,11 @@ export interface BetaEffortCapability {
    * Whether this capability is supported by the model.
    */
   supported: boolean;
+
+  /**
+   * Indicates whether a capability is supported.
+   */
+  xhigh: BetaCapabilitySupport | null;
 }
 
 /**

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

@@ -64,6 +64,7 @@ export {
   type BetaManagedAgentsDeleteSessionResource,
   type BetaManagedAgentsFileResource,
   type BetaManagedAgentsGitHubRepositoryResource,
+  type BetaManagedAgentsMemoryStoreResource,
   type BetaManagedAgentsSessionResource,
   type ResourceRetrieveResponse,
   type ResourceUpdateResponse,
@@ -83,6 +84,7 @@ export {
   type BetaManagedAgentsDeletedSession,
   type BetaManagedAgentsFileResourceParams,
   type BetaManagedAgentsGitHubRepositoryResourceParams,
+  type BetaManagedAgentsMemoryStoreResourceParam,
   type BetaManagedAgentsSession,
   type BetaManagedAgentsSessionAgent,
   type BetaManagedAgentsSessionStats,

package/src/resources/beta/sessions/resources.ts

@@ -213,23 +213,71 @@ export interface BetaManagedAgentsGitHubRepositoryResource {
   checkout?: SessionsAPI.BetaManagedAgentsBranchCheckout | SessionsAPI.BetaManagedAgentsCommitCheckout | null;
 }
 
+/**
+ * A memory store attached to an agent session.
+ */
+export interface BetaManagedAgentsMemoryStoreResource {
+  /**
+   * The memory store ID (memstore\_...). Must belong to the caller's organization
+   * and workspace.
+   */
+  memory_store_id: string;
+
+  type: 'memory_store';
+
+  /**
+   * Access mode for an attached memory store.
+   */
+  access?: 'read_write' | 'read_only' | null;
+
+  /**
+   * Description of the memory store, snapshotted at attach time. Rendered into the
+   * agent's system prompt. Empty string when the store has no description.
+   */
+  description?: string;
+
+  /**
+   * Per-attachment guidance for the agent on how to use this store. Rendered into
+   * the memory section of the system prompt. Max 4096 chars.
+   */
+  instructions?: string | null;
+
+  /**
+   * Filesystem path where the store is mounted in the session container, e.g.
+   * /mnt/memory/user-preferences. Derived from the store's name. Output-only.
+   */
+  mount_path?: string | null;
+
+  /**
+   * Display name of the memory store, snapshotted at attach time. Later edits to the
+   * store's name do not propagate to this resource.
+   */
+  name?: string | null;
+}
+
+/**
+ * A memory store attached to an agent session.
+ */
 export type BetaManagedAgentsSessionResource =
   | BetaManagedAgentsGitHubRepositoryResource
-  | BetaManagedAgentsFileResource;
+  | BetaManagedAgentsFileResource
+  | BetaManagedAgentsMemoryStoreResource;
 
 /**
  * The requested session resource.
  */
 export type ResourceRetrieveResponse =
   | BetaManagedAgentsGitHubRepositoryResource
-  | BetaManagedAgentsFileResource;
+  | BetaManagedAgentsFileResource
+  | BetaManagedAgentsMemoryStoreResource;
 
 /**
  * The updated session resource.
  */
 export type ResourceUpdateResponse =
   | BetaManagedAgentsGitHubRepositoryResource
-  | BetaManagedAgentsFileResource;
+  | BetaManagedAgentsFileResource
+  | BetaManagedAgentsMemoryStoreResource;
 
 export interface ResourceRetrieveParams {
   /**
@@ -308,6 +356,7 @@ export declare namespace Resources {
     type BetaManagedAgentsDeleteSessionResource as BetaManagedAgentsDeleteSessionResource,
     type BetaManagedAgentsFileResource as BetaManagedAgentsFileResource,
     type BetaManagedAgentsGitHubRepositoryResource as BetaManagedAgentsGitHubRepositoryResource,
+    type BetaManagedAgentsMemoryStoreResource as BetaManagedAgentsMemoryStoreResource,
     type BetaManagedAgentsSessionResource as BetaManagedAgentsSessionResource,
     type ResourceRetrieveResponse as ResourceRetrieveResponse,
     type ResourceUpdateResponse as ResourceUpdateResponse,

package/src/resources/beta/sessions/sessions.ts

@@ -68,6 +68,7 @@ import {
   BetaManagedAgentsDeleteSessionResource,
   BetaManagedAgentsFileResource,
   BetaManagedAgentsGitHubRepositoryResource,
+  BetaManagedAgentsMemoryStoreResource,
   BetaManagedAgentsSessionResource,
   BetaManagedAgentsSessionResourcesPageCursor,
   ResourceAddParams,
@@ -352,6 +353,30 @@ export interface BetaManagedAgentsGitHubRepositoryResourceParams {
   mount_path?: string | null;
 }
 
+/**
+ * Parameters for attaching a memory store to an agent session.
+ */
+export interface BetaManagedAgentsMemoryStoreResourceParam {
+  /**
+   * The memory store ID (memstore\_...). Must belong to the caller's organization
+   * and workspace.
+   */
+  memory_store_id: string;
+
+  type: 'memory_store';
+
+  /**
+   * Access mode for an attached memory store.
+   */
+  access?: 'read_write' | 'read_only' | null;
+
+  /**
+   * Per-attachment guidance for the agent on how to use this store. Rendered into
+   * the memory section of the system prompt. Max 4096 chars.
+   */
+  instructions?: string | null;
+}
+
 /**
  * A Managed Agents `session`.
  */
@@ -510,7 +535,11 @@ export interface SessionCreateParams {
    * Body param: Resources (e.g. repositories, files) to mount into the session's
    * container.
    */
-  resources?: Array<BetaManagedAgentsGitHubRepositoryResourceParams | BetaManagedAgentsFileResourceParams>;
+  resources?: Array<
+    | BetaManagedAgentsGitHubRepositoryResourceParams
+    | BetaManagedAgentsFileResourceParams
+    | BetaManagedAgentsMemoryStoreResourceParam
+  >;
 
   /**
    * Body param: Human-readable session title.
@@ -635,6 +664,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsDeletedSession as BetaManagedAgentsDeletedSession,
     type BetaManagedAgentsFileResourceParams as BetaManagedAgentsFileResourceParams,
     type BetaManagedAgentsGitHubRepositoryResourceParams as BetaManagedAgentsGitHubRepositoryResourceParams,
+    type BetaManagedAgentsMemoryStoreResourceParam as BetaManagedAgentsMemoryStoreResourceParam,
     type BetaManagedAgentsSession as BetaManagedAgentsSession,
     type BetaManagedAgentsSessionAgent as BetaManagedAgentsSessionAgent,
     type BetaManagedAgentsSessionStats as BetaManagedAgentsSessionStats,
@@ -713,6 +743,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsDeleteSessionResource as BetaManagedAgentsDeleteSessionResource,
     type BetaManagedAgentsFileResource as BetaManagedAgentsFileResource,
     type BetaManagedAgentsGitHubRepositoryResource as BetaManagedAgentsGitHubRepositoryResource,
+    type BetaManagedAgentsMemoryStoreResource as BetaManagedAgentsMemoryStoreResource,
     type BetaManagedAgentsSessionResource as BetaManagedAgentsSessionResource,
     type ResourceRetrieveResponse as ResourceRetrieveResponse,
     type ResourceUpdateResponse as ResourceUpdateResponse,

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

@@ -0,0 +1,283 @@
+// 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 { PageCursor, type PageCursorParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class UserProfiles extends APIResource {
+  /**
+   * Create User Profile
+   *
+   * @example
+   * ```ts
+   * const betaUserProfile =
+   *   await client.beta.userProfiles.create();
+   * ```
+   */
+  create(params: UserProfileCreateParams, options?: RequestOptions): APIPromise<BetaUserProfile> {
+    const { betas, ...body } = params;
+    return this._client.post('/v1/user_profiles?beta=true', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Get User Profile
+   *
+   * @example
+   * ```ts
+   * const betaUserProfile =
+   *   await client.beta.userProfiles.retrieve(
+   *     'uprof_011CZkZCu8hGbp5mYRQgUmz9',
+   *   );
+   * ```
+   */
+  retrieve(
+    userProfileID: string,
+    params: UserProfileRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaUserProfile> {
+    const { betas } = params ?? {};
+    return this._client.get(path`/v1/user_profiles/${userProfileID}?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Update User Profile
+   *
+   * @example
+   * ```ts
+   * const betaUserProfile =
+   *   await client.beta.userProfiles.update(
+   *     'uprof_011CZkZCu8hGbp5mYRQgUmz9',
+   *   );
+   * ```
+   */
+  update(
+    userProfileID: string,
+    params: UserProfileUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<BetaUserProfile> {
+    const { betas, ...body } = params;
+    return this._client.post(path`/v1/user_profiles/${userProfileID}?beta=true`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * List User Profiles
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const betaUserProfile of client.beta.userProfiles.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: UserProfileListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BetaUserProfilesPageCursor, BetaUserProfile> {
+    const { betas, ...query } = params ?? {};
+    return this._client.getAPIList('/v1/user_profiles?beta=true', PageCursor<BetaUserProfile>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Create Enrollment URL
+   *
+   * @example
+   * ```ts
+   * const betaUserProfileEnrollmentURL =
+   *   await client.beta.userProfiles.createEnrollmentURL(
+   *     'uprof_011CZkZCu8hGbp5mYRQgUmz9',
+   *   );
+   * ```
+   */
+  createEnrollmentURL(
+    userProfileID: string,
+    params: UserProfileCreateEnrollmentURLParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaUserProfileEnrollmentURL> {
+    const { betas } = params ?? {};
+    return this._client.post(path`/v1/user_profiles/${userProfileID}/enrollment_url?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export type BetaUserProfilesPageCursor = PageCursor<BetaUserProfile>;
+
+export interface BetaUserProfile {
+  /**
+   * Unique identifier for this user profile, prefixed `uprof_`.
+   */
+  id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  created_at: string;
+
+  /**
+   * Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up
+   * to 512 chars.
+   */
+  metadata: { [key: string]: string };
+
+  /**
+   * Trust grants for this profile, keyed by grant name. Key omitted when no grant is
+   * active or in flight.
+   */
+  trust_grants: { [key: string]: BetaUserProfileTrustGrant };
+
+  /**
+   * Object type. Always `user_profile`.
+   */
+  type: 'user_profile';
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  updated_at: string;
+
+  /**
+   * Platform's own identifier for this user. Not enforced unique.
+   */
+  external_id?: string | null;
+}
+
+export interface BetaUserProfileEnrollmentURL {
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  expires_at: string;
+
+  /**
+   * Object type. Always `enrollment_url`.
+   */
+  type: 'enrollment_url';
+
+  /**
+   * Enrollment URL to send to the end user. Valid until `expires_at`.
+   */
+  url: string;
+}
+
+export interface BetaUserProfileTrustGrant {
+  /**
+   * Status of the trust grant.
+   */
+  status: 'active' | 'pending' | 'rejected';
+}
+
+export interface UserProfileCreateParams {
+  /**
+   * Body param: Platform's own identifier for this user. Not enforced unique.
+   * Maximum 255 characters.
+   */
+  external_id?: string | null;
+
+  /**
+   * 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
+   * be non-empty strings.
+   */
+  metadata?: { [key: string]: string };
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface UserProfileRetrieveParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface UserProfileUpdateParams {
+  /**
+   * Body param: If present, replaces the stored external_id. Omit to leave
+   * unchanged. Maximum 255 characters.
+   */
+  external_id?: string | null;
+
+  /**
+   * 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.
+   * Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64
+   * characters and values up to 512 characters.
+   */
+  metadata?: { [key: string]: string };
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface UserProfileListParams extends PageCursorParams {
+  /**
+   * Query param: Query parameter for order
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface UserProfileCreateEnrollmentURLParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export declare namespace UserProfiles {
+  export {
+    type BetaUserProfile as BetaUserProfile,
+    type BetaUserProfileEnrollmentURL as BetaUserProfileEnrollmentURL,
+    type BetaUserProfileTrustGrant as BetaUserProfileTrustGrant,
+    type BetaUserProfilesPageCursor as BetaUserProfilesPageCursor,
+    type UserProfileCreateParams as UserProfileCreateParams,
+    type UserProfileRetrieveParams as UserProfileRetrieveParams,
+    type UserProfileUpdateParams as UserProfileUpdateParams,
+    type UserProfileListParams as UserProfileListParams,
+    type UserProfileCreateEnrollmentURLParams as UserProfileCreateEnrollmentURLParams,
+  };
+}

package/src/resources/completions.ts

@@ -149,38 +149,22 @@ export interface CompletionCreateParamsBase {
   stream?: boolean;
 
   /**
-   * Body param: Amount of randomness injected into the response.
-   *
-   * Defaults to `1.0`. Ranges from `0.0` to `1.0`. Use `temperature` closer to `0.0`
-   * for analytical / multiple choice, and closer to `1.0` for creative and
-   * generative tasks.
-   *
-   * Note that even with `temperature` of `0.0`, the results will not be fully
-   * deterministic.
+   * @deprecated Deprecated. Models released after Claude Opus 4.6 do not support
+   * setting temperature. A value of 1.0 of will be accepted for backwards
+   * compatibility, all other values will be rejected with a 400 error.
    */
   temperature?: number;
 
   /**
-   * Body param: Only sample from the top K options for each subsequent token.
-   *
-   * Used to remove "long tail" low probability responses.
-   * [Learn more technical details here](https://towardsdatascience.com/how-to-sample-from-language-models-682bceb97277).
-   *
-   * Recommended for advanced use cases only. You usually only need to use
-   * `temperature`.
+   * @deprecated Deprecated. Models released after Claude Opus 4.6 do not accept
+   * top_k; any value will be rejected with a 400 error.
    */
   top_k?: number;
 
   /**
-   * Body param: Use nucleus sampling.
-   *
-   * In nucleus sampling, we compute the cumulative distribution over all the options
-   * for each subsequent token in decreasing probability order and cut it off once it
-   * reaches a particular probability specified by `top_p`. You should either alter
-   * `temperature` or `top_p`, but not both.
-   *
-   * Recommended for advanced use cases only. You usually only need to use
-   * `temperature`.
+   * @deprecated Deprecated. Models released after Claude Opus 4.6 do not support
+   * setting top_p. A value >= 0.99 will be accepted for backwards compatibility, all
+   * other values will be rejected with a 400 error.
    */
   top_p?: number;
 

package/src/resources/messages/messages.ts

@@ -76,7 +76,7 @@ export class Messages extends APIResource {
       );
     }
     if (
-      body.model in MODELS_TO_WARN_WITH_THINKING_ENABLED &&
+      MODELS_TO_WARN_WITH_THINKING_ENABLED.includes(body.model) &&
       body.thinking &&
       body.thinking.type === 'enabled'
     ) {
@@ -1075,6 +1075,7 @@ export interface Metadata {
  * details and options.
  */
 export type Model =
+  | 'claude-opus-4-7'
   | 'claude-mythos-preview'
   | 'claude-opus-4-6'
   | 'claude-sonnet-4-6'
@@ -1097,7 +1098,7 @@ export interface OutputConfig {
   /**
    * All possible effort levels.
    */
-  effort?: 'low' | 'medium' | 'high' | 'max' | null;
+  effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
 
   /**
    * A schema to specify Claude's output format in responses. See
@@ -1128,7 +1129,7 @@ const DEPRECATED_MODELS: {
   'claude-sonnet-4-20250514': 'June 15th, 2026',
 };
 
-const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-opus-4-6'];
+const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-mythos-preview', 'claude-opus-4-6'];
 
 export interface PlainTextSource {
   data: string;

package/src/resources/models.ts

@@ -117,6 +117,11 @@ export interface EffortCapability {
    * Whether this capability is supported by the model.
    */
   supported: boolean;
+
+  /**
+   * Indicates whether a capability is supported.
+   */
+  xhigh: CapabilitySupport | null;
 }
 
 /**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.89.0'; // x-release-please-version
+export const VERSION = '0.91.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.89.0";
+export declare const VERSION = "0.91.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.89.0";
+export declare const VERSION = "0.91.0";
 //# sourceMappingURL=version.d.ts.map