@anthropic-ai/sdk 0.117.1 → 0.119.0

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,57 @@ 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, `type` for nameless server
+ * toolsets (browser/computer), `name` for everything else.
  */
 export function toolName(tool: BetaToolUnion | BetaRunnableTool): string {
-  return 'name' in tool ? tool.name : tool.mcp_server_name;
+  return (
+    'name' in tool ? tool.name
+    : 'mcp_server_name' in tool ? tool.mcp_server_name
+    : tool.type
+  );
 }
 
-/**
- * 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

@@ -492,7 +492,12 @@ async function generateToolResponse(
   const available = availableToolNames(params);
   const toolResults = await Promise.all(
     toolUseBlocks.map(async (toolUse) => {
-      const tool = params.tools.find((t) => ('name' in t ? t.name : t.mcp_server_name) === toolUse.name);
+      const tool = params.tools.find(
+        (t) =>
+          ('name' in t ? t.name
+          : 'mcp_server_name' in t ? t.mcp_server_name
+          : t.type) === toolUse.name,
+      );
       // A `tool_removal` is only a hint to the model, which may still emit a tool_use for a
       // withdrawn tool — treat those exactly like a tool that was never defined.
       if (!tool || !('run' in tool) || !available.has(toolUse.name)) {
@@ -578,18 +583,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

@@ -101,13 +101,13 @@ import {
 } from './dreams';
 import * as FilesAPI from './files';
 import {
+  BetaDeletedFile,
+  BetaFileMetadata,
+  BetaFileMetadataPage,
   BetaFileScope,
-  DeletedFile,
   FileDeleteParams,
   FileDownloadParams,
   FileListParams,
-  FileMetadata,
-  FileMetadataPage,
   FileRetrieveMetadataParams,
   FileUploadParams,
   Files,
@@ -304,6 +304,46 @@ import {
   BetaBashCodeExecutionToolResultBlockParam,
   BetaBashCodeExecutionToolResultError,
   BetaBashCodeExecutionToolResultErrorParam,
+  BetaBrowserCloseTabConfig,
+  BetaBrowserDoubleClickConfig,
+  BetaBrowserFileUploadConfig,
+  BetaBrowserFindConfig,
+  BetaBrowserFormInputConfig,
+  BetaBrowserGetPageTextConfig,
+  BetaBrowserHoldKeyConfig,
+  BetaBrowserHoverConfig,
+  BetaBrowserJavascriptExecConfig,
+  BetaBrowserKeyConfig,
+  BetaBrowserLeftClickConfig,
+  BetaBrowserLeftClickDragConfig,
+  BetaBrowserLeftMouseDownConfig,
+  BetaBrowserLeftMouseUpConfig,
+  BetaBrowserListTabsConfig,
+  BetaBrowserMiddleClickConfig,
+  BetaBrowserMouseMoveConfig,
+  BetaBrowserNavigateConfig,
+  BetaBrowserNewTabConfig,
+  BetaBrowserReadConsoleConfig,
+  BetaBrowserReadNetworkConfig,
+  BetaBrowserReadPageConfig,
+  BetaBrowserRightClickConfig,
+  BetaBrowserScreenshotConfig,
+  BetaBrowserScrollConfig,
+  BetaBrowserScrollToConfig,
+  BetaBrowserStateBlockParam,
+  BetaBrowserStateChange,
+  BetaBrowserStateChangeDownloadCompleted,
+  BetaBrowserStateChangeDownloadFailed,
+  BetaBrowserStateChangeDownloadStarted,
+  BetaBrowserStateChangeTabOpened,
+  BetaBrowserStateTabEntry,
+  BetaBrowserSwitchTabConfig,
+  BetaBrowserToolset20260801,
+  BetaBrowserToolsetConfigs,
+  BetaBrowserTripleClickConfig,
+  BetaBrowserTypeConfig,
+  BetaBrowserWaitConfig,
+  BetaBrowserZoomConfig,
   BetaCacheControlEphemeral,
   BetaCacheCreation,
   BetaCacheMissMessagesChanged,
@@ -349,6 +389,25 @@ import {
   BetaCompactionBlockParam,
   BetaCompactionContentBlockDelta,
   BetaCompactionIterationUsage,
+  BetaComputerCursorPositionConfig,
+  BetaComputerDoubleClickConfig,
+  BetaComputerHoldKeyConfig,
+  BetaComputerKeyConfig,
+  BetaComputerLeftClickConfig,
+  BetaComputerLeftClickDragConfig,
+  BetaComputerLeftMouseDownConfig,
+  BetaComputerLeftMouseUpConfig,
+  BetaComputerMiddleClickConfig,
+  BetaComputerMouseMoveConfig,
+  BetaComputerRightClickConfig,
+  BetaComputerScreenshotConfig,
+  BetaComputerScrollConfig,
+  BetaComputerToolset20260801,
+  BetaComputerToolsetConfigs,
+  BetaComputerTripleClickConfig,
+  BetaComputerTypeConfig,
+  BetaComputerWaitConfig,
+  BetaComputerZoomConfig,
   BetaContainer,
   BetaContainerParams,
   BetaContainerUploadBlock,
@@ -381,6 +440,7 @@ import {
   BetaFileDocumentSource,
   BetaFileImageSource,
   BetaImageBlockParam,
+  BetaImageTransformationsParam,
   BetaInputJSONDelta,
   BetaJSONOutputFormat,
   BetaInputTokensClearAtLeast,
@@ -403,7 +463,6 @@ import {
   BetaMessageParam,
   BetaMessageTokensCount,
   BetaMetadata,
-  BetaMidConversationSystemBlockParam,
   BetaOutputConfig,
   BetaOutputTokensDetails,
   BetaPlainTextSource,
@@ -646,6 +705,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'
@@ -823,6 +883,46 @@ export declare namespace Beta {
     type BetaBashCodeExecutionToolResultBlockParam as BetaBashCodeExecutionToolResultBlockParam,
     type BetaBashCodeExecutionToolResultError as BetaBashCodeExecutionToolResultError,
     type BetaBashCodeExecutionToolResultErrorParam as BetaBashCodeExecutionToolResultErrorParam,
+    type BetaBrowserCloseTabConfig as BetaBrowserCloseTabConfig,
+    type BetaBrowserDoubleClickConfig as BetaBrowserDoubleClickConfig,
+    type BetaBrowserFileUploadConfig as BetaBrowserFileUploadConfig,
+    type BetaBrowserFindConfig as BetaBrowserFindConfig,
+    type BetaBrowserFormInputConfig as BetaBrowserFormInputConfig,
+    type BetaBrowserGetPageTextConfig as BetaBrowserGetPageTextConfig,
+    type BetaBrowserHoldKeyConfig as BetaBrowserHoldKeyConfig,
+    type BetaBrowserHoverConfig as BetaBrowserHoverConfig,
+    type BetaBrowserJavascriptExecConfig as BetaBrowserJavascriptExecConfig,
+    type BetaBrowserKeyConfig as BetaBrowserKeyConfig,
+    type BetaBrowserLeftClickConfig as BetaBrowserLeftClickConfig,
+    type BetaBrowserLeftClickDragConfig as BetaBrowserLeftClickDragConfig,
+    type BetaBrowserLeftMouseDownConfig as BetaBrowserLeftMouseDownConfig,
+    type BetaBrowserLeftMouseUpConfig as BetaBrowserLeftMouseUpConfig,
+    type BetaBrowserListTabsConfig as BetaBrowserListTabsConfig,
+    type BetaBrowserMiddleClickConfig as BetaBrowserMiddleClickConfig,
+    type BetaBrowserMouseMoveConfig as BetaBrowserMouseMoveConfig,
+    type BetaBrowserNavigateConfig as BetaBrowserNavigateConfig,
+    type BetaBrowserNewTabConfig as BetaBrowserNewTabConfig,
+    type BetaBrowserReadConsoleConfig as BetaBrowserReadConsoleConfig,
+    type BetaBrowserReadNetworkConfig as BetaBrowserReadNetworkConfig,
+    type BetaBrowserReadPageConfig as BetaBrowserReadPageConfig,
+    type BetaBrowserRightClickConfig as BetaBrowserRightClickConfig,
+    type BetaBrowserScreenshotConfig as BetaBrowserScreenshotConfig,
+    type BetaBrowserScrollConfig as BetaBrowserScrollConfig,
+    type BetaBrowserScrollToConfig as BetaBrowserScrollToConfig,
+    type BetaBrowserStateBlockParam as BetaBrowserStateBlockParam,
+    type BetaBrowserStateChange as BetaBrowserStateChange,
+    type BetaBrowserStateChangeDownloadCompleted as BetaBrowserStateChangeDownloadCompleted,
+    type BetaBrowserStateChangeDownloadFailed as BetaBrowserStateChangeDownloadFailed,
+    type BetaBrowserStateChangeDownloadStarted as BetaBrowserStateChangeDownloadStarted,
+    type BetaBrowserStateChangeTabOpened as BetaBrowserStateChangeTabOpened,
+    type BetaBrowserStateTabEntry as BetaBrowserStateTabEntry,
+    type BetaBrowserSwitchTabConfig as BetaBrowserSwitchTabConfig,
+    type BetaBrowserToolset20260801 as BetaBrowserToolset20260801,
+    type BetaBrowserToolsetConfigs as BetaBrowserToolsetConfigs,
+    type BetaBrowserTripleClickConfig as BetaBrowserTripleClickConfig,
+    type BetaBrowserTypeConfig as BetaBrowserTypeConfig,
+    type BetaBrowserWaitConfig as BetaBrowserWaitConfig,
+    type BetaBrowserZoomConfig as BetaBrowserZoomConfig,
     type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
     type BetaCacheCreation as BetaCacheCreation,
     type BetaCacheMissMessagesChanged as BetaCacheMissMessagesChanged,
@@ -868,6 +968,25 @@ export declare namespace Beta {
     type BetaCompactionBlockParam as BetaCompactionBlockParam,
     type BetaCompactionContentBlockDelta as BetaCompactionContentBlockDelta,
     type BetaCompactionIterationUsage as BetaCompactionIterationUsage,
+    type BetaComputerCursorPositionConfig as BetaComputerCursorPositionConfig,
+    type BetaComputerDoubleClickConfig as BetaComputerDoubleClickConfig,
+    type BetaComputerHoldKeyConfig as BetaComputerHoldKeyConfig,
+    type BetaComputerKeyConfig as BetaComputerKeyConfig,
+    type BetaComputerLeftClickConfig as BetaComputerLeftClickConfig,
+    type BetaComputerLeftClickDragConfig as BetaComputerLeftClickDragConfig,
+    type BetaComputerLeftMouseDownConfig as BetaComputerLeftMouseDownConfig,
+    type BetaComputerLeftMouseUpConfig as BetaComputerLeftMouseUpConfig,
+    type BetaComputerMiddleClickConfig as BetaComputerMiddleClickConfig,
+    type BetaComputerMouseMoveConfig as BetaComputerMouseMoveConfig,
+    type BetaComputerRightClickConfig as BetaComputerRightClickConfig,
+    type BetaComputerScreenshotConfig as BetaComputerScreenshotConfig,
+    type BetaComputerScrollConfig as BetaComputerScrollConfig,
+    type BetaComputerToolset20260801 as BetaComputerToolset20260801,
+    type BetaComputerToolsetConfigs as BetaComputerToolsetConfigs,
+    type BetaComputerTripleClickConfig as BetaComputerTripleClickConfig,
+    type BetaComputerTypeConfig as BetaComputerTypeConfig,
+    type BetaComputerWaitConfig as BetaComputerWaitConfig,
+    type BetaComputerZoomConfig as BetaComputerZoomConfig,
     type BetaContainer as BetaContainer,
     type BetaContainerParams as BetaContainerParams,
     type BetaContainerUploadBlock as BetaContainerUploadBlock,
@@ -900,6 +1019,7 @@ export declare namespace Beta {
     type BetaFileDocumentSource as BetaFileDocumentSource,
     type BetaFileImageSource as BetaFileImageSource,
     type BetaImageBlockParam as BetaImageBlockParam,
+    type BetaImageTransformationsParam as BetaImageTransformationsParam,
     type BetaInputJSONDelta as BetaInputJSONDelta,
     type BetaJSONOutputFormat as BetaJSONOutputFormat,
     type BetaInputTokensClearAtLeast as BetaInputTokensClearAtLeast,
@@ -924,7 +1044,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,
@@ -1263,10 +1382,10 @@ export declare namespace Beta {
 
   export {
     Files as Files,
+    type BetaDeletedFile as BetaDeletedFile,
+    type BetaFileMetadata as BetaFileMetadata,
     type BetaFileScope as BetaFileScope,
-    type DeletedFile as DeletedFile,
-    type FileMetadata as FileMetadata,
-    type FileMetadataPage as FileMetadataPage,
+    type BetaFileMetadataPage as BetaFileMetadataPage,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileDownloadParams as FileDownloadParams,

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/files.ts

@@ -18,7 +18,7 @@ export class Files extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const fileMetadata of client.beta.files.list()) {
+   * for await (const betaFileMetadata of client.beta.files.list()) {
    *   // ...
    * }
    * ```
@@ -26,9 +26,9 @@ export class Files extends APIResource {
   list(
     params: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<FileMetadataPage, FileMetadata> {
+  ): PagePromise<BetaFileMetadataPage, BetaFileMetadata> {
     const { betas, ...query } = params ?? {};
-    return this._client.getAPIList('/v1/files?beta=true', Page<FileMetadata>, {
+    return this._client.getAPIList('/v1/files?beta=true', Page<BetaFileMetadata>, {
       query,
       ...options,
       headers: buildHeaders([
@@ -43,7 +43,7 @@ export class Files extends APIResource {
    *
    * @example
    * ```ts
-   * const deletedFile = await client.beta.files.delete(
+   * const betaDeletedFile = await client.beta.files.delete(
    *   'file_id',
    * );
    * ```
@@ -52,7 +52,7 @@ export class Files extends APIResource {
     fileID: string,
     params: FileDeleteParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<DeletedFile> {
+  ): APIPromise<BetaDeletedFile> {
     const { betas } = params ?? {};
     return this._client.delete(path`/v1/files/${fileID}?beta=true`, {
       ...options,
@@ -100,7 +100,7 @@ export class Files extends APIResource {
    *
    * @example
    * ```ts
-   * const fileMetadata =
+   * const betaFileMetadata =
    *   await client.beta.files.retrieveMetadata('file_id');
    * ```
    */
@@ -108,7 +108,7 @@ export class Files extends APIResource {
     fileID: string,
     params: FileRetrieveMetadataParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FileMetadata> {
+  ): APIPromise<BetaFileMetadata> {
     const { betas } = params ?? {};
     return this._client.get(path`/v1/files/${fileID}?beta=true`, {
       ...options,
@@ -124,12 +124,12 @@ export class Files extends APIResource {
    *
    * @example
    * ```ts
-   * const fileMetadata = await client.beta.files.upload({
+   * const betaFileMetadata = await client.beta.files.upload({
    *   file: fs.createReadStream('path/to/file'),
    * });
    * ```
    */
-  upload(params: FileUploadParams, options?: RequestOptions): APIPromise<FileMetadata> {
+  upload(params: FileUploadParams, options?: RequestOptions): APIPromise<BetaFileMetadata> {
     const { betas, ...body } = params;
 
     return this._client.post(
@@ -150,21 +150,9 @@ export class Files extends APIResource {
   }
 }
 
-export type FileMetadataPage = Page<FileMetadata>;
+export type BetaFileMetadataPage = Page<BetaFileMetadata>;
 
-export interface BetaFileScope {
-  /**
-   * The ID of the scoping resource (e.g., the session ID).
-   */
-  id: string;
-
-  /**
-   * The type of scope (e.g., `"session"`).
-   */
-  type: 'session';
-}
-
-export interface DeletedFile {
+export interface BetaDeletedFile {
   /**
    * ID of the deleted file.
    */
@@ -178,7 +166,7 @@ export interface DeletedFile {
   type?: 'file_deleted';
 }
 
-export interface FileMetadata {
+export interface BetaFileMetadata {
   /**
    * Unique object identifier.
    *
@@ -225,6 +213,18 @@ export interface FileMetadata {
   scope?: BetaFileScope | null;
 }
 
+export interface BetaFileScope {
+  /**
+   * The ID of the scoping resource (e.g., the session ID).
+   */
+  id: string;
+
+  /**
+   * The type of scope (e.g., `"session"`).
+   */
+  type: 'session';
+}
+
 export interface FileListParams extends PageParams {
   /**
    * Query param: Filter by scope ID. Only returns files associated with the
@@ -273,10 +273,10 @@ export interface FileUploadParams {
 
 export declare namespace Files {
   export {
+    type BetaDeletedFile as BetaDeletedFile,
+    type BetaFileMetadata as BetaFileMetadata,
     type BetaFileScope as BetaFileScope,
-    type DeletedFile as DeletedFile,
-    type FileMetadata as FileMetadata,
-    type FileMetadataPage as FileMetadataPage,
+    type BetaFileMetadataPage as BetaFileMetadataPage,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileDownloadParams as FileDownloadParams,