anthropic 1.72.0 → 1.74.0

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

@@ -60,6 +60,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
 
@@ -80,13 +86,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.
@@ -130,14 +137,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
@@ -174,6 +187,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

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

@@ -67,20 +67,30 @@ module Anthropic
         # treats these as no-ops. Empty string content is not allowed.
         variant :compaction, -> { Anthropic::Beta::BetaCompactionBlockParam }
 
-        # 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.
+        # Mid-conversation directive to make a tool available.
+        #
+        # ``tool`` is a reference to a tool (or MCP toolset) declared in the
+        # request's ``tools``. Under the ``inline-tools-2026-09-15`` beta it may
+        # instead be a reference to a tool defined earlier in ``messages``, or a
+        # ``tool_definition`` object that carries an inline tool definition in
+        # ``definition`` (the same object a ``tools`` entry holds). An ``mcp_toolset``
+        # definition also requires the ``mcp-client-2026-09-15`` beta. The tool is
+        # offered to the model from this point in the conversation onward.
         variant :tool_addition, -> { Anthropic::Beta::BetaRequestToolAdditionBlock }
 
         # 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.
+        # ``tool`` references a tool (or MCP toolset) by name: one declared in the
+        # request's ``tools`` or defined earlier in ``messages``. It is no longer
+        # offered to the model from this point in the conversation onward.
         variant :tool_removal, -> { Anthropic::Beta::BetaRequestToolRemovalBlock }
 
+        # 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.
+        variant :mcp_tool_listing, -> { Anthropic::Beta::BetaMCPToolListingBlockParam }
+
         # A `fallback` block echoed back from a prior response.
         #
         # Accepted in `messages[].content` and not rendered into the prompt; not
@@ -121,6 +131,7 @@ module Anthropic
           COMPACTION = :compaction
           TOOL_ADDITION = :tool_addition
           TOOL_REMOVAL = :tool_removal
+          MCP_TOOL_LISTING = :mcp_tool_listing
           FALLBACK = :fallback
 
           # @!method self.values
@@ -128,7 +139,7 @@ module Anthropic
         end
 
         # @!method self.variants
-        #   @return [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(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)]
 
         # Creates a new instance of the variant class whose `type` matches the given
         # value, passing the remaining arguments to its constructor.
@@ -182,7 +193,13 @@ module Anthropic
         #
         #   @option args [String, nil] :encrypted_content Opaque metadata from prior compaction, to be round-tripped verbatim
         #
-        #   @option args [Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference] :tool
+        #   @option args [Array<Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock>, nil] :tool_changes The tool changes of the compacted range, as the server returned them on this blo
+        #
+        #   @option args [Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference, Anthropic::Models::Beta::BetaToolChangeToolDefinitionParam, Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference] :tool
+        #
+        #   @option args [String] :mcp_server_name The name of the MCP server this listing came from, as `mcp_servers` declares it.
+        #
+        #   @option args [Array<Anthropic::Models::Beta::BetaMCPToolParam>] :tools The server's tools, exactly as the response listed them.
         #
         #   @option args [Anthropic::Models::Beta::BetaFallbackInfoParam] :from Identifies one hop of a fallback transition.
         #
@@ -191,7 +208,7 @@ module Anthropic
         #   @option args [Object] :trigger The response block's `trigger`, echoed verbatim. Accepted and ignored by the ser
         #
         # @raise [ArgumentError]
-        # @return [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 [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]
         def self.new(type:, **args)
           case type.to_sym
           when :text
@@ -238,6 +255,8 @@ module Anthropic
             Anthropic::Beta::BetaRequestToolAdditionBlock.new(**args)
           when :tool_removal
             Anthropic::Beta::BetaRequestToolRemovalBlock.new(**args)
+          when :mcp_tool_listing
+            Anthropic::Beta::BetaMCPToolListingBlockParam.new(**args)
           when :fallback
             Anthropic::Beta::BetaFallbackBlockParam.new(**args)
           else

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

@@ -5,19 +5,19 @@ module Anthropic
     module Beta
       class BetaContextManagementCapability < Anthropic::Internal::Type::BaseModel
         # @!attribute clear_thinking_20251015
-        #   Indicates whether a capability is supported.
+        #   Whether the clear_thinking_20251015 strategy is supported.
         #
         #   @return [Anthropic::Models::Beta::BetaCapabilitySupport, nil]
         required :clear_thinking_20251015, -> { Anthropic::Beta::BetaCapabilitySupport }, nil?: true
 
         # @!attribute clear_tool_uses_20250919
-        #   Indicates whether a capability is supported.
+        #   Whether the clear_tool_uses_20250919 strategy is supported.
         #
         #   @return [Anthropic::Models::Beta::BetaCapabilitySupport, nil]
         required :clear_tool_uses_20250919, -> { Anthropic::Beta::BetaCapabilitySupport }, nil?: true
 
         # @!attribute compact_20260112
-        #   Indicates whether a capability is supported.
+        #   Whether the compact_20260112 strategy is supported.
         #
         #   @return [Anthropic::Models::Beta::BetaCapabilitySupport, nil]
         required :compact_20260112, -> { Anthropic::Beta::BetaCapabilitySupport }, nil?: true
@@ -31,11 +31,11 @@ module Anthropic
         # @!method initialize(clear_thinking_20251015:, clear_tool_uses_20250919:, compact_20260112:, supported:)
         #   Context management capability details.
         #
-        #   @param clear_thinking_20251015 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Indicates whether a capability is supported.
+        #   @param clear_thinking_20251015 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Whether the clear_thinking_20251015 strategy is supported.
         #
-        #   @param clear_tool_uses_20250919 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Indicates whether a capability is supported.
+        #   @param clear_tool_uses_20250919 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Whether the clear_tool_uses_20250919 strategy is supported.
         #
-        #   @param compact_20260112 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Indicates whether a capability is supported.
+        #   @param compact_20260112 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Whether the compact_20260112 strategy is supported.
         #
         #   @param supported [Boolean] Whether this capability is supported by the model.
       end

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

@@ -11,94 +11,16 @@ module Anthropic
         #   completed.
         #
         #   @return [Anthropic::Models::Beta::BetaCacheMissModelChanged, Anthropic::Models::Beta::BetaCacheMissSystemChanged, Anthropic::Models::Beta::BetaCacheMissToolsChanged, Anthropic::Models::Beta::BetaCacheMissMessagesChanged, Anthropic::Models::Beta::BetaCacheMissPreviousMessageNotFound, Anthropic::Models::Beta::BetaCacheMissUnavailable, nil]
-        required :cache_miss_reason,
-                 union: -> {
-                   Anthropic::Beta::BetaDiagnostics::CacheMissReason
-                 },
-                 nil?: true
+        required :cache_miss_reason, union: -> { Anthropic::Beta::BetaCacheMissReason }, nil?: true
 
         # @!method initialize(cache_miss_reason:)
-        #   Response envelope for request-level diagnostics. Present (possibly null)
-        #   whenever the caller supplied `diagnostics` on the request.
+        #   Request-level diagnostics: why the prompt cache could not fully reuse the prefix
+        #   of the request named by `diagnostics.previous_message_id`.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaDiagnostics} for more details.
         #
         #   @param cache_miss_reason [Anthropic::Models::Beta::BetaCacheMissModelChanged, Anthropic::Models::Beta::BetaCacheMissSystemChanged, Anthropic::Models::Beta::BetaCacheMissToolsChanged, Anthropic::Models::Beta::BetaCacheMissMessagesChanged, Anthropic::Models::Beta::BetaCacheMissPreviousMessageNotFound, Anthropic::Models::Beta::BetaCacheMissUnavailable, nil] Explains why the prompt cache could not fully reuse the prefix from the request
-
-        # 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.
-        #
-        # @see Anthropic::Models::Beta::BetaDiagnostics#cache_miss_reason
-        module CacheMissReason
-          extend Anthropic::Internal::Type::Union
-
-          discriminator :type
-
-          variant :model_changed, -> { Anthropic::Beta::BetaCacheMissModelChanged }
-
-          variant :system_changed, -> { Anthropic::Beta::BetaCacheMissSystemChanged }
-
-          variant :tools_changed, -> { Anthropic::Beta::BetaCacheMissToolsChanged }
-
-          variant :messages_changed, -> { Anthropic::Beta::BetaCacheMissMessagesChanged }
-
-          variant :previous_message_not_found, -> { Anthropic::Beta::BetaCacheMissPreviousMessageNotFound }
-
-          variant :unavailable, -> { Anthropic::Beta::BetaCacheMissUnavailable }
-
-          module Type
-            extend Anthropic::Internal::Type::Enum
-
-            MODEL_CHANGED = :model_changed
-            SYSTEM_CHANGED = :system_changed
-            TOOLS_CHANGED = :tools_changed
-            MESSAGES_CHANGED = :messages_changed
-            PREVIOUS_MESSAGE_NOT_FOUND = :previous_message_not_found
-            UNAVAILABLE = :unavailable
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-
-          # @!method self.variants
-          #   @return [Array(Anthropic::Models::Beta::BetaCacheMissModelChanged, Anthropic::Models::Beta::BetaCacheMissSystemChanged, Anthropic::Models::Beta::BetaCacheMissToolsChanged, Anthropic::Models::Beta::BetaCacheMissMessagesChanged, Anthropic::Models::Beta::BetaCacheMissPreviousMessageNotFound, Anthropic::Models::Beta::BetaCacheMissUnavailable)]
-
-          # 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::BetaDiagnostics::CacheMissReason} for more details.
-          #
-          # @param type [Symbol, Anthropic::Models::Beta::BetaDiagnostics::CacheMissReason::Type, String]
-          #
-          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
-          #
-          #   @option args [Integer] :cache_missed_input_tokens Approximate number of input tokens that would have been read from cache had the
-          #
-          # @raise [ArgumentError]
-          # @return [Anthropic::Models::Beta::BetaCacheMissModelChanged, Anthropic::Models::Beta::BetaCacheMissSystemChanged, Anthropic::Models::Beta::BetaCacheMissToolsChanged, Anthropic::Models::Beta::BetaCacheMissMessagesChanged, Anthropic::Models::Beta::BetaCacheMissPreviousMessageNotFound, Anthropic::Models::Beta::BetaCacheMissUnavailable]
-          def self.new(type:, **args)
-            case type.to_sym
-            when :model_changed
-              Anthropic::Beta::BetaCacheMissModelChanged.new(**args)
-            when :system_changed
-              Anthropic::Beta::BetaCacheMissSystemChanged.new(**args)
-            when :tools_changed
-              Anthropic::Beta::BetaCacheMissToolsChanged.new(**args)
-            when :messages_changed
-              Anthropic::Beta::BetaCacheMissMessagesChanged.new(**args)
-            when :previous_message_not_found
-              Anthropic::Beta::BetaCacheMissPreviousMessageNotFound.new(**args)
-            when :unavailable
-              Anthropic::Beta::BetaCacheMissUnavailable.new(**args)
-            else
-              raise ArgumentError, "unknown type: #{type}"
-            end
-          end
-        end
       end
     end
 

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

@@ -6,68 +6,105 @@ module Anthropic
       # @see Anthropic::Resources::Beta::Dreams#create
       class BetaDream < Anthropic::Internal::Type::BaseModel
         # @!attribute id
+        #   The unique ID of the dream (`drm_...`).
         #
         #   @return [String]
         required :id, String
 
         # @!attribute archived_at
-        #   A timestamp in RFC 3339 format
+        #   When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
         #
         #   @return [Time, nil]
         required :archived_at, Time, nil?: true
 
         # @!attribute created_at
-        #   A timestamp in RFC 3339 format
+        #   When the dream was created, in RFC 3339.
+        #
+        #   Lists of dreams are sorted by this time, newest first.
         #
         #   @return [Time]
         required :created_at, Time
 
         # @!attribute ended_at
-        #   A timestamp in RFC 3339 format
+        #   When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or
+        #   `null` if it is still `pending` or `running`.
         #
         #   @return [Time, nil]
         required :ended_at, Time, nil?: true
 
         # @!attribute error
-        #   Failure detail for a Dream whose `status` is `failed`.
+        #   Why the dream failed, or `null` if `status` isn't `failed`.
         #
         #   @return [Anthropic::Models::Beta::BetaDreamError, nil]
         required :error, -> { Anthropic::Beta::BetaDreamError }, nil?: true
 
         # @!attribute inputs
+        #   The sources that the dream reads, from the request that created it.
         #
         #   @return [Array<Anthropic::Models::Beta::BetaDreamMemoryStoreInput, Anthropic::Models::Beta::BetaDreamSessionsInput>]
         required :inputs, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaDreamInput] }
 
         # @!attribute instructions
+        #   The guidance given when the dream was created, or `null` if none was given.
         #
         #   @return [String, nil]
         required :instructions, String, nil?: true
 
         # @!attribute model
-        #   Model identifier and configuration applied to every pipeline stage. Same wire
-        #   shape as the Agents API ModelConfig.
+        #   The model that runs a dream, from the request that created it.
+        #
+        #   The dream uses this model for all of its work. The response always gives the
+        #   model as an object, even if the request gave only a model ID.
         #
         #   @return [Anthropic::Models::Beta::BetaDreamModelConfig]
         required :model, -> { Anthropic::Beta::BetaDreamModelConfig }
 
         # @!attribute output_behavior
+        #   Where the dream writes its result, as set in the request that created the dream.
+        #   If that request left out `output_behavior`, the dream used the `create_new`
+        #   behavior.
         #
         #   @return [Anthropic::Models::Beta::BetaOutputBehaviorCreateNew, Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting]
         required :output_behavior, union: -> { Anthropic::Beta::BetaOutputBehavior }
 
         # @!attribute outputs
+        #   The memory store that holds the dream's result, as a one-item array, or an empty
+        #   array until the dream records that memory store.
+        #
+        #   The array is empty while the dream is `pending` and for a short time after it
+        #   starts `running`. It can stay empty if the dream fails or is canceled before
+        #   then. The memory store holds the complete result only once `status` is
+        #   `completed`.
+        #
+        #   See the
+        #   [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#use-the-output)
+        #   for how to review and use the result.
         #
         #   @return [Array<Anthropic::Models::Beta::BetaDreamOutput>]
         required :outputs, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaDreamOutput] }
 
         # @!attribute session_id
+        #   The ID of the session that runs the dream (`sesn_...`), or `null` if that
+        #   session hasn't started.
+        #
+        #   Stream that session's events to follow what the dream reads and writes.
+        #
+        #   See the
+        #   [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#watch-the-pipeline-run)
+        #   for how to watch a running dream.
         #
         #   @return [String, nil]
         required :session_id, String, nil?: true
 
         # @!attribute status
-        #   Lifecycle status of a Dream.
+        #   Where a dream is in its lifecycle.
+        #
+        #   `completed`, `failed`, and `canceled` are final: once a dream has one of these
+        #   statuses, its status doesn't change again.
+        #
+        #   See the
+        #   [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#lifecycle)
+        #   for what each status means.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaDreamStatus]
         required :status, enum: -> { Anthropic::Beta::BetaDreamStatus }
@@ -78,49 +115,58 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaDream::Type }
 
         # @!attribute usage
-        #   Cumulative token usage for the dream across every pipeline stage.
+        #   The dream's token counts, which stop changing once its `status` is `completed`
+        #   or `failed`. After a cancel, they can keep changing.
         #
         #   @return [Anthropic::Models::Beta::BetaDreamUsage]
         required :usage, -> { Anthropic::Beta::BetaDreamUsage }
 
         # @!method initialize(id:, archived_at:, created_at:, ended_at:, error:, inputs:, instructions:, model:, output_behavior:, outputs:, session_id:, status:, type:, usage:)
-        #   An asynchronous memory-consolidation job that reads a memory store plus a set of
-        #   session transcripts and writes consolidated memories into an output memory store
-        #   — a new store by default, or an existing store chosen via output_behavior. The
-        #   Dreams API is in research preview: the request and response shapes are volatile
-        #   and may change without the deprecation period that applies to
+        #   An asynchronous job that reads a memory store and past sessions, then writes a
+        #   reorganized version of that memory store.
+        #
+        #   By default the dream writes its result to a new memory store and doesn't change
+        #   the input memory store. With `output_behavior` set to `update_existing`, it
+        #   writes its result into the input memory store instead.
+        #
+        #   The Dreams API is in research preview: the request and response shapes are
+        #   volatile and may change without the deprecation period that applies to
         #   generally-available endpoints.
         #
+        #   See the
+        #   [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#how-it-works)
+        #   for what a dream reads and produces.
+        #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaDream} for more details.
         #
-        #   @param id [String]
+        #   @param id [String] The unique ID of the dream (`drm_...`).
         #
-        #   @param archived_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param archived_at [Time, nil] When the dream was archived, in RFC 3339, or `null` if it hasn't been archived.
         #
-        #   @param created_at [Time] A timestamp in RFC 3339 format
+        #   @param created_at [Time] When the dream was created, in RFC 3339.
         #
-        #   @param ended_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param ended_at [Time, nil] When the dream reached `completed`, `failed`, or `canceled`, in RFC 3339, or `nu
         #
-        #   @param error [Anthropic::Models::Beta::BetaDreamError, nil] Failure detail for a Dream whose `status` is `failed`.
+        #   @param error [Anthropic::Models::Beta::BetaDreamError, nil] Why the dream failed, or `null` if `status` isn't `failed`.
         #
-        #   @param inputs [Array<Anthropic::Models::Beta::BetaDreamMemoryStoreInput, Anthropic::Models::Beta::BetaDreamSessionsInput>]
+        #   @param inputs [Array<Anthropic::Models::Beta::BetaDreamMemoryStoreInput, Anthropic::Models::Beta::BetaDreamSessionsInput>] The sources that the dream reads, from the request that created it.
         #
-        #   @param instructions [String, nil]
+        #   @param instructions [String, nil] The guidance given when the dream was created, or `null` if none was given.
         #
-        #   @param model [Anthropic::Models::Beta::BetaDreamModelConfig] Model identifier and configuration applied to every pipeline stage. Same wire sh
+        #   @param model [Anthropic::Models::Beta::BetaDreamModelConfig] The model that runs a dream, from the request that created it.
         #
-        #   @param output_behavior [Anthropic::Models::Beta::BetaOutputBehaviorCreateNew, Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting]
+        #   @param output_behavior [Anthropic::Models::Beta::BetaOutputBehaviorCreateNew, Anthropic::Models::Beta::BetaOutputBehaviorUpdateExisting] Where the dream writes its result, as set in the request that created the dream.
         #
-        #   @param outputs [Array<Anthropic::Models::Beta::BetaDreamOutput>]
+        #   @param outputs [Array<Anthropic::Models::Beta::BetaDreamOutput>] The memory store that holds the dream's result, as a one-item array, or an empty
         #
-        #   @param session_id [String, nil]
+        #   @param session_id [String, nil] The ID of the session that runs the dream (`sesn_...`), or `null` if that sessio
         #
-        #   @param status [Symbol, Anthropic::Models::Beta::BetaDreamStatus] Lifecycle status of a Dream.
+        #   @param status [Symbol, Anthropic::Models::Beta::BetaDreamStatus] Where a dream is in its lifecycle.
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaDream::Type]
         #
-        #   @param usage [Anthropic::Models::Beta::BetaDreamUsage] Cumulative token usage for the dream across every pipeline stage.
+        #   @param usage [Anthropic::Models::Beta::BetaDreamUsage] The dream's token counts, which stop changing once its `status` is `completed` o
 
         # @see Anthropic::Models::Beta::BetaDream#type
         module Type

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

@@ -5,11 +5,17 @@ module Anthropic
     module Beta
       class BetaDreamError < Anthropic::Internal::Type::BaseModel
         # @!attribute message
+        #   A human-readable explanation of why the dream failed.
         #
         #   @return [String]
         required :message, String
 
         # @!attribute type
+        #   A code for why the dream failed, such as `timeout` or `internal_error`.
+        #
+        #   The
+        #   [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#errors)
+        #   lists common error codes and when they occur.
         #
         #   @return [String]
         required :type, String
@@ -17,8 +23,12 @@ module Anthropic
         # @!method initialize(message:, type:)
         #   Failure detail for a Dream whose `status` is `failed`.
         #
-        #   @param message [String]
-        #   @param type [String]
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaDreamError} for more details.
+        #
+        #   @param message [String] A human-readable explanation of why the dream failed.
+        #
+        #   @param type [String] A code for why the dream failed, such as `timeout` or `internal_error`.
       end
     end
 

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

@@ -3,15 +3,18 @@
 module Anthropic
   module Models
     module Beta
+      # A source that a dream reads, such as a memory store or a set of sessions.
       module BetaDreamInput
         extend Anthropic::Internal::Type::Union
 
         discriminator :type
 
-        # An input memory store the dream reads from. The dream never mutates this store unless it is also the destination: with output_behavior {type: "update_existing"} the job consolidates this store in place.
+        # The memory store that a dream reads, given as an entry in `inputs`.
+        #
+        # With `output_behavior` set to `update_existing`, the dream writes its result into this memory store. Otherwise the dream doesn't change it.
         variant :memory_store, -> { Anthropic::Beta::BetaDreamMemoryStoreInput }
 
-        # Input session transcripts the dream reads.
+        # The sessions that a dream reads, given as an entry in `inputs`.
         variant :sessions, -> { Anthropic::Beta::BetaDreamSessionsInput }
 
         module Type
@@ -30,13 +33,16 @@ 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::BetaDreamInput} for more details.
+        #
         # @param type [Symbol, Anthropic::Models::Beta::BetaDreamInput::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 read (`memstore_...`).
         #
-        #   @option args [Array<String>] :session_ids
+        #   @option args [Array<String>] :session_ids The IDs of the sessions whose transcripts the dream reads (`sesn_...`).
         #
         # @raise [ArgumentError]
         # @return [Anthropic::Models::Beta::BetaDreamMemoryStoreInput, Anthropic::Models::Beta::BetaDreamSessionsInput]

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

@@ -5,6 +5,10 @@ module Anthropic
     module Beta
       class BetaDreamMemoryStoreInput < Anthropic::Internal::Type::BaseModel
         # @!attribute memory_store_id
+        #   The ID of the memory store for the dream to read (`memstore_...`).
+        #
+        #   The memory store must be in the same workspace as the dream and must not be
+        #   archived.
         #
         #   @return [String]
         required :memory_store_id, String
@@ -15,11 +19,16 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaDreamMemoryStoreInput::Type }
 
         # @!method initialize(memory_store_id:, type:)
-        #   An input memory store the dream reads from. The dream never mutates this store
-        #   unless it is also the destination: with output_behavior {type:
-        #   "update_existing"} the job consolidates this store in place.
+        #   The memory store that a dream reads, given as an entry in `inputs`.
+        #
+        #   With `output_behavior` set to `update_existing`, the dream writes its result
+        #   into this memory store. Otherwise the dream doesn't change it.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaDreamMemoryStoreInput} for more details.
+        #
+        #   @param memory_store_id [String] The ID of the memory store for the dream to read (`memstore_...`).
         #
-        #   @param memory_store_id [String]
         #   @param type [Symbol, Anthropic::Models::Beta::BetaDreamMemoryStoreInput::Type]
 
         # @see Anthropic::Models::Beta::BetaDreamMemoryStoreInput#type

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

@@ -5,6 +5,10 @@ module Anthropic
     module Beta
       class BetaDreamMemoryStoreOutput < Anthropic::Internal::Type::BaseModel
         # @!attribute memory_store_id
+        #   The ID of the memory store that the dream writes its result to (`memstore_...`).
+        #
+        #   With `output_behavior` set to `create_new`, this is a new memory store. With
+        #   `update_existing`, it is the input memory store.
         #
         #   @return [String]
         required :memory_store_id, String
@@ -15,9 +19,13 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaDreamMemoryStoreOutput::Type }
 
         # @!method initialize(memory_store_id:, type:)
-        #   An output memory store the dream writes consolidated memories into.
+        #   The memory store that holds a dream's result, as an entry in `outputs`.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaDreamMemoryStoreOutput} for more details.
+        #
+        #   @param memory_store_id [String] The ID of the memory store that the dream writes its result to (`memstore_...`).
         #
-        #   @param memory_store_id [String]
         #   @param type [Symbol, Anthropic::Models::Beta::BetaDreamMemoryStoreOutput::Type]
 
         # @see Anthropic::Models::Beta::BetaDreamMemoryStoreOutput#type