@anthropic-ai/sdk 0.116.0 → 0.118.0

package/src/lib/tools/SessionToolRunner.ts

@@ -11,7 +11,7 @@ import type {
 import type { BetaToolResultContentBlockParam } from '../../resources/beta';
 import { loggerFor, type Logger } from '../../internal/utils/log';
 import { sleep } from '../../internal/utils/sleep';
-import { isFatal4xx } from '../../internal/utils/backoff';
+import { applyJitter, backoff, isFatal4xx } from '../../internal/utils/backoff';
 import { linkAbort } from '../../internal/utils/abort';
 import { AsyncQueue } from '../../internal/utils/async-queue';
 import { buildHeaders } from '../../internal/headers';
@@ -27,7 +27,16 @@ const STREAM_BACKOFF_START_MS = 500;
 const STREAM_BACKOFF_CAP_MS = 10_000;
 const TOOL_TIMEOUT_MS = 120_000;
 const DRAIN_TIMEOUT_MS = 30_000;
-const SEND_RETRIES = 3;
+const SEND_BACKOFF_START_MS = 1_000;
+const SEND_BACKOFF_CAP_MS = 30_000;
+/**
+ * How long a transiently failing tool-result send keeps retrying when the
+ * runner is used on its own: the server's default work-item lease TTL.
+ * `EnvironmentWorker` overrides it with the live TTL from each lease heartbeat
+ * (`_setSendRetryWindow`), so a send is only abandoned once the lease can no
+ * longer be ours.
+ */
+const SEND_RETRY_WINDOW_MS = 5 * 60_000;
 
 /** Block type accepted in a `user.tool_result` event's content — codegen'd, stays in sync with the API. */
 type SessionContentBlock = NonNullable<BetaManagedAgentsUserToolResultEventParams['content']>[number];
@@ -310,6 +319,7 @@ export class SessionToolRunner implements AsyncIterable<DispatchedToolCall> {
   readonly #awaitingConfirmation = new Map<string, DispatchedToolUseEvent>();
   readonly #results = new AsyncQueue<DispatchedToolCall>();
   #inFlightCount = 0;
+  #sendRetryWindowMs = SEND_RETRY_WINDOW_MS;
   #onIdle: (() => void) | null = null;
   readonly #idleClock: IdleClock;
 
@@ -343,6 +353,15 @@ export class SessionToolRunner implements AsyncIterable<DispatchedToolCall> {
     this.#controller.abort();
   }
 
+  /**
+   * @internal
+   * `EnvironmentWorker` keeps this equal to the lease TTL each heartbeat
+   * reports; applies to a send already retrying.
+   */
+  _setSendRetryWindow(ms: number): void {
+    this.#sendRetryWindowMs = ms;
+  }
+
   async *[Symbol.asyncIterator](): AsyncIterator<DispatchedToolCall> {
     if (this.#consumed) {
       throw new AnthropicError('Cannot iterate over a consumed SessionToolRunner');
@@ -764,8 +783,11 @@ export class SessionToolRunner implements AsyncIterable<DispatchedToolCall> {
 
   async #sendResult(result: DispatchedToolResultParams, toolUseId: string): Promise<boolean> {
     const ctrl = this.#controller;
+    const start = Date.now();
     let lastErr: unknown;
-    for (let i = 0; i < SEND_RETRIES; i++) {
+    let attempt = 0;
+    while (true) {
+      attempt++;
       // An abort throws to unwind the caller rather than returning a
       // `posted: false` result the iterator would carry on past.
       ctrl.signal.throwIfAborted();
@@ -782,13 +804,24 @@ export class SessionToolRunner implements AsyncIterable<DispatchedToolCall> {
         // Only short-circuit on a permanent 4xx; 408/409/429 deserve the
         // remaining retries (aligned with the core client's retry policy).
         if (isFatal4xx(e)) break;
-        // Back off only *between* attempts — never after the final one, since
-        // there is no further try left to wait for.
-        if (i < SEND_RETRIES - 1) await sleep((i + 1) * 1000, ctrl.signal);
+        const remainingMs = this.#sendRetryWindowMs - (Date.now() - start);
+        if (remainingMs <= 0) break;
+        const waitMs = Math.min(
+          applyJitter(backoff(attempt - 1, SEND_BACKOFF_START_MS, SEND_BACKOFF_CAP_MS)),
+          remainingMs,
+        );
+        this.#logger.warn('tool result send failed; retrying', {
+          tool_use_id: toolUseId,
+          attempt,
+          backoff_ms: waitMs,
+          error: String(e),
+        });
+        await sleep(waitMs, ctrl.signal);
       }
     }
     this.#logger.error('failed to send tool result', {
       tool_use_id: toolUseId,
+      attempts: attempt,
       error: String(lastErr),
     });
     return false;

package/src/resources/beta/agents/agents.ts

@@ -21,7 +21,7 @@ export class Agents extends APIResource {
    * ```ts
    * const betaManagedAgentsAgent =
    *   await client.beta.agents.create({
-   *     model: 'claude-sonnet-4-6',
+   *     model: 'claude-opus-5',
    *     name: 'My First Agent',
    *   });
    * ```
@@ -915,7 +915,7 @@ export interface AgentCreateParams {
   /**
    * Body param: Model identifier. Accepts the
    * [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
-   * e.g. `claude-opus-4-6`, or a `model_config` object for additional configuration
+   * e.g. `claude-opus-5`, or a `model_config` object for additional configuration
    * control
    */
   model: BetaManagedAgentsModel | BetaManagedAgentsModelConfigParams;
@@ -1015,7 +1015,7 @@ export interface AgentUpdateParams {
   /**
    * Body param: Model identifier. Accepts the
    * [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
-   * e.g. `claude-opus-4-6`, or a `model_config` object for additional configuration
+   * e.g. `claude-opus-5`, or a `model_config` object for additional configuration
    * control. Omit to preserve. Cannot be cleared.
    */
   model?: BetaManagedAgentsModel | BetaManagedAgentsModelConfigParams;

package/src/resources/beta/beta.ts

@@ -89,6 +89,9 @@ import {
   BetaDreamStatus,
   BetaDreamUsage,
   BetaDreamsPageCursor,
+  BetaOutputBehavior,
+  BetaOutputBehaviorCreateNew,
+  BetaOutputBehaviorUpdateExisting,
   DreamArchiveParams,
   DreamCancelParams,
   DreamCreateParams,
@@ -400,7 +403,6 @@ import {
   BetaMessageParam,
   BetaMessageTokensCount,
   BetaMetadata,
-  BetaMidConversationSystemBlockParam,
   BetaOutputConfig,
   BetaOutputTokensDetails,
   BetaPlainTextSource,
@@ -643,6 +645,7 @@ export type AnthropicBeta =
   | 'fast-mode-2026-02-01'
   | 'output-300k-2026-03-24'
   | 'user-profiles-2026-03-24'
+  | 'user-profiles-2026-08-18'
   | 'advisor-tool-2026-03-01'
   | 'managed-agents-2026-04-01'
   | 'cache-diagnosis-2026-04-07'
@@ -921,7 +924,6 @@ export declare namespace Beta {
     type BetaMessageParam as BetaMessageParam,
     type BetaMessageTokensCount as BetaMessageTokensCount,
     type BetaMetadata as BetaMetadata,
-    type BetaMidConversationSystemBlockParam as BetaMidConversationSystemBlockParam,
     type BetaOutputConfig as BetaOutputConfig,
     type BetaOutputTokensDetails as BetaOutputTokensDetails,
     type BetaPlainTextSource as BetaPlainTextSource,
@@ -1361,6 +1363,9 @@ export declare namespace Beta {
     type BetaDreamSessionsInput as BetaDreamSessionsInput,
     type BetaDreamStatus as BetaDreamStatus,
     type BetaDreamUsage as BetaDreamUsage,
+    type BetaOutputBehavior as BetaOutputBehavior,
+    type BetaOutputBehaviorCreateNew as BetaOutputBehaviorCreateNew,
+    type BetaOutputBehaviorUpdateExisting as BetaOutputBehaviorUpdateExisting,
     type BetaDreamsPageCursor as BetaDreamsPageCursor,
     type DreamCreateParams as DreamCreateParams,
     type DreamRetrieveParams as DreamRetrieveParams,

package/src/resources/beta/dreams.ts

@@ -138,9 +138,10 @@ export type BetaDreamsPageCursor = PageCursor<BetaDream>;
 
 /**
  * An asynchronous memory-consolidation job that reads a memory store plus a set of
- * session transcripts and writes consolidated memories into a new output memory
- * store. The Dreams API is in research preview: the request and response shapes
- * are volatile and may change without the deprecation period that applies to
+ * session transcripts and writes consolidated memories into an output memory store
+ * — a new store by default, or an existing store chosen via output_behavior. The
+ * Dreams API is in research preview: the request and response shapes are volatile
+ * and may change without the deprecation period that applies to
  * generally-available endpoints.
  */
 export interface BetaDream {
@@ -176,6 +177,13 @@ export interface BetaDream {
    */
   model: BetaDreamModelConfig;
 
+  /**
+   * The default destination: the job creates a new output memory store as a clone of
+   * the memory_store input and writes the consolidated memories into it. The input
+   * store is never mutated.
+   */
+  output_behavior: BetaOutputBehavior;
+
   outputs: Array<BetaDreamOutput>;
 
   session_id: string | null;
@@ -203,12 +211,16 @@ export interface BetaDreamError {
 }
 
 /**
- * An input memory store the dream reads from. The dream never mutates this store.
+ * An input memory store the dream reads from. The dream never mutates this store
+ * unless it is also the destination: with output_behavior {type:
+ * "update_existing"} the job consolidates this store in place.
  */
 export type BetaDreamInput = BetaDreamMemoryStoreInput | BetaDreamSessionsInput;
 
 /**
- * An input memory store the dream reads from. The dream never mutates this store.
+ * An input memory store the dream reads from. The dream never mutates this store
+ * unless it is also the destination: with output_behavior {type:
+ * "update_existing"} the job consolidates this store in place.
  */
 export interface BetaDreamMemoryStoreInput {
   memory_store_id: string;
@@ -231,7 +243,7 @@ export interface BetaDreamMemoryStoreOutput {
  */
 export interface BetaDreamModelConfig {
   /**
-   * Model identifier, e.g. "claude-opus-4-7". 1-256 characters.
+   * Model identifier, e.g. "claude-opus-5". 1-256 characters.
    */
   id: string;
 
@@ -248,7 +260,7 @@ export interface BetaDreamModelConfig {
  */
 export interface BetaDreamModelConfigParam {
   /**
-   * Model identifier, e.g. "claude-opus-4-7". 1-256 characters.
+   * Model identifier, e.g. "claude-opus-5". 1-256 characters.
    */
   id: string;
 
@@ -308,6 +320,33 @@ export interface BetaDreamUsage {
   output_tokens: number;
 }
 
+/**
+ * The default destination: the job creates a new output memory store as a clone of
+ * the memory_store input and writes the consolidated memories into it. The input
+ * store is never mutated.
+ */
+export type BetaOutputBehavior = BetaOutputBehaviorCreateNew | BetaOutputBehaviorUpdateExisting;
+
+/**
+ * The default destination: the job creates a new output memory store as a clone of
+ * the memory_store input and writes the consolidated memories into it. The input
+ * store is never mutated.
+ */
+export interface BetaOutputBehaviorCreateNew {
+  type: 'create_new';
+}
+
+/**
+ * The job writes the consolidated memories into this existing memory store instead
+ * of creating one. In EAP the store must be the job's own memory_store input, so
+ * the job consolidates the store in place.
+ */
+export interface BetaOutputBehaviorUpdateExisting {
+  memory_store_id: string;
+
+  type: 'update_existing';
+}
+
 export interface DreamCreateParams {
   /**
    * Body param
@@ -324,6 +363,13 @@ export interface DreamCreateParams {
    */
   instructions?: string | null;
 
+  /**
+   * Body param: The default destination: the job creates a new output memory store
+   * as a clone of the memory_store input and writes the consolidated memories into
+   * it. The input store is never mutated.
+   */
+  output_behavior?: BetaOutputBehavior;
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -394,6 +440,9 @@ export declare namespace Dreams {
     type BetaDreamSessionsInput as BetaDreamSessionsInput,
     type BetaDreamStatus as BetaDreamStatus,
     type BetaDreamUsage as BetaDreamUsage,
+    type BetaOutputBehavior as BetaOutputBehavior,
+    type BetaOutputBehaviorCreateNew as BetaOutputBehaviorCreateNew,
+    type BetaOutputBehaviorUpdateExisting as BetaOutputBehaviorUpdateExisting,
     type BetaDreamsPageCursor as BetaDreamsPageCursor,
     type DreamCreateParams as DreamCreateParams,
     type DreamRetrieveParams as DreamRetrieveParams,

package/src/resources/beta/environments/environments.ts

@@ -260,9 +260,9 @@ export interface BetaEnvironment {
   created_at: string;
 
   /**
-   * User-provided description for the environment
+   * User-provided description for the environment; null when unset
    */
-  description: string;
+  description: string | null;
 
   /**
    * User-provided metadata key-value pairs
@@ -525,7 +525,8 @@ export interface EnvironmentUpdateParams {
   config?: BetaCloudConfigParams | BetaSelfHostedConfigParams | null;
 
   /**
-   * Body param: Updated description of the environment
+   * Body param: Updated description of the environment. Omit to preserve; null
+   * clears to null; an empty string is stored as an empty string.
    */
   description?: string | null;
 

package/src/resources/beta/index.ts

@@ -156,6 +156,9 @@ export {
   type BetaDreamSessionsInput,
   type BetaDreamStatus,
   type BetaDreamUsage,
+  type BetaOutputBehavior,
+  type BetaOutputBehaviorCreateNew,
+  type BetaOutputBehaviorUpdateExisting,
   type DreamCreateParams,
   type DreamRetrieveParams,
   type DreamListParams,
@@ -333,7 +336,6 @@ export {
   type BetaMessageParam,
   type BetaMessageTokensCount,
   type BetaMetadata,
-  type BetaMidConversationSystemBlockParam,
   type BetaOutputConfig,
   type BetaOutputTokensDetails,
   type BetaPlainTextSource,

package/src/resources/beta/memory-stores/index.ts

@@ -38,6 +38,7 @@ export {
   type BetaManagedAgentsAPIActor,
   type BetaManagedAgentsMemoryVersion,
   type BetaManagedAgentsMemoryVersionOperation,
+  type BetaManagedAgentsServiceAccountActor,
   type BetaManagedAgentsSessionActor,
   type BetaManagedAgentsUserActor,
   type MemoryVersionRetrieveParams,

package/src/resources/beta/memory-stores/memory-stores.ts

@@ -30,6 +30,7 @@ import {
   BetaManagedAgentsMemoryVersion,
   BetaManagedAgentsMemoryVersionOperation,
   BetaManagedAgentsMemoryVersionsPageCursor,
+  BetaManagedAgentsServiceAccountActor,
   BetaManagedAgentsSessionActor,
   BetaManagedAgentsUserActor,
   MemoryVersionListParams,
@@ -408,6 +409,7 @@ export declare namespace MemoryStores {
     type BetaManagedAgentsAPIActor as BetaManagedAgentsAPIActor,
     type BetaManagedAgentsMemoryVersion as BetaManagedAgentsMemoryVersion,
     type BetaManagedAgentsMemoryVersionOperation as BetaManagedAgentsMemoryVersionOperation,
+    type BetaManagedAgentsServiceAccountActor as BetaManagedAgentsServiceAccountActor,
     type BetaManagedAgentsSessionActor as BetaManagedAgentsSessionActor,
     type BetaManagedAgentsUserActor as BetaManagedAgentsUserActor,
     type BetaManagedAgentsMemoryVersionsPageCursor as BetaManagedAgentsMemoryVersionsPageCursor,

package/src/resources/beta/memory-stores/memory-versions.ts

@@ -117,7 +117,8 @@ export type BetaManagedAgentsMemoryVersionsPageCursor = PageCursor<BetaManagedAg
 export type BetaManagedAgentsActor =
   | BetaManagedAgentsSessionActor
   | BetaManagedAgentsAPIActor
-  | BetaManagedAgentsUserActor;
+  | BetaManagedAgentsUserActor
+  | BetaManagedAgentsServiceAccountActor;
 
 /**
  * Attribution for a write made directly via the public API (outside of any
@@ -228,6 +229,19 @@ export interface BetaManagedAgentsMemoryVersion {
  */
 export type BetaManagedAgentsMemoryVersionOperation = 'created' | 'modified' | 'deleted';
 
+/**
+ * Attribution for a write made by a workload authenticated as a service account,
+ * for example via Workload Identity Federation.
+ */
+export interface BetaManagedAgentsServiceAccountActor {
+  /**
+   * ID of the service account that performed the write (a `svac_...` value).
+   */
+  service_account_id: string;
+
+  type: 'service_account_actor';
+}
+
 /**
  * Attribution for a write made by an agent during a session, through the mounted
  * filesystem at `/mnt/memory/`.
@@ -298,6 +312,11 @@ export interface MemoryVersionListParams extends PageCursorParams {
    */
   operation?: BetaManagedAgentsMemoryVersionOperation;
 
+  /**
+   * Query param: Query parameter for service_account_id
+   */
+  service_account_id?: string;
+
   /**
    * Query param: Query parameter for session_id
    */
@@ -332,6 +351,7 @@ export declare namespace MemoryVersions {
     type BetaManagedAgentsAPIActor as BetaManagedAgentsAPIActor,
     type BetaManagedAgentsMemoryVersion as BetaManagedAgentsMemoryVersion,
     type BetaManagedAgentsMemoryVersionOperation as BetaManagedAgentsMemoryVersionOperation,
+    type BetaManagedAgentsServiceAccountActor as BetaManagedAgentsServiceAccountActor,
     type BetaManagedAgentsSessionActor as BetaManagedAgentsSessionActor,
     type BetaManagedAgentsUserActor as BetaManagedAgentsUserActor,
     type BetaManagedAgentsMemoryVersionsPageCursor as BetaManagedAgentsMemoryVersionsPageCursor,

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

@@ -35,7 +35,7 @@ export class Batches extends APIResource {
    *           messages: [
    *             { content: 'Hello, world', role: 'user' },
    *           ],
-   *           model: 'claude-opus-4-6',
+   *           model: 'claude-opus-5',
    *         },
    *       },
    *     ],

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

@@ -142,7 +142,6 @@ export {
   type BetaMessageParam,
   type BetaMessageTokensCount,
   type BetaMetadata,
-  type BetaMidConversationSystemBlockParam,
   type BetaOutputConfig,
   type BetaOutputTokensDetails,
   type BetaPlainTextSource,

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

@@ -70,7 +70,7 @@ export class Messages extends APIResource {
    * const betaMessage = await client.beta.messages.create({
    *   max_tokens: 1024,
    *   messages: [{ content: 'Hello, world', role: 'user' }],
-   *   model: 'claude-opus-4-6',
+   *   model: 'claude-opus-5',
    * });
    * ```
    */
@@ -110,7 +110,7 @@ export class Messages extends APIResource {
       );
     }
 
-    let timeout = (this._client as any)._options.timeout as number | null;
+    let timeout = options?.timeout ?? ((this._client as any)._options.timeout as number | null);
     if (!body.stream && timeout == null) {
       const maxNonstreamingTokens = MODEL_NONSTREAMING_TOKENS[body.model] ?? undefined;
       timeout = this._client.calculateNonstreamingTimeout(body.max_tokens, maxNonstreamingTokens);
@@ -192,7 +192,7 @@ export class Messages extends APIResource {
    * const betaMessageTokensCount =
    *   await client.beta.messages.countTokens({
    *     messages: [{ content: 'Hello, world', role: 'user' }],
-   *     model: 'claude-opus-4-6',
+   *     model: 'claude-opus-5',
    *   });
    * ```
    */
@@ -1419,7 +1419,6 @@ export type BetaContentBlockParam =
   | BetaRequestMCPToolResultBlockParam
   | BetaContainerUploadBlockParam
   | BetaCompactionBlockParam
-  | BetaMidConversationSystemBlockParam
   | BetaRequestToolAdditionBlock
   | BetaRequestToolRemovalBlock
   | BetaFallbackBlockParam;
@@ -2418,27 +2417,6 @@ export interface BetaMetadata {
   user_id?: string | null;
 }
 
-/**
- * System instructions that appear mid-conversation.
- *
- * Use this block to provide or update system-level instructions at a specific
- * point in the conversation, rather than only via the top-level `system`
- * parameter.
- */
-export interface BetaMidConversationSystemBlockParam {
-  /**
-   * System instruction text blocks.
-   */
-  content: Array<BetaTextBlockParam | BetaRequestToolAdditionBlock | BetaRequestToolRemovalBlock>;
-
-  type: 'mid_conv_system';
-
-  /**
-   * Create a cache control breakpoint at this content block.
-   */
-  cache_control?: BetaCacheControlEphemeral | null;
-}
-
 export interface BetaOutputConfig {
   /**
    * All possible effort levels.
@@ -5560,7 +5538,6 @@ export declare namespace Messages {
     type BetaMessageParam as BetaMessageParam,
     type BetaMessageTokensCount as BetaMessageTokensCount,
     type BetaMetadata as BetaMetadata,
-    type BetaMidConversationSystemBlockParam as BetaMidConversationSystemBlockParam,
     type BetaOutputConfig as BetaOutputConfig,
     type BetaOutputTokensDetails as BetaOutputTokensDetails,
     type BetaPlainTextSource as BetaPlainTextSource,

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

@@ -370,7 +370,7 @@ export interface BetaManagedAgentsAgentWithOverridesParams {
   mcp_servers?: Array<AgentsAPI.BetaManagedAgentsURLMCPServerParams>;
 
   /**
-   * Replacement model. Accepts the model string, e.g. `claude-opus-4-6`, or a
+   * Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a
    * `model_config` object. Omit to use the agent's model.
    */
   model?: AgentsAPI.BetaManagedAgentsModel | AgentsAPI.BetaManagedAgentsModelConfigParams;

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

@@ -24,7 +24,7 @@ export class UserProfiles extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
         options?.headers,
       ]),
     });
@@ -50,7 +50,7 @@ export class UserProfiles extends APIResource {
     return this._client.get(path`/v1/user_profiles/${userProfileID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
         options?.headers,
       ]),
     });
@@ -77,7 +77,7 @@ export class UserProfiles extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
         options?.headers,
       ]),
     });
@@ -103,7 +103,7 @@ export class UserProfiles extends APIResource {
       query,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-03-24'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
         options?.headers,
       ]),
     });
@@ -129,7 +129,7 @@ export class UserProfiles extends APIResource {
     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() },
+        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
         options?.headers,
       ]),
     });
@@ -155,13 +155,6 @@ export interface BetaUserProfile {
    */
   metadata: { [key: string]: string };
 
-  /**
-   * 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';
-
   /**
    * Trust grants for this profile, keyed by grant name. Key omitted when no grant is
    * active or in flight.
@@ -178,16 +171,33 @@ export interface BetaUserProfile {
    */
   updated_at: string;
 
+  /**
+   * How the platform uses the API on behalf of the entity this profile represents.
+   * `application`: the platform sells a product that uses the API behind the scenes,
+   * and the profile represents an individual end-user of that product.
+   * `passthrough`: the platform resells raw inference, and the profile identifies
+   * the resold-to company.
+   */
+  access_type?: 'application' | 'passthrough';
+
   /**
    * Platform's own identifier for this user. Not enforced unique.
    */
   external_id?: string | null;
 
   /**
-   * Display name of the entity this profile represents. For `resold` this is the
-   * resold-to company's name.
+   * 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.
    */
   name?: 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.
+   */
+  relationship?: 'external' | 'resold' | 'internal';
 }
 
 export interface BetaUserProfileEnrollmentURL {
@@ -215,6 +225,15 @@ export interface BetaUserProfileTrustGrant {
 }
 
 export interface UserProfileCreateParams {
+  /**
+   * Body param: How the platform uses the API on behalf of the entity this profile
+   * represents. `application`: the platform sells a product that uses the API behind
+   * the scenes, and the profile represents an individual end-user of that product.
+   * `passthrough`: the platform resells raw inference, and the profile identifies
+   * the resold-to company.
+   */
+  access_type?: 'application' | 'passthrough';
+
   /**
    * Body param: Platform's own identifier for this user. Not enforced unique.
    * Maximum 255 characters.
@@ -229,9 +248,10 @@ export interface UserProfileCreateParams {
   metadata?: { [key: string]: string };
 
   /**
-   * Body param: Display name of the entity this profile represents. Required when
-   * relationship is `resold` (the resold-to company's name); optional otherwise.
-   * Maximum 255 characters.
+   * 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.
    */
   name?: string | null;
 
@@ -257,6 +277,15 @@ export interface UserProfileRetrieveParams {
 }
 
 export interface UserProfileUpdateParams {
+  /**
+   * Body param: How the platform uses the API on behalf of the entity this profile
+   * represents. `application`: the platform sells a product that uses the API behind
+   * the scenes, and the profile represents an individual end-user of that product.
+   * `passthrough`: the platform resells raw inference, and the profile identifies
+   * the resold-to company.
+   */
+  access_type?: 'application' | 'passthrough' | null;
+
   /**
    * Body param: If present, replaces the stored external_id. Omit to leave
    * unchanged. Maximum 255 characters.

package/src/resources/index.ts

@@ -94,7 +94,6 @@ export {
   type MessageStreamParams,
   type MessageTokensCount,
   type Metadata,
-  type MidConversationSystemBlockParam,
   type Model,
   type OutputConfig,
   type OutputTokensDetails,

package/src/resources/messages/batches.ts

@@ -33,7 +33,7 @@ export class Batches extends APIResource {
    *         messages: [
    *           { content: 'Hello, world', role: 'user' },
    *         ],
-   *         model: 'claude-opus-4-6',
+   *         model: 'claude-opus-5',
    *       },
    *     },
    *   ],

package/src/resources/messages/index.ts

@@ -83,7 +83,6 @@ export {
   type MessageParam,
   type MessageTokensCount,
   type Metadata,
-  type MidConversationSystemBlockParam,
   type Model,
   type OutputConfig,
   type OutputTokensDetails,