@code-yeongyu/senpi 2026.8.25 → 2026.8.26

package/node_modules/@anthropic-ai/sdk/src/resources/beta/messages/messages.ts

@@ -2,13 +2,14 @@
 
 import { AnthropicError } from '../../../error';
 import { Anthropic } from '../../../client';
+import * as BatchesAPI from './batches';
 import { APIPromise } from '../../../core/api-promise';
 import { APIResource } from '../../../core/resource';
 import { Stream } from '../../../core/streaming';
 import { MODEL_NONSTREAMING_TOKENS } from '../../../internal/constants';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
-import { stainlessHelperHeader } from '../../../lib/stainless-helper-header';
+import { stainlessHelperHeader } from '../../../internal/stainless-helper-header';
 import {
   parseBetaMessage,
   type ExtractParsedContentFromBetaParams,
@@ -25,7 +26,6 @@ import type { Model } from '../../messages/messages';
 import * as BetaMessagesAPI from './messages';
 import * as MessagesAPI from '../../messages/messages';
 import * as BetaAPI from '../beta';
-import * as BatchesAPI from './batches';
 import {
   BatchCancelParams,
   BatchCreateParams,
@@ -48,19 +48,7 @@ import {
 
 const DEPRECATED_MODELS: {
   [K in Model]?: string;
-} = {
-  'claude-1.3': 'November 6th, 2024',
-  'claude-1.3-100k': 'November 6th, 2024',
-  'claude-instant-1.1': 'November 6th, 2024',
-  'claude-instant-1.1-100k': 'November 6th, 2024',
-  'claude-instant-1.2': 'November 6th, 2024',
-  'claude-3-sonnet-20240229': 'July 21st, 2025',
-  'claude-3-opus-20240229': 'January 5th, 2026',
-  'claude-2.1': 'July 21st, 2025',
-  'claude-2.0': 'July 21st, 2025',
-  'claude-3-7-sonnet-latest': 'February 19th, 2026',
-  'claude-3-7-sonnet-20250219': 'February 19th, 2026',
-};
+} = {};
 
 const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-mythos-preview', 'claude-opus-4-6'];
 
@@ -75,14 +63,14 @@ export class Messages extends APIResource {
    * conversations.
    *
    * Learn more about the Messages API in our
-   * [user guide](https://docs.claude.com/en/docs/initial-setup)
+   * [user guide](https://platform.claude.com/docs/en/get-started)
    *
    * @example
    * ```ts
    * 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',
    * });
    * ```
    */
@@ -102,7 +90,7 @@ export class Messages extends APIResource {
     // Transform deprecated output_format to output_config.format
     const modifiedParams = transformOutputFormat(params);
 
-    const { betas, ...body } = modifiedParams;
+    const { betas, user_profile_id, ...body } = modifiedParams;
 
     if (body.model in DEPRECATED_MODELS) {
       console.warn(
@@ -122,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);
@@ -136,7 +124,10 @@ export class Messages extends APIResource {
       timeout: timeout ?? 600000,
       ...options,
       headers: buildHeaders([
-        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
+        {
+          ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
+          ...(user_profile_id != null ? { 'anthropic-user-profile-id': user_profile_id } : undefined),
+        },
         helperHeader,
         options?.headers,
       ]),
@@ -194,14 +185,14 @@ export class Messages extends APIResource {
    * including tools, images, and documents, without creating it.
    *
    * Learn more about token counting in our
-   * [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
+   * [user guide](https://platform.claude.com/docs/en/build-with-claude/token-counting)
    *
    * @example
    * ```ts
    * const betaMessageTokensCount =
    *   await client.beta.messages.countTokens({
    *     messages: [{ content: 'Hello, world', role: 'user' }],
-   *     model: 'claude-opus-4-6',
+   *     model: 'claude-opus-5',
    *   });
    * ```
    */
@@ -212,12 +203,15 @@ export class Messages extends APIResource {
     // Transform deprecated output_format to output_config.format
     const modifiedParams = transformOutputFormat(params);
 
-    const { betas, ...body } = modifiedParams;
+    const { betas, user_profile_id, ...body } = modifiedParams;
     return this._client.post('/v1/messages/count_tokens?beta=true', {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString(),
+          ...(user_profile_id != null ? { 'anthropic-user-profile-id': user_profile_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -289,8 +283,9 @@ export interface BetaAdvisorMessageIterationUsage {
   input_tokens: number;
 
   /**
-   * The model that will complete your prompt.\n\nSee
-   * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
    * details and options.
    */
   model: MessagesAPI.Model;
@@ -313,6 +308,12 @@ export interface BetaAdvisorRedactedResultBlock {
    */
   encrypted_content: string;
 
+  /**
+   * The advisor sub-inference's stop reason (same values as the top-level message
+   * `stop_reason`).
+   */
+  stop_reason: string | null;
+
   type: 'advisor_redacted_result';
 }
 
@@ -323,9 +324,18 @@ export interface BetaAdvisorRedactedResultBlockParam {
   encrypted_content: string;
 
   type: 'advisor_redacted_result';
+
+  stop_reason?: string | null;
 }
 
 export interface BetaAdvisorResultBlock {
+  /**
+   * The advisor sub-inference's stop reason (same values as the top-level message
+   * `stop_reason`). `max_tokens` indicates the advisor's output was truncated at the
+   * tool's `max_tokens` value or the advisor model's policy cap.
+   */
+  stop_reason: string | null;
+
   text: string;
 
   type: 'advisor_result';
@@ -335,12 +345,15 @@ export interface BetaAdvisorResultBlockParam {
   text: string;
 
   type: 'advisor_result';
+
+  stop_reason?: string | null;
 }
 
 export interface BetaAdvisorTool20260301 {
   /**
-   * The model that will complete your prompt.\n\nSee
-   * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
    * details and options.
    */
   model: MessagesAPI.Model;
@@ -354,7 +367,9 @@ export interface BetaAdvisorTool20260301 {
 
   type: 'advisor_20260301';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -374,6 +389,17 @@ export interface BetaAdvisorTool20260301 {
    */
   defer_loading?: boolean;
 
+  /**
+   * Bounds the advisor's total output (thinking + text) per call. When the advisor
+   * hits this cap, the returned advisor_result or advisor_redacted_result block
+   * carries stop_reason='max_tokens', and a truncation note is appended to the
+   * advice text the worker model sees (inside the encrypted blob in redacted mode).
+   * When set, the server also emits a remaining-tokens budget block in the advisor's
+   * prompt so the advisor self-shapes toward the cap. When omitted, the advisor
+   * model's default output cap applies and no budget block is emitted.
+   */
+  max_tokens?: number | null;
+
   /**
    * Maximum number of times the tool can be used in the API request.
    */
@@ -416,7 +442,8 @@ export interface BetaAdvisorToolResultError {
     | 'too_many_requests'
     | 'overloaded'
     | 'unavailable'
-    | 'execution_time_exceeded';
+    | 'execution_time_exceeded'
+    | 'model_not_found';
 
   type: 'advisor_tool_result_error';
 }
@@ -428,7 +455,8 @@ export interface BetaAdvisorToolResultErrorParam {
     | 'too_many_requests'
     | 'overloaded'
     | 'unavailable'
-    | 'execution_time_exceeded';
+    | 'execution_time_exceeded'
+    | 'model_not_found';
 
   type: 'advisor_tool_result_error';
 }
@@ -534,138 +562,1164 @@ export interface BetaBashCodeExecutionToolResultErrorParam {
   type: 'bash_code_execution_tool_result_error';
 }
 
-export interface BetaCacheControlEphemeral {
-  type: 'ephemeral';
+/**
+ * `close_tab`'s config overrides.
+ */
+export interface BetaBrowserCloseTabConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
   /**
-   * The time-to-live for the cache control breakpoint.
-   *
-   * This may be one the following values:
-   *
-   * - `5m`: 5 minutes
-   * - `1h`: 1 hour
-   *
-   * Defaults to `5m`.
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
    */
-  ttl?: '5m' | '1h';
+  enabled?: boolean | null;
 }
 
-export interface BetaCacheCreation {
+/**
+ * `double_click`'s config overrides.
+ */
+export interface BetaBrowserDoubleClickConfig {
   /**
-   * The number of input tokens used to create the 1 hour cache entry.
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
    */
-  ephemeral_1h_input_tokens: number;
+  defer_loading?: boolean | null;
 
   /**
-   * The number of input tokens used to create the 5 minute cache entry.
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
    */
-  ephemeral_5m_input_tokens: number;
+  enabled?: boolean | null;
 }
 
-export interface BetaCitationCharLocation {
-  cited_text: string;
-
-  document_index: number;
+/**
+ * `file_upload`'s config overrides.
+ */
+export interface BetaBrowserFileUploadConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  document_title: string | null;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  end_char_index: number;
+/**
+ * `find`'s config overrides.
+ */
+export interface BetaBrowserFindConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  file_id: string | null;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  start_char_index: number;
+/**
+ * `form_input`'s config overrides.
+ */
+export interface BetaBrowserFormInputConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  type: 'char_location';
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
 }
 
-export interface BetaCitationCharLocationParam {
-  cited_text: string;
+/**
+ * `get_page_text`'s config overrides.
+ */
+export interface BetaBrowserGetPageTextConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  document_index: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  document_title: string | null;
+/**
+ * `hold_key`'s config overrides.
+ */
+export interface BetaBrowserHoldKeyConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  end_char_index: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  start_char_index: number;
+/**
+ * `hover`'s config overrides.
+ */
+export interface BetaBrowserHoverConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  type: 'char_location';
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
 }
 
-export interface BetaCitationConfig {
-  enabled: boolean;
-}
+/**
+ * `javascript_exec`'s config overrides.
+ */
+export interface BetaBrowserJavascriptExecConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-export interface BetaCitationContentBlockLocation {
-  cited_text: string;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  document_index: number;
+/**
+ * `key`'s config overrides.
+ */
+export interface BetaBrowserKeyConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  document_title: string | null;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  end_block_index: number;
+/**
+ * `left_click`'s config overrides.
+ */
+export interface BetaBrowserLeftClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  file_id: string | null;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  start_block_index: number;
+/**
+ * `left_click_drag`'s config overrides.
+ */
+export interface BetaBrowserLeftClickDragConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  type: 'content_block_location';
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
 }
 
-export interface BetaCitationContentBlockLocationParam {
-  cited_text: string;
+/**
+ * `left_mouse_down`'s config overrides.
+ */
+export interface BetaBrowserLeftMouseDownConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  document_index: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  document_title: string | null;
+/**
+ * `left_mouse_up`'s config overrides.
+ */
+export interface BetaBrowserLeftMouseUpConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  end_block_index: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  start_block_index: number;
+/**
+ * `list_tabs`'s config overrides.
+ */
+export interface BetaBrowserListTabsConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  type: 'content_block_location';
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
 }
 
-export interface BetaCitationPageLocation {
-  cited_text: string;
-
-  document_index: number;
+/**
+ * `middle_click`'s config overrides.
+ */
+export interface BetaBrowserMiddleClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  document_title: string | null;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  end_page_number: number;
+/**
+ * `mouse_move`'s config overrides.
+ */
+export interface BetaBrowserMouseMoveConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  file_id: string | null;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  start_page_number: number;
+/**
+ * `navigate`'s config overrides.
+ */
+export interface BetaBrowserNavigateConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  type: 'page_location';
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
 }
 
-export interface BetaCitationPageLocationParam {
-  cited_text: string;
+/**
+ * `new_tab`'s config overrides.
+ */
+export interface BetaBrowserNewTabConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  document_index: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  document_title: string | null;
+/**
+ * `read_console`'s config overrides.
+ */
+export interface BetaBrowserReadConsoleConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  end_page_number: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  start_page_number: number;
+/**
+ * `read_network`'s config overrides.
+ */
+export interface BetaBrowserReadNetworkConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  type: 'page_location';
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
 }
 
-export interface BetaCitationSearchResultLocation {
-  cited_text: string;
-
-  end_block_index: number;
+/**
+ * `read_page`'s config overrides.
+ */
+export interface BetaBrowserReadPageConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  search_result_index: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
 
-  source: string;
+/**
+ * `right_click`'s config overrides.
+ */
+export interface BetaBrowserRightClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
 
-  start_block_index: number;
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `screenshot`'s config overrides.
+ */
+export interface BetaBrowserScreenshotConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `scroll`'s config overrides.
+ */
+export interface BetaBrowserScrollConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `scroll_to`'s config overrides.
+ */
+export interface BetaBrowserScrollToConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * The caller's browser state after a browser toolset member call — the full
+ * inventory of open tabs, which tab is active, and any side effects (tabs opened,
+ * download state changes) the call produced.
+ *
+ * At most one per `tool_result`, only on a non-error result answering a browser
+ * toolset member `tool_use`. The server renders the model-visible text from it;
+ * the model never sees the raw fields.
+ */
+export interface BetaBrowserStateBlockParam {
+  /**
+   * All tabs open in the browser after this call — the full inventory, not a delta.
+   * May be empty. Whenever non-empty, exactly one entry carries `active: true`.
+   */
+  tabs: Array<BetaBrowserStateTabEntry>;
+
+  type: 'browser_state';
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Tabs opened and download state changes during this call. "Nothing to report" is
+   * expressed by omitting the field, never by an empty list.
+   */
+  state_changes?: Array<BetaBrowserStateChange> | null;
+}
+
+/**
+ * A tab this call's execution opened that remains open at its end — the creation
+ * delta of the `tabs` inventory, not an event log.
+ *
+ * Carries only the `tab_id`; the tab's `title` and `url` live on its `tabs` entry,
+ * which must include the same `tab_id`. A tab opened during a failed call gets no
+ * deferred `tab_opened`; it simply appears in the next result's `tabs` inventory.
+ */
+export type BetaBrowserStateChange =
+  | BetaBrowserStateChangeTabOpened
+  | BetaBrowserStateChangeDownloadStarted
+  | BetaBrowserStateChangeDownloadCompleted
+  | BetaBrowserStateChangeDownloadFailed;
+
+/**
+ * A file download that finished during this call, reported with the same
+ * `download_id` as its `download_started` — or without a prior `download_started`,
+ * when the download finished during the call that started it (at most one state
+ * change per `download_id` per result).
+ */
+export interface BetaBrowserStateChangeDownloadCompleted {
+  /**
+   * The caller-assigned identifier for this download, stable across the state
+   * changes reporting it.
+   */
+  download_id: string;
+
+  type: 'download_completed';
+
+  /**
+   * The final post-redirect URL the download was served from.
+   */
+  url: string;
+
+  /**
+   * Where the executor saved the file, on the executor's filesystem. Only included
+   * when another tool in the same environment can read the file at that path.
+   */
+  path?: string | null;
+
+  /**
+   * The completed download's size.
+   */
+  size_bytes?: number | null;
+}
+
+/**
+ * A file download that failed — or was cancelled — during this call.
+ */
+export interface BetaBrowserStateChangeDownloadFailed {
+  /**
+   * The caller-assigned identifier for this download, stable across the state
+   * changes reporting it.
+   */
+  download_id: string;
+
+  type: 'download_failed';
+
+  /**
+   * The final post-redirect URL the download was served from.
+   */
+  url: string;
+
+  /**
+   * The failure or cancellation detail, when known.
+   */
+  error?: string | null;
+}
+
+/**
+ * A file download that started during this call.
+ */
+export interface BetaBrowserStateChangeDownloadStarted {
+  /**
+   * The caller-assigned identifier for this download, stable across the state
+   * changes reporting it.
+   */
+  download_id: string;
+
+  type: 'download_started';
+
+  /**
+   * The final post-redirect URL the download was served from.
+   */
+  url: string;
+}
+
+/**
+ * A tab this call's execution opened that remains open at its end — the creation
+ * delta of the `tabs` inventory, not an event log.
+ *
+ * Carries only the `tab_id`; the tab's `title` and `url` live on its `tabs` entry,
+ * which must include the same `tab_id`. A tab opened during a failed call gets no
+ * deferred `tab_opened`; it simply appears in the next result's `tabs` inventory.
+ */
+export interface BetaBrowserStateChangeTabOpened {
+  /**
+   * The `tab_id` of the opened tab, present in `tabs`.
+   */
+  tab_id: string;
+
+  type: 'tab_opened';
+}
+
+/**
+ * One open browser tab reported in a `browser_state` block's `tabs` inventory.
+ *
+ * `tab_id` is the caller-assigned identifier for the tab; `title` and `url`
+ * describe the page the tab is currently showing and may be empty strings (a blank
+ * tab legitimately has both empty). `active` marks the tab that is active after
+ * this call; whenever `tabs` is non-empty, exactly one entry is marked.
+ */
+export interface BetaBrowserStateTabEntry {
+  /**
+   * The caller-assigned identifier for this tab, unique within the inventory.
+   */
+  tab_id: string;
+
+  /**
+   * The title of the page the tab is showing. May be empty.
+   */
+  title: string;
+
+  /**
+   * The URL of the page the tab is showing. May be empty.
+   */
+  url: string;
+
+  /**
+   * Whether this tab is the active tab after this call. Whenever `tabs` is
+   * non-empty, exactly one entry is marked `active: true`.
+   */
+  active?: boolean;
+}
+
+/**
+ * `switch_tab`'s config overrides.
+ */
+export interface BetaBrowserSwitchTabConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * The browser toolset: a single `tools[]` entry (carrying no `name`) that declares
+ * the browser tool family. The model is served the family's tool with any members
+ * disabled via `configs` removed from its schema.
+ */
+export interface BetaBrowserToolset20260801 {
+  type: 'browser_toolset_20260801';
+
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Per-member configuration for `browser_toolset_20260801`: one optional field per
+   * member tool, keyed by the member name — the same name the member's `tool_use`
+   * blocks carry. Every member is an accepted key, and a member's defaults apply
+   * wherever its key is absent. Unknown keys are rejected: the field set is this
+   * toolset version's complete member set.
+   */
+  configs?: BetaBrowserToolsetConfigs | null;
+}
+
+/**
+ * Per-member configuration for `browser_toolset_20260801`: one optional field per
+ * member tool, keyed by the member name — the same name the member's `tool_use`
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
+ * toolset version's complete member set.
+ */
+export interface BetaBrowserToolsetConfigs {
+  /**
+   * `close_tab`'s config overrides.
+   */
+  close_tab?: BetaBrowserCloseTabConfig | null;
+
+  /**
+   * `double_click`'s config overrides.
+   */
+  double_click?: BetaBrowserDoubleClickConfig | null;
+
+  /**
+   * `file_upload`'s config overrides.
+   */
+  file_upload?: BetaBrowserFileUploadConfig | null;
+
+  /**
+   * `find`'s config overrides.
+   */
+  find?: BetaBrowserFindConfig | null;
+
+  /**
+   * `form_input`'s config overrides.
+   */
+  form_input?: BetaBrowserFormInputConfig | null;
+
+  /**
+   * `get_page_text`'s config overrides.
+   */
+  get_page_text?: BetaBrowserGetPageTextConfig | null;
+
+  /**
+   * `hold_key`'s config overrides.
+   */
+  hold_key?: BetaBrowserHoldKeyConfig | null;
+
+  /**
+   * `hover`'s config overrides.
+   */
+  hover?: BetaBrowserHoverConfig | null;
+
+  /**
+   * `javascript_exec`'s config overrides.
+   */
+  javascript_exec?: BetaBrowserJavascriptExecConfig | null;
+
+  /**
+   * `key`'s config overrides.
+   */
+  key?: BetaBrowserKeyConfig | null;
+
+  /**
+   * `left_click`'s config overrides.
+   */
+  left_click?: BetaBrowserLeftClickConfig | null;
+
+  /**
+   * `left_click_drag`'s config overrides.
+   */
+  left_click_drag?: BetaBrowserLeftClickDragConfig | null;
+
+  /**
+   * `left_mouse_down`'s config overrides.
+   */
+  left_mouse_down?: BetaBrowserLeftMouseDownConfig | null;
+
+  /**
+   * `left_mouse_up`'s config overrides.
+   */
+  left_mouse_up?: BetaBrowserLeftMouseUpConfig | null;
+
+  /**
+   * `list_tabs`'s config overrides.
+   */
+  list_tabs?: BetaBrowserListTabsConfig | null;
+
+  /**
+   * `middle_click`'s config overrides.
+   */
+  middle_click?: BetaBrowserMiddleClickConfig | null;
+
+  /**
+   * `mouse_move`'s config overrides.
+   */
+  mouse_move?: BetaBrowserMouseMoveConfig | null;
+
+  /**
+   * `navigate`'s config overrides.
+   */
+  navigate?: BetaBrowserNavigateConfig | null;
+
+  /**
+   * `new_tab`'s config overrides.
+   */
+  new_tab?: BetaBrowserNewTabConfig | null;
+
+  /**
+   * `read_console`'s config overrides.
+   */
+  read_console?: BetaBrowserReadConsoleConfig | null;
+
+  /**
+   * `read_network`'s config overrides.
+   */
+  read_network?: BetaBrowserReadNetworkConfig | null;
+
+  /**
+   * `read_page`'s config overrides.
+   */
+  read_page?: BetaBrowserReadPageConfig | null;
+
+  /**
+   * `right_click`'s config overrides.
+   */
+  right_click?: BetaBrowserRightClickConfig | null;
+
+  /**
+   * `screenshot`'s config overrides.
+   */
+  screenshot?: BetaBrowserScreenshotConfig | null;
+
+  /**
+   * `scroll`'s config overrides.
+   */
+  scroll?: BetaBrowserScrollConfig | null;
+
+  /**
+   * `scroll_to`'s config overrides.
+   */
+  scroll_to?: BetaBrowserScrollToConfig | null;
+
+  /**
+   * `switch_tab`'s config overrides.
+   */
+  switch_tab?: BetaBrowserSwitchTabConfig | null;
+
+  /**
+   * `triple_click`'s config overrides.
+   */
+  triple_click?: BetaBrowserTripleClickConfig | null;
+
+  /**
+   * `type`'s config overrides.
+   */
+  type?: BetaBrowserTypeConfig | null;
+
+  /**
+   * `wait`'s config overrides.
+   */
+  wait?: BetaBrowserWaitConfig | null;
+
+  /**
+   * `zoom`'s config overrides.
+   */
+  zoom?: BetaBrowserZoomConfig | null;
+}
+
+/**
+ * `triple_click`'s config overrides.
+ */
+export interface BetaBrowserTripleClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `type`'s config overrides.
+ */
+export interface BetaBrowserTypeConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `wait`'s config overrides.
+ */
+export interface BetaBrowserWaitConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `zoom`'s config overrides.
+ */
+export interface BetaBrowserZoomConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+export interface BetaCacheControlEphemeral {
+  type: 'ephemeral';
+
+  /**
+   * The time-to-live for the cache control breakpoint.
+   *
+   * This may be one the following values:
+   *
+   * - `5m`: 5 minutes
+   * - `1h`: 1 hour
+   *
+   * Defaults to `5m`. See
+   * [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
+   * for details.
+   */
+  ttl?: '5m' | '1h';
+}
+
+export interface BetaCacheCreation {
+  /**
+   * The number of input tokens used to create the 1 hour cache entry.
+   */
+  ephemeral_1h_input_tokens: number;
+
+  /**
+   * The number of input tokens used to create the 5 minute cache entry.
+   */
+  ephemeral_5m_input_tokens: number;
+}
+
+export interface BetaCacheMissMessagesChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'messages_changed';
+}
+
+export interface BetaCacheMissModelChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'model_changed';
+}
+
+export interface BetaCacheMissPreviousMessageNotFound {
+  type: 'previous_message_not_found';
+}
+
+export interface BetaCacheMissSystemChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'system_changed';
+}
+
+export interface BetaCacheMissToolsChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'tools_changed';
+}
+
+export interface BetaCacheMissUnavailable {
+  type: 'unavailable';
+}
+
+export interface BetaCitationCharLocation {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_char_index: number;
+
+  file_id: string | null;
+
+  start_char_index: number;
+
+  type: 'char_location';
+}
+
+export interface BetaCitationCharLocationParam {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_char_index: number;
+
+  start_char_index: number;
+
+  type: 'char_location';
+}
+
+export interface BetaCitationConfig {
+  enabled: boolean;
+}
+
+export interface BetaCitationContentBlockLocation {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
+  end_block_index: number;
+
+  file_id: string | null;
+
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
+  start_block_index: number;
+
+  type: 'content_block_location';
+}
+
+export interface BetaCitationContentBlockLocationParam {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
+  end_block_index: number;
+
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
+  start_block_index: number;
+
+  type: 'content_block_location';
+}
+
+export interface BetaCitationPageLocation {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_page_number: number;
+
+  file_id: string | null;
+
+  start_page_number: number;
+
+  type: 'page_location';
+}
+
+export interface BetaCitationPageLocationParam {
+  cited_text: string;
+
+  document_index: number;
+
+  document_title: string | null;
+
+  end_page_number: number;
+
+  start_page_number: number;
+
+  type: 'page_location';
+}
+
+export interface BetaCitationSearchResultLocation {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
+  cited_text: string;
+
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
+  end_block_index: number;
+
+  /**
+   * 0-based index of the cited search result among all `search_result` content
+   * blocks in the request, in the order they appear across messages and tool
+   * results.
+   *
+   * Counted separately from `document_index`; server-side web search results are not
+   * included in this count.
+   */
+  search_result_index: number;
+
+  source: string;
+
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
+  start_block_index: number;
 
   title: string | null;
 
@@ -673,14 +1727,40 @@ export interface BetaCitationSearchResultLocation {
 }
 
 export interface BetaCitationSearchResultLocationParam {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
+  /**
+   * 0-based index of the cited search result among all `search_result` content
+   * blocks in the request, in the order they appear across messages and tool
+   * results.
+   *
+   * Counted separately from `document_index`; server-side web search results are not
+   * included in this count.
+   */
   search_result_index: number;
 
   source: string;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   title: string | null;
@@ -847,7 +1927,9 @@ export interface BetaCodeExecutionTool20250522 {
 
   type: 'code_execution_20250522';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -874,9 +1956,46 @@ export interface BetaCodeExecutionTool20250825 {
    */
   name: 'code_execution';
 
-  type: 'code_execution_20250825';
+  type: 'code_execution_20250825';
+
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * If true, tool will not be included in initial system prompt. Only loaded when
+   * returned via tool_reference from tool search.
+   */
+  defer_loading?: boolean;
+
+  /**
+   * When true, guarantees schema validation on tool names and inputs
+   */
+  strict?: boolean;
+}
+
+/**
+ * Code execution tool with REPL state persistence (daemon mode + gVisor
+ * checkpoint).
+ */
+export interface BetaCodeExecutionTool20260120 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in `tool_use` blocks.
+   */
+  name: 'code_execution';
+
+  type: 'code_execution_20260120';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -896,10 +2015,9 @@ export interface BetaCodeExecutionTool20250825 {
 }
 
 /**
- * Code execution tool with REPL state persistence (daemon mode + gVisor
- * checkpoint).
+ * Code execution tool with REPL state persistence.
  */
-export interface BetaCodeExecutionTool20260120 {
+export interface BetaCodeExecutionTool20260521 {
   /**
    * Name of the tool.
    *
@@ -907,9 +2025,11 @@ export interface BetaCodeExecutionTool20260120 {
    */
   name: 'code_execution';
 
-  type: 'code_execution_20260120';
+  type: 'code_execution_20260521';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -1043,68 +2163,498 @@ export interface BetaCompactionBlock {
  * treats these as no-ops. Empty string content is not allowed.
  */
 export interface BetaCompactionBlockParam {
+  type: 'compaction';
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Summary of previously compacted content, or null if compaction failed
+   */
+  content?: string | null;
+
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content?: string | null;
+}
+
+export interface BetaCompactionContentBlockDelta {
+  content: string | null;
+
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content: string | null;
+
+  type: 'compaction_delta';
+}
+
+/**
+ * Token usage for a compaction iteration.
+ */
+export interface BetaCompactionIterationUsage {
+  /**
+   * Breakdown of cached tokens by TTL
+   */
+  cache_creation: BetaCacheCreation | null;
+
+  /**
+   * The number of input tokens used to create the cache entry.
+   */
+  cache_creation_input_tokens: number;
+
+  /**
+   * The number of input tokens read from the cache.
+   */
+  cache_read_input_tokens: number;
+
+  /**
+   * The number of input tokens which were used.
+   */
+  input_tokens: number;
+
+  /**
+   * The number of output tokens which were used.
+   */
+  output_tokens: number;
+
+  /**
+   * Usage for a compaction iteration
+   */
+  type: 'compaction';
+}
+
+/**
+ * `cursor_position`'s config overrides.
+ */
+export interface BetaComputerCursorPositionConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `double_click`'s config overrides.
+ */
+export interface BetaComputerDoubleClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `hold_key`'s config overrides.
+ */
+export interface BetaComputerHoldKeyConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `key`'s config overrides.
+ */
+export interface BetaComputerKeyConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `left_click`'s config overrides.
+ */
+export interface BetaComputerLeftClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `left_click_drag`'s config overrides.
+ */
+export interface BetaComputerLeftClickDragConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `left_mouse_down`'s config overrides.
+ */
+export interface BetaComputerLeftMouseDownConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `left_mouse_up`'s config overrides.
+ */
+export interface BetaComputerLeftMouseUpConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `middle_click`'s config overrides.
+ */
+export interface BetaComputerMiddleClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `mouse_move`'s config overrides.
+ */
+export interface BetaComputerMouseMoveConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `right_click`'s config overrides.
+ */
+export interface BetaComputerRightClickConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `screenshot`'s config overrides.
+ */
+export interface BetaComputerScreenshotConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * `scroll`'s config overrides.
+ */
+export interface BetaComputerScrollConfig {
+  /**
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
+   */
+  defer_loading?: boolean | null;
+
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
+}
+
+/**
+ * The computer toolset: a single `tools[]` entry (carrying no `name`) that
+ * declares the computer tool family. The model is served the family's tool with
+ * any members disabled via `configs` removed from its schema. Every member is
+ * enabled by default, zoom included. The single-tool options `display_number` and
+ * `enable_zoom` are not fields of a toolset entry — it carries only `type`,
+ * `configs`, and `cache_control`; zoom is controlled via `configs.zoom.enabled`.
+ */
+export interface BetaComputerToolset20260801 {
+  type: 'computer_toolset_20260801';
+
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Per-member configuration for `computer_toolset_20260801`: one optional field per
+   * member tool, keyed by the member name — the same name the member's `tool_use`
+   * blocks carry. Every member is an accepted key, and a member's defaults apply
+   * wherever its key is absent. Unknown keys are rejected: the field set is this
+   * toolset version's complete member set.
+   */
+  configs?: BetaComputerToolsetConfigs | null;
+}
+
+/**
+ * Per-member configuration for `computer_toolset_20260801`: one optional field per
+ * member tool, keyed by the member name — the same name the member's `tool_use`
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
+ * toolset version's complete member set.
+ */
+export interface BetaComputerToolsetConfigs {
+  /**
+   * `cursor_position`'s config overrides.
+   */
+  cursor_position?: BetaComputerCursorPositionConfig | null;
+
+  /**
+   * `double_click`'s config overrides.
+   */
+  double_click?: BetaComputerDoubleClickConfig | null;
+
+  /**
+   * `hold_key`'s config overrides.
+   */
+  hold_key?: BetaComputerHoldKeyConfig | null;
+
+  /**
+   * `key`'s config overrides.
+   */
+  key?: BetaComputerKeyConfig | null;
+
+  /**
+   * `left_click`'s config overrides.
+   */
+  left_click?: BetaComputerLeftClickConfig | null;
+
+  /**
+   * `left_click_drag`'s config overrides.
+   */
+  left_click_drag?: BetaComputerLeftClickDragConfig | null;
+
+  /**
+   * `left_mouse_down`'s config overrides.
+   */
+  left_mouse_down?: BetaComputerLeftMouseDownConfig | null;
+
+  /**
+   * `left_mouse_up`'s config overrides.
+   */
+  left_mouse_up?: BetaComputerLeftMouseUpConfig | null;
+
+  /**
+   * `middle_click`'s config overrides.
+   */
+  middle_click?: BetaComputerMiddleClickConfig | null;
+
+  /**
+   * `mouse_move`'s config overrides.
+   */
+  mouse_move?: BetaComputerMouseMoveConfig | null;
+
+  /**
+   * `right_click`'s config overrides.
+   */
+  right_click?: BetaComputerRightClickConfig | null;
+
+  /**
+   * `screenshot`'s config overrides.
+   */
+  screenshot?: BetaComputerScreenshotConfig | null;
+
   /**
-   * Summary of previously compacted content, or null if compaction failed
+   * `scroll`'s config overrides.
    */
-  content: string | null;
+  scroll?: BetaComputerScrollConfig | null;
 
-  type: 'compaction';
+  /**
+   * `triple_click`'s config overrides.
+   */
+  triple_click?: BetaComputerTripleClickConfig | null;
 
   /**
-   * Create a cache control breakpoint at this content block.
+   * `type`'s config overrides.
    */
-  cache_control?: BetaCacheControlEphemeral | null;
+  type?: BetaComputerTypeConfig | null;
 
   /**
-   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   * `wait`'s config overrides.
    */
-  encrypted_content?: string | null;
-}
+  wait?: BetaComputerWaitConfig | null;
 
-export interface BetaCompactionContentBlockDelta {
-  content: string | null;
+  /**
+   * `zoom`'s config overrides.
+   */
+  zoom?: BetaComputerZoomConfig | null;
+}
 
+/**
+ * `triple_click`'s config overrides.
+ */
+export interface BetaComputerTripleClickConfig {
   /**
-   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
    */
-  encrypted_content: string | null;
+  defer_loading?: boolean | null;
 
-  type: 'compaction_delta';
+  /**
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
+   */
+  enabled?: boolean | null;
 }
 
 /**
- * Token usage for a compaction iteration.
+ * `type`'s config overrides.
  */
-export interface BetaCompactionIterationUsage {
+export interface BetaComputerTypeConfig {
   /**
-   * Breakdown of cached tokens by TTL
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
    */
-  cache_creation: BetaCacheCreation | null;
+  defer_loading?: boolean | null;
 
   /**
-   * The number of input tokens used to create the cache entry.
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
    */
-  cache_creation_input_tokens: number;
+  enabled?: boolean | null;
+}
 
+/**
+ * `wait`'s config overrides.
+ */
+export interface BetaComputerWaitConfig {
   /**
-   * The number of input tokens read from the cache.
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
    */
-  cache_read_input_tokens: number;
+  defer_loading?: boolean | null;
 
   /**
-   * The number of input tokens which were used.
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
    */
-  input_tokens: number;
+  enabled?: boolean | null;
+}
 
+/**
+ * `zoom`'s config overrides.
+ */
+export interface BetaComputerZoomConfig {
   /**
-   * The number of output tokens which were used.
+   * Defer loading for this member. Must resolve to the same value on every enabled
+   * member of the toolset.
    */
-  output_tokens: number;
+  defer_loading?: boolean | null;
 
   /**
-   * Usage for a compaction iteration
+   * Whether this member is offered to the model. Default is per member, per the
+   * toolset's documentation. A member whose enabled resolves false is withheld from
+   * the served schema.
    */
-  type: 'compaction';
+  enabled?: boolean | null;
 }
 
 /**
@@ -1186,7 +2736,8 @@ export type BetaContentBlock =
   | BetaMCPToolUseBlock
   | BetaMCPToolResultBlock
   | BetaContainerUploadBlock
-  | BetaCompactionBlock;
+  | BetaCompactionBlock
+  | BetaFallbackBlock;
 
 /**
  * Regular text content.
@@ -1211,7 +2762,10 @@ export type BetaContentBlockParam =
   | BetaMCPToolUseBlockParam
   | BetaRequestMCPToolResultBlockParam
   | BetaContainerUploadBlockParam
-  | BetaCompactionBlockParam;
+  | BetaCompactionBlockParam
+  | BetaRequestToolAdditionBlock
+  | BetaRequestToolRemovalBlock
+  | BetaFallbackBlockParam;
 
 export interface BetaContentBlockSource {
   content: string | Array<BetaContentBlockSourceContent>;
@@ -1242,6 +2796,42 @@ export interface BetaCountTokensContextManagementResponse {
   original_input_tokens: number;
 }
 
+/**
+ * Response envelope for request-level diagnostics. Present (possibly null)
+ * whenever the caller supplied `diagnostics` on the request.
+ */
+export interface BetaDiagnostics {
+  /**
+   * Explains why the prompt cache could not fully reuse the prefix from the request
+   * identified by `diagnostics.previous_message_id`. `null` means diagnosis is still
+   * pending — the response was serialized before the background comparison
+   * completed.
+   */
+  cache_miss_reason:
+    | BetaCacheMissModelChanged
+    | BetaCacheMissSystemChanged
+    | BetaCacheMissToolsChanged
+    | BetaCacheMissMessagesChanged
+    | BetaCacheMissPreviousMessageNotFound
+    | BetaCacheMissUnavailable
+    | null;
+}
+
+/**
+ * Request-level diagnostics. Currently carries the previous response id for
+ * prompt-cache divergence reporting.
+ */
+export interface BetaDiagnosticsParam {
+  /**
+   * The `id` (`msg_...`) from this client's previous /v1/messages response. The
+   * server compares that request's prompt fingerprint against this one and returns
+   * `diagnostics.cache_miss_reason` when the prompt-cache prefix could not be
+   * reused. Pass `null` on the first turn to opt in without a prior message to
+   * compare.
+   */
+  previous_message_id?: string | null;
+}
+
 /**
  * Tool invocation directly from the model.
  */
@@ -1295,6 +2885,306 @@ export interface BetaEncryptedCodeExecutionResultBlockParam {
   type: 'encrypted_code_execution_result';
 }
 
+/**
+ * Marks the point in `content` where one model's output gives way to the next.
+ *
+ * One block appears per hop where a preceding model actually ran this turn and
+ * declined. A turn where no preceding model ran and declined has no such boundary
+ * and carries no block — the signal for whether a fallback model served the
+ * response is the presence of a `fallback_message` entry in `usage.iterations`,
+ * not this block.
+ *
+ * The block is treated like a server-tool content block for streaming: it arrives
+ * via the standard `content_block_start` / `content_block_stop` pair and carries
+ * no deltas.
+ */
+export interface BetaFallbackBlock {
+  /**
+   * The model whose output ends at this point — the model that declined at this hop.
+   * When the declining hop is the requested model, its `model` echoes the top-level
+   * `model` string the caller sent (alias or canonical); when the declining hop is a
+   * fallback model, its `model` is that model's canonical id.
+   */
+  from: BetaFallbackInfo;
+
+  /**
+   * The fallback model producing the content that follows this block. Its `model` is
+   * always the canonical id.
+   */
+  to: BetaFallbackInfo;
+
+  /**
+   * What caused the `from` model to hand over at this hop.
+   */
+  trigger: BetaFallbackRefusalTrigger;
+
+  type: 'fallback';
+}
+
+/**
+ * A `fallback` block echoed back from a prior response.
+ *
+ * Accepted in `messages[].content` and not rendered into the prompt; not validated
+ * against the request's `fallbacks` chain or top-level `model`.
+ *
+ * Echo the assistant turn back verbatim, including this block in its original
+ * position. The block marks the boundary between content produced before and after
+ * a fallback hop, and the server relies on that boundary to validate the turn:
+ * when thinking runs flank the boundary, omitting the block merges them into one
+ * span the server cannot validate (the request is rejected), and moving it into
+ * the middle of a single run is likewise rejected; between non-thinking blocks the
+ * block's placement has no validation effect.
+ */
+export interface BetaFallbackBlockParam {
+  /**
+   * Identifies one hop of a fallback transition.
+   */
+  from: BetaFallbackInfoParam;
+
+  /**
+   * Identifies one hop of a fallback transition.
+   */
+  to: BetaFallbackInfoParam;
+
+  type: 'fallback';
+
+  /**
+   * The response block's `trigger`, echoed verbatim. Accepted and ignored by the
+   * server; any object or `null` is allowed.
+   */
+  trigger?: unknown;
+}
+
+/**
+ * No reprice was applied; `reason` says why.
+ */
+export interface BetaFallbackCreditNotApplied {
+  /**
+   * Why the reprice was not applied.
+   *
+   * A closed enum; additions to the redemption-check vocabulary arrive as deliberate
+   * schema updates.
+   */
+  reason:
+    | 'body_mismatch'
+    | 'continuation_excluded'
+    | 'continuation_only'
+    | 'expired'
+    | 'invalid_target_model'
+    | 'not_enabled'
+    | 'reprice_unavailable'
+    | 'temporarily_unavailable'
+    | 'variant_fields_present'
+    | 'wrong_organization'
+    | 'wrong_platform'
+    | 'wrong_workspace';
+
+  type: 'not_applied';
+
+  /**
+   * Request fields to remove before retrying, so the retry can redeem this token.
+   *
+   * Present exactly when `reason` is `variant_fields_present` — never null, never an
+   * empty array; absent otherwise. Fields are named only from your own request, and
+   * only after the sealed variant hash matched. A served best-effort retry has
+   * already been billed at normal price; nothing redeems retroactively, but a
+   * corrected re-send inside the token's five-minute window can still redeem.
+   */
+  remove_to_redeem?: Array<string> | null;
+}
+
+/**
+ * The reprice was applied: the retry is billed as if the conversation had been on
+ * the retry model all along.
+ */
+export interface BetaFallbackCreditRedeemed {
+  type: 'redeemed';
+}
+
+/**
+ * Object form of `fallback_credit_token`: the token plus a redemption mode.
+ *
+ * Requires `anthropic-beta: fallback-credit-2026-07-01`; without that header the
+ * field accepts the bare string only. The bare string and the mode-less object are
+ * equivalent (both select `strict`), so wrapping an existing token changes nothing
+ * by itself.
+ */
+export interface BetaFallbackCreditTokenParam {
+  /**
+   * The opaque `fallback_credit_token` from a prior refusal's `stop_details` — the
+   * same string the bare-string form carries.
+   */
+  token: string;
+
+  /**
+   * How a failing token affects the retry. `strict` (the default, and the
+   * bare-string behavior): a failing redemption is a 400 and the retry is not
+   * served. `best_effort`: the retry is served either way — a token-layer failure no
+   * longer rejects the request; the retry proceeds at normal price and the outcome
+   * is reported on the response's `usage.fallback_credit`. Two failures stay hard in
+   * both modes: a malformed token, and combining `fallback_credit_token` with
+   * `fallbacks`.
+   */
+  mode?: 'strict' | 'best_effort';
+}
+
+/**
+ * Outcome of the `fallback_credit_token` presented on this request.
+ */
+export interface BetaFallbackCreditUsage {
+  /**
+   * Whether the fallback-credit reprice was applied to this response's billing.
+   *
+   * A union discriminated on `type`. `redeemed`: the retry is billed as if the
+   * conversation had been on the retry model all along — including when the
+   * resulting shift is zero because there was nothing to move. `not_applied`: no
+   * reprice was applied; the arm's `reason` says why.
+   */
+  status: BetaFallbackCreditRedeemed | BetaFallbackCreditNotApplied;
+}
+
+/**
+ * Identifies one hop of a fallback transition.
+ */
+export interface BetaFallbackInfo {
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+}
+
+/**
+ * Identifies one hop of a fallback transition.
+ */
+export interface BetaFallbackInfoParam {
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+}
+
+/**
+ * Token usage for the fallback-model attempt of a server-side fallback request.
+ *
+ * Produced in place of a `message` entry for whichever hop served the response. A
+ * declined hop produces the existing `message` entry. Whether a fallback model
+ * served the response is signalled by the presence of this entry in
+ * `usage.iterations`.
+ */
+export interface BetaFallbackMessageIterationUsage {
+  /**
+   * Breakdown of cached tokens by TTL
+   */
+  cache_creation: BetaCacheCreation | null;
+
+  /**
+   * The number of input tokens used to create the cache entry.
+   */
+  cache_creation_input_tokens: number;
+
+  /**
+   * The number of input tokens read from the cache.
+   */
+  cache_read_input_tokens: number;
+
+  /**
+   * The number of input tokens which were used.
+   */
+  input_tokens: number;
+
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+
+  /**
+   * The number of output tokens which were used.
+   */
+  output_tokens: number;
+
+  /**
+   * Usage for the fallback-model attempt that served the response
+   */
+  type: 'fallback_message';
+}
+
+/**
+ * One entry in the `fallbacks` chain on a `/v1/messages` request.
+ *
+ * `model` is required. The override fields (`max_tokens`, `thinking`,
+ * `output_config`, and `speed`) set the corresponding parameter for this attempt
+ * only and are validated as if the request were made to `model`. Any other key is
+ * rejected at parse time.
+ */
+export interface BetaFallbackParam {
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+
+  max_tokens?: number | null;
+
+  output_config?: BetaOutputConfig | null;
+
+  /**
+   * Inference speed mode. `fast` provides significantly faster output token
+   * generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
+   */
+  speed?: 'standard' | 'fast' | null;
+
+  thinking?: BetaThinkingConfigEnabled | BetaThinkingConfigDisabled | BetaThinkingConfigAdaptive | null;
+
+  [k: string]: unknown;
+}
+
+/**
+ * The `from` model declined for policy reasons.
+ */
+export interface BetaFallbackRefusalTrigger {
+  /**
+   * The policy category that triggered a refusal.
+   *
+   * - `cyber` - The request could enable cyber harm, such as malware or exploit
+   *   development. Benign cybersecurity work can also trigger this category.
+   * - `bio` - The request could enable biological harm, such as dangerous lab
+   *   methods. Beneficial life sciences work can also trigger this category.
+   * - `frontier_llm` - The request could assist the development of competing AI
+   *   models, which is restricted under
+   *   [Anthropic's commercial terms](https://www.anthropic.com/legal/commercial-terms).
+   *   Benign machine learning work can also trigger this category.
+   * - `reasoning_extraction` - The request asks the model to reproduce its internal
+   *   reasoning in the response text. To get reasoning in a structured form instead,
+   *   use
+   *   [adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking).
+   * - `general_harms` - The request could be related to an area that was determined
+   *   as harmful. Benign work might sometimes trigger this category.
+   */
+  category: 'cyber' | 'bio' | 'frontier_llm' | 'reasoning_extraction' | 'general_harms' | null;
+
+  type: 'refusal';
+}
+
+/**
+ * Opt-in server-side retry on one or more substitute models when the requested
+ * model declines for policy reasons. Tried in order: if the first entry also
+ * declines, the second is tried, and so on. The string "default" requests the
+ * requested model's server-defined default fallback configuration.
+ */
+export type BetaFallbacksParam = Array<BetaFallbackParam> | 'default';
+
 export interface BetaFileDocumentSource {
   file_id: string;
 
@@ -1316,6 +3206,32 @@ export interface BetaImageBlockParam {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Configures the transformations the server applies to this image before the model
+   * observes it. Each key names a condition the server transforms images for; its
+   * value selects the transformation applied. Omitted keys keep their default
+   * behavior, and an empty object is equivalent to omitting the field.
+   */
+  transformations?: BetaImageTransformationsParam | null;
+}
+
+/**
+ * Configures the transformations the server applies to this image before the model
+ * observes it. Each key names a condition the server transforms images for; its
+ * value selects the transformation applied. Omitted keys keep their default
+ * behavior, and an empty object is equivalent to omitting the field.
+ */
+export interface BetaImageTransformationsParam {
+  /**
+   * What the server does when this image exceeds the model's maximum image size.
+   * `"downsize"` (the default) scales the image down to fit, which changes the
+   * dimensions the model observes without telling you. `"error"` instead rejects the
+   * request with a 400 error naming the image's dimensions and the largest
+   * dimensions that fit, so you can scale the image deliberately — your image is
+   * never silently scaled down.
+   */
+  oversized_image?: 'downsize' | 'error';
 }
 
 export interface BetaInputJSONDelta {
@@ -1347,7 +3263,10 @@ export interface BetaInputTokensTrigger {
  * - Understand token accumulation across server-side tool use loops
  */
 export type BetaIterationsUsage = Array<
-  BetaMessageIterationUsage | BetaCompactionIterationUsage | BetaAdvisorMessageIterationUsage
+  | BetaMessageIterationUsage
+  | BetaCompactionIterationUsage
+  | BetaAdvisorMessageIterationUsage
+  | BetaFallbackMessageIterationUsage
 >;
 
 export interface BetaJSONOutputFormat {
@@ -1465,7 +3384,9 @@ export interface BetaMemoryTool20250818 {
 
   type: 'memory_20250818';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -1659,8 +3580,15 @@ export interface BetaMessage {
   context_management: BetaContextManagementResponse | null;
 
   /**
-   * The model that will complete your prompt.\n\nSee
-   * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * Response envelope for request-level diagnostics. Present (possibly null)
+   * whenever the caller supplied `diagnostics` on the request.
+   */
+  diagnostics: BetaDiagnostics | null;
+
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
    * details and options.
    */
   model: MessagesAPI.Model;
@@ -1690,6 +3618,7 @@ export interface BetaMessage {
    *   back as-is in a subsequent request to let the model continue.
    * - `"refusal"`: when streaming classifiers intervene to handle potential policy
    *   violations
+   * - `"model_context_window_exceeded"`: we exceeded the model's context window
    *
    * In non-streaming mode this value is always non-null. In streaming mode, it is
    * null in the `message_start` event and non-null otherwise.
@@ -1742,6 +3671,11 @@ export interface BetaMessageDeltaUsage {
    */
   cache_read_input_tokens: number | null;
 
+  /**
+   * Outcome of the `fallback_credit_token` presented on this request.
+   */
+  fallback_credit: BetaFallbackCreditUsage | null;
+
   /**
    * The cumulative number of input tokens which were used.
    */
@@ -1764,6 +3698,16 @@ export interface BetaMessageDeltaUsage {
    */
   output_tokens: number;
 
+  /**
+   * Breakdown of output tokens by category.
+   *
+   * `output_tokens` remains the inclusive, authoritative total used for billing.
+   * This object provides a read-only decomposition for observability — for example,
+   * how many of the billed output tokens were spent on internal reasoning that may
+   * have been summarized before being returned to you.
+   */
+  output_tokens_details: BetaOutputTokensDetails | null;
+
   /**
    * The number of server tool requests.
    */
@@ -1794,6 +3738,14 @@ export interface BetaMessageIterationUsage {
    */
   input_tokens: number;
 
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+
   /**
    * The number of output tokens which were used.
    */
@@ -1808,7 +3760,7 @@ export interface BetaMessageIterationUsage {
 export interface BetaMessageParam {
   content: string | Array<BetaContentBlockParam>;
 
-  role: 'user' | 'assistant';
+  role: 'user' | 'assistant' | 'system';
 }
 
 export interface BetaMessageTokensCount {
@@ -1853,6 +3805,20 @@ export interface BetaOutputConfig {
   task_budget?: BetaTokenTaskBudget | null;
 }
 
+export interface BetaOutputTokensDetails {
+  /**
+   * Number of output tokens the model generated as internal reasoning, including the
+   * thinking-block delimiter tokens.
+   *
+   * Reflects the raw reasoning the model produced, not the (possibly shorter)
+   * summarized thinking text returned in the response body. Computed by
+   * re-tokenizing the raw reasoning text, so it may differ from the model's exact
+   * generation count by a small number of tokens. Always ≤ `output_tokens`;
+   * `output_tokens - thinking_tokens` approximates the non-reasoning output.
+   */
+  thinking_tokens: number;
+}
+
 export interface BetaPlainTextSource {
   data: string;
 
@@ -1897,7 +3863,8 @@ export interface BetaRawContentBlockStartEvent {
     | BetaMCPToolUseBlock
     | BetaMCPToolResultBlock
     | BetaContainerUploadBlock
-    | BetaCompactionBlock;
+    | BetaCompactionBlock
+    | BetaFallbackBlock;
 
   index: number;
 
@@ -1978,12 +3945,28 @@ export type BetaRawMessageStreamEvent =
   | BetaRawContentBlockStopEvent;
 
 export interface BetaRedactedThinkingBlock {
+  /**
+   * The contents of this redacted thinking block, returned when portions of the
+   * model's thinking were safety-redacted. This field is opaque and encrypted, with
+   * no readable content.
+   *
+   * Pass `redacted_thinking` blocks back to the API unchanged when continuing a
+   * multi-turn conversation.
+   *
+   * See
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#redacted-thinking-blocks)
+   * for details.
+   */
   data: string;
 
   type: 'redacted_thinking';
 }
 
 export interface BetaRedactedThinkingBlockParam {
+  /**
+   * The `data` value of this redacted thinking block, exactly as returned by the API
+   * in a previous response. Opaque and encrypted; pass it back unchanged.
+   */
   data: string;
 
   type: 'redacted_thinking';
@@ -1994,19 +3977,85 @@ export interface BetaRedactedThinkingBlockParam {
  */
 export interface BetaRefusalStopDetails {
   /**
-   * The policy category that triggered the refusal.
+   * The policy category that triggered a refusal.
+   *
+   * - `cyber` - The request could enable cyber harm, such as malware or exploit
+   *   development. Benign cybersecurity work can also trigger this category.
+   * - `bio` - The request could enable biological harm, such as dangerous lab
+   *   methods. Beneficial life sciences work can also trigger this category.
+   * - `frontier_llm` - The request could assist the development of competing AI
+   *   models, which is restricted under
+   *   [Anthropic's commercial terms](https://www.anthropic.com/legal/commercial-terms).
+   *   Benign machine learning work can also trigger this category.
+   * - `reasoning_extraction` - The request asks the model to reproduce its internal
+   *   reasoning in the response text. To get reasoning in a structured form instead,
+   *   use
+   *   [adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking).
+   * - `general_harms` - The request could be related to an area that was determined
+   *   as harmful. Benign work might sometimes trigger this category.
+   */
+  category: 'cyber' | 'bio' | 'frontier_llm' | 'reasoning_extraction' | 'general_harms' | null;
+
+  /**
+   * Human-readable explanation of the refusal.
+   *
+   * This text is not guaranteed to be stable. `null` when no explanation is
+   * available for the category.
+   */
+  explanation: string | null;
+
+  /**
+   * Opaque code that refunds the cache-miss cost when retrying this refused request
+   * on the fallback model. Pass it as `fallback_credit_token` on the retry request.
+   * Expires 5 minutes after the refusal.
+   *
+   * The retry is sent either with the same request body (`system`, `messages`,
+   * `tools`, and other render-shaping fields), or with the same body plus one
+   * appended `assistant` message whose content is the partial text (with any
+   * trailing whitespace stripped from the final text block) and paired server-tool
+   * blocks from this refusal — which also authorizes that appended turn as an
+   * assistant-prefill continuation on models that otherwise disallow prefill. A
+   * token minted mid-server-tool-loop whose partial content was continuable may only
+   * be redeemed the second way — if a same-body retry is rejected with a 400 saying
+   * the token must be redeemed by continuing the partial response, retry the second
+   * way instead. Either way: same workspace, same platform; a mismatch is a 400.
+   * Resending a token for an already-warm prefix is permitted but yields no
+   * additional credit.
    *
-   * `null` when the refusal doesn't map to a named category.
+   * `null` when the refused model isn't eligible for a fallback credit.
    */
-  category: 'cyber' | 'bio' | null;
+  fallback_credit_token: string | null;
 
   /**
-   * Human-readable explanation of the refusal.
+   * Whether the accompanying `fallback_credit_token` may be redeemed with the
+   * appended-assistant retry form. Only set when `fallback_credit_token` is present.
    *
-   * This text is not guaranteed to be stable. `null` when no explanation is
-   * available for the category.
+   * `true`: retry by resending the same request body plus one appended `assistant`
+   * message whose content is this response's `content` with any trailing whitespace
+   * stripped from the final text block and unpaired `tool_use` blocks omitted (the
+   * same appended-turn shape described on `fallback_credit_token`), with the token
+   * attached. `false`: retry by resending the original request body unchanged, with
+   * the token attached — the appended-assistant form is not available for this
+   * refusal (no continuable partial content, or the request uses `output_format` or
+   * a `tool_choice` that forces tool use). One exception: when the request used
+   * `output_format` or a forced `tool_choice` and the refusal arrived after server
+   * tools (including MCP connector tools) had already executed, the token may not be
+   * redeemable by either retry form; if the exact-body retry is then rejected with a
+   * 400 saying the token must be redeemed by continuing the partial response,
+   * discard the token and retry without it.
+   *
+   * Advisory: if an appended-assistant retry is rejected with a 400 despite `true`,
+   * fall back to resending the original request body with the token.
    */
-  explanation: string | null;
+  fallback_has_prefill_claim: boolean | null;
+
+  /**
+   * The server's suggested retry target for this refusal. Populated when a fallback
+   * attempt could not be made (the fallback model's rate limit was exhausted, or it
+   * was overloaded); names the fallback model the caller can retry directly. Null
+   * otherwise.
+   */
+  recommended_model: string | null;
 
   type: 'refusal';
 }
@@ -2066,6 +4115,50 @@ export interface BetaRequestMCPToolResultBlockParam {
   is_error?: boolean;
 }
 
+/**
+ * Mid-conversation directive to surface a declared tool.
+ *
+ * `tool` references a tool (or MCP toolset) by name from the request's `tools`; it
+ * is offered to the model from this point in the conversation onward.
+ */
+export interface BetaRequestToolAdditionBlock {
+  /**
+   * Reference to a single tool the caller declared directly in `tools[]`. Does not
+   * accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+   * tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+   */
+  tool: BetaToolChangeToolReference | BetaToolChangeMCPToolReference | BetaToolChangeMCPToolsetReference;
+
+  type: 'tool_addition';
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+}
+
+/**
+ * Mid-conversation directive to withdraw a tool.
+ *
+ * `tool` references a tool (or MCP toolset) by name from the request's `tools`; it
+ * is no longer offered to the model from this point in the conversation onward.
+ */
+export interface BetaRequestToolRemovalBlock {
+  /**
+   * Reference to a single tool the caller declared directly in `tools[]`. Does not
+   * accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+   * tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+   */
+  tool: BetaToolChangeToolReference | BetaToolChangeMCPToolReference | BetaToolChangeMCPToolsetReference;
+
+  type: 'tool_removal';
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+}
+
 export interface BetaSearchResultBlockParam {
   content: Array<BetaTextBlockParam>;
 
@@ -2162,6 +4255,11 @@ export interface BetaServerToolUseBlockParam {
 }
 
 export interface BetaSignatureDelta {
+  /**
+   * The `signature` for this thinking block: an opaque value used to verify that the
+   * block was generated by Claude when it is passed back to the API. Delivered in a
+   * `signature_delta` event just before the block's `content_block_stop` event.
+   */
   signature: string;
 
   type: 'signature_delta';
@@ -2182,7 +4280,7 @@ export interface BetaSkill {
   type: 'anthropic' | 'custom';
 
   /**
-   * Skill version or 'latest' for most recent version
+   * The resolved version: a skill version ID for custom skills.
    */
   version: string;
 }
@@ -2389,16 +4487,41 @@ export interface BetaTextEditorCodeExecutionViewResultBlockParam {
 }
 
 export interface BetaThinkingBlock {
+  /**
+   * A value used to verify that this thinking block was generated by Claude when it
+   * is passed back to the API.
+   *
+   * This is an opaque field and should not be interpreted or parsed. When passing
+   * thinking blocks back to the API (required when using tools with extended
+   * thinking), pass them back exactly as received, with this field intact.
+   *
+   * See
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
+   * for details.
+   */
   signature: string;
 
+  /**
+   * The text of Claude's thinking process for this block.
+   */
   thinking: string;
 
   type: 'thinking';
 }
 
 export interface BetaThinkingBlockParam {
+  /**
+   * The `signature` value of this thinking block, exactly as returned by the API in
+   * a previous response. Used to verify that the block was generated by Claude.
+   *
+   * Thinking blocks must be passed back unmodified and in their original order; a
+   * modified block results in a 400 `invalid_request_error`.
+   */
   signature: string;
 
+  /**
+   * The `thinking` text of this block as returned by the API.
+   */
   thinking: string;
 
   type: 'thinking';
@@ -2429,7 +4552,7 @@ export interface BetaThinkingConfigEnabled {
    * Must be ≥1024 and less than `max_tokens`.
    *
    * See
-   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
    * for details.
    */
   budget_tokens: number;
@@ -2453,7 +4576,7 @@ export interface BetaThinkingConfigEnabled {
  * tokens and counts towards your `max_tokens` limit.
  *
  * See
- * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+ * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
  * for details.
  */
 export type BetaThinkingConfigParam =
@@ -2462,6 +4585,23 @@ export type BetaThinkingConfigParam =
   | BetaThinkingConfigAdaptive;
 
 export interface BetaThinkingDelta {
+  /**
+   * Per-frame increment of a coarse, running estimate of the tokens this thinking
+   * block has produced so far. Present whenever the
+   * `thinking-token-count-2026-05-13` beta is set; `null` unless `thinking.display`
+   * resolves to `"omitted"` and a count is due this frame. Sum the increments across
+   * `thinking_delta` frames on this block for a progress indicator. Each increment
+   * is a non-negative multiple of a fixed quantum and the cadence is rate-limited,
+   * so this is a deliberately lossy display hint, not a billable count;
+   * `usage.output_tokens` remains authoritative.
+   */
+  estimated_tokens: number | null;
+
+  /**
+   * The incremental `thinking` text for this content block. Concatenate the
+   * `thinking` values of successive `thinking_delta` events to assemble the block's
+   * full `thinking` value.
+   */
   thinking: string;
 
   type: 'thinking_delta';
@@ -2510,7 +4650,9 @@ export interface BetaTool {
    */
   name: string;
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2580,7 +4722,9 @@ export interface BetaToolBash20241022 {
 
   type: 'bash_20241022';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2611,7 +4755,9 @@ export interface BetaToolBash20250124 {
 
   type: 'bash_20250124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2632,6 +4778,38 @@ export interface BetaToolBash20250124 {
   strict?: boolean;
 }
 
+/**
+ * Reference to a single MCP tool by its server and remote name — the same
+ * `server_name`/`name` pair `mcp_tool_use` carries.
+ */
+export interface BetaToolChangeMCPToolReference {
+  name: string;
+
+  server_name: string;
+
+  type: 'mcp_tool_reference';
+}
+
+/**
+ * Reference to every tool in the named MCP server's toolset.
+ */
+export interface BetaToolChangeMCPToolsetReference {
+  server_name: string;
+
+  type: 'mcp_toolset_reference';
+}
+
+/**
+ * Reference to a single tool the caller declared directly in `tools[]`. Does not
+ * accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+ * tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+ */
+export interface BetaToolChangeToolReference {
+  name: string;
+
+  type: 'tool_reference';
+}
+
 /**
  * How the model should use the provided tools. The model can use a specific tool,
  * any available tool, decide by itself, or not use tools at all.
@@ -2715,7 +4893,9 @@ export interface BetaToolComputerUse20241022 {
 
   type: 'computer_20241022';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2761,7 +4941,9 @@ export interface BetaToolComputerUse20250124 {
 
   type: 'computer_20250124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2807,7 +4989,9 @@ export interface BetaToolComputerUse20251124 {
 
   type: 'computer_20251124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2876,9 +5060,15 @@ export interface BetaToolResultBlockParam {
         | BetaSearchResultBlockParam
         | BetaRequestDocumentBlock
         | BetaToolReferenceBlockParam
+        | BetaBrowserStateBlockParam
       >;
 
   is_error?: boolean;
+
+  /**
+   * For a toolset member tool_result, the toolset family of the paired tool_use.
+   */
+  toolset_name?: string | null;
 }
 
 export interface BetaToolSearchToolBm25_20251119 {
@@ -2891,7 +5081,9 @@ export interface BetaToolSearchToolBm25_20251119 {
 
   type: 'tool_search_tool_bm25_20251119' | 'tool_search_tool_bm25';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2920,7 +5112,9 @@ export interface BetaToolSearchToolRegex20251119 {
 
   type: 'tool_search_tool_regex_20251119' | 'tool_search_tool_regex';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -2972,6 +5166,8 @@ export interface BetaToolSearchToolResultErrorParam {
   error_code: 'invalid_tool_input' | 'unavailable' | 'too_many_requests' | 'execution_time_exceeded';
 
   type: 'tool_search_tool_result_error';
+
+  error_message?: string | null;
 }
 
 export interface BetaToolSearchToolSearchResultBlock {
@@ -2998,7 +5194,9 @@ export interface BetaToolTextEditor20241022 {
 
   type: 'text_editor_20241022';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3029,7 +5227,9 @@ export interface BetaToolTextEditor20250124 {
 
   type: 'text_editor_20250124';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3060,7 +5260,9 @@ export interface BetaToolTextEditor20250429 {
 
   type: 'text_editor_20250429';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3091,7 +5293,9 @@ export interface BetaToolTextEditor20250728 {
 
   type: 'text_editor_20250728';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * Create a cache control breakpoint at this content block.
@@ -3129,11 +5333,14 @@ export type BetaToolUnion =
   | BetaCodeExecutionTool20250522
   | BetaCodeExecutionTool20250825
   | BetaCodeExecutionTool20260120
+  | BetaCodeExecutionTool20260521
+  | BetaBrowserToolset20260801
   | BetaToolComputerUse20241022
   | BetaMemoryTool20250818
   | BetaToolComputerUse20250124
   | BetaToolTextEditor20241022
   | BetaToolComputerUse20251124
+  | BetaComputerToolset20260801
   | BetaToolTextEditor20250124
   | BetaToolTextEditor20250429
   | BetaToolTextEditor20250728
@@ -3142,6 +5349,8 @@ export type BetaToolUnion =
   | BetaWebSearchTool20260209
   | BetaWebFetchTool20260209
   | BetaWebFetchTool20260309
+  | BetaWebSearchTool20260318
+  | BetaWebFetchTool20260318
   | BetaAdvisorTool20260301
   | BetaToolSearchToolBm25_20251119
   | BetaToolSearchToolRegex20251119
@@ -3160,6 +5369,11 @@ export interface BetaToolUseBlock {
    * Tool invocation directly from the model.
    */
   caller?: BetaDirectCaller | BetaServerToolCaller | BetaServerToolCaller20260120;
+
+  /**
+   * For a toolset member tool_use, the toolset family.
+   */
+  toolset_name?: string | null;
 }
 
 export interface BetaToolUseBlockParam {
@@ -3180,6 +5394,11 @@ export interface BetaToolUseBlockParam {
    * Tool invocation directly from the model.
    */
   caller?: BetaDirectCaller | BetaServerToolCaller | BetaServerToolCaller20260120;
+
+  /**
+   * For a toolset member tool_use, the toolset family this member belongs to.
+   */
+  toolset_name?: string | null;
 }
 
 export interface BetaToolUsesKeep {
@@ -3222,6 +5441,11 @@ export interface BetaUsage {
    */
   cache_read_input_tokens: number | null;
 
+  /**
+   * Outcome of the `fallback_credit_token` presented on this request.
+   */
+  fallback_credit: BetaFallbackCreditUsage | null;
+
   /**
    * The geographic region where inference was performed for this request.
    */
@@ -3249,6 +5473,16 @@ export interface BetaUsage {
    */
   output_tokens: number;
 
+  /**
+   * Breakdown of output tokens by category.
+   *
+   * `output_tokens` remains the inclusive, authoritative total used for billing.
+   * This object provides a read-only decomposition for observability — for example,
+   * how many of the billed output tokens were spent on internal reasoning that may
+   * have been summarized before being returned to you.
+   */
+  output_tokens_details: BetaOutputTokensDetails | null;
+
   /**
    * The number of server tool requests.
    */
@@ -3260,7 +5494,9 @@ export interface BetaUsage {
   service_tier: 'standard' | 'priority' | 'batch' | null;
 
   /**
-   * The inference speed mode used for this request.
+   * Inference speed mode. `fast` provides significantly faster output token
+   * generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
    */
   speed: 'standard' | 'fast' | null;
 }
@@ -3333,7 +5569,9 @@ export interface BetaWebFetchTool20250910 {
 
   type: 'web_fetch_20250910';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * List of domains to allow fetching from
@@ -3389,7 +5627,9 @@ export interface BetaWebFetchTool20260209 {
 
   type: 'web_fetch_20260209';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * List of domains to allow fetching from
@@ -3448,7 +5688,74 @@ export interface BetaWebFetchTool20260309 {
 
   type: 'web_fetch_20260309';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
+
+  /**
+   * List of domains to allow fetching from
+   */
+  allowed_domains?: Array<string> | null;
+
+  /**
+   * List of domains to block fetching from
+   */
+  blocked_domains?: Array<string> | null;
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Citations configuration for fetched documents. Citations are disabled by
+   * default.
+   */
+  citations?: BetaCitationsConfigParam | null;
+
+  /**
+   * If true, tool will not be included in initial system prompt. Only loaded when
+   * returned via tool_reference from tool search.
+   */
+  defer_loading?: boolean;
+
+  /**
+   * Maximum number of tokens used by including web page text content in the context.
+   * The limit is approximate and does not apply to binary content such as PDFs.
+   */
+  max_content_tokens?: number | null;
+
+  /**
+   * Maximum number of times the tool can be used in the API request.
+   */
+  max_uses?: number | null;
+
+  /**
+   * When true, guarantees schema validation on tool names and inputs
+   */
+  strict?: boolean;
+
+  /**
+   * Whether to use cached content. Set to false to bypass the cache and fetch fresh
+   * content. Only set to false when the user explicitly requests fresh content or
+   * when fetching rapidly-changing sources.
+   */
+  use_cache?: boolean;
+}
+
+export interface BetaWebFetchTool20260318 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in `tool_use` blocks.
+   */
+  name: 'web_fetch';
+
+  type: 'web_fetch_20260318';
+
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * List of domains to allow fetching from
@@ -3488,6 +5795,16 @@ export interface BetaWebFetchTool20260309 {
    */
   max_uses?: number | null;
 
+  /**
+   * How this tool's result blocks appear in the API response when the result was
+   * consumed by a completed code_execution call in the same turn. 'full' returns the
+   * complete content (default). 'excluded' drops the nested server_tool_use and
+   * result block pair entirely. Results from direct calls, or from code_execution
+   * calls that paused before completing, are always returned in full so they can be
+   * sent back on the next turn.
+   */
+  response_inclusion?: 'full' | 'excluded';
+
   /**
    * When true, guarantees schema validation on tool names and inputs
    */
@@ -3548,6 +5865,7 @@ export type BetaWebFetchToolResultErrorCode =
   | 'invalid_tool_input'
   | 'url_too_long'
   | 'url_not_allowed'
+  | 'url_not_in_prior_context'
   | 'url_not_accessible'
   | 'unsupported_content_type'
   | 'too_many_requests'
@@ -3588,7 +5906,9 @@ export interface BetaWebSearchTool20250305 {
 
   type: 'web_search_20250305';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * If provided, only these domains will be included in results. Cannot be used
@@ -3640,7 +5960,63 @@ export interface BetaWebSearchTool20260209 {
 
   type: 'web_search_20260209';
 
-  allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
+
+  /**
+   * If provided, only these domains will be included in results. Cannot be used
+   * alongside `blocked_domains`.
+   */
+  allowed_domains?: Array<string> | null;
+
+  /**
+   * If provided, these domains will never appear in results. Cannot be used
+   * alongside `allowed_domains`.
+   */
+  blocked_domains?: Array<string> | null;
+
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * If true, tool will not be included in initial system prompt. Only loaded when
+   * returned via tool_reference from tool search.
+   */
+  defer_loading?: boolean;
+
+  /**
+   * Maximum number of times the tool can be used in the API request.
+   */
+  max_uses?: number | null;
+
+  /**
+   * When true, guarantees schema validation on tool names and inputs
+   */
+  strict?: boolean;
+
+  /**
+   * Parameters for the user's location. Used to provide more relevant search
+   * results.
+   */
+  user_location?: BetaUserLocation | null;
+}
+
+export interface BetaWebSearchTool20260318 {
+  /**
+   * Name of the tool.
+   *
+   * This is how the tool will be called by the model and in `tool_use` blocks.
+   */
+  name: 'web_search';
+
+  type: 'web_search_20260318';
+
+  allowed_callers?: Array<
+    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
+  >;
 
   /**
    * If provided, only these domains will be included in results. Cannot be used
@@ -3670,6 +6046,16 @@ export interface BetaWebSearchTool20260209 {
    */
   max_uses?: number | null;
 
+  /**
+   * How this tool's result blocks appear in the API response when the result was
+   * consumed by a completed code_execution call in the same turn. 'full' returns the
+   * complete content (default). 'excluded' drops the nested server_tool_use and
+   * result block pair entirely. Results from direct calls, or from code_execution
+   * calls that paused before completing, are always returned in full so they can be
+   * sent back on the next turn.
+   */
+  response_inclusion?: 'full' | 'excluded';
+
   /**
    * When true, guarantees schema validation on tool names and inputs
    */
@@ -3755,8 +6141,13 @@ export interface MessageCreateParamsBase {
    * Note that our models may stop _before_ reaching this maximum. This parameter
    * only specifies the absolute maximum number of tokens to generate.
    *
+   * Set to `0` to populate the
+   * [prompt cache](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pre-warming-the-cache)
+   * without generating a response.
+   *
    * Different models have different maximum values for this parameter. See
-   * [models](https://docs.claude.com/en/docs/models-overview) for details.
+   * [models](https://platform.claude.com/docs/en/about-claude/models/overview) for
+   * details.
    */
   max_tokens: number;
 
@@ -3818,20 +6209,22 @@ export interface MessageCreateParamsBase {
    * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
    * ```
    *
-   * See [input examples](https://docs.claude.com/en/api/messages-examples).
+   * See
+   * [input examples](https://platform.claude.com/docs/en/build-with-claude/working-with-messages).
    *
    * Note that if you want to include a
-   * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
-   * top-level `system` parameter — there is no `"system"` role for input messages in
-   * the Messages API.
+   * [system prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role),
+   * you can use the top-level `system` parameter — there is no `"system"` role for
+   * input messages in the Messages API.
    *
    * There is a limit of 100,000 messages in a single request.
    */
   messages: Array<BetaMessageParam>;
 
   /**
-   * Body param: The model that will complete your prompt.\n\nSee
-   * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * Body param: The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
    * details and options.
    */
   model: MessagesAPI.Model;
@@ -3855,6 +6248,43 @@ export interface MessageCreateParamsBase {
    */
   context_management?: BetaContextManagementConfig | null;
 
+  /**
+   * Body param: Request-level diagnostics. Currently carries the previous response
+   * id for prompt-cache divergence reporting.
+   */
+  diagnostics?: BetaDiagnosticsParam | null;
+
+  /**
+   * Body param: The `fallback_credit_token` from a prior refusal's `stop_details`.
+   *
+   * When a preceding request was refused and returned a `fallback_credit_token`,
+   * pass that code here on the retry to have the retry's cache-creation tokens for
+   * the prefix that was warm on the refused model billed at the cache-read rate.
+   * Must be redeemed by the same organization and workspace, with the same request
+   * body (optionally extended by one appended `assistant` message whose content is
+   * the partial text — with any trailing whitespace stripped from the final text
+   * block — and paired server-tool blocks streamed before the refusal; the
+   * appended-assistant form is not available for requests with `output_format` set
+   * or forced `tool_choice`), on an eligible fallback model, on the same platform,
+   * and within 5 minutes of the refusal; a mismatch is a 400. A token minted
+   * mid-server-tool-loop whose partial content was continuable may only be redeemed
+   * with the appended-assistant form — if an exact-body retry is rejected with a 400
+   * saying the token must be redeemed by continuing the partial response, retry with
+   * the appended-assistant form instead.
+   *
+   * When the appended-assistant form is used on a model that otherwise disallows
+   * assistant-turn prefill, this token also authorizes that one prefill.
+   */
+  fallback_credit_token?: string | BetaFallbackCreditTokenParam | null;
+
+  /**
+   * Body param: Opt-in server-side retry on one or more substitute models when the
+   * requested model declines for policy reasons. Tried in order: if the first entry
+   * also declines, the second is tried, and so on. The string "default" requests the
+   * requested model's server-defined default fallback configuration.
+   */
+  fallbacks?: BetaFallbacksParam | null;
+
   /**
    * Body param: Specifies the geographic region for inference processing. If not
    * specified, the workspace's `default_inference_geo` is used.
@@ -3891,13 +6321,15 @@ export interface MessageCreateParamsBase {
    * standard capacity for this request.
    *
    * Anthropic offers different levels of service for your API requests. See
-   * [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
+   * [service-tiers](https://platform.claude.com/docs/en/api/service-tiers) for
+   * details.
    */
   service_tier?: 'auto' | 'standard_only';
 
   /**
-   * Body param: The inference speed mode for this request. `"fast"` enables high
-   * output-tokens-per-second inference.
+   * Body param: Inference speed mode. `fast` provides significantly faster output
+   * token generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
    */
   speed?: 'standard' | 'fast' | null;
 
@@ -3918,7 +6350,8 @@ export interface MessageCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream?: boolean;
 
@@ -3927,7 +6360,7 @@ export interface MessageCreateParamsBase {
    *
    * A system prompt is a way of providing context and instructions to Claude, such
    * as specifying a particular goal or role. See our
-   * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
+   * [guide to system prompts](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role).
    */
   system?: string | Array<BetaTextBlockParam>;
 
@@ -3946,7 +6379,7 @@ export interface MessageCreateParamsBase {
    * tokens and counts towards your `max_tokens` limit.
    *
    * See
-   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
    * for details.
    */
   thinking?: BetaThinkingConfigParam;
@@ -3967,9 +6400,9 @@ export interface MessageCreateParamsBase {
    *
    * There are two types of tools: **client tools** and **server tools**. The
    * behavior described below applies to client tools. For
-   * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * [server tools](https://platform.claude.com/docs/en/agents-and-tools/tool-use/server-tools),
    * see their individual documentation as each has its own behavior (e.g., the
-   * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   * [web search tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)).
    *
    * Each tool definition includes:
    *
@@ -4032,7 +6465,9 @@ export interface MessageCreateParamsBase {
    * functions, or more generally whenever you want the model to produce a particular
    * JSON structure of output.
    *
-   * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
+   * See our
+   * [guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview)
+   * for more details.
    */
   tools?: Array<BetaToolUnion>;
 
@@ -4050,15 +6485,16 @@ export interface MessageCreateParamsBase {
   top_p?: number;
 
   /**
-   * Body param: The user profile ID to attribute this request to. Use when acting on
-   * behalf of a party other than your organization.
+   * Header param: Optional header to specify the beta version(s) you want to use.
    */
-  user_profile_id?: string | null;
+  betas?: Array<BetaAPI.AnthropicBeta>;
 
   /**
-   * Header param: Optional header to specify the beta version(s) you want to use.
+   * Header param: The user profile ID to attribute this request to. Use when acting
+   * on behalf of a party other than your organization. Requires the `user-profiles`
+   * beta header.
    */
-  betas?: Array<BetaAPI.AnthropicBeta>;
+  user_profile_id?: string;
 }
 
 export namespace MessageCreateParams {
@@ -4071,7 +6507,8 @@ export interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream?: false;
 }
@@ -4081,7 +6518,8 @@ export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+   * See [streaming](https://platform.claude.com/docs/en/build-with-claude/streaming)
+   * for details.
    */
   stream: true;
 }
@@ -4145,20 +6583,22 @@ export interface MessageCountTokensParams {
    * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
    * ```
    *
-   * See [input examples](https://docs.claude.com/en/api/messages-examples).
+   * See
+   * [input examples](https://platform.claude.com/docs/en/build-with-claude/working-with-messages).
    *
    * Note that if you want to include a
-   * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
-   * top-level `system` parameter — there is no `"system"` role for input messages in
-   * the Messages API.
+   * [system prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role),
+   * you can use the top-level `system` parameter — there is no `"system"` role for
+   * input messages in the Messages API.
    *
    * There is a limit of 100,000 messages in a single request.
    */
   messages: Array<BetaMessageParam>;
 
   /**
-   * Body param: The model that will complete your prompt.\n\nSee
-   * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * Body param: The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
    * details and options.
    */
   model: MessagesAPI.Model;
@@ -4198,8 +6638,9 @@ export interface MessageCountTokensParams {
   output_format?: BetaJSONOutputFormat | null;
 
   /**
-   * Body param: The inference speed mode for this request. `"fast"` enables high
-   * output-tokens-per-second inference.
+   * Body param: Inference speed mode. `fast` provides significantly faster output
+   * token generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
    */
   speed?: 'standard' | 'fast' | null;
 
@@ -4208,7 +6649,7 @@ export interface MessageCountTokensParams {
    *
    * A system prompt is a way of providing context and instructions to Claude, such
    * as specifying a particular goal or role. See our
-   * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
+   * [guide to system prompts](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role).
    */
   system?: string | Array<BetaTextBlockParam>;
 
@@ -4220,7 +6661,7 @@ export interface MessageCountTokensParams {
    * tokens and counts towards your `max_tokens` limit.
    *
    * See
-   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
    * for details.
    */
   thinking?: BetaThinkingConfigParam;
@@ -4241,9 +6682,9 @@ export interface MessageCountTokensParams {
    *
    * There are two types of tools: **client tools** and **server tools**. The
    * behavior described below applies to client tools. For
-   * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * [server tools](https://platform.claude.com/docs/en/agents-and-tools/tool-use/server-tools),
    * see their individual documentation as each has its own behavior (e.g., the
-   * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   * [web search tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)).
    *
    * Each tool definition includes:
    *
@@ -4306,7 +6747,9 @@ export interface MessageCountTokensParams {
    * functions, or more generally whenever you want the model to produce a particular
    * JSON structure of output.
    *
-   * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
+   * See our
+   * [guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview)
+   * for more details.
    */
   tools?: Array<
     | BetaTool
@@ -4315,11 +6758,14 @@ export interface MessageCountTokensParams {
     | BetaCodeExecutionTool20250522
     | BetaCodeExecutionTool20250825
     | BetaCodeExecutionTool20260120
+    | BetaCodeExecutionTool20260521
+    | BetaBrowserToolset20260801
     | BetaToolComputerUse20241022
     | BetaMemoryTool20250818
     | BetaToolComputerUse20250124
     | BetaToolTextEditor20241022
     | BetaToolComputerUse20251124
+    | BetaComputerToolset20260801
     | BetaToolTextEditor20250124
     | BetaToolTextEditor20250429
     | BetaToolTextEditor20250728
@@ -4328,6 +6774,8 @@ export interface MessageCountTokensParams {
     | BetaWebSearchTool20260209
     | BetaWebFetchTool20260209
     | BetaWebFetchTool20260309
+    | BetaWebSearchTool20260318
+    | BetaWebFetchTool20260318
     | BetaAdvisorTool20260301
     | BetaToolSearchToolBm25_20251119
     | BetaToolSearchToolRegex20251119
@@ -4338,6 +6786,13 @@ export interface MessageCountTokensParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: The user profile ID to attribute this request to. Use when acting
+   * on behalf of a party other than your organization. Requires the `user-profiles`
+   * beta header.
+   */
+  user_profile_id?: string;
 }
 
 export { BetaToolRunner, type BetaToolRunnerParams } from '../../../lib/tools/BetaToolRunner';
@@ -4371,8 +6826,54 @@ export declare namespace Messages {
     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,
+    type BetaCacheMissModelChanged as BetaCacheMissModelChanged,
+    type BetaCacheMissPreviousMessageNotFound as BetaCacheMissPreviousMessageNotFound,
+    type BetaCacheMissSystemChanged as BetaCacheMissSystemChanged,
+    type BetaCacheMissToolsChanged as BetaCacheMissToolsChanged,
+    type BetaCacheMissUnavailable as BetaCacheMissUnavailable,
     type BetaCitationCharLocation as BetaCitationCharLocation,
     type BetaCitationCharLocationParam as BetaCitationCharLocationParam,
     type BetaCitationConfig as BetaCitationConfig,
@@ -4397,6 +6898,7 @@ export declare namespace Messages {
     type BetaCodeExecutionTool20250522 as BetaCodeExecutionTool20250522,
     type BetaCodeExecutionTool20250825 as BetaCodeExecutionTool20250825,
     type BetaCodeExecutionTool20260120 as BetaCodeExecutionTool20260120,
+    type BetaCodeExecutionTool20260521 as BetaCodeExecutionTool20260521,
     type BetaCodeExecutionToolResultBlock as BetaCodeExecutionToolResultBlock,
     type BetaCodeExecutionToolResultBlockContent as BetaCodeExecutionToolResultBlockContent,
     type BetaCodeExecutionToolResultBlockParam as BetaCodeExecutionToolResultBlockParam,
@@ -4409,6 +6911,25 @@ export declare namespace Messages {
     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,
@@ -4420,13 +6941,28 @@ export declare namespace Messages {
     type BetaContextManagementConfig as BetaContextManagementConfig,
     type BetaContextManagementResponse as BetaContextManagementResponse,
     type BetaCountTokensContextManagementResponse as BetaCountTokensContextManagementResponse,
+    type BetaDiagnostics as BetaDiagnostics,
+    type BetaDiagnosticsParam as BetaDiagnosticsParam,
     type BetaDirectCaller as BetaDirectCaller,
     type BetaDocumentBlock as BetaDocumentBlock,
     type BetaEncryptedCodeExecutionResultBlock as BetaEncryptedCodeExecutionResultBlock,
     type BetaEncryptedCodeExecutionResultBlockParam as BetaEncryptedCodeExecutionResultBlockParam,
+    type BetaFallbackBlock as BetaFallbackBlock,
+    type BetaFallbackBlockParam as BetaFallbackBlockParam,
+    type BetaFallbackCreditNotApplied as BetaFallbackCreditNotApplied,
+    type BetaFallbackCreditRedeemed as BetaFallbackCreditRedeemed,
+    type BetaFallbackCreditTokenParam as BetaFallbackCreditTokenParam,
+    type BetaFallbackCreditUsage as BetaFallbackCreditUsage,
+    type BetaFallbackInfo as BetaFallbackInfo,
+    type BetaFallbackInfoParam as BetaFallbackInfoParam,
+    type BetaFallbackMessageIterationUsage as BetaFallbackMessageIterationUsage,
+    type BetaFallbackParam as BetaFallbackParam,
+    type BetaFallbackRefusalTrigger as BetaFallbackRefusalTrigger,
+    type BetaFallbacksParam as BetaFallbacksParam,
     type BetaFileDocumentSource as BetaFileDocumentSource,
     type BetaFileImageSource as BetaFileImageSource,
     type BetaImageBlockParam as BetaImageBlockParam,
+    type BetaImageTransformationsParam as BetaImageTransformationsParam,
     type BetaInputJSONDelta as BetaInputJSONDelta,
     type BetaInputTokensClearAtLeast as BetaInputTokensClearAtLeast,
     type BetaInputTokensTrigger as BetaInputTokensTrigger,
@@ -4453,6 +6989,7 @@ export declare namespace Messages {
     type BetaMessageTokensCount as BetaMessageTokensCount,
     type BetaMetadata as BetaMetadata,
     type BetaOutputConfig as BetaOutputConfig,
+    type BetaOutputTokensDetails as BetaOutputTokensDetails,
     type BetaPlainTextSource as BetaPlainTextSource,
     type BetaRawContentBlockDelta as BetaRawContentBlockDelta,
     type BetaRawContentBlockDeltaEvent as BetaRawContentBlockDeltaEvent,
@@ -4469,6 +7006,8 @@ export declare namespace Messages {
     type BetaRequestMCPServerToolConfiguration as BetaRequestMCPServerToolConfiguration,
     type BetaRequestMCPServerURLDefinition as BetaRequestMCPServerURLDefinition,
     type BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
+    type BetaRequestToolAdditionBlock as BetaRequestToolAdditionBlock,
+    type BetaRequestToolRemovalBlock as BetaRequestToolRemovalBlock,
     type BetaSearchResultBlockParam as BetaSearchResultBlockParam,
     type BetaServerToolCaller as BetaServerToolCaller,
     type BetaServerToolCaller20260120 as BetaServerToolCaller20260120,
@@ -4506,6 +7045,9 @@ export declare namespace Messages {
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
     type BetaToolBash20250124 as BetaToolBash20250124,
+    type BetaToolChangeMCPToolReference as BetaToolChangeMCPToolReference,
+    type BetaToolChangeMCPToolsetReference as BetaToolChangeMCPToolsetReference,
+    type BetaToolChangeToolReference as BetaToolChangeToolReference,
     type BetaToolChoice as BetaToolChoice,
     type BetaToolChoiceAny as BetaToolChoiceAny,
     type BetaToolChoiceAuto as BetaToolChoiceAuto,
@@ -4544,6 +7086,7 @@ export declare namespace Messages {
     type BetaWebFetchTool20250910 as BetaWebFetchTool20250910,
     type BetaWebFetchTool20260209 as BetaWebFetchTool20260209,
     type BetaWebFetchTool20260309 as BetaWebFetchTool20260309,
+    type BetaWebFetchTool20260318 as BetaWebFetchTool20260318,
     type BetaWebFetchToolResultBlock as BetaWebFetchToolResultBlock,
     type BetaWebFetchToolResultBlockParam as BetaWebFetchToolResultBlockParam,
     type BetaWebFetchToolResultErrorBlock as BetaWebFetchToolResultErrorBlock,
@@ -4553,6 +7096,7 @@ export declare namespace Messages {
     type BetaWebSearchResultBlockParam as BetaWebSearchResultBlockParam,
     type BetaWebSearchTool20250305 as BetaWebSearchTool20250305,
     type BetaWebSearchTool20260209 as BetaWebSearchTool20260209,
+    type BetaWebSearchTool20260318 as BetaWebSearchTool20260318,
     type BetaWebSearchToolRequestError as BetaWebSearchToolRequestError,
     type BetaWebSearchToolResultBlock as BetaWebSearchToolResultBlock,
     type BetaWebSearchToolResultBlockContent as BetaWebSearchToolResultBlockContent,