anthropic 1.16.3 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed35d862c36fcf182d10e3564e1e8b3033d28d50cc41722cecad9f5cefe04485
-  data.tar.gz: ecd043c34b77294b695b30a6c4b18ea202ab0a395ee71f60c19bbfefe1c2e820
+  metadata.gz: aa12265ad752f381a43cc10fd241f157049b40a092f8792f58c942d1d2523aeb
+  data.tar.gz: c3f5c151995f28bfca102ac4dca98e33c3f1144c6c2d9a20a864d092a1fb2304
 SHA512:
-  metadata.gz: 4d1d6c091b2c84079ff5ef5eb101aec169b3c39ca85a451d1ec0825bed474d8cdc7a2910f9244311e49c2064917969c3fae3e03d75f825fc8831a64d0a849ed4
-  data.tar.gz: 51e4e737cc87f636e52394ff615cbf563cd225031840add3fe05e01855a942735de1f51ed488ba25d2ff9a532e23b0c267972abe91021ab53aa2666ec3eb1600
+  metadata.gz: b155c6a753280b3219a33514bec5698ea303fd35e9d37166ca8de2af27d0708468f2c944100684e3fe56b6415e24d9ad279e5f2c8a1abadcb5c3fc793fc5b94d
+  data.tar.gz: 3be747abe016c87882b22921c29704e3b2808e18a6aaec060388414cd209f8b5a610c81024807c419a2942e5a56bfe31026d6da2b4f34dec2043a9349e95166d

data/CHANGELOG.md

@@ -1,5 +1,42 @@
 # 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)
+
+### Features
+
+* **api:** add support for Structured Outputs in the Messages API ([06e1fd9](https://github.com/anthropics/anthropic-sdk-ruby/commit/06e1fd93f073462f887a933af1dbca17138980c7))
+* **api:** migrate sending message format in output_config rather than output_format ([13ac36e](https://github.com/anthropics/anthropic-sdk-ruby/commit/13ac36e97e8898d46b802c540b7dba7272247108))
+* **client:** migrate output config ([#784](https://github.com/anthropics/anthropic-sdk-ruby/issues/784)) ([d055b2b](https://github.com/anthropics/anthropic-sdk-ruby/commit/d055b2b172ad951cf6b20bea709c8bd3b4f345c6))
+
+
+### Chores
+
+* add cgi gem as explicit dependency ([b9ef072](https://github.com/anthropics/anthropic-sdk-ruby/commit/b9ef072be4d8ecd4f12e90403183b0ced5cb360f))
+* **client:** mark claude-3-5-haiku as deprecated ([2ed73fd](https://github.com/anthropics/anthropic-sdk-ruby/commit/2ed73fde07fa480ff55d67b47442deebb76bc1e5))
+* **internal:** update `actions/checkout` version ([2f82126](https://github.com/anthropics/anthropic-sdk-ruby/commit/2f8212603e7a6b7a96afaa3cfd19a55a0853f49c))
+* **internal:** use different example values for some enums ([13d8b68](https://github.com/anthropics/anthropic-sdk-ruby/commit/13d8b68d290c11497faed22e2eda1778187bf2ec))
+
 ## 1.16.3 (2026-01-05)
 
 Full Changelog: [v1.16.2...v1.16.3](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.16.2...v1.16.3)

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.16.3"
+gem "anthropic", "~> 1.18.0"
 ```
 
 <!-- x-release-please-end -->
@@ -39,7 +39,7 @@ anthropic = Anthropic::Client.new(
 message = anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-opus-4-5-20251101"
+  model: "claude-sonnet-4-5-20250929"
 )
 
 puts(message.content)
@@ -53,7 +53,7 @@ We provide support for streaming responses using Server-Sent Events (SSE).
 stream = anthropic.messages.stream(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-opus-4-5-20251101"
+  model: "claude-sonnet-4-5-20250929"
 )
 
 stream.each do |message|
@@ -109,6 +109,34 @@ client.beta.messages.tool_runner(
 ).each_message { puts _1.content }
 ```
 
+### Structured Outputs
+
+Constrain Claude's responses to follow a specific JSON schema using the `output_config` parameter:
+
+```ruby
+class FamousNumber < Anthropic::BaseModel
+  required :value, Float
+  optional :reason, String, doc: "why is this number mathematically significant?"
+end
+
+class Output < Anthropic::BaseModel
+  required :numbers, Anthropic::ArrayOf[FamousNumber], min_length: 3, max_length: 5
+end
+
+message = anthropic.messages.create(
+  model: "claude-sonnet-4-5-20250929",
+  max_tokens: 1024,
+  messages: [{role: "user", content: "give me some famous numbers"}],
+  output_config: {format: Output}
+)
+
+# Access the parsed response
+message.parsed_output
+# => #<Output numbers=[#<FamousNumber value=3.14159... reason="Pi is...">...]>
+```
+
+For streaming and more examples, see [helpers.md](helpers.md#structured-outputs).
+
 ### Pagination
 
 List methods in the Anthropic API are paginated.
@@ -168,7 +196,7 @@ begin
   message = anthropic.messages.create(
     max_tokens: 1024,
     messages: [{role: "user", content: "Hello, Claude"}],
-    model: :"claude-opus-4-5-20251101"
+    model: "claude-sonnet-4-5-20250929"
   )
 rescue Anthropic::Errors::APIConnectionError => e
   puts("The server could not be reached")
@@ -215,7 +243,7 @@ anthropic = Anthropic::Client.new(
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-opus-4-5-20251101",
+  model: "claude-sonnet-4-5-20250929",
   request_options: {max_retries: 5}
 )
 ```
@@ -234,7 +262,7 @@ anthropic = Anthropic::Client.new(
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-opus-4-5-20251101",
+  model: "claude-sonnet-4-5-20250929",
   request_options: {timeout: 5}
 )
 ```
@@ -330,7 +358,7 @@ message =
   anthropic.messages.create(
     max_tokens: 1024,
     messages: [{role: "user", content: "Hello, Claude"}],
-    model: :"claude-opus-4-5-20251101",
+    model: "claude-sonnet-4-5-20250929",
     request_options: {
       extra_query: {my_query_parameter: value},
       extra_body: {my_body_parameter: value},
@@ -379,7 +407,7 @@ You can provide typesafe request parameters like so:
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [Anthropic::MessageParam.new(role: "user", content: "Hello, Claude")],
-  model: :"claude-opus-4-5-20251101"
+  model: "claude-sonnet-4-5-20250929"
 )
 ```
 
@@ -390,14 +418,14 @@ Or, equivalently:
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-opus-4-5-20251101"
+  model: "claude-sonnet-4-5-20250929"
 )
 
 # You can also splat a full Params class:
 params = Anthropic::MessageCreateParams.new(
   max_tokens: 1024,
   messages: [Anthropic::MessageParam.new(role: "user", content: "Hello, Claude")],
-  model: :"claude-opus-4-5-20251101"
+  model: "claude-sonnet-4-5-20250929"
 )
 anthropic.messages.create(**params)
 ```

data/lib/anthropic/helpers/messages.rb

@@ -13,11 +13,26 @@ module Anthropic
         #
         # @param strict [Boolean, nil]
         #
+        # @param is_beta [Boolean]
+        #
         # @return [Hash{String=>Class}, Hash{String=>Class}]
-        def distill_input_schema_models!(data, strict:)
+        def distill_input_schema_models!(data, strict:, is_beta: false)
           tools = {}
           models = {}
 
+          # Check for invalid output_config type before pattern matching
+          if data.key?(:output_config) && !data[:output_config].is_a?(Hash)
+            raise ArgumentError,
+                  "output_config must be a Hash, got #{data[:output_config].class}"
+          end
+
+          # Check for conflicting output_format and output_config[:format] before pattern matching
+          if data.key?(:output_format) && data.dig(:output_config, :format)
+            raise ArgumentError,
+                  "Both output_format and output_config[:format] were provided. " \
+                  "Please use only output_config[:format] (output_format is deprecated)."
+          end
+
           case data
           in {tools: Array => tool_array}
             mapped = tool_array.map do |tool|
@@ -54,12 +69,38 @@ module Anthropic
               end
             end
             tool_array.replace(mapped)
+          # GA: output_config with BaseModel class as format
+          in {output_config: {format: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model} => output_config}
+            name = model_name(model.name)
+            models.store(name, model)
+            schema = model.to_json_schema
+            Anthropic::Helpers::InputSchema::SupportedSchemas.transform_schema!(schema)
+            output_config.update(format: {type: :json_schema, schema:})
+            inject_structured_output_beta_header!(data) if is_beta
+          # GA: output_config.format.schema as BaseModel class
+          in {output_config: {format: {schema: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model} => format_} => _output_config}
+            name = model_name(model.name)
+            models.store(name, model)
+            schema = model.to_json_schema
+            Anthropic::Helpers::InputSchema::SupportedSchemas.transform_schema!(schema)
+            format_.update(type: :json_schema, schema:)
+            inject_structured_output_beta_header!(data) if is_beta
+          # Beta: output_format as BaseModel class (deprecated)
           in {output_format: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model}
+            transform_output_format_to_output_config!(data, model:, models:, is_beta:)
+          # rubocop:disable Lint/DuplicateBranch
+          in {output_format: {schema: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model}}
+            # This branch handles output_format: {schema: Model} vs output_format: Model above
+            transform_output_format_to_output_config!(data, model:, models:, is_beta:)
+          # rubocop:enable Lint/DuplicateBranch
+          in {output_config: {format: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model}}
+            # New API: output_config.format with model class
             name = model_name(model.name)
             models.store(name, model)
             schema = model.to_json_schema
             Anthropic::Helpers::InputSchema::SupportedSchemas.transform_schema!(schema)
             data.update(output_format: {type: :json_schema, schema: schema})
+          # Beta: output_format.schema as BaseModel class (deprecated)
           in {output_format: {schema: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model} => output_format}
             name = model_name(model.name)
             models.store(name, model)
@@ -108,6 +149,50 @@ module Anthropic
           raw
         end
 
+        # @api private
+        #
+        # Transform deprecated output_format to output_config.format
+        #
+        # @param data [Hash{Symbol=>Object}]
+        # @param model [Class]
+        # @param models [Hash{String=>Class}]
+        # @param is_beta [Boolean]
+        private def transform_output_format_to_output_config!(data, model:, models:, is_beta:)
+          warn(
+            "[DEPRECATION] output_format is deprecated. Use output_config[:format] instead.",
+            category: :deprecated
+          )
+          # Error if output_config exists but is not a hash
+          if data.key?(:output_config) && !data[:output_config].is_a?(Hash)
+            raise ArgumentError,
+                  "output_config must be a Hash, got #{data[:output_config].class}"
+          end
+          # Error if both params are provided
+          if data&.dig(:output_config, :format)
+            raise ArgumentError,
+                  "Both output_format and output_config[:format] were provided. " \
+                  "Please use only output_config[:format] (output_format is deprecated)."
+          end
+          name = model_name(model.name)
+          models.store(name, model)
+          schema = model.to_json_schema
+          Anthropic::Helpers::InputSchema::SupportedSchemas.transform_schema!(schema)
+          output_config = data[:output_config].to_h
+          output_config.store(:format, type: :json_schema, schema: schema)
+          data.delete(:output_format)
+          data[:output_config] = output_config
+          inject_structured_output_beta_header!(data) if is_beta
+        end
+
+        # @api private
+        #
+        # Inject the structured outputs beta header into the request data
+        #
+        # @param data [Hash{Symbol=>Object}]
+        private def inject_structured_output_beta_header!(data)
+          data[:betas] = data[:betas].to_a.dup.push("structured-outputs-2025-12-15").uniq
+        end
+
         # @api private
         #
         # @param classname [String]

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

@@ -63,7 +63,7 @@ module Anthropic
         # @return [Anthropic::Models::Message, Anthropic::Models::Beta::BetaMessage]
         def accumulated_message
           until_done
-          parse_tool_uses!(@accumated_message_snapshot)
+          parse_content_blocks!(@accumated_message_snapshot)
           @accumated_message_snapshot
         end
 
@@ -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
@@ -217,47 +228,72 @@ module Anthropic
 
         # @api private
         #
-        # Parse tool use blocks in the message using the provided tool models.
+        # Parse tool use blocks and text blocks with structured output in the message.
         #
         # @param message [Anthropic::Models::Message] The message to parse
         #
-        # @return [Anthropic::Models::Message] The message with parsed tool uses
-        private def parse_tool_uses!(message)
+        # @return [Anthropic::Models::Message] The message with parsed content
+        private def parse_content_blocks!(message)
           return message unless message&.content
 
           # rubocop:disable Metrics/BlockLength
           message.content.each_with_index do |content, index|
-            next unless content.type == :tool_use
+            case content.type
+            when :tool_use
+              next unless (tool = @tools[content.name])
 
-            next unless (tool = @tools[content.name])
+              parsed =
+                begin
+                  parsed_input = if content.input.is_a?(String)
+                    JSON.parse(content.input, symbolize_names: true)
+                  else
+                    content.input
+                  end
 
-            parsed =
-              begin
-                parsed_input = if content.input.is_a?(String)
-                  JSON.parse(content.input, symbolize_names: true)
+                  Anthropic::Internal::Type::Converter.coerce(tool, parsed_input)
+                rescue StandardError => e
+                  e
+                end
+
+              cls =
+                case content
+                in Anthropic::ContentBlock
+                  Anthropic::Models::ToolUseBlock
                 else
-                  content.input
+                  Anthropic::Models::BetaToolUseBlock
                 end
+              message.content[index] = cls.new(
+                id: content.id,
+                input: content.input,
+                name: content.name,
+                type: content.type,
+                parsed: parsed
+              )
+            when :text
+              next unless (model = @models.first&.last)
 
-                Anthropic::Internal::Type::Converter.coerce(tool, parsed_input)
-              rescue StandardError => e
-                e
-              end
+              parsed =
+                begin
+                  json = JSON.parse(content.text, symbolize_names: true)
+                  Anthropic::Internal::Type::Converter.coerce(model, json)
+                rescue StandardError => e
+                  {error: e.message}
+                end
 
-            cls =
-              case content
-              in Anthropic::ContentBlock
-                Anthropic::Models::ToolUseBlock
-              else
-                Anthropic::Models::BetaToolUseBlock
-              end
-            message.content[index] = cls.new(
-              id: content.id,
-              input: content.input,
-              name: content.name,
-              type: content.type,
-              parsed: parsed
-            )
+              cls =
+                case content
+                in Anthropic::ContentBlock
+                  Anthropic::Models::TextBlock
+                else
+                  Anthropic::Models::BetaTextBlock
+                end
+              message.content[index] = cls.new(
+                citations: content.citations,
+                text: content.text,
+                type: content.type,
+                parsed: parsed
+              )
+            end
           end
           # rubocop:enable Metrics/BlockLength
 

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_code_execution_tool_20250522.rb

@@ -37,6 +37,7 @@ module Anthropic
         optional :defer_loading, Anthropic::Internal::Type::Boolean
 
         # @!attribute strict
+        #   When true, guarantees schema validation on tool names and inputs
         #
         #   @return [Boolean, nil]
         optional :strict, Anthropic::Internal::Type::Boolean
@@ -51,7 +52,7 @@ module Anthropic
         #
         #   @param defer_loading [Boolean] If true, tool will not be included in initial system prompt. Only loaded when re
         #
-        #   @param strict [Boolean]
+        #   @param strict [Boolean] When true, guarantees schema validation on tool names and inputs
         #
         #   @param name [Symbol, :code_execution] Name of the tool.
         #

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

@@ -37,6 +37,7 @@ module Anthropic
         optional :defer_loading, Anthropic::Internal::Type::Boolean
 
         # @!attribute strict
+        #   When true, guarantees schema validation on tool names and inputs
         #
         #   @return [Boolean, nil]
         optional :strict, Anthropic::Internal::Type::Boolean
@@ -51,7 +52,7 @@ module Anthropic
         #
         #   @param defer_loading [Boolean] If true, tool will not be included in initial system prompt. Only loaded when re
         #
-        #   @param strict [Boolean]
+        #   @param strict [Boolean] When true, guarantees schema validation on tool names and inputs
         #
         #   @param name [Symbol, :code_execution] Name of the tool.
         #

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