anthropic 1.42.0 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5babf593055aa56b8e86a7cbf3b2485d7b6e0a73d6c44a89ecf3bfa467c7863a
-  data.tar.gz: 0a1f49bd358d4bd27ea403115b22da8180af21afbacac24489801074f6815db5
+  metadata.gz: 876ada84a1da262a8c81ca559e5123da5d477507d02e127415541a6c58e12acd
+  data.tar.gz: 45fbc86ad5fa0153da5ff489c356acbd52ec59cee705d1dd3e8f764262c7a232
 SHA512:
-  metadata.gz: 99b5b9414478942809c6b2a5b26441f236e2322fdca0d310b794ebdd0fec20dcea666330514bb5ec1bf580549a60909890eb09e890f054308ecb2a9b0cdcb028
-  data.tar.gz: 720e57337738ec199b4f6eaddd64584d368db6961ffcf91256a598d2ae2638e06ec5dd126b51d46d065b5abd2e25d45f4dcd1c41c098e98c2d84e76205766578
+  metadata.gz: 747f49e8366dec6fddbe2190984cf71927f6e55829ce868e8dd116b91ccdd5f89331ad115b84527d73f8963f892f3fea4e317b366283f4df2df1dfb4a3ba3ab1
+  data.tar.gz: 6ab572aa679fe5f526ab9043d67f128382e0518f3bfc3d628feefbd751f71eda4be61c05a1767b96faf2b816e58868adab3ed1c4ee3009a7b0efbee220ebdacd

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.44.0 (2026-05-28)
+
+Full Changelog: [v1.43.0...v1.44.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.43.0...v1.44.0)
+
+### Features
+
+* **api:** Add support for claude-opus-4-8, mid-conversation system blocks, and usage.output_tokens_details ([6e361e7](https://github.com/anthropics/anthropic-sdk-ruby/commit/6e361e7ef1fc3bcbcb2b5bfa2a08bccd6a68ba72))
+
+
+### Bug Fixes
+
+* **internal:** preserve path-qualified multipart filenames (SDK-40) ([#937](https://github.com/anthropics/anthropic-sdk-ruby/issues/937)) ([000e793](https://github.com/anthropics/anthropic-sdk-ruby/commit/000e793062309ee421111866f1bd56d0384277f3))
+
+
+### Documentation
+
+* replace literal newlines ([e698364](https://github.com/anthropics/anthropic-sdk-ruby/commit/e698364084ebde9398a3c8e4c969e5922e778658))
+
+## 1.43.0 (2026-05-21)
+
+Full Changelog: [v1.42.0...v1.43.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.42.0...v1.43.0)
+
+### Features
+
+* **api:** Add support for thinking-token-count beta for estimated tokens in thinking block deltas when streaming ([9cd8a67](https://github.com/anthropics/anthropic-sdk-ruby/commit/9cd8a67e5a4382a72c2e417de9be587be9237353))
+
 ## 1.42.0 (2026-05-19)
 
 Full Changelog: [v1.41.0...v1.42.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.41.0...v1.42.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.42.0"
+gem "anthropic", "~> 1.44.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/anthropic/file_part.rb

@@ -45,7 +45,10 @@ module Anthropic
       @filename =
         case [filename, (@content = content)]
         in [String | Pathname, _]
-          ::File.basename(filename)
+          # Preserve an explicit filename verbatim (e.g. a path-qualified
+          # `my-skill/SKILL.md`, which the Skills API requires). Only the
+          # auto-derived `nil` branches below are reduced to a basename.
+          filename.to_s
         in [nil, Pathname]
           content.basename.to_path
         in [nil, IO]

data/lib/anthropic/internal/util.rb

@@ -590,10 +590,14 @@ module Anthropic
 
           case val
           in Anthropic::FilePart unless val.filename.nil?
-            filename = encode_path(val.filename)
+            # A multipart `filename=` is an RFC 7578 / 6266 quoted-string, not a
+            # URI path segment: escape `"` and `\` and drop CR/LF, but keep `/`
+            # and spaces literal so path-qualified names (e.g. `dir/SKILL.md`,
+            # required by the Skills API) survive instead of becoming `dir%2F...`.
+            filename = val.filename.to_s.gsub(/["\\]/) { "\\#{_1}" }.delete("\r\n")
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = encode_path(::File.basename(val.to_path))
+            filename = ::File.basename(val.to_path).gsub(/["\\]/) { "\\#{_1}" }.delete("\r\n")
             y << "; filename=\"#{filename}\""
           else
           end

data/lib/anthropic/models/anthropic_beta.rb

@@ -57,6 +57,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::CACHE_DIAGNOSIS_2026_04_07 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::THINKING_TOKEN_COUNT_2026_05_13 }
+
       # @!method self.variants
       #   @return [Array(String, Symbol)]
 
@@ -91,6 +93,7 @@ module Anthropic
       ADVISOR_TOOL_2026_03_01 = :"advisor-tool-2026-03-01"
       MANAGED_AGENTS_2026_04_01 = :"managed-agents-2026-04-01"
       CACHE_DIAGNOSIS_2026_04_07 = :"cache-diagnosis-2026-04-07"
+      THINKING_TOKEN_COUNT_2026_05_13 = :"thinking-token-count-2026-05-13"
 
       # @!endgroup
     end

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

@@ -111,7 +111,9 @@ module Anthropic
         module Model
           extend Anthropic::Internal::Type::Union
 
-          # The model that will power your agent.\n\nSee [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
+          # The model that will power your agent.
+          #
+          # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
           variant union: -> { Anthropic::Beta::BetaManagedAgentsModel }
 
           # An object that defines additional configuration control over model use

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

@@ -140,7 +140,9 @@ module Anthropic
         module Model
           extend Anthropic::Internal::Type::Union
 
-          # The model that will power your agent.\n\nSee [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
+          # The model that will power your agent.
+          #
+          # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
           variant union: -> { Anthropic::Beta::BetaManagedAgentsModel }
 
           # An object that defines additional configuration control over model use

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

@@ -29,8 +29,9 @@ module Anthropic
         required :input_tokens, Integer
 
         # @!attribute model
-        #   The model that will complete your prompt.\n\nSee
-        #   [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         #   details and options.
         #
         #   @return [Symbol, String, Anthropic::Models::Model]
@@ -62,7 +63,7 @@ module Anthropic
         #
         #   @param input_tokens [Integer] The number of input tokens which were used.
         #
-        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
         #
         #   @param output_tokens [Integer] The number of output tokens which were used.
         #

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

@@ -11,17 +11,26 @@ module Anthropic
         #   @return [String]
         required :encrypted_content, String
 
+        # @!attribute stop_reason
+        #   The advisor sub-inference's stop reason (same values as the top-level message
+        #   `stop_reason`).
+        #
+        #   @return [String, nil]
+        required :stop_reason, String, nil?: true
+
         # @!attribute type
         #
         #   @return [Symbol, :advisor_redacted_result]
         required :type, const: :advisor_redacted_result
 
-        # @!method initialize(encrypted_content:, type: :advisor_redacted_result)
+        # @!method initialize(encrypted_content:, stop_reason:, type: :advisor_redacted_result)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaAdvisorRedactedResultBlock} for more details.
         #
         #   @param encrypted_content [String] Opaque blob containing the advisor's output. Round-trip verbatim; do not inspect
         #
+        #   @param stop_reason [String, nil] The advisor sub-inference's stop reason (same values as the top-level message `s
+        #
         #   @param type [Symbol, :advisor_redacted_result]
       end
     end

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

@@ -15,9 +15,16 @@ module Anthropic
         #   @return [Symbol, :advisor_redacted_result]
         required :type, const: :advisor_redacted_result
 
-        # @!method initialize(encrypted_content:, type: :advisor_redacted_result)
+        # @!attribute stop_reason
+        #
+        #   @return [String, nil]
+        optional :stop_reason, String, nil?: true
+
+        # @!method initialize(encrypted_content:, stop_reason: nil, type: :advisor_redacted_result)
         #   @param encrypted_content [String] Opaque blob produced by a prior response; must be round-tripped verbatim.
         #
+        #   @param stop_reason [String, nil]
+        #
         #   @param type [Symbol, :advisor_redacted_result]
       end
     end

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

@@ -4,6 +4,14 @@ module Anthropic
   module Models
     module Beta
       class BetaAdvisorResultBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute stop_reason
+        #   The advisor sub-inference's stop reason (same values as the top-level message
+        #   `stop_reason`). `max_tokens` indicates the advisor's output was truncated at the
+        #   tool's `max_tokens` value or the advisor model's policy cap.
+        #
+        #   @return [String, nil]
+        required :stop_reason, String, nil?: true
+
         # @!attribute text
         #
         #   @return [String]
@@ -14,8 +22,14 @@ module Anthropic
         #   @return [Symbol, :advisor_result]
         required :type, const: :advisor_result
 
-        # @!method initialize(text:, type: :advisor_result)
+        # @!method initialize(stop_reason:, text:, type: :advisor_result)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaAdvisorResultBlock} for more details.
+        #
+        #   @param stop_reason [String, nil] The advisor sub-inference's stop reason (same values as the top-level message `s
+        #
         #   @param text [String]
+        #
         #   @param type [Symbol, :advisor_result]
       end
     end

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

@@ -14,8 +14,14 @@ module Anthropic
         #   @return [Symbol, :advisor_result]
         required :type, const: :advisor_result
 
-        # @!method initialize(text:, type: :advisor_result)
+        # @!attribute stop_reason
+        #
+        #   @return [String, nil]
+        optional :stop_reason, String, nil?: true
+
+        # @!method initialize(text:, stop_reason: nil, type: :advisor_result)
         #   @param text [String]
+        #   @param stop_reason [String, nil]
         #   @param type [Symbol, :advisor_result]
       end
     end

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

@@ -5,8 +5,9 @@ module Anthropic
     module Beta
       class BetaAdvisorTool20260301 < Anthropic::Internal::Type::BaseModel
         # @!attribute model
-        #   The model that will complete your prompt.\n\nSee
-        #   [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         #   details and options.
         #
         #   @return [Symbol, String, Anthropic::Models::Model]
@@ -68,7 +69,7 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaAdvisorTool20260301} for more details.
         #
-        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
         #
         #   @param allowed_callers [Array<Symbol, Anthropic::Models::Beta::BetaAdvisorTool20260301::AllowedCaller>]
         #

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

@@ -68,8 +68,14 @@ module Anthropic
         # treats these as no-ops. Empty string content is not allowed.
         variant :compaction, -> { Anthropic::Beta::BetaCompactionBlockParam }
 
+        # System instructions that appear mid-conversation.
+        #
+        # Use this block to provide or update system-level instructions at a specific
+        # point in the conversation, rather than only via the top-level `system` parameter.
+        variant :mid_conv_system, -> { Anthropic::Beta::BetaMidConversationSystemBlockParam }
+
         # @!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)]
+        #   @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::BetaMidConversationSystemBlockParam)]
       end
     end
 

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

@@ -3,12 +3,15 @@
 module Anthropic
   module Models
     module Beta
-      # The model that will power your agent.\n\nSee
-      # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+      # The model that will power your agent.
+      #
+      # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
       # details and options.
       module BetaManagedAgentsModel
         extend Anthropic::Internal::Type::Union
 
+        variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_4_8 }
+
         variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_4_7 }
 
         variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_4_6 }
@@ -38,6 +41,9 @@ module Anthropic
 
         # @!group
 
+        # Frontier intelligence for long-running agents and coding
+        CLAUDE_OPUS_4_8 = :"claude-opus-4-8"
+
         # Frontier intelligence for long-running agents and coding
         CLAUDE_OPUS_4_7 = :"claude-opus-4-7"
 

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

@@ -5,8 +5,9 @@ module Anthropic
     module Beta
       class BetaManagedAgentsModelConfig < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   The model that will power your agent.\n\nSee
-        #   [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   The model that will power your agent.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         #   details and options.
         #
         #   @return [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel]
@@ -26,7 +27,7 @@ module Anthropic
         #
         #   Model identifier and configuration.
         #
-        #   @param id [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel] The model that will power your agent.\n\nSee [models](https://docs.anthropic.com
+        #   @param id [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel] The model that will power your agent.
         #
         #   @param speed [Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfig::Speed] Inference speed mode. `fast` provides significantly faster output token generati
 

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

@@ -5,8 +5,9 @@ module Anthropic
     module Beta
       class BetaManagedAgentsModelConfigParams < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   The model that will power your agent.\n\nSee
-        #   [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   The model that will power your agent.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         #   details and options.
         #
         #   @return [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel]
@@ -26,7 +27,7 @@ module Anthropic
         #
         #   An object that defines additional configuration control over model use
         #
-        #   @param id [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel] The model that will power your agent.\n\nSee [models](https://docs.anthropic.com
+        #   @param id [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel] The model that will power your agent.
         #
         #   @param speed [Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams::Speed, nil] Inference speed mode. `fast` provides significantly faster output token generati
 

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

@@ -87,8 +87,9 @@ module Anthropic
         required :diagnostics, -> { Anthropic::Beta::BetaDiagnostics }, nil?: true
 
         # @!attribute model
-        #   The model that will complete your prompt.\n\nSee
-        #   [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         #   details and options.
         #
         #   @return [Symbol, String, Anthropic::Models::Model]
@@ -179,7 +180,7 @@ module Anthropic
         #
         #   @param diagnostics [Anthropic::Models::Beta::BetaDiagnostics, nil] Response envelope for request-level diagnostics. Present (possibly
         #
-        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
+        #   @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.
         #

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

@@ -43,13 +43,24 @@ module Anthropic
         #   @return [Integer]
         required :output_tokens, Integer
 
+        # @!attribute output_tokens_details
+        #   Breakdown of output tokens by category.
+        #
+        #   `output_tokens` remains the inclusive, authoritative total used for billing.
+        #   This object provides a read-only decomposition for observability — for example,
+        #   how many of the billed output tokens were spent on internal reasoning that may
+        #   have been summarized before being returned to you.
+        #
+        #   @return [Anthropic::Models::Beta::BetaOutputTokensDetails, nil]
+        required :output_tokens_details, -> { Anthropic::Beta::BetaOutputTokensDetails }, nil?: true
+
         # @!attribute server_tool_use
         #   The number of server tool requests.
         #
         #   @return [Anthropic::Models::Beta::BetaServerToolUsage, nil]
         required :server_tool_use, -> { Anthropic::Beta::BetaServerToolUsage }, nil?: true
 
-        # @!method initialize(cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, iterations:, output_tokens:, server_tool_use:)
+        # @!method initialize(cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, iterations:, output_tokens:, output_tokens_details:, server_tool_use:)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaMessageDeltaUsage} for more details.
         #
@@ -63,6 +74,8 @@ module Anthropic
         #
         #   @param output_tokens [Integer] The cumulative number of output tokens which were used.
         #
+        #   @param output_tokens_details [Anthropic::Models::Beta::BetaOutputTokensDetails, nil] Breakdown of output tokens by category.
+        #
         #   @param server_tool_use [Anthropic::Models::Beta::BetaServerToolUsage, nil] The number of server tool requests.
       end
     end

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>]
+        #   @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::BetaMidConversationSystemBlockParam>]
         required :content, union: -> { Anthropic::Beta::BetaMessageParam::Content }
 
         # @!attribute role
@@ -15,7 +15,7 @@ module Anthropic
         required :role, enum: -> { Anthropic::Beta::BetaMessageParam::Role }
 
         # @!method initialize(content:, role:)
-        #   @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>]
+        #   @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::BetaMidConversationSystemBlockParam>]
         #   @param role [Symbol, Anthropic::Models::Beta::BetaMessageParam::Role]
 
         # @see Anthropic::Models::Beta::BetaMessageParam#content
@@ -27,7 +27,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>)]
+          #   @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::BetaMidConversationSystemBlockParam>)]
 
           # @type [Anthropic::Internal::Type::Converter]
           BetaContentBlockParamArray =
@@ -40,6 +40,7 @@ module Anthropic
 
           USER = :user
           ASSISTANT = :assistant
+          SYSTEM = :system
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMidConversationSystemBlockParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute content
+        #   System instruction text blocks.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaTextBlockParam>]
+        required :content, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaTextBlockParam] }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mid_conv_system]
+        required :type, const: :mid_conv_system
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!method initialize(content:, cache_control: nil, type: :mid_conv_system)
+        #   System instructions that appear mid-conversation.
+        #
+        #   Use this block to provide or update system-level instructions at a specific
+        #   point in the conversation, rather than only via the top-level `system`
+        #   parameter.
+        #
+        #   @param content [Array<Anthropic::Models::Beta::BetaTextBlockParam>] System instruction text blocks.
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param type [Symbol, :mid_conv_system]
+      end
+    end
+
+    BetaMidConversationSystemBlockParam = Beta::BetaMidConversationSystemBlockParam
+  end
+end

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaOutputTokensDetails < Anthropic::Internal::Type::BaseModel
+        # @!attribute thinking_tokens
+        #   Number of output tokens the model generated as internal reasoning, including the
+        #   thinking-block delimiter tokens.
+        #
+        #   Reflects the raw reasoning the model produced, not the (possibly shorter)
+        #   summarized thinking text returned in the response body. Computed by
+        #   re-tokenizing the raw reasoning text, so it may differ from the model's exact
+        #   generation count by a small number of tokens. Always ≤ `output_tokens`;
+        #   `output_tokens - thinking_tokens` approximates the non-reasoning output.
+        #
+        #   @return [Integer]
+        required :thinking_tokens, Integer
+
+        # @!method initialize(thinking_tokens:)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaOutputTokensDetails} for more details.
+        #
+        #   @param thinking_tokens [Integer] Number of output tokens the model generated as internal reasoning, including
+      end
+    end
+
+    BetaOutputTokensDetails = Beta::BetaOutputTokensDetails
+  end
+end

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

@@ -4,6 +4,19 @@ module Anthropic
   module Models
     module Beta
       class BetaThinkingDelta < Anthropic::Internal::Type::BaseModel
+        # @!attribute estimated_tokens
+        #   Per-frame increment of a coarse, running estimate of the tokens this thinking
+        #   block has produced so far. Present whenever the
+        #   `thinking-token-count-2026-05-13` beta is set; `null` unless `thinking.display`
+        #   resolves to `"omitted"` and a count is due this frame. Sum the increments across
+        #   `thinking_delta` frames on this block for a progress indicator. Each increment
+        #   is a non-negative multiple of a fixed quantum and the cadence is rate-limited,
+        #   so this is a deliberately lossy display hint, not a billable count;
+        #   `usage.output_tokens` remains authoritative.
+        #
+        #   @return [Integer, nil]
+        required :estimated_tokens, Integer, nil?: true
+
         # @!attribute thinking
         #
         #   @return [String]
@@ -14,8 +27,14 @@ module Anthropic
         #   @return [Symbol, :thinking_delta]
         required :type, const: :thinking_delta
 
-        # @!method initialize(thinking:, type: :thinking_delta)
+        # @!method initialize(estimated_tokens:, thinking:, type: :thinking_delta)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaThinkingDelta} for more details.
+        #
+        #   @param estimated_tokens [Integer, nil] Per-frame increment of a coarse, running estimate of the tokens this thinking bl
+        #
         #   @param thinking [String]
+        #
         #   @param type [Symbol, :thinking_delta]
       end
     end

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

@@ -55,6 +55,17 @@ module Anthropic
         #   @return [Integer]
         required :output_tokens, Integer
 
+        # @!attribute output_tokens_details
+        #   Breakdown of output tokens by category.
+        #
+        #   `output_tokens` remains the inclusive, authoritative total used for billing.
+        #   This object provides a read-only decomposition for observability — for example,
+        #   how many of the billed output tokens were spent on internal reasoning that may
+        #   have been summarized before being returned to you.
+        #
+        #   @return [Anthropic::Models::Beta::BetaOutputTokensDetails, nil]
+        required :output_tokens_details, -> { Anthropic::Beta::BetaOutputTokensDetails }, nil?: true
+
         # @!attribute server_tool_use
         #   The number of server tool requests.
         #
@@ -73,7 +84,7 @@ module Anthropic
         #   @return [Symbol, Anthropic::Models::Beta::BetaUsage::Speed, nil]
         required :speed, enum: -> { Anthropic::Beta::BetaUsage::Speed }, nil?: true
 
-        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, inference_geo:, input_tokens:, iterations:, output_tokens:, server_tool_use:, service_tier:, speed:)
+        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, inference_geo:, input_tokens:, iterations:, output_tokens:, output_tokens_details:, server_tool_use:, service_tier:, speed:)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaUsage} for more details.
         #
@@ -91,6 +102,8 @@ module Anthropic
         #
         #   @param output_tokens [Integer] The number of output tokens which were used.
         #
+        #   @param output_tokens_details [Anthropic::Models::Beta::BetaOutputTokensDetails, nil] Breakdown of output tokens by category.
+        #
         #   @param server_tool_use [Anthropic::Models::Beta::BetaServerToolUsage, nil] The number of server tool requests.
         #
         #   @param service_tier [Symbol, Anthropic::Models::Beta::BetaUsage::ServiceTier, nil] If the request used the priority, standard, or batch tier.

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

@@ -9,6 +9,7 @@ module Anthropic
         INVALID_TOOL_INPUT = :invalid_tool_input
         URL_TOO_LONG = :url_too_long
         URL_NOT_ALLOWED = :url_not_allowed
+        URL_NOT_IN_PRIOR_CONTEXT = :url_not_in_prior_context
         URL_NOT_ACCESSIBLE = :url_not_accessible
         UNSUPPORTED_CONTENT_TYPE = :unsupported_content_type
         TOO_MANY_REQUESTS = :too_many_requests

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

@@ -79,8 +79,9 @@ module Anthropic
         required :messages, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaMessageParam] }
 
         # @!attribute model
-        #   The model that will complete your prompt.\n\nSee
-        #   [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         #   details and options.
         #
         #   @return [Symbol, String, Anthropic::Models::Model]
@@ -258,7 +259,7 @@ module Anthropic
         #
         #   @param messages [Array<Anthropic::Models::Beta::BetaMessageParam>] Input messages.
         #
-        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
         #
         #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Top-level cache control automatically applies a cache_control marker to the last
         #