@anthropic-ai/sdk 0.125.0 → 0.126.0

package/src/resources/beta/models.ts

@@ -83,6 +83,23 @@ export interface BetaCapabilitySupport {
   supported: boolean;
 }
 
+/**
+ * Compaction capability details: whether the model accepts the top-level
+ * `compaction` request parameter, with one entry per supported `compaction.type`
+ * value.
+ */
+export interface BetaCompactionCapability {
+  /**
+   * Whether the summarize compaction type is supported.
+   */
+  summarize: BetaCapabilitySupport;
+
+  /**
+   * Whether this capability is supported by the model.
+   */
+  supported: boolean;
+}
+
 /**
  * Context management capability details.
  */
@@ -162,6 +179,13 @@ export interface BetaModelCapabilities {
    */
   code_execution: BetaCapabilitySupport;
 
+  /**
+   * Compaction capability details: whether the model accepts the top-level
+   * `compaction` request parameter, with one entry per supported `compaction.type`
+   * value.
+   */
+  compaction: BetaCompactionCapability | null;
+
   /**
    * Context management support and available strategies.
    */
@@ -307,6 +331,7 @@ export interface ModelListParams extends PageParams {
 export declare namespace Models {
   export {
     type BetaCapabilitySupport as BetaCapabilitySupport,
+    type BetaCompactionCapability as BetaCompactionCapability,
     type BetaContextManagementCapability as BetaContextManagementCapability,
     type BetaEffortCapability as BetaEffortCapability,
     type BetaModelCapabilities as BetaModelCapabilities,

package/src/resources/beta/organization/workspaces/workspaces.ts

@@ -146,17 +146,17 @@ export interface BetaDataResidency {
   /**
    * Permitted inference geo values. 'unrestricted' means all geos are allowed.
    */
-  allowed_inference_geos: Array<string> | 'unrestricted';
+  allowed_inference_geos: Array<BetaAllowedInferenceGeo> | 'unrestricted';
 
   /**
    * Default inference geo applied when requests omit the parameter.
    */
-  default_inference_geo: string;
+  default_inference_geo: 'global' | 'us';
 
   /**
    * Geographic region for workspace data storage. Immutable after creation.
    */
-  workspace_geo: string;
+  workspace_geo: 'us';
 }
 
 export interface BetaDataResidencyCreateConfig {

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

@@ -226,7 +226,9 @@ export interface BetaManagedAgentsAgentCustomToolUseEvent {
   /**
    * When set, this event was cross-posted from a subagent's thread to surface its
    * custom tool use on the primary thread's stream. Empty on the thread's own
-   * events. Echo this on a `user.custom_tool_result` event to route the result back.
+   * events. Informational only: the server routes the matching
+   * `user.custom_tool_result` by `custom_tool_use_id`, so clients do not send it
+   * back.
    */
   session_thread_id?: string | null;
 }
@@ -314,8 +316,8 @@ export interface BetaManagedAgentsAgentMCPToolUseEvent {
   /**
    * When set, this event was cross-posted from a subagent's thread to surface its
    * permission request on the primary thread's stream. Empty on the thread's own
-   * events. Echo this on a `user.tool_confirmation` event to route the approval
-   * back.
+   * events. Informational only: the server routes the matching
+   * `user.tool_confirmation` by `tool_use_id`, so clients do not send it back.
    */
   session_thread_id?: string | null;
 }
@@ -574,8 +576,9 @@ export interface BetaManagedAgentsAgentToolUseEvent {
   /**
    * When set, this event was cross-posted from a subagent's thread to surface its
    * permission request on the primary thread's stream. Empty on the thread's own
-   * events. Echo this on a `user.tool_confirmation` event to route the approval
-   * back.
+   * events. Informational only: the server routes the matching
+   * `user.tool_confirmation` or `user.tool_result` by `tool_use_id`, so clients do
+   * not send it back.
    */
   session_thread_id?: string | null;
 }
@@ -1041,11 +1044,6 @@ export interface BetaManagedAgentsSessionErrorEvent {
    */
   id: string;
 
-  /**
-   * An unknown or unexpected error occurred during session execution. A fallback
-   * variant; clients that don't recognize a new error code can match on
-   * `retry_status` and `message` alone.
-   */
   error:
     | BetaManagedAgentsUnknownError
     | BetaManagedAgentsModelOverloadedError
@@ -1141,9 +1139,6 @@ export interface BetaManagedAgentsSessionStatusIdleEvent {
    */
   processed_at: string;
 
-  /**
-   * The agent completed its turn naturally and is ready for the next user message.
-   */
   stop_reason:
     | BetaManagedAgentsSessionEndTurn
     | BetaManagedAgentsSessionRequiresAction
@@ -1258,9 +1253,6 @@ export interface BetaManagedAgentsSessionThreadStatusIdleEvent {
    */
   session_thread_id: string;
 
-  /**
-   * The agent completed its turn naturally and is ready for the next user message.
-   */
   stop_reason:
     | BetaManagedAgentsSessionEndTurn
     | BetaManagedAgentsSessionRequiresAction
@@ -1777,8 +1769,8 @@ export interface BetaManagedAgentsUserCustomToolResultEvent {
   processed_at?: string | null;
 
   /**
-   * Routes this result to a subagent thread. Copy from the `agent.custom_tool_use`
-   * event's `session_thread_id`.
+   * Set by the server to the subagent thread this result was routed to. Omitted when
+   * it was routed to the primary thread.
    */
   session_thread_id?: string | null;
 }
@@ -1993,9 +1985,8 @@ export interface BetaManagedAgentsUserToolConfirmationEvent {
   processed_at?: string | null;
 
   /**
-   * When set, the confirmation routes to this subagent's thread rather than the
-   * primary. Echo this from the `session_thread_id` on the `agent.tool_use` or
-   * `agent.mcp_tool_use` event that prompted the approval.
+   * Set by the server to the subagent thread this confirmation was routed to.
+   * Omitted when it was routed to the primary thread.
    */
   session_thread_id?: string | null;
 }

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

@@ -268,9 +268,6 @@ export interface BetaManagedAgentsMemoryStoreResource {
   name?: string | null;
 }
 
-/**
- * A memory store attached to an agent session.
- */
 export type BetaManagedAgentsSessionResource =
   | BetaManagedAgentsGitHubRepositoryResource
   | BetaManagedAgentsFileResource

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

@@ -1077,8 +1077,8 @@ export interface BetaManagedAgentsUserToolResultEvent {
   processed_at?: string | null;
 
   /**
-   * Routes this result to a subagent thread. Copy from the `agent.tool_use` event's
-   * `session_thread_id`.
+   * Set by the server to the subagent thread this result was routed to. Omitted when
+   * it was routed to the primary thread.
    */
   session_thread_id?: string | null;
 }

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

@@ -17,12 +17,15 @@ export class UserProfiles extends APIResource {
    * ```
    */
   create(params: UserProfileCreateParams, options?: RequestOptions): APIPromise<BetaUserProfile> {
-    const { betas, ...body } = params;
+    const { betas, workspace_id, ...body } = params;
     return this._client.post('/v1/user_profiles?beta=true', {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -44,11 +47,14 @@ export class UserProfiles extends APIResource {
     params: UserProfileRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<BetaUserProfile> {
-    const { betas } = params ?? {};
+    const { betas, workspace_id } = params ?? {};
     return this._client.get(path`/v1/user_profiles/${userProfileID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -70,12 +76,15 @@ export class UserProfiles extends APIResource {
     params: UserProfileUpdateParams,
     options?: RequestOptions,
   ): APIPromise<BetaUserProfile> {
-    const { betas, ...body } = params;
+    const { betas, workspace_id, ...body } = params;
     return this._client.post(path`/v1/user_profiles/${userProfileID}?beta=true`, {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -96,12 +105,15 @@ export class UserProfiles extends APIResource {
     params: UserProfileListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<BetaUserProfilesPageCursor, BetaUserProfile> {
-    const { betas, ...query } = params ?? {};
+    const { betas, workspace_id, ...query } = params ?? {};
     return this._client.getAPIList('/v1/user_profiles?beta=true', PageCursor<BetaUserProfile>, {
       query,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -123,11 +135,14 @@ export class UserProfiles extends APIResource {
     params: UserProfileCreateEnrollmentURLParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<BetaUserProfileEnrollmentURL> {
-    const { betas } = params ?? {};
+    const { betas, workspace_id } = params ?? {};
     return this._client.post(path`/v1/user_profiles/${userProfileID}/enrollment_url?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -378,6 +393,16 @@ export interface UserProfileCreateParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileRetrieveParams {
@@ -385,6 +410,16 @@ export interface UserProfileRetrieveParams {
    * Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Optional header to select the Workspace for this request. The value is a
+   * Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileUpdateParams {
@@ -436,6 +471,16 @@ export interface UserProfileUpdateParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileListParams extends PageCursorParams {
@@ -453,6 +498,16 @@ export interface UserProfileListParams extends PageCursorParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileCreateEnrollmentURLParams {
@@ -460,6 +515,16 @@ export interface UserProfileCreateEnrollmentURLParams {
    * Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Optional header to select the Workspace for this request. The value is a
+   * Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export declare namespace UserProfiles {

package/src/resources/beta/vaults/credentials.ts

@@ -289,11 +289,6 @@ export interface BetaManagedAgentsCredential {
   display_name?: string | null;
 }
 
-/**
- * Substitute the secret on any host the session's Environment network policy
- * permits egress to. The Environment's network policy is the only boundary on
- * where the secret can reach.
- */
 export type BetaManagedAgentsCredentialNetworkingParams =
   | BetaManagedAgentsUnrestrictedCredentialNetworkingParams
   | BetaManagedAgentsLimitedCredentialNetworkingParams;
@@ -573,9 +568,6 @@ export interface BetaManagedAgentsMCPOAuthRefreshParams {
    */
   token_endpoint: string;
 
-  /**
-   * Token endpoint requires no client authentication.
-   */
   token_endpoint_auth:
     | BetaManagedAgentsTokenEndpointAuthNoneParam
     | BetaManagedAgentsTokenEndpointAuthBasicParam
@@ -606,9 +598,6 @@ export interface BetaManagedAgentsMCPOAuthRefreshResponse {
    */
   token_endpoint: string;
 
-  /**
-   * Token endpoint requires no client authentication.
-   */
   token_endpoint_auth:
     | BetaManagedAgentsTokenEndpointAuthNoneResponse
     | BetaManagedAgentsTokenEndpointAuthBasicResponse
@@ -639,9 +628,6 @@ export interface BetaManagedAgentsMCPOAuthRefreshUpdateParams {
    */
   scope?: string | null;
 
-  /**
-   * Updated HTTP Basic authentication parameters for the token endpoint.
-   */
   token_endpoint_auth?:
     | BetaManagedAgentsTokenEndpointAuthBasicUpdateParam
     | BetaManagedAgentsTokenEndpointAuthPostUpdateParam;

package/src/resources/completions.ts

@@ -156,7 +156,7 @@ export interface CompletionCreateParamsBase {
 
   /**
    * @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
+   * setting temperature. A value of 1.0 will be accepted for backwards
    * compatibility, all other values will be rejected with a 400 error.
    */
   temperature?: number;

package/src/resources/index.ts

@@ -255,6 +255,12 @@ export {
   type WebFetchToolResultErrorBlock,
   type WebFetchToolResultErrorBlockParam,
   type WebFetchToolResultErrorCode,
+  type WebFetchURLSourceAll,
+  type WebFetchURLSourceExcept,
+  type WebFetchURLSourceNone,
+  type WebFetchURLSourceOnly,
+  type WebFetchURLSourceToolReference,
+  type WebFetchURLSources,
   type WebSearchResultBlock,
   type WebSearchResultBlockParam,
   type WebSearchTool20250305,

package/src/resources/messages/index.ts

@@ -237,6 +237,12 @@ export {
   type WebFetchToolResultErrorBlock,
   type WebFetchToolResultErrorBlockParam,
   type WebFetchToolResultErrorCode,
+  type WebFetchURLSourceAll,
+  type WebFetchURLSourceExcept,
+  type WebFetchURLSourceNone,
+  type WebFetchURLSourceOnly,
+  type WebFetchURLSourceToolReference,
+  type WebFetchURLSources,
   type WebSearchResultBlock,
   type WebSearchResultBlockParam,
   type WebSearchTool20250305,