anthropic 1.72.0 → 1.74.0

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

@@ -5,33 +5,32 @@ module Anthropic
     module Beta
       class BetaDreamModelConfig < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   Model identifier, e.g. "claude-opus-5". 1-256 characters.
+        #   The ID of the model that runs the dream, as given in the request that created
+        #   it.
         #
         #   @return [String]
         required :id, String
 
         # @!attribute speed
-        #   Inference speed mode. `fast` provides significantly faster output token
-        #   generation at premium pricing. Not all models support `fast`; invalid
-        #   combinations are rejected at create time.
+        #   How fast the model generates output for the dream. Always `standard`.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaDreamModelConfig::Speed, nil]
         optional :speed, enum: -> { Anthropic::Beta::BetaDreamModelConfig::Speed }
 
         # @!method initialize(id:, speed: nil)
-        #   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.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaDreamModelConfig} for more details.
         #
-        #   @param id [String] Model identifier, e.g. "claude-opus-5". 1-256 characters.
+        #   @param id [String] The ID of the model that runs the dream, as given in the request that created it
         #
-        #   @param speed [Symbol, Anthropic::Models::Beta::BetaDreamModelConfig::Speed] Inference speed mode. `fast` provides significantly faster output token generati
+        #   @param speed [Symbol, Anthropic::Models::Beta::BetaDreamModelConfig::Speed] How fast the model generates output for the dream. Always `standard`.
 
-        # Inference speed mode. `fast` provides significantly faster output token
-        # generation at premium pricing. Not all models support `fast`; invalid
-        # combinations are rejected at create time.
+        # How fast the model generates output for the dream. Always `standard`.
         #
         # @see Anthropic::Models::Beta::BetaDreamModelConfig#speed
         module Speed

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

@@ -5,32 +5,38 @@ module Anthropic
     module Beta
       class BetaDreamModelConfigParam < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   Model identifier, e.g. "claude-opus-5". 1-256 characters.
+        #   The ID of the model to run the dream with.
+        #
+        #   The ID can be 1 to 256 characters long.
+        #
+        #   The
+        #   [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#limits)
+        #   lists the supported models.
         #
         #   @return [String]
         required :id, String
 
         # @!attribute speed
-        #   Inference speed mode. `fast` provides significantly faster output token
-        #   generation at premium pricing. Not all models support `fast`; invalid
-        #   combinations are rejected at create time.
+        #   How fast the model generates output for the dream. Defaults to `standard`.
+        #
+        #   Dreams accept only `standard`.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaDreamModelConfigParam::Speed, nil]
         optional :speed, enum: -> { Anthropic::Beta::BetaDreamModelConfigParam::Speed }, nil?: true
 
         # @!method initialize(id:, speed: nil)
-        #   Model identifier and configuration applied to every pipeline stage.
+        #   The object form of `model` in a request to create a dream.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaDreamModelConfigParam} for more details.
         #
-        #   @param id [String] Model identifier, e.g. "claude-opus-5". 1-256 characters.
+        #   @param id [String] The ID of the model to run the dream with.
         #
-        #   @param speed [Symbol, Anthropic::Models::Beta::BetaDreamModelConfigParam::Speed, nil] Inference speed mode. `fast` provides significantly faster output token generati
+        #   @param speed [Symbol, Anthropic::Models::Beta::BetaDreamModelConfigParam::Speed, nil] How fast the model generates output for the dream. Defaults to `standard`.
 
-        # Inference speed mode. `fast` provides significantly faster output token
-        # generation at premium pricing. Not all models support `fast`; invalid
-        # combinations are rejected at create time.
+        # How fast the model generates output for the dream. Defaults to `standard`.
+        #
+        # Dreams accept only `standard`.
         #
         # @see Anthropic::Models::Beta::BetaDreamModelConfigParam#speed
         module Speed

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

@@ -5,6 +5,10 @@ module Anthropic
     module Beta
       class BetaDreamOutput < 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,14 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaDreamOutput::Type }
 
         # @!method initialize(memory_store_id:, type:)
-        #   An output memory store the dream writes consolidated memories into.
+        #   An entry in a dream's `outputs` that references the memory store holding its
+        #   result.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaDreamOutput} 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::BetaDreamOutput::Type]
 
         # @see Anthropic::Models::Beta::BetaDreamOutput#type

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

@@ -5,6 +5,14 @@ module Anthropic
     module Beta
       class BetaDreamSessionsInput < Anthropic::Internal::Type::BaseModel
         # @!attribute session_ids
+        #   The IDs of the sessions whose transcripts the dream reads (`sesn_...`).
+        #
+        #   Give 1 to 100 IDs, with no duplicates. Each session must be in the same
+        #   workspace as the dream. Responses list the IDs in sorted order.
+        #
+        #   The
+        #   [limits table in the Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#limits)
+        #   lists all the limits on a dream.
         #
         #   @return [Array<String>]
         required :session_ids, Anthropic::Internal::Type::ArrayOf[String]
@@ -15,9 +23,13 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaDreamSessionsInput::Type }
 
         # @!method initialize(session_ids:, type:)
-        #   Input session transcripts the dream reads.
+        #   The sessions that a dream reads, given as an entry in `inputs`.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaDreamSessionsInput} for more details.
+        #
+        #   @param session_ids [Array<String>] The IDs of the sessions whose transcripts the dream reads (`sesn_...`).
         #
-        #   @param session_ids [Array<String>]
         #   @param type [Symbol, Anthropic::Models::Beta::BetaDreamSessionsInput::Type]
 
         # @see Anthropic::Models::Beta::BetaDreamSessionsInput#type

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

@@ -3,7 +3,14 @@
 module Anthropic
   module Models
     module Beta
-      # 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.
       module BetaDreamStatus
         extend Anthropic::Internal::Type::Enum
 
@@ -25,7 +32,9 @@ module Anthropic
         # If `outputs` references a memory store, that memory store keeps what the dream wrote before it stopped.
         FAILED = :failed
 
-        # The caller canceled the dream before it completed.
+        # A cancel request stopped the dream before it reached `completed` or `failed`.
+        #
+        # If `outputs` references a memory store, that memory store keeps what the dream wrote. `usage` can keep changing after the cancel.
         CANCELED = :canceled
 
         # @!method self.values

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

@@ -5,39 +5,52 @@ module Anthropic
     module Beta
       class BetaDreamUsage < Anthropic::Internal::Type::BaseModel
         # @!attribute cache_creation_input_tokens
-        #   Total tokens used to create prompt-cache entries (sum of all TTL tiers).
+        #   The dream's input tokens that were written to the prompt cache, for both the
+        #   5-minute and 1-hour cache durations.
         #
         #   @return [Integer]
         required :cache_creation_input_tokens, Integer
 
         # @!attribute cache_read_input_tokens
-        #   Total tokens read from prompt cache.
+        #   The dream's input tokens that were read from the prompt cache.
         #
         #   @return [Integer]
         required :cache_read_input_tokens, Integer
 
         # @!attribute input_tokens
-        #   Total uncached input tokens consumed across every pipeline stage.
+        #   The dream's input tokens that weren't read from or written to the prompt cache.
         #
         #   @return [Integer]
         required :input_tokens, Integer
 
         # @!attribute output_tokens
-        #   Total output tokens generated across every pipeline stage.
+        #   The tokens that the model generated for the dream.
         #
         #   @return [Integer]
         required :output_tokens, Integer
 
         # @!method initialize(cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, output_tokens:)
-        #   Cumulative token usage for the dream across every pipeline stage.
+        #   The tokens that a dream has used so far.
         #
-        #   @param cache_creation_input_tokens [Integer] Total tokens used to create prompt-cache entries (sum of all TTL tiers).
+        #   The counts are zero while the dream is `pending` and update while it is
+        #   `running`. They can keep changing after a cancel.
         #
-        #   @param cache_read_input_tokens [Integer] Total tokens read from prompt cache.
+        #   See the
+        #   [Dreams guide](https://platform.claude.com/docs/en/managed-agents/dreams#billing)
+        #   for how dreams are billed. See the
+        #   [prompt caching guide](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance)
+        #   for how the input token counts add up.
         #
-        #   @param input_tokens [Integer] Total uncached input tokens consumed across every pipeline stage.
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaDreamUsage} for more details.
         #
-        #   @param output_tokens [Integer] Total output tokens generated across every pipeline stage.
+        #   @param cache_creation_input_tokens [Integer] The dream's input tokens that were written to the prompt cache, for both the 5-m
+        #
+        #   @param cache_read_input_tokens [Integer] The dream's input tokens that were read from the prompt cache.
+        #
+        #   @param input_tokens [Integer] The dream's input tokens that weren't read from or written to the prompt cache.
+        #
+        #   @param output_tokens [Integer] The tokens that the model generated for the dream.
       end
     end
 

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

@@ -26,7 +26,9 @@ module Anthropic
 
         variant :overloaded_error, -> { Anthropic::BetaOverloadedError }
 
-        # The `output_behavior.memory_store_id` target is still held by a prior `{type: "update_existing"}` dream — one that is `pending` or `running`, or was canceled with its final writes still landing. Rarely the named dream has just finished (`completed`/`failed`) and its execution is still closing; an immediate retry then almost always succeeds. The message names the holding dream when the server can identify it (rarely omitted); poll it to a terminal state or cancel it, then retry. Carried with `x-should-retry: false`.
+        # Returned with status 409 when a request to create a dream sets `output_behavior` to `update_existing` and another dream that writes into the same memory store hasn't fully stopped.
+        #
+        # The other dream is `pending` or `running`, or it has just stopped and is still finishing its last writes. `message` gives the ID of the other dream when the server can identify it. If that dream has already reached `completed`, `failed`, or `canceled`, retry after a short wait. Otherwise, wait for the other dream to end or cancel it, then retry. The response sets the `x-should-retry` header to `false`.
         variant :conflict_error, -> { Anthropic::Beta::BetaTargetStoreHeldError }
 
         module Type
@@ -60,7 +62,7 @@ module Anthropic
         #
         # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
         #
-        #   @option args [String] :message Human-readable description of the conflict, naming the dream that holds the targ
+        #   @option args [String] :message A human-readable explanation of why the memory store can't be used yet, with the
         #
         # @raise [ArgumentError]
         # @return [Anthropic::Models::BetaInvalidRequestError, Anthropic::Models::BetaAuthenticationError, Anthropic::Models::BetaBillingError, Anthropic::Models::BetaPermissionError, Anthropic::Models::BetaNotFoundError, Anthropic::Models::BetaRateLimitError, Anthropic::Models::BetaGatewayTimeoutError, Anthropic::Models::BetaAPIError, Anthropic::Models::BetaOverloadedError, Anthropic::Models::Beta::BetaTargetStoreHeldError]

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

@@ -35,7 +35,7 @@ module Anthropic
         required :supported, Anthropic::Internal::Type::Boolean
 
         # @!attribute xhigh
-        #   Indicates whether a capability is supported.
+        #   Whether the model supports xhigh effort level.
         #
         #   @return [Anthropic::Models::Beta::BetaCapabilitySupport, nil]
         required :xhigh, -> { Anthropic::Beta::BetaCapabilitySupport }, nil?: true
@@ -53,7 +53,7 @@ module Anthropic
         #
         #   @param supported [Boolean] Whether this capability is supported by the model.
         #
-        #   @param xhigh [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Indicates whether a capability is supported.
+        #   @param xhigh [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Whether the model supports xhigh effort level.
       end
     end
 

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

@@ -33,7 +33,7 @@ module Anthropic
 
         # @!attribute thinking
         #
-        #   @return [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
+        #   @return [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
         optional :thinking, union: -> { Anthropic::Beta::BetaFallbackParam::Thinking }, nil?: true
 
         # @!method initialize(model:, max_tokens: nil, output_config: nil, speed: nil, thinking: nil)
@@ -55,7 +55,7 @@ module Anthropic
         #
         #   @param speed [Symbol, Anthropic::Models::Beta::BetaFallbackParam::Speed, nil] Inference speed mode. `fast` provides significantly faster output token generati
         #
-        #   @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
+        #   @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
 
         # Inference speed mode. `fast` provides significantly faster output token
         # generation at premium pricing. Not all models support `fast`; invalid
@@ -82,6 +82,8 @@ module Anthropic
 
           variant :disabled, -> { Anthropic::Beta::BetaThinkingConfigDisabled }
 
+          variant :between_tools, -> { Anthropic::Beta::BetaThinkingConfigBetweenTools }
+
           variant :adaptive, -> { Anthropic::Beta::BetaThinkingConfigAdaptive }
 
           module Type
@@ -89,6 +91,7 @@ module Anthropic
 
             ENABLED = :enabled
             DISABLED = :disabled
+            BETWEEN_TOOLS = :between_tools
             ADAPTIVE = :adaptive
 
             # @!method self.values
@@ -96,7 +99,7 @@ module Anthropic
           end
 
           # @!method self.variants
-          #   @return [Array(Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigAdaptive)]
+          #   @return [Array(Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive)]
 
           # Creates a new instance of the variant class whose `type` matches the given
           # value, passing the remaining arguments to its constructor.
@@ -110,18 +113,20 @@ module Anthropic
           #
           #   @option args [Integer] :budget_tokens Determines how many tokens Claude can use for its internal reasoning process. La
           #
-          #   @option args [Anthropic::Models::Beta::BetaThinkingBlockBinding, nil] :block_binding Controls for block binding: what happens when a thinking block this
+          #   @option args [Anthropic::Models::Beta::BetaThinkingBlockBinding, nil] :block_binding Controls for block binding: what happens when a thinking block this request send
           #
           #   @option args [Symbol, Anthropic::Models::Beta::BetaThinkingConfigEnabled::Display, nil, Symbol, Anthropic::Models::Beta::BetaThinkingConfigAdaptive::Display, nil] :display_ Controls how thinking content appears in the response. When set to `summarized`,
           #
           # @raise [ArgumentError]
-          # @return [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigAdaptive]
+          # @return [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive]
           def self.new(type:, **args)
             case type.to_sym
             when :enabled
               Anthropic::Beta::BetaThinkingConfigEnabled.new(**args)
             when :disabled
               Anthropic::Beta::BetaThinkingConfigDisabled.new(**args)
+            when :between_tools
+              Anthropic::Beta::BetaThinkingConfigBetweenTools.new(**args)
             when :adaptive
               Anthropic::Beta::BetaThinkingConfigAdaptive.new(**args)
             else

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

@@ -5,7 +5,9 @@ module Anthropic
     module Beta
       class BetaFallbackRefusalTrigger < Anthropic::Internal::Type::BaseModel
         # @!attribute category
-        #   The policy category that triggered a refusal.
+        #   The policy category that triggered the `from` model's refusal at this hop.
+        #   `null` when the refusal doesn't map to a named category. Same vocabulary as
+        #   `stop_details.category`.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaFallbackRefusalTrigger::Category, nil]
         required :category, enum: -> { Anthropic::Beta::BetaFallbackRefusalTrigger::Category }, nil?: true
@@ -18,11 +20,16 @@ module Anthropic
         # @!method initialize(category:, type: :refusal)
         #   The `from` model declined for policy reasons.
         #
-        #   @param category [Symbol, Anthropic::Models::Beta::BetaFallbackRefusalTrigger::Category, nil] The policy category that triggered a refusal.
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaFallbackRefusalTrigger} for more details.
+        #
+        #   @param category [Symbol, Anthropic::Models::Beta::BetaFallbackRefusalTrigger::Category, nil] The policy category that triggered the `from` model's refusal at this hop. `null
         #
         #   @param type [Symbol, :refusal]
 
-        # The policy category that triggered a refusal.
+        # The policy category that triggered the `from` model's refusal at this hop.
+        # `null` when the refusal doesn't map to a named category. Same vocabulary as
+        # `stop_details.category`.
         #
         # @see Anthropic::Models::Beta::BetaFallbackRefusalTrigger#category
         module Category

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

@@ -11,7 +11,7 @@ module Anthropic
         required :id, String
 
         # @!attribute archived_at
-        #   A timestamp in RFC 3339 format
+        #   When the agent was archived. Null if not archived.
         #
         #   @return [Time, nil]
         required :archived_at, Time, nil?: true
@@ -45,7 +45,7 @@ module Anthropic
         required :model, -> { Anthropic::Beta::BetaManagedAgentsModelConfig }
 
         # @!attribute multiagent
-        #   Resolved coordinator topology with a concrete agent roster.
+        #   Multiagent orchestration configuration. Null when the agent is single-threaded.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsMultiagent, nil]
         required :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagent }, nil?: true
@@ -98,7 +98,7 @@ module Anthropic
         #
         #   @param id [String]
         #
-        #   @param archived_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param archived_at [Time, nil] When the agent was archived. Null if not archived.
         #
         #   @param created_at [Time] A timestamp in RFC 3339 format
         #
@@ -110,7 +110,7 @@ module Anthropic
         #
         #   @param model [Anthropic::Models::Beta::BetaManagedAgentsModelConfig] Model identifier and configuration.
         #
-        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagent, nil] Resolved coordinator topology with a concrete agent roster.
+        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagent, nil] Multiagent orchestration configuration. Null when the agent is single-threaded.
         #
         #   @param name [String]
         #

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

@@ -65,7 +65,7 @@ module Anthropic
         #
         #   @option args [Boolean, nil] :enabled Whether this tool is enabled and available to Claude. Overrides the default_conf
         #
-        #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] :permission_policy Permission policy for tool execution.
+        #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] :permission_policy Permission policy for this tool. Controls whether tool calls are auto-approved o
         #
         #   @option args [Symbol, :bash, Symbol, :edit, Symbol, :read, Symbol, :write, Symbol, :glob, Symbol, :grep, Symbol, :web_fetch, Symbol, :web_search] :name Must be "bash".
         #

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

@@ -17,7 +17,7 @@ module Anthropic
                  -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaManagedAgentsAgentToolConfigParams] }
 
         # @!attribute default_config
-        #   Default configuration for all tools in a toolset.
+        #   Default configuration applied to all tools in this set.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil]
         optional :default_config,
@@ -32,7 +32,7 @@ module Anthropic
         #
         #   @param configs [Array<Anthropic::Models::Beta::BetaManagedAgentsBashToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsEditToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsReadToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWriteToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGlobToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGrepToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebFetchToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebSearchToolConfigParams>] Per-tool configuration overrides.
         #
-        #   @param default_config [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil] Default configuration for all tools in a toolset.
+        #   @param default_config [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil] Default configuration applied to all tools in this set.
 
         # @see Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params#type
         module Type

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

@@ -12,7 +12,8 @@ module Anthropic
         optional :enabled, Anthropic::Internal::Type::Boolean, nil?: true
 
         # @!attribute permission_policy
-        #   Permission policy for tool execution.
+        #   Default permission policy for tools. 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,
@@ -30,9 +31,10 @@ module Anthropic
         #
         #   @param enabled [Boolean, nil] Whether tools are enabled and available to Claude by default. Defaults to true i
         #
-        #   @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] Default permission policy for tools. Controls whether tool calls are auto-approv
 
-        # Permission policy for tool execution.
+        # Default permission policy for tools. Controls whether tool calls are
+        # auto-approved or require confirmation.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams#permission_policy
         module PermissionPolicy

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

@@ -155,13 +155,13 @@ module Anthropic
           #
           #   @option args [Array<Anthropic::Models::Beta::BetaManagedAgentsBashToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsEditToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsReadToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWriteToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGlobToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGrepToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebFetchToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebSearchToolConfigParams>, Array<Anthropic::Models::Beta::BetaManagedAgentsMCPToolConfigParams>] :configs Per-tool configuration overrides.
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration for all tools in a toolset.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration applied to all tools in this set.
           #
           #   @option args [String] :mcp_server_name Name of the MCP server. Must match a server name from the mcp_servers array. 1-2
           #
           #   @option args [String] :description Description of what the tool does, shown to the agent to help it decide when to
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema for custom tool input parameters.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema defining the expected input parameters for the tool.
           #
           #   @option args [String] :name Unique name for the tool. 1-128 characters; letters, digits, underscores, and hy
           #

data/lib/anthropic/models/beta/beta_managed_agents_bash_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::BetaManagedAgentsBashToolConfigParams::Type]
         #
         #   @param name [Symbol, :bash] Must be "bash".
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsBashToolConfigParams#permission_policy
         module PermissionPolicy

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

@@ -5,7 +5,8 @@ module Anthropic
     module Beta
       class BetaManagedAgentsBudgetLimit < Anthropic::Internal::Type::BaseModel
         # @!attribute max_list_cost
-        #   A monetary amount in a specific currency.
+        #   Maximum list cost the session may accrue. List price is used regardless of any
+        #   negotiated discount, so the cap fires at or before the actual charge.
         #
         #   @return [Anthropic::Models::BetaMonetaryAmount]
         required :max_list_cost, -> { Anthropic::BetaMonetaryAmount }
@@ -19,7 +20,10 @@ module Anthropic
         #   A hard spend ceiling. The session stops issuing new model requests once the
         #   tracked list cost reaches `max_list_cost`.
         #
-        #   @param max_list_cost [Anthropic::Models::BetaMonetaryAmount] A monetary amount in a specific currency.
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit} for more details.
+        #
+        #   @param max_list_cost [Anthropic::Models::BetaMonetaryAmount] Maximum list cost the session may accrue. List price is used regardless of any n
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit::Type]
 

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

@@ -26,7 +26,8 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsCronSchedule::Type }
 
         # @!attribute last_run_at
-        #   A timestamp in RFC 3339 format
+        #   Time the most recent scheduled run actually started. Null until one completes;
+        #   preserved after the deployment is archived. Manual runs do not update this.
         #
         #   @return [Time, nil]
         optional :last_run_at, Time, nil?: true
@@ -53,7 +54,7 @@ module Anthropic
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsCronSchedule::Type]
         #
-        #   @param last_run_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param last_run_at [Time, nil] Time the most recent scheduled run actually started. Null until one completes; p
         #
         #   @param upcoming_runs_at [Array<Time>] Up to 5 timestamps of upcoming cron occurrences. Non-empty for active and paused
 

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

@@ -12,7 +12,7 @@ module Anthropic
         required :description, String
 
         # @!attribute input_schema
-        #   JSON Schema for custom tool input parameters.
+        #   JSON Schema defining the expected input parameters for the tool.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema]
         required :input_schema, -> { Anthropic::Beta::BetaManagedAgentsCustomToolInputSchema }
@@ -40,7 +40,7 @@ module Anthropic
         #
         #   @param description [String] Description of what the tool does, shown to the agent to help it decide when to
         #
-        #   @param input_schema [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] JSON Schema for custom tool input parameters.
+        #   @param input_schema [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] JSON Schema defining the expected input parameters for the tool.
         #
         #   @param name [String] Unique name for the tool. 1-128 characters; letters, digits, underscores, and hy
         #

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

@@ -5,7 +5,8 @@ module Anthropic
     module Beta
       class BetaManagedAgentsDeltaContent < Anthropic::Internal::Type::BaseModel
         # @!attribute content
-        #   Regular text content.
+        #   A partial element of the content array at index, typed like the element itself —
+        #   the same shape the buffered agent.message carries in content.
         #
         #   @return [Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock]
         required :content, -> { Anthropic::Beta::Sessions::BetaManagedAgentsTextBlock }
@@ -27,7 +28,7 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaManagedAgentsDeltaContent} for more details.
         #
-        #   @param content [Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock] Regular text content.
+        #   @param content [Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock] A partial element of the content array at index, typed like the element itself —
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsDeltaContent::Type]
         #