anthropic 1.72.0 → 1.74.0

data/lib/anthropic/models/beta/beta_managed_agents_web_search_tool_config_params.rb

@@ -36,7 +36,8 @@ module Anthropic
         optional :enabled, Anthropic::Internal::Type::Boolean, nil?: true
 
         # @!attribute permission_policy
-        #   Permission policy for tool execution.
+        #   Permission policy for this tool. Controls whether tool calls are auto-approved
+        #   or require confirmation.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil]
         optional :permission_policy,
@@ -67,7 +68,7 @@ module Anthropic
         #
         #   @param enabled [Boolean, nil] Whether this tool is enabled and available to Claude. Overrides the default_conf
         #
-        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for tool execution.
+        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for this tool. Controls whether tool calls are auto-approved o
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsWebSearchToolConfigParams::Type]
         #
@@ -75,7 +76,8 @@ module Anthropic
         #
         #   @param name [Symbol, :web_search] Must be "web_search".
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsWebSearchToolConfigParams#permission_policy
         module PermissionPolicy

data/lib/anthropic/models/beta/beta_managed_agents_write_tool_config_params.rb

@@ -18,7 +18,8 @@ module Anthropic
         optional :enabled, Anthropic::Internal::Type::Boolean, nil?: true
 
         # @!attribute permission_policy
-        #   Permission policy for tool execution.
+        #   Permission policy for this tool. Controls whether tool calls are auto-approved
+        #   or require confirmation.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil]
         optional :permission_policy,
@@ -39,13 +40,14 @@ module Anthropic
         #
         #   @param enabled [Boolean, nil] Whether this tool is enabled and available to Claude. Overrides the default_conf
         #
-        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for tool execution.
+        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for this tool. Controls whether tool calls are auto-approved o
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsWriteToolConfigParams::Type]
         #
         #   @param name [Symbol, :write] Must be "write".
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsWriteToolConfigParams#permission_policy
         module PermissionPolicy

data/lib/anthropic/models/beta/beta_mcp_tool.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMCPTool < Anthropic::Internal::Type::BaseModel
+        # @!attribute input_schema
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :input_schema, Anthropic::Internal::Type::HashOf[Anthropic::Internal::Type::Unknown]
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!method initialize(input_schema:, name:, description: nil)
+        #   A tool as an MCP server lists it: its name on that server, its description, and
+        #   its input schema.
+        #
+        #   @param input_schema [Hash{Symbol=>Object}]
+        #   @param name [String]
+        #   @param description [String]
+      end
+    end
+
+    BetaMCPTool = Beta::BetaMCPTool
+  end
+end

data/lib/anthropic/models/beta/beta_mcp_tool_listing_block.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMCPToolListingBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute mcp_server_name
+        #
+        #   @return [String]
+        required :mcp_server_name, String
+
+        # @!attribute tools
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaMCPTool>]
+        required :tools, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaMCPTool] }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mcp_tool_listing]
+        required :type, const: :mcp_tool_listing
+
+        # @!method initialize(mcp_server_name:, tools:, type: :mcp_tool_listing)
+        #   The tool listing the server fetched from an MCP server while producing this
+        #   response. Send the assistant message back unchanged, this block included, so
+        #   later requests use this listing instead of asking the MCP server again.
+        #
+        #   @param mcp_server_name [String]
+        #   @param tools [Array<Anthropic::Models::Beta::BetaMCPTool>]
+        #   @param type [Symbol, :mcp_tool_listing]
+      end
+    end
+
+    BetaMCPToolListingBlock = Beta::BetaMCPToolListingBlock
+  end
+end

data/lib/anthropic/models/beta/beta_mcp_tool_listing_block_param.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMCPToolListingBlockParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute mcp_server_name
+        #   The name of the MCP server this listing came from, as `mcp_servers` declares it.
+        #
+        #   @return [String]
+        required :mcp_server_name, String
+
+        # @!attribute tools
+        #   The server's tools, exactly as the response listed them.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaMCPToolParam>]
+        required :tools, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaMCPToolParam] }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mcp_tool_listing]
+        required :type, const: :mcp_tool_listing
+
+        # @!method initialize(mcp_server_name:, tools:, type: :mcp_tool_listing)
+        #   The tool listing an MCP server returned while an earlier response was produced,
+        #   as that response carried it. Send the assistant message back unchanged, this
+        #   block included, and the server uses this listing for the matching `mcp_toolset`
+        #   instead of asking the MCP server again.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaMCPToolListingBlockParam} for more details.
+        #
+        #   @param mcp_server_name [String] The name of the MCP server this listing came from, as `mcp_servers` declares it.
+        #
+        #   @param tools [Array<Anthropic::Models::Beta::BetaMCPToolParam>] The server's tools, exactly as the response listed them.
+        #
+        #   @param type [Symbol, :mcp_tool_listing]
+      end
+    end
+
+    BetaMCPToolListingBlockParam = Beta::BetaMCPToolListingBlockParam
+  end
+end

data/lib/anthropic/models/beta/beta_mcp_tool_param.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMCPToolParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute input_schema
+        #   The tool's input schema as the MCP server lists it, verbatim.
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :input_schema, Anthropic::Internal::Type::HashOf[Anthropic::Internal::Type::Unknown]
+
+        # @!attribute name
+        #   The tool's name as the MCP server lists it (not prefixed with the server name).
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute description
+        #   The tool's description as the MCP server lists it.
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!method initialize(input_schema:, name:, description: nil)
+        #   A tool as an MCP server lists it: its name on that server, its description, and
+        #   its input schema.
+        #
+        #   @param input_schema [Hash{Symbol=>Object}] The tool's input schema as the MCP server lists it, verbatim.
+        #
+        #   @param name [String] The tool's name as the MCP server lists it (not prefixed with the server name).
+        #
+        #   @param description [String, nil] The tool's description as the MCP server lists it.
+      end
+    end
+
+    BetaMCPToolParam = Beta::BetaMCPToolParam
+  end
+end

data/lib/anthropic/models/beta/beta_mcp_toolset.rb

@@ -35,12 +35,28 @@ module Anthropic
         #   @return [Anthropic::Models::Beta::BetaMCPToolDefaultConfig, nil]
         optional :default_config, -> { Anthropic::Beta::BetaMCPToolDefaultConfig }
 
-        # @!method initialize(mcp_server_name:, cache_control: nil, configs: nil, default_config: nil, type: :mcp_toolset)
+        # @!attribute tools
+        #   The server's tool listing, pinned: when present, the server is not asked for its
+        #   tools before sampling and exactly these entries, with `default_config` and
+        #   `configs` applied, are the toolset's tools. Copy it from the `mcp_tool_listing`
+        #   block of an earlier response.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaMCPToolParam>, nil]
+        optional :tools,
+                 -> {
+                   Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaMCPToolParam]
+                 },
+                 nil?: true
+
+        # @!method initialize(mcp_server_name:, cache_control: nil, configs: nil, default_config: nil, tools: nil, type: :mcp_toolset)
         #   Configuration for a group of tools from an MCP server.
         #
         #   Allows configuring enabled status and defer_loading for all tools from an MCP
         #   server, with optional per-tool overrides.
         #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaMCPToolset} for more details.
+        #
         #   @param mcp_server_name [String] Name of the MCP server to configure tools for
         #
         #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
@@ -49,6 +65,8 @@ module Anthropic
         #
         #   @param default_config [Anthropic::Models::Beta::BetaMCPToolDefaultConfig] Default configuration applied to all tools from this server
         #
+        #   @param tools [Array<Anthropic::Models::Beta::BetaMCPToolParam>, nil] The server's tool listing, pinned: when present, the server is not asked for its
+        #
         #   @param type [Symbol, :mcp_toolset]
       end
     end

data/lib/anthropic/models/beta/beta_message.rb

@@ -16,8 +16,9 @@ module Anthropic
         required :id, String
 
         # @!attribute container
-        #   Information about the container used in the request (for the code execution
-        #   tool)
+        #   Information about the container used in this request.
+        #
+        #   This will be non-null if a container tool (e.g. code execution) was used.
         #
         #   @return [Anthropic::Models::Beta::BetaContainer, nil]
         required :container, -> { Anthropic::Beta::BetaContainer }, nil?: true
@@ -56,7 +57,7 @@ module Anthropic
         #   [{ "type": "text", "text": "B)" }]
         #   ```
         #
-        #   @return [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock>]
+        #   @return [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock, Anthropic::Models::Beta::BetaMCPToolListingBlock>]
         required :content, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaContentBlock] }
 
         # parsed value of response when a JSON output schema object has been specified via :output_format
@@ -80,8 +81,8 @@ module Anthropic
         required :context_management, -> { Anthropic::Beta::BetaContextManagementResponse }, nil?: true
 
         # @!attribute diagnostics
-        #   Response envelope for request-level diagnostics. Present (possibly null)
-        #   whenever the caller supplied `diagnostics` on the request.
+        #   Request-level diagnostics. `null` when the request did not supply `diagnostics`,
+        #   or when it did and no prompt-cache divergence was detected.
         #
         #   @return [Anthropic::Models::Beta::BetaDiagnostics, nil]
         required :diagnostics, -> { Anthropic::Beta::BetaDiagnostics }, nil?: true
@@ -104,7 +105,9 @@ module Anthropic
         required :role, const: :assistant
 
         # @!attribute stop_details
-        #   Structured information about a refusal.
+        #   Structured information about why model output stopped.
+        #
+        #   This is `null` when the `stop_reason` has no additional detail to report.
         #
         #   @return [Anthropic::Models::Beta::BetaRefusalStopDetails, nil]
         required :stop_details, -> { Anthropic::Beta::BetaRefusalStopDetails }, nil?: true
@@ -200,17 +203,17 @@ module Anthropic
         #
         #   @param id [String] Unique object identifier.
         #
-        #   @param container [Anthropic::Models::Beta::BetaContainer, nil] Information about the container used in the request (for the code execution tool
+        #   @param container [Anthropic::Models::Beta::BetaContainer, nil] Information about the container used in this request.
         #
-        #   @param content [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock>] Content generated by the model.
+        #   @param content [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock, Anthropic::Models::Beta::BetaMCPToolListingBlock>] Content generated by the model.
         #
         #   @param context_management [Anthropic::Models::Beta::BetaContextManagementResponse, nil] Context management response.
         #
-        #   @param diagnostics [Anthropic::Models::Beta::BetaDiagnostics, nil] Response envelope for request-level diagnostics. Present (possibly
+        #   @param diagnostics [Anthropic::Models::Beta::BetaDiagnostics, nil] Request-level diagnostics. `null` when the request did not supply `diagnostics`,
         #
         #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
         #
-        #   @param stop_details [Anthropic::Models::Beta::BetaRefusalStopDetails, nil] Structured information about a refusal.
+        #   @param stop_details [Anthropic::Models::Beta::BetaRefusalStopDetails, nil] Structured information about why model output stopped.
         #
         #   @param stop_reason [Symbol, Anthropic::Models::Beta::BetaStopReason, nil] The reason that we stopped.
         #

data/lib/anthropic/models/beta/beta_message_delta_usage.rb

@@ -19,6 +19,10 @@ module Anthropic
         # @!attribute fallback_credit
         #   Outcome of the `fallback_credit_token` presented on this request.
         #
+        #   Present on every response to a non-batch request that carried a
+        #   `fallback_credit_token`, in either redemption mode; absent otherwise (batch
+        #   items accept and ignore the token and carry no outcome object).
+        #
         #   @return [Anthropic::Models::Beta::BetaFallbackCreditUsage, nil]
         required :fallback_credit, -> { Anthropic::Beta::BetaFallbackCreditUsage }, nil?: true
 

data/lib/anthropic/models/beta/beta_message_param.rb

@@ -6,7 +6,7 @@ module Anthropic
       class BetaMessageParam < Anthropic::Internal::Type::BaseModel
         # @!attribute content
         #
-        #   @return [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, Anthropic::Models::Beta::BetaFallbackBlockParam>]
+        #   @return [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, Anthropic::Models::Beta::BetaMCPToolListingBlockParam, Anthropic::Models::Beta::BetaFallbackBlockParam>]
         required :content, union: -> { Anthropic::Beta::BetaMessageParam::Content }
 
         # @!attribute role
@@ -39,7 +39,7 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaMessageParam} for more details.
         #
-        #   @param content [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, Anthropic::Models::Beta::BetaFallbackBlockParam>]
+        #   @param content [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, Anthropic::Models::Beta::BetaMCPToolListingBlockParam, Anthropic::Models::Beta::BetaFallbackBlockParam>]
         #
         #   @param role [Symbol, Anthropic::Models::Beta::BetaMessageParam::Role]
         #
@@ -56,7 +56,7 @@ module Anthropic
           variant -> { Anthropic::Models::Beta::BetaMessageParam::Content::BetaContentBlockParamArray }
 
           # @!method self.variants
-          #   @return [Array(String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, Anthropic::Models::Beta::BetaFallbackBlockParam>)]
+          #   @return [Array(String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, Anthropic::Models::Beta::BetaMCPToolListingBlockParam, Anthropic::Models::Beta::BetaFallbackBlockParam>)]
 
           # @type [Anthropic::Internal::Type::Converter]
           BetaContentBlockParamArray =

data/lib/anthropic/models/beta/beta_model_capabilities.rb

@@ -23,9 +23,8 @@ module Anthropic
         required :code_execution, -> { Anthropic::Beta::BetaCapabilitySupport }
 
         # @!attribute compaction
-        #   Compaction capability details: whether the model accepts the top-level
-        #   `compaction` request parameter, with one entry per supported `compaction.type`
-        #   value.
+        #   Server-side compaction support (the top-level `compaction` parameter) and the
+        #   accepted `compaction.type` values.
         #
         #   @return [Anthropic::Models::Beta::BetaCompactionCapability, nil]
         required :compaction, -> { Anthropic::Beta::BetaCompactionCapability }, nil?: true
@@ -78,7 +77,7 @@ module Anthropic
         #
         #   @param code_execution [Anthropic::Models::Beta::BetaCapabilitySupport] Whether the model supports code execution tools.
         #
-        #   @param compaction [Anthropic::Models::Beta::BetaCompactionCapability, nil] Compaction capability details: whether the model accepts the top-level
+        #   @param compaction [Anthropic::Models::Beta::BetaCompactionCapability, nil] Server-side compaction support (the top-level `compaction` parameter) and the ac
         #
         #   @param context_management [Anthropic::Models::Beta::BetaContextManagementCapability] Context management support and available strategies.
         #

data/lib/anthropic/models/beta/beta_model_info.rb

@@ -20,7 +20,8 @@ module Anthropic
         required :allowed_fallback_models, Anthropic::Internal::Type::ArrayOf[String], nil?: true
 
         # @!attribute capabilities
-        #   Model capability information.
+        #   Object mapping capability names to their support details. Keys are always
+        #   present for all known capabilities.
         #
         #   @return [Anthropic::Models::Beta::BetaModelCapabilities, nil]
         required :capabilities, -> { Anthropic::Beta::BetaModelCapabilities }, nil?: true
@@ -66,7 +67,7 @@ module Anthropic
         #
         #   @param allowed_fallback_models [Array<String>, nil] Model IDs this model accepts as `fallbacks[i].model` on the Messages API. An emp
         #
-        #   @param capabilities [Anthropic::Models::Beta::BetaModelCapabilities, nil] Model capability information.
+        #   @param capabilities [Anthropic::Models::Beta::BetaModelCapabilities, nil] Object mapping capability names to their support details. Keys are always presen
         #
         #   @param created_at [Time] RFC 3339 datetime string representing the time at which the model was released.
         #

data/lib/anthropic/models/beta/beta_output_behavior.rb

@@ -3,15 +3,21 @@
 module Anthropic
   module Models
     module Beta
+      # Which memory store a dream writes its result to. Defaults to `create_new` when
+      # left out of a create request.
       module BetaOutputBehavior
         extend Anthropic::Internal::Type::Union
 
         discriminator :type
 
-        # The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.
+        # Write the result to a new memory store that starts as a copy of the input memory store. This is the default.
+        #
+        # The new memory store is in the same workspace as the dream. The dream doesn't change the input memory store.
         variant :create_new, -> { Anthropic::Beta::BetaOutputBehaviorCreateNew }
 
-        # The job writes the consolidated memories into this existing memory store instead of creating one. In EAP the store must be the job's own memory_store input, so the job consolidates the store in place.
+        # Write the result into the input memory store instead of a new memory store.
+        #
+        # The credential must be allowed to write memory stores, or the request returns a 403 error. While another `update_existing` dream on the same memory store hasn't fully stopped, the request returns a 409 error.
         variant :update_existing, -> { Anthropic::Beta::BetaOutputBehaviorUpdateExisting }
 
         module Type
@@ -30,11 +36,14 @@ module Anthropic
         # Creates a new instance of the variant class whose `type` matches the given
         # value, passing the remaining arguments to its constructor.
         #
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::BetaOutputBehavior} for more details.
+        #
         # @param type [Symbol, Anthropic::Models::Beta::BetaOutputBehavior::Type, String]
         #
         # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
         #
-        #   @option args [String] :memory_store_id
+        #   @option args [String] :memory_store_id The ID of the memory store for the dream to write its result to (`memstore_...`)
         #
         # @raise [ArgumentError]
         # @return [Anthropic::Models::Beta::BetaOutputBehaviorCreateNew, Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting]

data/lib/anthropic/models/beta/beta_output_behavior_create_new.rb

@@ -10,9 +10,11 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaOutputBehaviorCreateNew::Type }
 
         # @!method initialize(type:)
-        #   The default destination: the job creates a new output memory store as a clone of
-        #   the memory_store input and writes the consolidated memories into it. The input
-        #   store is never mutated.
+        #   Write the result to a new memory store that starts as a copy of the input memory
+        #   store. This is the default.
+        #
+        #   The new memory store is in the same workspace as the dream. The dream doesn't
+        #   change the input memory store.
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaOutputBehaviorCreateNew::Type]
 

data/lib/anthropic/models/beta/beta_output_behavior_update_existing.rb

@@ -5,6 +5,9 @@ module Anthropic
     module Beta
       class BetaOutputBehaviorUpdateExisting < Anthropic::Internal::Type::BaseModel
         # @!attribute memory_store_id
+        #   The ID of the memory store for the dream to write its result to
+        #   (`memstore_...`). It must be the memory store in the `memory_store` entry of
+        #   `inputs`.
         #
         #   @return [String]
         required :memory_store_id, String
@@ -15,11 +18,17 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaOutputBehaviorUpdateExisting::Type }
 
         # @!method initialize(memory_store_id:, type:)
-        #   The job writes the consolidated memories into this existing memory store instead
-        #   of creating one. In EAP the store must be the job's own memory_store input, so
-        #   the job consolidates the store in place.
+        #   Write the result into the input memory store instead of a new memory store.
+        #
+        #   The credential must be allowed to write memory stores, or the request returns a
+        #   403 error. While another `update_existing` dream on the same memory store hasn't
+        #   fully stopped, the request returns a 409 error.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting} for more details.
+        #
+        #   @param memory_store_id [String] The ID of the memory store for the dream to write its result to (`memstore_...`)
         #
-        #   @param memory_store_id [String]
         #   @param type [Symbol, Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting::Type]
 
         # @see Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting#type

data/lib/anthropic/models/beta/beta_output_config.rb

@@ -5,7 +5,10 @@ module Anthropic
     module Beta
       class BetaOutputConfig < Anthropic::Internal::Type::BaseModel
         # @!attribute effort
-        #   All possible effort levels.
+        #   How much effort the model should put into its response. Higher effort levels may
+        #   result in more thorough analysis but take longer.
+        #
+        #   Valid values are `low`, `medium`, `high`, `xhigh`, or `max`.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaOutputConfig::Effort, nil]
         optional :effort, enum: -> { Anthropic::Beta::BetaOutputConfig::Effort }, nil?: true
@@ -18,7 +21,7 @@ module Anthropic
         optional :format_, -> { Anthropic::Beta::BetaJSONOutputFormat }, api_name: :format, nil?: true
 
         # @!attribute task_budget
-        #   User-configurable total token budget across contexts.
+        #   Configuration for token budget tracking across contexts.
         #
         #   @return [Anthropic::Models::Beta::BetaTokenTaskBudget, nil]
         optional :task_budget, -> { Anthropic::Beta::BetaTokenTaskBudget }, nil?: true
@@ -27,13 +30,16 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaOutputConfig} for more details.
         #
-        #   @param effort [Symbol, Anthropic::Models::Beta::BetaOutputConfig::Effort, nil] All possible effort levels.
+        #   @param effort [Symbol, Anthropic::Models::Beta::BetaOutputConfig::Effort, nil] How much effort the model should put into its response. Higher effort levels may
         #
         #   @param format_ [Anthropic::Models::Beta::BetaJSONOutputFormat, nil] A schema to specify Claude's output format in responses. See [structured outputs
         #
-        #   @param task_budget [Anthropic::Models::Beta::BetaTokenTaskBudget, nil] User-configurable total token budget across contexts.
+        #   @param task_budget [Anthropic::Models::Beta::BetaTokenTaskBudget, nil] Configuration for token budget tracking across contexts.
 
-        # All possible effort levels.
+        # How much effort the model should put into its response. Higher effort levels may
+        # result in more thorough analysis but take longer.
+        #
+        # Valid values are `low`, `medium`, `high`, `xhigh`, or `max`.
         #
         # @see Anthropic::Models::Beta::BetaOutputConfig#effort
         module Effort

data/lib/anthropic/models/beta/beta_raw_content_block_start_event.rb

@@ -6,7 +6,7 @@ module Anthropic
       class BetaRawContentBlockStartEvent < Anthropic::Internal::Type::BaseModel
         # @!attribute content_block
         #
-        #   @return [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock]
+        #   @return [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock, Anthropic::Models::Beta::BetaMCPToolListingBlock]
         required :content_block, union: -> { Anthropic::Beta::BetaRawContentBlockStartEvent::ContentBlock }
 
         # @!attribute index
@@ -20,7 +20,7 @@ module Anthropic
         required :type, const: :content_block_start
 
         # @!method initialize(content_block:, index:, type: :content_block_start)
-        #   @param content_block [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock]
+        #   @param content_block [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock, Anthropic::Models::Beta::BetaMCPToolListingBlock]
         #   @param index [Integer]
         #   @param type [Symbol, :content_block_start]
 
@@ -82,6 +82,12 @@ module Anthropic
           # pair and carries no deltas.
           variant :fallback, -> { Anthropic::Beta::BetaFallbackBlock }
 
+          # The tool listing the server fetched from an MCP server while producing
+          # this response. Send the assistant message back unchanged, this block
+          # included, so later requests use this listing instead of asking the MCP
+          # server again.
+          variant :mcp_tool_listing, -> { Anthropic::Beta::BetaMCPToolListingBlock }
+
           module Type
             extend Anthropic::Internal::Type::Enum
 
@@ -102,13 +108,14 @@ module Anthropic
             CONTAINER_UPLOAD = :container_upload
             COMPACTION = :compaction
             FALLBACK = :fallback
+            MCP_TOOL_LISTING = :mcp_tool_listing
 
             # @!method self.values
             #   @return [Array<Symbol>]
           end
 
           # @!method self.variants
-          #   @return [Array(Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock)]
+          #   @return [Array(Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock, Anthropic::Models::Beta::BetaMCPToolListingBlock)]
 
           # Creates a new instance of the variant class whose `type` matches the given
           # value, passing the remaining arguments to its constructor.
@@ -153,14 +160,20 @@ module Anthropic
           #
           #   @option args [String, nil] :encrypted_content Opaque metadata from prior compaction, to be round-tripped verbatim
           #
+          #   @option args [Array<Anthropic::Models::Beta::BetaResponseToolAdditionBlock, Anthropic::Models::Beta::BetaResponseToolRemovalBlock>, nil] :tool_changes The tool changes of the compacted range: the `tool_addition` and `tool_removal`
+          #
           #   @option args [Anthropic::Models::Beta::BetaFallbackInfo] :from The model whose output ends at this point — the model that declined at this hop.
           #
           #   @option args [Anthropic::Models::Beta::BetaFallbackInfo] :to The fallback model producing the content that follows this block. Its `model` is
           #
           #   @option args [Anthropic::Models::Beta::BetaFallbackRefusalTrigger] :trigger What caused the `from` model to hand over at this hop.
           #
+          #   @option args [String] :mcp_server_name
+          #
+          #   @option args [Array<Anthropic::Models::Beta::BetaMCPTool>] :tools
+          #
           # @raise [ArgumentError]
-          # @return [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock]
+          # @return [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock, Anthropic::Models::Beta::BetaMCPToolListingBlock]
           def self.new(type:, **args)
             case type.to_sym
             when :text
@@ -197,6 +210,8 @@ module Anthropic
               Anthropic::Beta::BetaCompactionBlock.new(**args)
             when :fallback
               Anthropic::Beta::BetaFallbackBlock.new(**args)
+            when :mcp_tool_listing
+              Anthropic::Beta::BetaMCPToolListingBlock.new(**args)
             else
               raise ArgumentError, "unknown type: #{type}"
             end