anthropic 1.43.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4142618ad3822029520091b516413cf32261636cfeff2ea03f1d33e6342cee42
-  data.tar.gz: 86a9ff08d3ee65673f329261c436c7163b471aa0eebb33bb8d36a983bd959f82
+  metadata.gz: 8e459430d4274990ec5b16c71b6e8ceb9f8fb7ea7b598a0743b1395751f70a04
+  data.tar.gz: ca0766ef57242877ab67638e9c83c3511864e1fd99350fa100d3d095db0290d6
 SHA512:
-  metadata.gz: eeba6340d54d9d463d49723772cbb43b142b2835356d7719c53c41b56f73cf63d1784d71ee07337b1b43522609492ef5810ed0e48712b5f4649079d939fdd19b
-  data.tar.gz: 2a3bdb6b07367dbbf419d43b867920b7996544f7b7786eb4366913c5654c044ffb79d1e2a40dcd3a7cd69a37fbaea3bcb78aa2f74f701569b14633cc49470ae0
+  metadata.gz: 56c89b576946c7d3dc4544b96230be1602d4cbb58b72249065dd16f6bc2ec19077bbb7c87a6d5483a9f6642b6bae5b672aab9717efbeaebcf05878941c96f413
+  data.tar.gz: dab9b9b13abdb2b18049fe2549cad38d426e7616239c5d96245658ed3f05c6c14c15d13c2efac466424e77c744bd7fbece4ea9daf63ebdcdd00f5982591834e1

data/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 1.45.0 (2026-06-05)
+
+Full Changelog: [v1.44.0...v1.45.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.44.0...v1.45.0)
+
+### Features
+
+* **api:** mark Claude Opus 4.1 as deprecated ([ccc292f](https://github.com/anthropics/anthropic-sdk-ruby/commit/ccc292f10ffb2c825f5b34c8372e7d6803ebc83d))
+
+
+### Bug Fixes
+
+* **streaming:** carry encrypted_content through beta compaction accumulator ([#938](https://github.com/anthropics/anthropic-sdk-ruby/issues/938)) ([6bd298f](https://github.com/anthropics/anthropic-sdk-ruby/commit/6bd298fa4421192fdc74ee99462d94ec01a514d3))
+* **streaming:** carry stop_details and full usage through message_delta ([#940](https://github.com/anthropics/anthropic-sdk-ruby/issues/940)) ([ef4d2ea](https://github.com/anthropics/anthropic-sdk-ruby/commit/ef4d2ea31c0e566d7ad387419ba7d6144bf06861))
+
+
+### Chores
+
+* **internal:** codegen related update ([296d6a4](https://github.com/anthropics/anthropic-sdk-ruby/commit/296d6a47ec96c36cf7a924bd74aa752d2d2ff125))
+* **internal:** fix artifact url ([a97bd1e](https://github.com/anthropics/anthropic-sdk-ruby/commit/a97bd1e6fa5094057d2967d1b0573eec6602e026))
+* **internal:** fix branch names ([16564d3](https://github.com/anthropics/anthropic-sdk-ruby/commit/16564d3806d4cb70000fe374c6ccf399e8903ba8))
+* **internal:** update staging repo ([3f6005b](https://github.com/anthropics/anthropic-sdk-ruby/commit/3f6005b00242d66f711c31a4e51973576745aaee))
+
+
+### Documentation
+
+* point security reports to Anthropic's HackerOne program ([#6](https://github.com/anthropics/anthropic-sdk-ruby/issues/6)) ([2d0f2af](https://github.com/anthropics/anthropic-sdk-ruby/commit/2d0f2af04956b58976aaf783b6ce24a4271c15ab))
+
+## 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)

data/README.md

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

data/SECURITY.md

@@ -1,27 +1,15 @@
 # Security Policy
 
-## Reporting Security Issues
-
-This SDK is generated by [Stainless Software Inc](http://stainless.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
-
-To report a security issue, please contact the Stainless team at security@stainless.com.
-
-## Responsible Disclosure
-
-We appreciate the efforts of security researchers and individuals who help us maintain the security of
-SDKs we generate. If you believe you have found a security vulnerability, please adhere to responsible
-disclosure practices by allowing us a reasonable amount of time to investigate and address the issue
-before making any information public.
+Thank you for helping us keep the SDKs and systems they interact with secure.
 
-## Reporting Non-SDK Related Security Issues
+## Reporting Security Issues
 
-If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Anthropic, please follow the respective company's security reporting guidelines.
+This SDK is maintained by [Anthropic](https://www.anthropic.com/).
 
-### Anthropic Terms and Policies
+The security of our systems and user data is Anthropic’s top priority. We appreciate the work of security researchers acting in good faith in identifying and reporting potential vulnerabilities.
 
-Please contact support@anthropic.com for any questions or concerns regarding the security of our services.
+Our security program is managed on HackerOne and we ask that any validated vulnerability in this functionality be reported through their [submission form](https://hackerone.com/4f1f16ba-10d3-4d09-9ecc-c721aad90f24/embedded_submissions/new).
 
----
+## Anthropic Bug Bounty
 
-Thank you for helping us keep the SDKs and systems they interact with secure.
+Our Bug Bounty Program Guidelines are defined on our [HackerOne program page](https://hackerone.com/anthropic).

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/helpers/streaming/message_stream.rb

@@ -134,13 +134,31 @@ module Anthropic
               content.signature = delta.signature
             in Anthropic::Models::BetaCompactionContentBlockDelta if content.type == :compaction
               content.content = delta.content
+              content.encrypted_content = delta.encrypted_content
             else
             end
           in Anthropic::Models::RawMessageDeltaEvent | Anthropic::Models::BetaRawMessageDeltaEvent
             current_snapshot.stop_reason = event.delta.stop_reason
             current_snapshot.stop_sequence = event.delta.stop_sequence
+            current_snapshot.stop_details = event.delta.stop_details unless event.delta.stop_details.nil?
             current_snapshot.usage.output_tokens = event.usage.output_tokens
 
+            # The message_delta usage is authoritative for the final counts; carry every
+            # field the event reports (only when present, so we never clobber the
+            # message_start values with nils).
+            unless event.usage.input_tokens.nil?
+              current_snapshot.usage.input_tokens = event.usage.input_tokens
+            end
+            unless event.usage.cache_creation_input_tokens.nil?
+              current_snapshot.usage.cache_creation_input_tokens = event.usage.cache_creation_input_tokens
+            end
+            unless event.usage.cache_read_input_tokens.nil?
+              current_snapshot.usage.cache_read_input_tokens = event.usage.cache_read_input_tokens
+            end
+            unless event.usage.server_tool_use.nil?
+              current_snapshot.usage.server_tool_use = event.usage.server_tool_use
+            end
+
             if event.is_a?(Anthropic::Models::BetaRawMessageDeltaEvent) && !event.usage.iterations.nil?
               current_snapshot.usage.iterations = event.usage.iterations
             end

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/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