anthropic 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a48217d29048fbc0ea335a5b04b3bec6e8756d529231a8772e226d9680c18ed
-  data.tar.gz: a526e4b123b10883760189437147958f1bfdcf0fcedc7fe6087339ebd1f8e04c
+  metadata.gz: aa12265ad752f381a43cc10fd241f157049b40a092f8792f58c942d1d2523aeb
+  data.tar.gz: c3f5c151995f28bfca102ac4dca98e33c3f1144c6c2d9a20a864d092a1fb2304
 SHA512:
-  metadata.gz: 17a4deb6105e189cd657e4f90b71a984cf01aab50448deaf80ac6e73cff38c2f038d346e669fdd00d5b44fe99d2f412dcdbfcbf7b0974828d54de954cb267086
-  data.tar.gz: 7d01b98fc7ae9247cc3b6de9055ef7e4ce3ae5c8e613bb5c87caf8fdc063d93922ee7c8e284503a38803dcd5f3e0ac2076227276bcbf3dfb378b66cec75dc259
+  metadata.gz: b155c6a753280b3219a33514bec5698ea303fd35e9d37166ca8de2af27d0708468f2c944100684e3fe56b6415e24d9ad279e5f2c8a1abadcb5c3fc793fc5b94d
+  data.tar.gz: 3be747abe016c87882b22921c29704e3b2808e18a6aaec060388414cd209f8b5a610c81024807c419a2942e5a56bfe31026d6da2b4f34dec2043a9349e95166d

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.18.0 (2026-02-05)
+
+Full Changelog: [v1.17.0...v1.18.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.17.0...v1.18.0)
+
+### Features
+
+* **api:** manual updates ([53027e2](https://github.com/anthropics/anthropic-sdk-ruby/commit/53027e2d56db596ca8a42558d848ebd22075a854))
+
+
+### Bug Fixes
+
+* **client:** always add content-length to post body, even when empty ([359dcee](https://github.com/anthropics/anthropic-sdk-ruby/commit/359dcee68a26733fe1ee884a393aed88fd28b05b))
+
+
+### Chores
+
+* **ci:** remove claude-code-review workflow ([4d513ef](https://github.com/anthropics/anthropic-sdk-ruby/commit/4d513efcb8d074bd70efc4513bdcc5a0872e7171))
+* **docs:** remove www prefix ([306cdf9](https://github.com/anthropics/anthropic-sdk-ruby/commit/306cdf9962dba36b35a83eaaa7e5be166fc5a35f))
+
 ## 1.17.0 (2026-01-29)
 
 Full Changelog: [v1.16.3...v1.17.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.16.3...v1.17.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.17.0"
+gem "anthropic", "~> 1.18.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/anthropic/helpers/streaming/events.rb

@@ -76,6 +76,19 @@ module Anthropic
         required :signature, String
       end
 
+      class CompactionEvent < Anthropic::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :compaction]
+        required :type, const: :compaction
+
+        # @!attribute content
+        #   The compacted content summary.
+        #
+        #   @return [String, nil]
+        required :content, String, nil?: true
+      end
+
       class InputJsonEvent < Anthropic::Internal::Type::BaseModel
         # @!attribute type
         #

data/lib/anthropic/helpers/streaming/message_stream.rb

@@ -132,12 +132,18 @@ module Anthropic
               content.thinking += delta.thinking
             in Anthropic::Models::SignatureDelta | Anthropic::Models::BetaSignatureDelta if content.type == :thinking
               content.signature = delta.signature
+            in Anthropic::Models::BetaCompactionContentBlockDelta if content.type == :compaction
+              content.content = delta.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.usage.output_tokens = event.usage.output_tokens
+
+            if event.is_a?(Anthropic::Models::BetaRawMessageDeltaEvent) && !event.usage.iterations.nil?
+              current_snapshot.usage.iterations = event.usage.iterations
+            end
           else
           end
 
@@ -198,6 +204,11 @@ module Anthropic
                 type: :signature,
                 signature: content_block.signature
               )
+            in Anthropic::Models::BetaCompactionContentBlockDelta if content_block.type == :compaction
+              events_to_yield << Anthropic::Streaming::CompactionEvent.new(
+                type: :compaction,
+                content: content_block.content
+              )
             else
             end
           in Anthropic::Models::RawContentBlockStopEvent | Anthropic::Models::BetaRawContentBlockStopEvent

data/lib/anthropic/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module Anthropic
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = Anthropic::Internal::Util::ReadIOAdapter.new(body, &blk)

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

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaCompact20260112Edit < Anthropic::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :compact_20260112]
+        required :type, const: :compact_20260112
+
+        # @!attribute instructions
+        #   Additional instructions for summarization.
+        #
+        #   @return [String, nil]
+        optional :instructions, String, nil?: true
+
+        # @!attribute pause_after_compaction
+        #   Whether to pause after compaction and return the compaction block to the user.
+        #
+        #   @return [Boolean, nil]
+        optional :pause_after_compaction, Anthropic::Internal::Type::Boolean
+
+        # @!attribute trigger
+        #   When to trigger compaction. Defaults to 150000 input tokens.
+        #
+        #   @return [Anthropic::Models::Beta::BetaInputTokensTrigger, nil]
+        optional :trigger, -> { Anthropic::Beta::BetaInputTokensTrigger }, nil?: true
+
+        # @!method initialize(instructions: nil, pause_after_compaction: nil, trigger: nil, type: :compact_20260112)
+        #   Automatically compact older context when reaching the configured trigger
+        #   threshold.
+        #
+        #   @param instructions [String, nil] Additional instructions for summarization.
+        #
+        #   @param pause_after_compaction [Boolean] Whether to pause after compaction and return the compaction block to the user.
+        #
+        #   @param trigger [Anthropic::Models::Beta::BetaInputTokensTrigger, nil] When to trigger compaction. Defaults to 150000 input tokens.
+        #
+        #   @param type [Symbol, :compact_20260112]
+      end
+    end
+
+    BetaCompact20260112Edit = Beta::BetaCompact20260112Edit
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaCompactionBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute content
+        #   Summary of compacted content, or null if compaction failed
+        #
+        #   @return [String, nil]
+        required :content, String, nil?: true
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :compaction]
+        required :type, const: :compaction
+
+        # @!method initialize(content:, type: :compaction)
+        #   A compaction block returned when autocompact is triggered.
+        #
+        #   When content is None, it indicates the compaction failed to produce a valid
+        #   summary (e.g., malformed output from the model). Clients may round-trip
+        #   compaction blocks with null content; the server treats them as no-ops.
+        #
+        #   @param content [String, nil] Summary of compacted content, or null if compaction failed
+        #
+        #   @param type [Symbol, :compaction]
+      end
+    end
+
+    BetaCompactionBlock = Beta::BetaCompactionBlock
+  end
+end

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaCompactionBlockParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute content
+        #   Summary of previously compacted content, or null if compaction failed
+        #
+        #   @return [String, nil]
+        required :content, String, nil?: true
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :compaction]
+        required :type, const: :compaction
+
+        # @!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: :compaction)
+        #   A compaction block containing summary of previous context.
+        #
+        #   Users should round-trip these blocks from responses to subsequent requests to
+        #   maintain context across compaction boundaries.
+        #
+        #   When content is None, the block represents a failed compaction. The server
+        #   treats these as no-ops. Empty string content is not allowed.
+        #
+        #   @param content [String, nil] Summary of previously compacted content, or null if compaction failed
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param type [Symbol, :compaction]
+      end
+    end
+
+    BetaCompactionBlockParam = Beta::BetaCompactionBlockParam
+  end
+end

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaCompactionContentBlockDelta < Anthropic::Internal::Type::BaseModel
+        # @!attribute content
+        #
+        #   @return [String, nil]
+        required :content, String, nil?: true
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :compaction_delta]
+        required :type, const: :compaction_delta
+
+        # @!method initialize(content:, type: :compaction_delta)
+        #   @param content [String, nil]
+        #   @param type [Symbol, :compaction_delta]
+      end
+    end
+
+    BetaCompactionContentBlockDelta = Beta::BetaCompactionContentBlockDelta
+  end
+end

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaCompactionIterationUsage < Anthropic::Internal::Type::BaseModel
+        # @!attribute cache_creation
+        #   Breakdown of cached tokens by TTL
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheCreation, nil]
+        required :cache_creation, -> { Anthropic::Beta::BetaCacheCreation }, nil?: true
+
+        # @!attribute cache_creation_input_tokens
+        #   The number of input tokens used to create the cache entry.
+        #
+        #   @return [Integer]
+        required :cache_creation_input_tokens, Integer
+
+        # @!attribute cache_read_input_tokens
+        #   The number of input tokens read from the cache.
+        #
+        #   @return [Integer]
+        required :cache_read_input_tokens, Integer
+
+        # @!attribute input_tokens
+        #   The number of input tokens which were used.
+        #
+        #   @return [Integer]
+        required :input_tokens, Integer
+
+        # @!attribute output_tokens
+        #   The number of output tokens which were used.
+        #
+        #   @return [Integer]
+        required :output_tokens, Integer
+
+        # @!attribute type
+        #   Usage for a compaction iteration
+        #
+        #   @return [Symbol, :compaction]
+        required :type, const: :compaction
+
+        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, output_tokens:, type: :compaction)
+        #   Token usage for a compaction iteration.
+        #
+        #   @param cache_creation [Anthropic::Models::Beta::BetaCacheCreation, nil] Breakdown of cached tokens by TTL
+        #
+        #   @param cache_creation_input_tokens [Integer] The number of input tokens used to create the cache entry.
+        #
+        #   @param cache_read_input_tokens [Integer] The number of input tokens read from the cache.
+        #
+        #   @param input_tokens [Integer] The number of input tokens which were used.
+        #
+        #   @param output_tokens [Integer] The number of output tokens which were used.
+        #
+        #   @param type [Symbol, :compaction] Usage for a compaction iteration
+      end
+    end
+
+    BetaCompactionIterationUsage = Beta::BetaCompactionIterationUsage
+  end
+end

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

@@ -39,8 +39,15 @@ module Anthropic
         # Response model for a file uploaded to the container.
         variant :container_upload, -> { Anthropic::Beta::BetaContainerUploadBlock }
 
+        # A compaction block returned when autocompact is triggered.
+        #
+        # When content is None, it indicates the compaction failed to produce a valid
+        # summary (e.g., malformed output from the model). Clients may round-trip
+        # compaction blocks with null content; the server treats them as no-ops.
+        variant :compaction, -> { Anthropic::Beta::BetaCompactionBlock }
+
         # @!method self.variants
-        #   @return [Array(Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock)]
+        #   @return [Array(Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock)]
       end
     end
 

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

@@ -57,8 +57,17 @@ module Anthropic
         # Files uploaded via this block will be available in the container's input directory.
         variant :container_upload, -> { Anthropic::Beta::BetaContainerUploadBlockParam }
 
+        # A compaction block containing summary of previous context.
+        #
+        # Users should round-trip these blocks from responses to subsequent requests
+        # to maintain context across compaction boundaries.
+        #
+        # When content is None, the block represents a failed compaction. The server
+        # treats these as no-ops. Empty string content is not allowed.
+        variant :compaction, -> { Anthropic::Beta::BetaCompactionBlockParam }
+
         # @!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::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)]
+        #   @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::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)]
       end
     end
 

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

@@ -7,13 +7,15 @@ module Anthropic
         # @!attribute edits
         #   List of context management edits to apply
         #
-        #   @return [Array<Anthropic::Models::Beta::BetaClearToolUses20250919Edit, Anthropic::Models::Beta::BetaClearThinking20251015Edit>, nil]
+        #   @return [Array<Anthropic::Models::Beta::BetaClearToolUses20250919Edit, Anthropic::Models::Beta::BetaClearThinking20251015Edit, Anthropic::Models::Beta::BetaCompact20260112Edit>, nil]
         optional :edits,
                  -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaContextManagementConfig::Edit] }
 
         # @!method initialize(edits: nil)
-        #   @param edits [Array<Anthropic::Models::Beta::BetaClearToolUses20250919Edit, Anthropic::Models::Beta::BetaClearThinking20251015Edit>] List of context management edits to apply
+        #   @param edits [Array<Anthropic::Models::Beta::BetaClearToolUses20250919Edit, Anthropic::Models::Beta::BetaClearThinking20251015Edit, Anthropic::Models::Beta::BetaCompact20260112Edit>] List of context management edits to apply
 
+        # Automatically compact older context when reaching the configured trigger
+        # threshold.
         module Edit
           extend Anthropic::Internal::Type::Union
 
@@ -23,8 +25,11 @@ module Anthropic
 
           variant :clear_thinking_20251015, -> { Anthropic::Beta::BetaClearThinking20251015Edit }
 
+          # Automatically compact older context when reaching the configured trigger threshold.
+          variant :compact_20260112, -> { Anthropic::Beta::BetaCompact20260112Edit }
+
           # @!method self.variants
-          #   @return [Array(Anthropic::Models::Beta::BetaClearToolUses20250919Edit, Anthropic::Models::Beta::BetaClearThinking20251015Edit)]
+          #   @return [Array(Anthropic::Models::Beta::BetaClearToolUses20250919Edit, Anthropic::Models::Beta::BetaClearThinking20251015Edit, Anthropic::Models::Beta::BetaCompact20260112Edit)]
         end
       end
     end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # Token usage for a sampling iteration.
+      module BetaIterationsUsageItem
+        extend Anthropic::Internal::Type::Union
+
+        # Token usage for a sampling iteration.
+        variant -> { Anthropic::Beta::BetaMessageIterationUsage }
+
+        # Token usage for a compaction iteration.
+        variant -> { Anthropic::Beta::BetaCompactionIterationUsage }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage)]
+      end
+
+      # @type [Anthropic::Internal::Type::Converter]
+      BetaIterationsUsage =
+        Anthropic::Internal::Type::ArrayOf[union: -> { Anthropic::Beta::BetaIterationsUsageItem }]
+    end
+
+    # @type [Anthropic::Internal::Type::Converter]
+    BetaIterationsUsage = Beta::BetaIterationsUsage
+  end
+end

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

@@ -56,7 +56,7 @@ module Anthropic
         #   [{ "type": "text", "text": "B)" }]
         #   ```
         #
-        #   @return [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock>]
+        #   @return [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock>]
         required :content, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaContentBlock] }
 
         # parsed value of response when a JSON output schema object has been specified via :output_format
@@ -160,7 +160,7 @@ module Anthropic
         #
         #   @param container [Anthropic::Models::Beta::BetaContainer, nil] Information about the container used in the request (for the code execution tool
         #
-        #   @param content [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock>] Content generated by the model.
+        #   @param content [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock>] Content generated by the model.
         #
         #   @param context_management [Anthropic::Models::Beta::BetaContextManagementResponse, nil] Context management response.
         #

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

@@ -22,6 +22,21 @@ module Anthropic
         #   @return [Integer, nil]
         required :input_tokens, Integer, nil?: true
 
+        # @!attribute iterations
+        #   Per-iteration token usage breakdown.
+        #
+        #   Each entry represents one sampling iteration, with its own input/output token
+        #   counts and cache statistics. This allows you to:
+        #
+        #   - Determine which iterations exceeded long context thresholds (>=200k tokens)
+        #   - Calculate the true context window size from the last iteration
+        #   - Understand token accumulation across server-side tool use loops
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage>, nil]
+        required :iterations,
+                 -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaIterationsUsageItem] },
+                 nil?: true
+
         # @!attribute output_tokens
         #   The cumulative number of output tokens which were used.
         #
@@ -34,13 +49,18 @@ module Anthropic
         #   @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:, output_tokens:, server_tool_use:)
+        # @!method initialize(cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, iterations:, output_tokens:, server_tool_use:)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaMessageDeltaUsage} for more details.
+        #
         #   @param cache_creation_input_tokens [Integer, nil] The cumulative number of input tokens used to create the cache entry.
         #
         #   @param cache_read_input_tokens [Integer, nil] The cumulative number of input tokens read from the cache.
         #
         #   @param input_tokens [Integer, nil] The cumulative number of input tokens which were used.
         #
+        #   @param iterations [Array<Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage>, nil] Per-iteration token usage breakdown.
+        #
         #   @param output_tokens [Integer] The cumulative number of output tokens which were used.
         #
         #   @param server_tool_use [Anthropic::Models::Beta::BetaServerToolUsage, nil] The number of server tool requests.

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMessageIterationUsage < Anthropic::Internal::Type::BaseModel
+        # @!attribute cache_creation
+        #   Breakdown of cached tokens by TTL
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheCreation, nil]
+        required :cache_creation, -> { Anthropic::Beta::BetaCacheCreation }, nil?: true
+
+        # @!attribute cache_creation_input_tokens
+        #   The number of input tokens used to create the cache entry.
+        #
+        #   @return [Integer]
+        required :cache_creation_input_tokens, Integer
+
+        # @!attribute cache_read_input_tokens
+        #   The number of input tokens read from the cache.
+        #
+        #   @return [Integer]
+        required :cache_read_input_tokens, Integer
+
+        # @!attribute input_tokens
+        #   The number of input tokens which were used.
+        #
+        #   @return [Integer]
+        required :input_tokens, Integer
+
+        # @!attribute output_tokens
+        #   The number of output tokens which were used.
+        #
+        #   @return [Integer]
+        required :output_tokens, Integer
+
+        # @!attribute type
+        #   Usage for a sampling iteration
+        #
+        #   @return [Symbol, :message]
+        required :type, const: :message
+
+        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, output_tokens:, type: :message)
+        #   Token usage for a sampling iteration.
+        #
+        #   @param cache_creation [Anthropic::Models::Beta::BetaCacheCreation, nil] Breakdown of cached tokens by TTL
+        #
+        #   @param cache_creation_input_tokens [Integer] The number of input tokens used to create the cache entry.
+        #
+        #   @param cache_read_input_tokens [Integer] The number of input tokens read from the cache.
+        #
+        #   @param input_tokens [Integer] The number of input tokens which were used.
+        #
+        #   @param output_tokens [Integer] The number of output tokens which were used.
+        #
+        #   @param type [Symbol, :message] Usage for a sampling iteration
+      end
+    end
+
+    BetaMessageIterationUsage = Beta::BetaMessageIterationUsage
+  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::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>]
+        #   @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::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>]
         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::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>]
+        #   @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::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 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::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>)]
+          #   @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::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>)]
 
           # @type [Anthropic::Internal::Type::Converter]
           BetaContentBlockParamArray =

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

@@ -5,10 +5,7 @@ module Anthropic
     module Beta
       class BetaOutputConfig < Anthropic::Internal::Type::BaseModel
         # @!attribute effort
-        #   How much effort the model should put into its response. Higher effort levels may
-        #   result in more thorough analysis but take longer.
-        #
-        #   Valid values are `low`, `medium`, or `high`.
+        #   All possible effort levels.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaOutputConfig::Effort, nil]
         optional :effort, enum: -> { Anthropic::Beta::BetaOutputConfig::Effort }, nil?: true
@@ -24,14 +21,11 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaOutputConfig} for more details.
         #
-        #   @param effort [Symbol, Anthropic::Models::Beta::BetaOutputConfig::Effort, nil] How much effort the model should put into its response. Higher effort levels may
+        #   @param effort [Symbol, Anthropic::Models::Beta::BetaOutputConfig::Effort, nil] All possible effort levels.
         #
         #   @param format_ [Anthropic::Models::Beta::BetaJSONOutputFormat, nil] A schema to specify Claude's output format in responses. See [structured outputs
 
-        # How much effort the model should put into its response. Higher effort levels may
-        # result in more thorough analysis but take longer.
-        #
-        # Valid values are `low`, `medium`, or `high`.
+        # All possible effort levels.
         #
         # @see Anthropic::Models::Beta::BetaOutputConfig#effort
         module Effort
@@ -40,6 +34,7 @@ module Anthropic
           LOW = :low
           MEDIUM = :medium
           HIGH = :high
+          MAX = :max
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -18,8 +18,10 @@ module Anthropic
 
         variant :signature_delta, -> { Anthropic::Beta::BetaSignatureDelta }
 
+        variant :compaction_delta, -> { Anthropic::Beta::BetaCompactionContentBlockDelta }
+
         # @!method self.variants
-        #   @return [Array(Anthropic::Models::Beta::BetaTextDelta, Anthropic::Models::Beta::BetaInputJSONDelta, Anthropic::Models::Beta::BetaCitationsDelta, Anthropic::Models::Beta::BetaThinkingDelta, Anthropic::Models::Beta::BetaSignatureDelta)]
+        #   @return [Array(Anthropic::Models::Beta::BetaTextDelta, Anthropic::Models::Beta::BetaInputJSONDelta, Anthropic::Models::Beta::BetaCitationsDelta, Anthropic::Models::Beta::BetaThinkingDelta, Anthropic::Models::Beta::BetaSignatureDelta, Anthropic::Models::Beta::BetaCompactionContentBlockDelta)]
       end
     end