@anthropic-ai/sdk 0.117.1 → 0.118.0

package/src/core/error.ts

@@ -18,6 +18,7 @@ export class APIError<
   readonly error: TError;
 
   readonly requestID: string | null | undefined;
+  readonly workspaceID: string | null | undefined;
 
   /** The `error.type` from the API response body, e.g. `"rate_limit_error"` */
   readonly type: ErrorType | null;
@@ -33,6 +34,7 @@ export class APIError<
     this.status = status;
     this.headers = headers;
     this.requestID = headers?.get('request-id');
+    this.workspaceID = headers?.get('anthropic-workspace-id');
     this.error = error;
     this.type = type ?? null;
   }

package/src/core/middleware.ts

@@ -1,7 +1,7 @@
 import type { BaseAnthropic } from '../client';
 import type { Fetch } from '../internal/builtin-types';
 import { castToError, isAbortError } from '../internal/errors';
-import { addRequestID } from '../internal/parse';
+import { addResponseIDs } from '../internal/parse';
 import type { FinalRequestOptions } from '../internal/request-options';
 import { defaultLogger, loggerFor, type Logger } from '../internal/utils/log';
 import type { APIRequest } from './api';
@@ -299,7 +299,7 @@ async function parseMiddlewareResponse(
       // if there is no content we can't do anything
       return undefined;
     }
-    return addRequestID(await response.clone().json(), response);
+    return addResponseIDs(await response.clone().json(), response);
   }
 
   return await response.clone().text();

package/src/helpers/beta/zod.ts

@@ -16,9 +16,7 @@ import { BetaToolResultContentBlockParam } from '../../resources/beta';
 export function betaZodOutputFormat<ZodInput extends z.ZodType>(
   zodObject: ZodInput,
 ): AutoParseableBetaOutputFormat<z.infer<ZodInput>> {
-  let jsonSchema = z.toJSONSchema(zodObject, { reused: 'ref' });
-
-  jsonSchema = transformJSONSchema(jsonSchema);
+  const jsonSchema = transformJSONSchema(z.toJSONSchema(zodObject, { reused: 'ref' }));
 
   return {
     type: 'json_schema',

package/src/helpers/zod.ts

@@ -15,9 +15,7 @@ import { AutoParseableOutputFormat } from '../lib/parser';
 export function zodOutputFormat<ZodInput extends z.ZodType>(
   zodObject: ZodInput,
 ): AutoParseableOutputFormat<z.infer<ZodInput>> {
-  let jsonSchema = z.toJSONSchema(zodObject, { reused: 'ref' });
-
-  jsonSchema = transformJSONSchema(jsonSchema);
+  const jsonSchema = transformJSONSchema(z.toJSONSchema(zodObject, { reused: 'ref' }));
 
   return {
     type: 'json_schema',

package/src/internal/parse.ts

@@ -51,7 +51,7 @@ export async function defaultParseResponse<T>(
       }
 
       const json = await response.json();
-      return addRequestID(json as T, response);
+      return addResponseIDs(json as T, response);
     }
 
     const text = await response.text();
@@ -80,16 +80,16 @@ export async function defaultParseResponse<T>(
 
 export type WithRequestID<T> =
   T extends Array<any> | Response | AbstractPage<any> ? T
-  : T extends Record<string, any> ? T & { _request_id?: string | null }
+  : T extends Record<string, any> ? T & { _request_id?: string | null; _workspace_id?: string | null }
   : T;
 
-export function addRequestID<T>(value: T, response: Response): WithRequestID<T> {
+export function addResponseIDs<T>(value: T, response: Response): WithRequestID<T> {
   if (!value || typeof value !== 'object' || Array.isArray(value)) {
     return value as WithRequestID<T>;
   }
 
-  return Object.defineProperty(value, '_request_id', {
-    value: response.headers.get('request-id'),
-    enumerable: false,
+  return Object.defineProperties(value, {
+    _request_id: { value: response.headers.get('request-id'), enumerable: false },
+    _workspace_id: { value: response.headers.get('anthropic-workspace-id'), enumerable: false },
   }) as WithRequestID<T>;
 }

package/src/lib/BetaMessageStream.ts

@@ -74,6 +74,7 @@ export class BetaMessageStream<ParsedT = null> implements AsyncIterable<BetaMess
   #catchingPromiseCreated = false;
   #response: Response | null | undefined;
   #request_id: string | null | undefined;
+  #workspace_id: string | null | undefined;
   #logger: Logger;
 
   constructor(params: MessageCreateParamsBase | null, opts?: { logger?: Logger | undefined }) {
@@ -106,6 +107,10 @@ export class BetaMessageStream<ParsedT = null> implements AsyncIterable<BetaMess
     return this.#request_id;
   }
 
+  get workspace_id(): string | null | undefined {
+    return this.#workspace_id;
+  }
+
   /**
    * Returns the `MessageStream` data, the raw `Response` instance and the ID of the request,
    * returned vie the `request-id` header which is useful for debugging requests and resporting
@@ -120,6 +125,7 @@ export class BetaMessageStream<ParsedT = null> implements AsyncIterable<BetaMess
     data: BetaMessageStream<ParsedT>;
     response: Response;
     request_id: string | null | undefined;
+    workspace_id: string | null | undefined;
   }> {
     this.#catchingPromiseCreated = true;
 
@@ -132,6 +138,7 @@ export class BetaMessageStream<ParsedT = null> implements AsyncIterable<BetaMess
       data: this,
       response,
       request_id: response.headers.get('request-id'),
+      workspace_id: response.headers.get('anthropic-workspace-id'),
     };
   }
 
@@ -223,6 +230,7 @@ export class BetaMessageStream<ParsedT = null> implements AsyncIterable<BetaMess
     if (this.ended) return;
     this.#response = response;
     this.#request_id = response?.headers.get('request-id');
+    this.#workspace_id = response?.headers.get('anthropic-workspace-id');
     this.#resolveConnectedPromise(response);
     this._emit('connect');
   }

package/src/lib/MessageStream.ts

@@ -73,6 +73,7 @@ export class MessageStream<ParsedT = null> implements AsyncIterable<MessageStrea
   #catchingPromiseCreated = false;
   #response: Response | null | undefined;
   #request_id: string | null | undefined;
+  #workspace_id: string | null | undefined;
   #logger: Logger;
 
   constructor(params: MessageCreateParamsBase | null, opts?: { logger?: Logger | undefined }) {
@@ -105,6 +106,10 @@ export class MessageStream<ParsedT = null> implements AsyncIterable<MessageStrea
     return this.#request_id;
   }
 
+  get workspace_id(): string | null | undefined {
+    return this.#workspace_id;
+  }
+
   /**
    * Returns the `MessageStream` data, the raw `Response` instance and the ID of the request,
    * returned vie the `request-id` header which is useful for debugging requests and resporting
@@ -119,6 +124,7 @@ export class MessageStream<ParsedT = null> implements AsyncIterable<MessageStrea
     data: MessageStream<ParsedT>;
     response: Response;
     request_id: string | null | undefined;
+    workspace_id: string | null | undefined;
   }> {
     this.#catchingPromiseCreated = true;
 
@@ -131,6 +137,7 @@ export class MessageStream<ParsedT = null> implements AsyncIterable<MessageStrea
       data: this,
       response,
       request_id: response.headers.get('request-id'),
+      workspace_id: response.headers.get('anthropic-workspace-id'),
     };
   }
 
@@ -222,6 +229,7 @@ export class MessageStream<ParsedT = null> implements AsyncIterable<MessageStrea
     if (this.ended) return;
     this.#response = response;
     this.#request_id = response?.headers.get('request-id');
+    this.#workspace_id = response?.headers.get('anthropic-workspace-id');
     this.#resolveConnectedPromise(response);
     this._emit('connect');
   }

package/src/lib/environments/worker.ts

@@ -52,6 +52,10 @@ export interface EnvironmentWorkerOptions {
    * Tools to expose to each claimed session. Defaults to
    * `betaAgentToolset20260401(ctx)` (the standard `agent_toolset_20260401` set
    * bound to the per-session {@link AgentToolContext}).
+   *
+   * A `run` that blocks the event loop synchronously also stalls the lease
+   * heartbeat, and the worker can lose the lease; keep tools non-blocking (see
+   * {@link BetaRunnableTool.run}).
    */
   tools?: EnvironmentWorkerTools;
   /** Base directory for the per-session {@link AgentToolContext}. Defaults to `process.cwd()`. */
@@ -110,10 +114,10 @@ type ClaimedWork = Pick<BetaSelfHostedWork, 'id' | 'environment_id' | 'data'>;
  * For each claimed `session` work item it: builds the per-session
  * {@link AgentToolContext}, downloads the session agent's skills
  * (`setupSkills`), then runs a {@link SessionToolRunner} for the session
- * *while* heartbeating the work-item lease in parallel; on exit it force-stops
- * the work item, cleans up the downloaded skills, and loops to the next one. The
- * lease heartbeat reports `state === "stopping"` / a lost lease back into the run
- * by aborting the session runner.
+ * while heartbeating the work-item lease on the same event loop; on exit it
+ * force-stops the work item, cleans up the downloaded skills, and loops to the
+ * next one. The lease heartbeat reports `state === "stopping"` / a lost lease
+ * back into the run by aborting the session runner.
  *
  * Use {@link EnvironmentWorker.handleItem} if you already hold a claimed work
  * item (e.g. a `worker poll --on-work` script handed one to a fresh process) and
@@ -196,8 +200,8 @@ export class EnvironmentWorker {
    * per-session {@link AgentToolContext} (workdir from this worker's options),
    * download the session agent's skills (`setupSkills`), run a
    * {@link SessionToolRunner} for the session while heartbeating the work-item
-   * lease in parallel, and force-stop the work item on exit (whether the runner
-   * finishes normally, throws, or the heartbeat loop signals shutdown).
+   * lease, and force-stop the work item on exit (whether the runner finishes
+   * normally, throws, or the heartbeat loop signals shutdown).
    *
    * Use this when something else does the claiming — e.g. a `worker poll
    * --on-work` script that hands an already-claimed item to a fresh process. The
@@ -293,19 +297,26 @@ export class EnvironmentWorker {
     const ctrl = new AbortController();
     const detachExternal = linkAbort(externalSignal, ctrl);
 
-    const heartbeatPromise = heartbeatLoop(sessionClient, work, ctrl, log, this.requestOptions).catch((e) => {
+    // Inert until iterated below.
+    const runner = new SessionToolRunner(sessionId, {
+      client: sessionClient,
+      tools,
+      ...(this.maxIdleMs !== undefined ? { maxIdleMs: this.maxIdleMs } : {}),
+      ...(this.requestOptions !== undefined ? { requestOptions: this.requestOptions } : {}),
+      signal: ctrl.signal,
+    });
+
+    // Each heartbeat reports the lease TTL the server is enforcing; it becomes
+    // the runner's tool-result send retry window so a send keeps retrying
+    // exactly as long as the lease could still be live.
+    const heartbeatPromise = heartbeatLoop(sessionClient, work, ctrl, log, this.requestOptions, (ttlMs) =>
+      runner._setSendRetryWindow(ttlMs),
+    ).catch((e) => {
       if (!ctrl.signal.aborted) log.error('heartbeat loop failed', { work_id: work.id, error: String(e) });
       ctrl.abort();
     });
 
     try {
-      const runner = new SessionToolRunner(sessionId, {
-        client: sessionClient,
-        tools,
-        ...(this.maxIdleMs !== undefined ? { maxIdleMs: this.maxIdleMs } : {}),
-        ...(this.requestOptions !== undefined ? { requestOptions: this.requestOptions } : {}),
-        signal: ctrl.signal,
-      });
       for await (const _ of runner) {
         // Drive the runner to completion; per-call observability is not part
         // of this composition's surface — use `SessionToolRunner` directly
@@ -360,6 +371,8 @@ async function heartbeatLoop(
   ctrl: AbortController,
   logger: Logger,
   requestOptions?: BetaToolRunnerRequestOptions,
+  /** Called with the server-reported lease TTL after every successful beat. */
+  onLeaseTtl?: (ttlMs: number) => void,
 ): Promise<void> {
   let intervalMs = HEARTBEAT_DEFAULT_MS;
   let ttlMs = HEARTBEAT_TTL_DEFAULT_MS;
@@ -382,6 +395,7 @@ async function heartbeatLoop(
       if (resp.ttl_seconds > 0) {
         ttlMs = resp.ttl_seconds * 1000;
         intervalMs = Math.max(1_000, Math.min(ttlMs / 2, HEARTBEAT_DEFAULT_MS));
+        onLeaseTtl?.(ttlMs);
       }
       if (resp.state === 'stopping' || resp.state === 'stopped') {
         logger.info('heartbeat signals shutdown', { work_id: work.id, state: resp.state });

package/src/lib/tools/BetaRunnableTool.ts

@@ -22,10 +22,7 @@ import { ToolError } from './ToolError';
 
 export type Promisable<T> = T | Promise<T>;
 
-/**
- * Tool types that can be implemented on the client.
- * Excludes server-side tools like code execution, web search, and MCP toolsets.
- */
+/** Tools that run on the client. Server-side tools (code execution, web search, MCP toolsets) are not included. */
 export type BetaClientRunnableToolType =
   | BetaTool
   | BetaMemoryTool20250818
@@ -40,15 +37,9 @@ export type BetaClientRunnableToolType =
   | BetaToolTextEditor20250728;
 
 /**
- * The tool-use that triggered a {@link BetaRunnableTool.run}:
- *
- * - from `client.beta.messages.toolRunner`, a Messages `tool_use` content block;
- * - from `client.beta.sessions.events.toolRunner`, the `agent.tool_use` /
- *   `agent.custom_tool_use` session event.
- *
- * The shapes overlap on the common fields (`id`, `name`, `input`), so code that
- * only reads those works without narrowing; narrow on the shape (e.g. `'type' in
- * x`) when you need surface-specific properties.
+ * The tool call being served: a Messages `tool_use` block, or a session
+ * `agent.tool_use` / `agent.custom_tool_use` event. All three carry `id`,
+ * `name` and `input`.
  */
 export type BetaToolUse =
   | BetaToolUseBlock
@@ -56,65 +47,50 @@ export type BetaToolUse =
   | BetaManagedAgentsAgentCustomToolUseEvent;
 
 export type BetaToolRunContext = {
-  /** The tool-use that triggered this run. See {@link BetaToolUse}. */
   toolUse: BetaToolUse;
+  /** @deprecated Use `toolUse`. */
+  toolUseBlock: BetaToolUse;
   /**
-   * @deprecated Renamed to `toolUse`. Also note that for
-   * `client.beta.sessions.events.toolRunner` this is the `agent.tool_use` /
-   * `agent.custom_tool_use` *event*, not a Messages content block, despite the
-   * name — which is why it was renamed.
+   * Aborted when the runner is aborted or, in the session runner, when the
+   * per-tool timeout fires. The runner still waits for `run` to return, so
+   * check it in long-running work.
    */
-  toolUseBlock: BetaToolUse;
   signal?: AbortSignal | null | undefined;
 };
 
-// this type is just an extension of BetaTool with a run and parse method
-// that will be called by `toolRunner()` helpers
+/** A tool definition plus the `run` and `parse` the tool runners call. */
 export type BetaRunnableTool<Input = any> = BetaClientRunnableToolType & {
+  /**
+   * Runs on the event loop: a body that blocks synchronously stalls the runner
+   * and, in an `EnvironmentWorker`, the lease heartbeat. Await async work or
+   * move it to a worker thread.
+   */
   run: (
     args: Input,
     context?: BetaToolRunContext,
   ) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
   parse: (content: unknown) => Input;
-  /**
-   * Optional cleanup hook for tools that hold process-level resources (e.g. a
-   * persistent shell). `SessionToolRunner` (`client.beta.sessions.events.toolRunner`)
-   * calls it once when iteration ends.
-   */
+  /** Called once by the session runner when it stops. Release held resources here (e.g. a shell). */
   close?: () => Promisable<void>;
 };
 
-/**
- * Resolve the registry key for a tool — the name the model addresses it by.
- * MCP toolsets are keyed on `mcp_server_name`; every other tool on `name`.
- * Shared so the tool-name lookup is identical across `toolRunner()` surfaces.
- */
+/** The name the model calls a tool by: `mcp_server_name` for MCP toolsets, `name` for everything else. */
 export function toolName(tool: BetaToolUnion | BetaRunnableTool): string {
   return 'name' in tool ? tool.name : tool.mcp_server_name;
 }
 
-/**
- * Format a thrown value into tool-result content: a {@link ToolError} carries
- * its own structured content, anything else becomes an `Error: <message>`
- * string. Shared so every `toolRunner()` surface reports tool failures the
- * same way to the model.
- */
+/** Tool-result content for a thrown value: a {@link ToolError}'s own content, otherwise `Error: <message>`. */
 export function toolErrorContent(e: unknown): string | Array<BetaToolResultContentBlockParam> {
   return e instanceof ToolError ? e.content : `Error: ${e instanceof Error ? e.message : String(e)}`;
 }
 
-/** Outcome of {@link runRunnableTool}: the content to post back and whether it is an error. */
+/** What a tool run produced, and whether it failed. */
 export interface RunnableToolOutcome {
   content: string | Array<BetaToolResultContentBlockParam>;
   isError: boolean;
 }
 
-/**
- * Run a {@link BetaRunnableTool} end-to-end: parse the raw input, invoke `run`,
- * and format any thrown value via {@link toolErrorContent}. Shared so the
- * parse → run → catch → format pipeline is identical across `toolRunner()`
- * surfaces.
- */
+/** Parse the input, run the tool, and turn anything thrown into an error result. */
 export async function runRunnableTool(
   tool: BetaRunnableTool,
   rawInput: unknown,

package/src/lib/tools/BetaToolRunner.ts

@@ -578,18 +578,6 @@ function applyToolChange(block: BetaContentBlockParam, available: Set<string>):
     case 'tool_addition':
       applyToolReference(block, available);
       break;
-    case 'mid_conv_system':
-      // A `mid_conv_system` block's content is limited by the API schema to
-      // text / tool_addition / tool_removal, so we walk exactly one level — no recursion.
-      for (const inner of block.content) {
-        if (inner.type === 'tool_removal' || inner.type === 'tool_addition') {
-          applyToolReference(inner, available);
-        }
-      }
-      break;
-    default:
-      // Other and unknown/newer block types leave the set untouched (forward compatibility).
-      break;
   }
 }
 

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

@@ -403,7 +403,6 @@ import {
   BetaMessageParam,
   BetaMessageTokensCount,
   BetaMetadata,
-  BetaMidConversationSystemBlockParam,
   BetaOutputConfig,
   BetaOutputTokensDetails,
   BetaPlainTextSource,
@@ -646,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'
@@ -924,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,

package/src/resources/beta/dreams.ts

@@ -243,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;
 
@@ -260,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;
 

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

@@ -336,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,