anthropic 0.4.1 → 1.1.0

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # Response model for a file uploaded to the container.
+      module BetaContentBlock
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        variant :text, -> { Anthropic::Beta::BetaTextBlock }
+
+        variant :tool_use, -> { Anthropic::Beta::BetaToolUseBlock }
+
+        variant :server_tool_use, -> { Anthropic::Beta::BetaServerToolUseBlock }
+
+        variant :web_search_tool_result, -> { Anthropic::Beta::BetaWebSearchToolResultBlock }
+
+        variant :code_execution_tool_result, -> { Anthropic::Beta::BetaCodeExecutionToolResultBlock }
+
+        variant :mcp_tool_use, -> { Anthropic::Beta::BetaMCPToolUseBlock }
+
+        variant :mcp_tool_result, -> { Anthropic::Beta::BetaMCPToolResultBlock }
+
+        # Response model for a file uploaded to the container.
+        variant :container_upload, -> { Anthropic::Beta::BetaContainerUploadBlock }
+
+        variant :thinking, -> { Anthropic::Beta::BetaThinkingBlock }
+
+        variant :redacted_thinking, -> { Anthropic::Beta::BetaRedactedThinkingBlock }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock)]
+      end
+    end
+
+    BetaContentBlock = Beta::BetaContentBlock
+  end
+end

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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # Regular text content.
+      module BetaContentBlockParam
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        variant :server_tool_use, -> { Anthropic::Beta::BetaServerToolUseBlockParam }
+
+        variant :web_search_tool_result, -> { Anthropic::Beta::BetaWebSearchToolResultBlockParam }
+
+        variant :code_execution_tool_result, -> { Anthropic::Beta::BetaCodeExecutionToolResultBlockParam }
+
+        variant :mcp_tool_use, -> { Anthropic::Beta::BetaMCPToolUseBlockParam }
+
+        variant :mcp_tool_result, -> { Anthropic::Beta::BetaRequestMCPToolResultBlockParam }
+
+        # Regular text content.
+        variant :text, -> { Anthropic::Beta::BetaTextBlockParam }
+
+        # Image content specified directly as base64 data or as a reference via a URL.
+        variant :image, -> { Anthropic::Beta::BetaImageBlockParam }
+
+        # A block indicating a tool use by the model.
+        variant :tool_use, -> { Anthropic::Beta::BetaToolUseBlockParam }
+
+        # A block specifying the results of a tool use by the model.
+        variant :tool_result, -> { Anthropic::Beta::BetaToolResultBlockParam }
+
+        # Document content, either specified directly as base64 data, as text, or as a reference via a URL.
+        variant :document, -> { Anthropic::Beta::BetaBase64PDFBlock }
+
+        # A block specifying internal thinking by the model.
+        variant :thinking, -> { Anthropic::Beta::BetaThinkingBlockParam }
+
+        # A block specifying internal, redacted thinking by the model.
+        variant :redacted_thinking, -> { Anthropic::Beta::BetaRedactedThinkingBlockParam }
+
+        # A content block that represents a file to be uploaded to the container
+        # Files uploaded via this block will be available in the container's input directory.
+        variant :container_upload, -> { Anthropic::Beta::BetaContainerUploadBlockParam }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaBase64PDFBlock, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam)]
+      end
+    end
+
+    BetaContentBlockParam = Beta::BetaContentBlockParam
+  end
+end

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

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaContentBlockSource < Anthropic::Internal::Type::BaseModel
+        # @!attribute content
+        #
+        #   @return [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam>]
+        required :content, union: -> { Anthropic::Beta::BetaContentBlockSource::Content }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :content]
+        required :type, const: :content
+
+        # @!method initialize(content:, type: :content)
+        #   @param content [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam>]
+        #   @param type [Symbol, :content]
+
+        # @see Anthropic::Models::Beta::BetaContentBlockSource#content
+        module Content
+          extend Anthropic::Internal::Type::Union
+
+          variant String
+
+          variant -> { Anthropic::Models::Beta::BetaContentBlockSource::Content::BetaContentBlockSourceContentArray }
+
+          # @!method self.variants
+          #   @return [Array(String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam>)]
+
+          # @type [Anthropic::Internal::Type::Converter]
+          BetaContentBlockSourceContentArray =
+            Anthropic::Internal::Type::ArrayOf[union: -> { Anthropic::Beta::BetaContentBlockSourceContent }]
+        end
+      end
+    end
+
+    BetaContentBlockSource = Beta::BetaContentBlockSource
+  end
+end

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module BetaContentBlockSourceContent
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        variant :text, -> { Anthropic::Beta::BetaTextBlockParam }
+
+        variant :image, -> { Anthropic::Beta::BetaImageBlockParam }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam)]
+      end
+    end
+
+    BetaContentBlockSourceContent = Beta::BetaContentBlockSourceContent
+  end
+end

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

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

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

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

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

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaImageBlockParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute source
+        #
+        #   @return [Anthropic::Models::Beta::BetaBase64ImageSource, Anthropic::Models::Beta::BetaURLImageSource, Anthropic::Models::Beta::BetaFileImageSource]
+        required :source, union: -> { Anthropic::Beta::BetaImageBlockParam::Source }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :image]
+        required :type, const: :image
+
+        # @!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(source:, cache_control: nil, type: :image)
+        #   @param source [Anthropic::Models::Beta::BetaBase64ImageSource, Anthropic::Models::Beta::BetaURLImageSource, Anthropic::Models::Beta::BetaFileImageSource]
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param type [Symbol, :image]
+
+        # @see Anthropic::Models::Beta::BetaImageBlockParam#source
+        module Source
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          variant :base64, -> { Anthropic::Beta::BetaBase64ImageSource }
+
+          variant :url, -> { Anthropic::Beta::BetaURLImageSource }
+
+          variant :file, -> { Anthropic::Beta::BetaFileImageSource }
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaBase64ImageSource, Anthropic::Models::Beta::BetaURLImageSource, Anthropic::Models::Beta::BetaFileImageSource)]
+        end
+      end
+    end
+
+    BetaImageBlockParam = Beta::BetaImageBlockParam
+  end
+end

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

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

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMCPToolResultBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute content
+        #
+        #   @return [String, Array<Anthropic::Models::Beta::BetaTextBlock>]
+        required :content, union: -> { Anthropic::Beta::BetaMCPToolResultBlock::Content }
+
+        # @!attribute is_error
+        #
+        #   @return [Boolean]
+        required :is_error, Anthropic::Internal::Type::Boolean
+
+        # @!attribute tool_use_id
+        #
+        #   @return [String]
+        required :tool_use_id, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mcp_tool_result]
+        required :type, const: :mcp_tool_result
+
+        # @!method initialize(content:, is_error:, tool_use_id:, type: :mcp_tool_result)
+        #   @param content [String, Array<Anthropic::Models::Beta::BetaTextBlock>]
+        #   @param is_error [Boolean]
+        #   @param tool_use_id [String]
+        #   @param type [Symbol, :mcp_tool_result]
+
+        # @see Anthropic::Models::Beta::BetaMCPToolResultBlock#content
+        module Content
+          extend Anthropic::Internal::Type::Union
+
+          variant String
+
+          variant -> { Anthropic::Models::Beta::BetaMCPToolResultBlock::Content::BetaTextBlockArray }
+
+          # @!method self.variants
+          #   @return [Array(String, Array<Anthropic::Models::Beta::BetaTextBlock>)]
+
+          # @type [Anthropic::Internal::Type::Converter]
+          BetaTextBlockArray = Anthropic::Internal::Type::ArrayOf[-> { Anthropic::Beta::BetaTextBlock }]
+        end
+      end
+    end
+
+    BetaMCPToolResultBlock = Beta::BetaMCPToolResultBlock
+  end
+end

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMCPToolUseBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute input
+        #
+        #   @return [Object]
+        required :input, Anthropic::Internal::Type::Unknown
+
+        # @!attribute name
+        #   The name of the MCP tool
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute server_name
+        #   The name of the MCP server
+        #
+        #   @return [String]
+        required :server_name, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mcp_tool_use]
+        required :type, const: :mcp_tool_use
+
+        # @!method initialize(id:, input:, name:, server_name:, type: :mcp_tool_use)
+        #   @param id [String]
+        #
+        #   @param input [Object]
+        #
+        #   @param name [String] The name of the MCP tool
+        #
+        #   @param server_name [String] The name of the MCP server
+        #
+        #   @param type [Symbol, :mcp_tool_use]
+      end
+    end
+
+    BetaMCPToolUseBlock = Beta::BetaMCPToolUseBlock
+  end
+end

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

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMCPToolUseBlockParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute input
+        #
+        #   @return [Object]
+        required :input, Anthropic::Internal::Type::Unknown
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute server_name
+        #   The name of the MCP server
+        #
+        #   @return [String]
+        required :server_name, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mcp_tool_use]
+        required :type, const: :mcp_tool_use
+
+        # @!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(id:, input:, name:, server_name:, cache_control: nil, type: :mcp_tool_use)
+        #   @param id [String]
+        #
+        #   @param input [Object]
+        #
+        #   @param name [String]
+        #
+        #   @param server_name [String] The name of the MCP server
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param type [Symbol, :mcp_tool_use]
+      end
+    end
+
+    BetaMCPToolUseBlockParam = Beta::BetaMCPToolUseBlockParam
+  end
+end

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

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # @see Anthropic::Resources::Beta::Messages#create
+      #
+      # @see Anthropic::Resources::Beta::Messages#stream_raw
+      class BetaMessage < Anthropic::Internal::Type::BaseModel
+        # @!attribute id
+        #   Unique object identifier.
+        #
+        #   The format and length of IDs may change over time.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute container
+        #   Information about the container used in the request (for the code execution
+        #   tool)
+        #
+        #   @return [Anthropic::Models::Beta::BetaContainer, nil]
+        required :container, -> { Anthropic::Beta::BetaContainer }, nil?: true
+
+        # @!attribute content
+        #   Content generated by the model.
+        #
+        #   This is an array of content blocks, each of which has a `type` that determines
+        #   its shape.
+        #
+        #   Example:
+        #
+        #   ```json
+        #   [{ "type": "text", "text": "Hi, I'm Claude." }]
+        #   ```
+        #
+        #   If the request input `messages` ended with an `assistant` turn, then the
+        #   response `content` will continue directly from that last turn. You can use this
+        #   to constrain the model's output.
+        #
+        #   For example, if the input `messages` were:
+        #
+        #   ```json
+        #   [
+        #     {
+        #       "role": "user",
+        #       "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"
+        #     },
+        #     { "role": "assistant", "content": "The best answer is (" }
+        #   ]
+        #   ```
+        #
+        #   Then the response `content` might be:
+        #
+        #   ```json
+        #   [{ "type": "text", "text": "B)" }]
+        #   ```
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock>]
+        required :content, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaContentBlock] }
+
+        # @!attribute model
+        #   The model that will complete your prompt.\n\nSee
+        #   [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   details and options.
+        #
+        #   @return [Symbol, String, Anthropic::Models::Model]
+        required :model, union: -> { Anthropic::Model }
+
+        # @!attribute role
+        #   Conversational role of the generated message.
+        #
+        #   This will always be `"assistant"`.
+        #
+        #   @return [Symbol, :assistant]
+        required :role, const: :assistant
+
+        # @!attribute stop_reason
+        #   The reason that we stopped.
+        #
+        #   This may be one the following values:
+        #
+        #   - `"end_turn"`: the model reached a natural stopping point
+        #   - `"max_tokens"`: we exceeded the requested `max_tokens` or the model's maximum
+        #   - `"stop_sequence"`: one of your provided custom `stop_sequences` was generated
+        #   - `"tool_use"`: the model invoked one or more tools
+        #
+        #   In non-streaming mode this value is always non-null. In streaming mode, it is
+        #   null in the `message_start` event and non-null otherwise.
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaStopReason, nil]
+        required :stop_reason, enum: -> { Anthropic::Beta::BetaStopReason }, nil?: true
+
+        # @!attribute stop_sequence
+        #   Which custom stop sequence was generated, if any.
+        #
+        #   This value will be a non-null string if one of your custom stop sequences was
+        #   generated.
+        #
+        #   @return [String, nil]
+        required :stop_sequence, String, nil?: true
+
+        # @!attribute type
+        #   Object type.
+        #
+        #   For Messages, this is always `"message"`.
+        #
+        #   @return [Symbol, :message]
+        required :type, const: :message
+
+        # @!attribute usage
+        #   Billing and rate-limit usage.
+        #
+        #   Anthropic's API bills and rate-limits by token counts, as tokens represent the
+        #   underlying cost to our systems.
+        #
+        #   Under the hood, the API transforms requests into a format suitable for the
+        #   model. The model's output then goes through a parsing stage before becoming an
+        #   API response. As a result, the token counts in `usage` will not match one-to-one
+        #   with the exact visible content of an API request or response.
+        #
+        #   For example, `output_tokens` will be non-zero, even for an empty string response
+        #   from Claude.
+        #
+        #   Total input tokens in a request is the summation of `input_tokens`,
+        #   `cache_creation_input_tokens`, and `cache_read_input_tokens`.
+        #
+        #   @return [Anthropic::Models::Beta::BetaUsage]
+        required :usage, -> { Anthropic::Beta::BetaUsage }
+
+        # @!method initialize(id:, container:, content:, model:, stop_reason:, stop_sequence:, usage:, role: :assistant, type: :message)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaMessage} for more details.
+        #
+        #   @param id [String] Unique object identifier.
+        #
+        #   @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::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock>] Content generated by the model.
+        #
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
+        #
+        #   @param stop_reason [Symbol, Anthropic::Models::Beta::BetaStopReason, nil] The reason that we stopped.
+        #
+        #   @param stop_sequence [String, nil] Which custom stop sequence was generated, if any.
+        #
+        #   @param usage [Anthropic::Models::Beta::BetaUsage] Billing and rate-limit usage.
+        #
+        #   @param role [Symbol, :assistant] Conversational role of the generated message.
+        #
+        #   @param type [Symbol, :message] Object type.
+      end
+    end
+
+    BetaMessage = Beta::BetaMessage
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaMessageDeltaUsage < Anthropic::Internal::Type::BaseModel
+        # @!attribute cache_creation_input_tokens
+        #   The cumulative number of input tokens used to create the cache entry.
+        #
+        #   @return [Integer, nil]
+        required :cache_creation_input_tokens, Integer, nil?: true
+
+        # @!attribute cache_read_input_tokens
+        #   The cumulative number of input tokens read from the cache.
+        #
+        #   @return [Integer, nil]
+        required :cache_read_input_tokens, Integer, nil?: true
+
+        # @!attribute input_tokens
+        #   The cumulative number of input tokens which were used.
+        #
+        #   @return [Integer, nil]
+        required :input_tokens, Integer, nil?: true
+
+        # @!attribute output_tokens
+        #   The cumulative number of output tokens which were used.
+        #
+        #   @return [Integer]
+        required :output_tokens, Integer
+
+        # @!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:, output_tokens:, server_tool_use:)
+        #   @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 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.
+      end
+    end
+
+    BetaMessageDeltaUsage = Beta::BetaMessageDeltaUsage
+  end
+end