@anthropic-ai/sdk 0.113.0 → 0.115.0

package/src/lib/tools/BetaToolRunner.ts

@@ -2,7 +2,18 @@ import { BetaRunnableTool } from './BetaRunnableTool';
 import { ToolError } from './ToolError';
 import { Anthropic } from '../..';
 import { AnthropicError } from '../../core/error';
-import { BetaMessage, BetaMessageParam, BetaToolUnion, MessageCreateParams } from '../../resources/beta';
+import {
+  BetaContentBlockParam,
+  BetaMessage,
+  BetaMessageParam,
+  BetaRequestToolAdditionBlock,
+  BetaRequestToolRemovalBlock,
+  BetaToolChangeMCPToolReference,
+  BetaToolChangeMCPToolsetReference,
+  BetaToolChangeToolReference,
+  BetaToolUnion,
+  MessageCreateParams,
+} from '../../resources/beta';
 import { BetaMessageStream } from '../BetaMessageStream';
 import { RequestOptions } from '../../internal/request-options';
 import { buildHeaders } from '../../internal/headers';
@@ -467,16 +478,14 @@ async function generateToolResponse(
     return null;
   }
 
+  const available = availableToolNames(params);
   const toolResults = await Promise.all(
     toolUseBlocks.map(async (toolUse) => {
       const tool = params.tools.find((t) => ('name' in t ? t.name : t.mcp_server_name) === toolUse.name);
-      if (!tool || !('run' in tool)) {
-        return {
-          type: 'tool_result' as const,
-          tool_use_id: toolUse.id,
-          content: `Error: Tool '${toolUse.name}' not found`,
-          is_error: true,
-        };
+      // A `tool_removal` is only a hint to the model, which may still emit a tool_use for a
+      // withdrawn tool — treat those exactly like a tool that was never defined.
+      if (!tool || !('run' in tool) || !available.has(toolUse.name)) {
+        return toolNotFoundResult(toolUse);
       }
 
       try {
@@ -515,6 +524,90 @@ async function generateToolResponse(
   };
 }
 
+function toolNotFoundResult(toolUse: { id: string; name: string }) {
+  return {
+    type: 'tool_result' as const,
+    tool_use_id: toolUse.id,
+    content: `Error: Tool '${toolUse.name}' not found`,
+    is_error: true,
+  };
+}
+
+/**
+ * Computes the names of locally runnable tools that are still available for the assistant
+ * turn being answered, by folding `tool_removal` / `tool_addition` blocks from the
+ * `role: "system"` messages over the runnable tools. The assistant turn being answered is
+ * terminal-or-absent and only `system` messages are inspected, so folding the whole current
+ * history is exactly folding the messages preceding that turn — call this before appending
+ * anything after it. MCP references are ignored — those tools are executed server-side and
+ * never dispatched by this runner.
+ */
+function availableToolNames(params: BetaToolRunnerParams): Set<string> {
+  const available = new Set<string>();
+  for (const tool of params.tools) {
+    if ('run' in tool) {
+      available.add(tool.name);
+    }
+  }
+
+  for (const message of params.messages) {
+    if (message.role !== 'system' || typeof message.content === 'string') {
+      continue;
+    }
+    for (const block of message.content) {
+      applyToolChange(block, available);
+    }
+  }
+  return available;
+}
+
+function applyToolChange(block: BetaContentBlockParam, available: Set<string>): void {
+  switch (block.type) {
+    case 'tool_removal':
+    case 'tool_addition':
+      applyToolReference(block, available);
+      break;
+    case 'mid_conv_system':
+      // A `mid_conv_system` block's content is limited by the API schema to
+      // text / tool_addition / tool_removal, so we walk exactly one level — no recursion.
+      for (const inner of block.content) {
+        if (inner.type === 'tool_removal' || inner.type === 'tool_addition') {
+          applyToolReference(inner, available);
+        }
+      }
+      break;
+    default:
+      // Other and unknown/newer block types leave the set untouched (forward compatibility).
+      break;
+  }
+}
+
+function applyToolReference(
+  block: BetaRequestToolAdditionBlock | BetaRequestToolRemovalBlock,
+  available: Set<string>,
+): void {
+  const name = referencedToolName(block.tool);
+  if (name === undefined) return;
+  if (block.type === 'tool_removal') {
+    available.delete(name);
+  } else {
+    available.add(name);
+  }
+}
+
+function referencedToolName(
+  ref: BetaToolChangeToolReference | BetaToolChangeMCPToolReference | BetaToolChangeMCPToolsetReference,
+): string | undefined {
+  switch (ref.type) {
+    case 'tool_reference':
+      return ref.name;
+    default:
+      // mcp_tool_reference / mcp_toolset_reference run server-side; unknown reference
+      // types are ignored rather than rejected.
+      return undefined;
+  }
+}
+
 // vendored from typefest just to make things look a bit nicer on hover
 type Simplify<T> = { [KeyType in keyof T]: T[KeyType] } & {};
 

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

@@ -707,6 +707,7 @@ export interface BetaManagedAgentsMCPToolsetParams {
 export type BetaManagedAgentsModel =
   | 'claude-sonnet-5'
   | 'claude-fable-5'
+  | 'claude-opus-5'
   | 'claude-opus-4-8'
   | 'claude-opus-4-7'
   | 'claude-opus-4-6'

package/src/resources/beta/beta.ts

@@ -363,11 +363,16 @@ import {
   BetaEncryptedCodeExecutionResultBlockParam,
   BetaFallbackBlock,
   BetaFallbackBlockParam,
+  BetaFallbackCreditNotApplied,
+  BetaFallbackCreditRedeemed,
+  BetaFallbackCreditTokenParam,
+  BetaFallbackCreditUsage,
   BetaFallbackInfo,
   BetaFallbackInfoParam,
   BetaFallbackMessageIterationUsage,
   BetaFallbackParam,
   BetaFallbackRefusalTrigger,
+  BetaFallbacksParam,
   BetaFileDocumentSource,
   BetaFileImageSource,
   BetaImageBlockParam,
@@ -412,6 +417,8 @@ import {
   BetaRequestMCPServerToolConfiguration,
   BetaRequestMCPServerURLDefinition,
   BetaRequestMCPToolResultBlockParam,
+  BetaRequestToolAdditionBlock,
+  BetaRequestToolRemovalBlock,
   BetaSearchResultBlockParam,
   BetaServerToolCaller,
   BetaServerToolCaller20260120,
@@ -449,6 +456,9 @@ import {
   BetaTool,
   BetaToolBash20241022,
   BetaToolBash20250124,
+  BetaToolChangeMCPToolReference,
+  BetaToolChangeMCPToolsetReference,
+  BetaToolChangeToolReference,
   BetaToolChoice,
   BetaToolChoiceAny,
   BetaToolChoiceAuto,
@@ -633,7 +643,9 @@ export type AnthropicBeta =
   | 'dreaming-2026-04-21'
   | 'thinking-token-count-2026-05-13'
   | 'server-side-fallback-2026-06-01'
+  | 'server-side-fallback-2026-07-01'
   | 'fallback-credit-2026-06-01'
+  | 'fallback-credit-2026-07-01'
   | 'agent-memory-2026-07-22';
 
 export interface BetaAPIError {
@@ -842,11 +854,16 @@ export declare namespace Beta {
     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,
@@ -893,6 +910,8 @@ export declare namespace Beta {
     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,
@@ -930,6 +949,9 @@ export declare namespace Beta {
     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,

package/src/resources/beta/index.ts

@@ -292,11 +292,16 @@ export {
   type BetaEncryptedCodeExecutionResultBlockParam,
   type BetaFallbackBlock,
   type BetaFallbackBlockParam,
+  type BetaFallbackCreditNotApplied,
+  type BetaFallbackCreditRedeemed,
+  type BetaFallbackCreditTokenParam,
+  type BetaFallbackCreditUsage,
   type BetaFallbackInfo,
   type BetaFallbackInfoParam,
   type BetaFallbackMessageIterationUsage,
   type BetaFallbackParam,
   type BetaFallbackRefusalTrigger,
+  type BetaFallbacksParam,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,
@@ -344,6 +349,8 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaRequestToolAdditionBlock,
+  type BetaRequestToolRemovalBlock,
   type BetaSearchResultBlockParam,
   type BetaServerToolCaller,
   type BetaServerToolCaller20260120,
@@ -381,6 +388,9 @@ export {
   type BetaTool,
   type BetaToolBash20241022,
   type BetaToolBash20250124,
+  type BetaToolChangeMCPToolReference,
+  type BetaToolChangeMCPToolsetReference,
+  type BetaToolChangeToolReference,
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,

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

@@ -607,14 +607,15 @@ export namespace BatchCreateParams {
        * 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 | null;
+      fallback_credit_token?: string | BetaMessagesAPI.BetaFallbackCreditTokenParam | null;
 
       /**
        * 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.
+       * declines, the second is tried, and so on. The string "default" requests the
+       * requested model's server-defined default fallback configuration.
        */
-      fallbacks?: Array<BetaMessagesAPI.BetaFallbackParam> | null;
+      fallbacks?: BetaMessagesAPI.BetaFallbacksParam | null;
 
       /**
        * Specifies the geographic region for inference processing. If not specified, the

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

@@ -106,11 +106,16 @@ export {
   type BetaEncryptedCodeExecutionResultBlockParam,
   type BetaFallbackBlock,
   type BetaFallbackBlockParam,
+  type BetaFallbackCreditNotApplied,
+  type BetaFallbackCreditRedeemed,
+  type BetaFallbackCreditTokenParam,
+  type BetaFallbackCreditUsage,
   type BetaFallbackInfo,
   type BetaFallbackInfoParam,
   type BetaFallbackMessageIterationUsage,
   type BetaFallbackParam,
   type BetaFallbackRefusalTrigger,
+  type BetaFallbacksParam,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,
@@ -156,6 +161,8 @@ export {
   type BetaRequestMCPServerToolConfiguration,
   type BetaRequestMCPServerURLDefinition,
   type BetaRequestMCPToolResultBlockParam,
+  type BetaRequestToolAdditionBlock,
+  type BetaRequestToolRemovalBlock,
   type BetaSearchResultBlockParam,
   type BetaServerToolCaller,
   type BetaServerToolCaller20260120,
@@ -193,6 +200,9 @@ export {
   type BetaTool,
   type BetaToolBash20241022,
   type BetaToolBash20250124,
+  type BetaToolChangeMCPToolReference,
+  type BetaToolChangeMCPToolsetReference,
+  type BetaToolChangeToolReference,
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,

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

@@ -1441,6 +1441,8 @@ export type BetaContentBlockParam =
   | BetaContainerUploadBlockParam
   | BetaCompactionBlockParam
   | BetaMidConversationSystemBlockParam
+  | BetaRequestToolAdditionBlock
+  | BetaRequestToolRemovalBlock
   | BetaFallbackBlockParam;
 
 export interface BetaContentBlockSource {
@@ -1631,6 +1633,94 @@ export interface BetaFallbackBlockParam {
   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.
  */
@@ -1765,6 +1855,14 @@ export interface BetaFallbackRefusalTrigger {
   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;
 
@@ -2172,6 +2270,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.
@@ -2224,6 +2323,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.
    */
@@ -2346,7 +2450,7 @@ export interface BetaMidConversationSystemBlockParam {
   /**
    * System instruction text blocks.
    */
-  content: Array<BetaTextBlockParam>;
+  content: Array<BetaTextBlockParam | BetaRequestToolAdditionBlock | BetaRequestToolRemovalBlock>;
 
   type: 'mid_conv_system';
 
@@ -2668,6 +2772,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>;
 
@@ -3252,6 +3400,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.
@@ -3865,6 +4045,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.
    */
@@ -4694,14 +4879,15 @@ export interface MessageCreateParamsBase {
    * 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 | null;
+  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.
+   * also declines, the second is tried, and so on. The string "default" requests the
+   * requested model's server-defined default fallback configuration.
    */
-  fallbacks?: Array<BetaFallbackParam> | null;
+  fallbacks?: BetaFallbacksParam | null;
 
   /**
    * Body param: Specifies the geographic region for inference processing. If not
@@ -5306,11 +5492,16 @@ export declare namespace Messages {
     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,
@@ -5358,6 +5549,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,
@@ -5395,6 +5588,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,

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

@@ -1869,28 +1869,32 @@ export interface BetaManagedAgentsUserToolResultEventParams {
 
 export interface EventListParams extends PageCursorParams {
   /**
-   * Query param: Return events created after this time (exclusive).
+   * Query param: Return events created after this time (exclusive). Compared against
+   * the event's `processed_at` value.
    */
   'created_at[gt]'?: string;
 
   /**
-   * Query param: Return events created at or after this time (inclusive).
+   * Query param: Return events created at or after this time (inclusive). Compared
+   * against the event's `processed_at` value.
    */
   'created_at[gte]'?: string;
 
   /**
-   * Query param: Return events created before this time (exclusive).
+   * Query param: Return events created before this time (exclusive). Compared
+   * against the event's `processed_at` value.
    */
   'created_at[lt]'?: string;
 
   /**
-   * Query param: Return events created at or before this time (inclusive).
+   * Query param: Return events created at or before this time (inclusive). Compared
+   * against the event's `processed_at` value.
    */
   'created_at[lte]'?: string;
 
   /**
-   * Query param: Sort direction for results, ordered by created_at. Defaults to asc
-   * (chronological).
+   * Query param: Sort direction for results, ordered by the event's `processed_at`.
+   * Defaults to asc (chronological).
    */
   order?: 'asc' | 'desc';
 

package/src/resources/messages/messages.ts

@@ -1100,6 +1100,7 @@ export interface Message {
    *   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.
@@ -1259,6 +1260,7 @@ export type Model =
   | 'claude-sonnet-5'
   | 'claude-fable-5'
   | 'claude-mythos-5'
+  | 'claude-opus-5'
   | 'claude-opus-4-8'
   | 'claude-opus-4-7'
   | 'claude-mythos-preview'
@@ -1587,7 +1589,14 @@ export interface SignatureDelta {
   type: 'signature_delta';
 }
 
-export type StopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | 'pause_turn' | 'refusal';
+export type StopReason =
+  | 'end_turn'
+  | 'max_tokens'
+  | 'stop_sequence'
+  | 'tool_use'
+  | 'pause_turn'
+  | 'refusal'
+  | 'model_context_window_exceeded';
 
 export interface TextBlock {
   /**