anthropic-sdk-beta 0.1.0.pre.beta.6 → 0.1.0.pre.beta.7

data/lib/anthropic/models/tool.rb

@@ -9,23 +9,24 @@ module Anthropic
       #   This defines the shape of the `input` that your tool accepts and that the model
       #   will produce.
       #
-      #   @return [Anthropic::Models::Tool::InputSchema]
-      required :input_schema, -> { Anthropic::Models::Tool::InputSchema }
+      #   @return [Anthropic::Tool::InputSchema]
+      required :input_schema, -> { Anthropic::Tool::InputSchema }
 
       # @!attribute name
       #   Name of the tool.
       #
-      #   This is how the tool will be called by the model and in tool_use blocks.
+      #   This is how the tool will be called by the model and in `tool_use` blocks.
       #
       #   @return [String]
       required :name, String
 
       # @!attribute cache_control
+      #   Create a cache control breakpoint at this content block.
       #
-      #   @return [Anthropic::Models::CacheControlEphemeral, nil]
-      optional :cache_control, -> { Anthropic::Models::CacheControlEphemeral }, nil?: true
+      #   @return [Anthropic::CacheControlEphemeral, nil]
+      optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
 
-      # @!attribute [r] description
+      # @!attribute description
       #   Description of what this tool does.
       #
       #   Tool descriptions should be as detailed as possible. The more information that
@@ -36,21 +37,26 @@ module Anthropic
       #   @return [String, nil]
       optional :description, String
 
-      # @!parse
-      #   # @return [String]
-      #   attr_writer :description
-
-      # @!parse
-      #   # @param input_schema [Anthropic::Models::Tool::InputSchema]
-      #   # @param name [String]
-      #   # @param cache_control [Anthropic::Models::CacheControlEphemeral, nil]
-      #   # @param description [String]
-      #   #
-      #   def initialize(input_schema:, name:, cache_control: nil, description: nil, **) = super
+      # @!attribute type
+      #
+      #   @return [Symbol, Anthropic::Tool::Type, nil]
+      optional :type, enum: -> { Anthropic::Tool::Type }, nil?: true
 
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(input_schema:, name:, cache_control: nil, description: nil, type: nil)
+      #   Some parameter documentations has been truncated, see {Anthropic::Tool} for more
+      #   details.
+      #
+      #   @param input_schema [Anthropic::Tool::InputSchema] [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
+      #
+      #   @param name [String] Name of the tool.
+      #
+      #   @param cache_control [Anthropic::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+      #
+      #   @param description [String] Description of what this tool does.
+      #
+      #   @param type [Symbol, Anthropic::Tool::Type, nil]
 
-      # @see Anthropic::Models::Tool#input_schema
+      # @see Anthropic::Tool#input_schema
       class InputSchema < Anthropic::Internal::Type::BaseModel
         # @!attribute type
         #
@@ -62,18 +68,24 @@ module Anthropic
         #   @return [Object, nil]
         optional :properties, Anthropic::Internal::Type::Unknown, nil?: true
 
-        # @!parse
-        #   # [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
-        #   #
-        #   # This defines the shape of the `input` that your tool accepts and that the model
-        #   # will produce.
-        #   #
-        #   # @param properties [Object, nil]
-        #   # @param type [Symbol, :object]
-        #   #
-        #   def initialize(properties: nil, type: :object, **) = super
+        # @!method initialize(properties: nil, type: :object)
+        #   [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
+        #
+        #   This defines the shape of the `input` that your tool accepts and that the model
+        #   will produce.
+        #
+        #   @param properties [Object, nil]
+        #   @param type [Symbol, :object]
+      end
+
+      # @see Anthropic::Tool#type
+      module Type
+        extend Anthropic::Internal::Type::Enum
+
+        CUSTOM = :custom
 
-        # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+        # @!method self.values
+        #   @return [Array<Symbol>]
       end
     end
   end

data/lib/anthropic/models/tool_bash_20250124.rb

@@ -6,7 +6,7 @@ module Anthropic
       # @!attribute name
       #   Name of the tool.
       #
-      #   This is how the tool will be called by the model and in tool_use blocks.
+      #   This is how the tool will be called by the model and in `tool_use` blocks.
       #
       #   @return [Symbol, :bash]
       required :name, const: :bash
@@ -17,18 +17,20 @@ module Anthropic
       required :type, const: :bash_20250124
 
       # @!attribute cache_control
+      #   Create a cache control breakpoint at this content block.
       #
-      #   @return [Anthropic::Models::CacheControlEphemeral, nil]
-      optional :cache_control, -> { Anthropic::Models::CacheControlEphemeral }, nil?: true
+      #   @return [Anthropic::CacheControlEphemeral, nil]
+      optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
 
-      # @!parse
-      #   # @param cache_control [Anthropic::Models::CacheControlEphemeral, nil]
-      #   # @param name [Symbol, :bash]
-      #   # @param type [Symbol, :bash_20250124]
-      #   #
-      #   def initialize(cache_control: nil, name: :bash, type: :bash_20250124, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(cache_control: nil, name: :bash, type: :bash_20250124)
+      #   Some parameter documentations has been truncated, see
+      #   {Anthropic::ToolBash20250124} for more details.
+      #
+      #   @param cache_control [Anthropic::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+      #
+      #   @param name [Symbol, :bash] Name of the tool.
+      #
+      #   @param type [Symbol, :bash_20250124]
     end
   end
 end

data/lib/anthropic/models/tool_choice.rb

@@ -10,20 +10,30 @@ module Anthropic
       discriminator :type
 
       # The model will automatically decide whether to use tools.
-      variant :auto, -> { Anthropic::Models::ToolChoiceAuto }
+      variant :auto, -> { Anthropic::ToolChoiceAuto }
 
       # The model will use any available tools.
-      variant :any, -> { Anthropic::Models::ToolChoiceAny }
+      variant :any, -> { Anthropic::ToolChoiceAny }
 
       # The model will use the specified tool with `tool_choice.name`.
-      variant :tool, -> { Anthropic::Models::ToolChoiceTool }
+      variant :tool, -> { Anthropic::ToolChoiceTool }
 
       # The model will not be allowed to use tools.
-      variant :none, -> { Anthropic::Models::ToolChoiceNone }
+      variant :none, -> { Anthropic::ToolChoiceNone }
 
-      # @!parse
-      #   # @return [Array(Anthropic::Models::ToolChoiceAuto, Anthropic::Models::ToolChoiceAny, Anthropic::Models::ToolChoiceTool, Anthropic::Models::ToolChoiceNone)]
-      #   def self.variants; end
+      # @!method self.variants
+      #   @return [Array(Anthropic::ToolChoiceAuto, Anthropic::ToolChoiceAny, Anthropic::ToolChoiceTool, Anthropic::ToolChoiceNone)]
+
+      define_sorbet_constant!(:Variants) do
+        T.type_alias do
+          T.any(
+            Anthropic::ToolChoiceAuto,
+            Anthropic::ToolChoiceAny,
+            Anthropic::ToolChoiceTool,
+            Anthropic::ToolChoiceNone
+          )
+        end
+      end
     end
   end
 end

data/lib/anthropic/models/tool_choice_any.rb

@@ -8,7 +8,7 @@ module Anthropic
       #   @return [Symbol, :any]
       required :type, const: :any
 
-      # @!attribute [r] disable_parallel_tool_use
+      # @!attribute disable_parallel_tool_use
       #   Whether to disable parallel tool use.
       #
       #   Defaults to `false`. If set to `true`, the model will output exactly one tool
@@ -17,19 +17,15 @@ module Anthropic
       #   @return [Boolean, nil]
       optional :disable_parallel_tool_use, Anthropic::Internal::Type::Boolean
 
-      # @!parse
-      #   # @return [Boolean]
-      #   attr_writer :disable_parallel_tool_use
-
-      # @!parse
-      #   # The model will use any available tools.
-      #   #
-      #   # @param disable_parallel_tool_use [Boolean]
-      #   # @param type [Symbol, :any]
-      #   #
-      #   def initialize(disable_parallel_tool_use: nil, type: :any, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(disable_parallel_tool_use: nil, type: :any)
+      #   Some parameter documentations has been truncated, see {Anthropic::ToolChoiceAny}
+      #   for more details.
+      #
+      #   The model will use any available tools.
+      #
+      #   @param disable_parallel_tool_use [Boolean] Whether to disable parallel tool use.
+      #
+      #   @param type [Symbol, :any]
     end
   end
 end

data/lib/anthropic/models/tool_choice_auto.rb

@@ -8,7 +8,7 @@ module Anthropic
       #   @return [Symbol, :auto]
       required :type, const: :auto
 
-      # @!attribute [r] disable_parallel_tool_use
+      # @!attribute disable_parallel_tool_use
       #   Whether to disable parallel tool use.
       #
       #   Defaults to `false`. If set to `true`, the model will output at most one tool
@@ -17,19 +17,15 @@ module Anthropic
       #   @return [Boolean, nil]
       optional :disable_parallel_tool_use, Anthropic::Internal::Type::Boolean
 
-      # @!parse
-      #   # @return [Boolean]
-      #   attr_writer :disable_parallel_tool_use
-
-      # @!parse
-      #   # The model will automatically decide whether to use tools.
-      #   #
-      #   # @param disable_parallel_tool_use [Boolean]
-      #   # @param type [Symbol, :auto]
-      #   #
-      #   def initialize(disable_parallel_tool_use: nil, type: :auto, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(disable_parallel_tool_use: nil, type: :auto)
+      #   Some parameter documentations has been truncated, see
+      #   {Anthropic::ToolChoiceAuto} for more details.
+      #
+      #   The model will automatically decide whether to use tools.
+      #
+      #   @param disable_parallel_tool_use [Boolean] Whether to disable parallel tool use.
+      #
+      #   @param type [Symbol, :auto]
     end
   end
 end

data/lib/anthropic/models/tool_choice_none.rb

@@ -8,14 +8,10 @@ module Anthropic
       #   @return [Symbol, :none]
       required :type, const: :none
 
-      # @!parse
-      #   # The model will not be allowed to use tools.
-      #   #
-      #   # @param type [Symbol, :none]
-      #   #
-      #   def initialize(type: :none, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(type: :none)
+      #   The model will not be allowed to use tools.
+      #
+      #   @param type [Symbol, :none]
     end
   end
 end

data/lib/anthropic/models/tool_choice_tool.rb

@@ -14,7 +14,7 @@ module Anthropic
       #   @return [Symbol, :tool]
       required :type, const: :tool
 
-      # @!attribute [r] disable_parallel_tool_use
+      # @!attribute disable_parallel_tool_use
       #   Whether to disable parallel tool use.
       #
       #   Defaults to `false`. If set to `true`, the model will output exactly one tool
@@ -23,20 +23,17 @@ module Anthropic
       #   @return [Boolean, nil]
       optional :disable_parallel_tool_use, Anthropic::Internal::Type::Boolean
 
-      # @!parse
-      #   # @return [Boolean]
-      #   attr_writer :disable_parallel_tool_use
-
-      # @!parse
-      #   # The model will use the specified tool with `tool_choice.name`.
-      #   #
-      #   # @param name [String]
-      #   # @param disable_parallel_tool_use [Boolean]
-      #   # @param type [Symbol, :tool]
-      #   #
-      #   def initialize(name:, disable_parallel_tool_use: nil, type: :tool, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(name:, disable_parallel_tool_use: nil, type: :tool)
+      #   Some parameter documentations has been truncated, see
+      #   {Anthropic::ToolChoiceTool} for more details.
+      #
+      #   The model will use the specified tool with `tool_choice.name`.
+      #
+      #   @param name [String] The name of the tool to use.
+      #
+      #   @param disable_parallel_tool_use [Boolean] Whether to disable parallel tool use.
+      #
+      #   @param type [Symbol, :tool]
     end
   end
 end

data/lib/anthropic/models/tool_result_block_param.rb

@@ -14,67 +14,69 @@ module Anthropic
       required :type, const: :tool_result
 
       # @!attribute cache_control
+      #   Create a cache control breakpoint at this content block.
       #
-      #   @return [Anthropic::Models::CacheControlEphemeral, nil]
-      optional :cache_control, -> { Anthropic::Models::CacheControlEphemeral }, nil?: true
+      #   @return [Anthropic::CacheControlEphemeral, nil]
+      optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
 
-      # @!attribute [r] content
+      # @!attribute content
       #
-      #   @return [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam>, nil]
-      optional :content, union: -> { Anthropic::Models::ToolResultBlockParam::Content }
+      #   @return [String, Array<Anthropic::TextBlockParam, Anthropic::ImageBlockParam>, nil]
+      optional :content, union: -> { Anthropic::ToolResultBlockParam::Content }
 
-      # @!parse
-      #   # @return [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam>]
-      #   attr_writer :content
-
-      # @!attribute [r] is_error
+      # @!attribute is_error
       #
       #   @return [Boolean, nil]
       optional :is_error, Anthropic::Internal::Type::Boolean
 
-      # @!parse
-      #   # @return [Boolean]
-      #   attr_writer :is_error
-
-      # @!parse
-      #   # @param tool_use_id [String]
-      #   # @param cache_control [Anthropic::Models::CacheControlEphemeral, nil]
-      #   # @param content [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam>]
-      #   # @param is_error [Boolean]
-      #   # @param type [Symbol, :tool_result]
-      #   #
-      #   def initialize(tool_use_id:, cache_control: nil, content: nil, is_error: nil, type: :tool_result, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(tool_use_id:, cache_control: nil, content: nil, is_error: nil, type: :tool_result)
+      #   @param tool_use_id [String]
+      #
+      #   @param cache_control [Anthropic::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+      #
+      #   @param content [String, Array<Anthropic::TextBlockParam, Anthropic::ImageBlockParam>]
+      #
+      #   @param is_error [Boolean]
+      #
+      #   @param type [Symbol, :tool_result]
 
-      # @see Anthropic::Models::ToolResultBlockParam#content
+      # @see Anthropic::ToolResultBlockParam#content
       module Content
         extend Anthropic::Internal::Type::Union
 
         variant String
 
-        variant -> { Anthropic::Models::ToolResultBlockParam::Content::ContentArray }
+        variant -> { Anthropic::ToolResultBlockParam::Content::ContentArray }
 
         module Content
           extend Anthropic::Internal::Type::Union
 
           discriminator :type
 
-          variant :text, -> { Anthropic::Models::TextBlockParam }
+          variant :text, -> { Anthropic::TextBlockParam }
+
+          variant :image, -> { Anthropic::ImageBlockParam }
 
-          variant :image, -> { Anthropic::Models::ImageBlockParam }
+          # @!method self.variants
+          #   @return [Array(Anthropic::TextBlockParam, Anthropic::ImageBlockParam)]
 
-          # @!parse
-          #   # @return [Array(Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam)]
-          #   def self.variants; end
+          define_sorbet_constant!(:Variants) do
+            T.type_alias { T.any(Anthropic::TextBlockParam, Anthropic::ImageBlockParam) }
+          end
         end
 
-        # @!parse
-        #   # @return [Array(String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam>)]
-        #   def self.variants; end
+        # @!method self.variants
+        #   @return [Array(String, Array<Anthropic::TextBlockParam, Anthropic::ImageBlockParam>)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias do
+            T.any(String, T::Array[T.any(Anthropic::TextBlockParam, Anthropic::ImageBlockParam)])
+          end
+        end
 
+        # @type [Anthropic::Internal::Type::Converter]
         ContentArray =
-          Anthropic::Internal::Type::ArrayOf[union: -> { Anthropic::Models::ToolResultBlockParam::Content::Content }]
+          Anthropic::Internal::Type::ArrayOf[union: -> { Anthropic::ToolResultBlockParam::Content::Content }]
       end
     end
   end

data/lib/anthropic/models/tool_text_editor_20250124.rb

@@ -6,7 +6,7 @@ module Anthropic
       # @!attribute name
       #   Name of the tool.
       #
-      #   This is how the tool will be called by the model and in tool_use blocks.
+      #   This is how the tool will be called by the model and in `tool_use` blocks.
       #
       #   @return [Symbol, :str_replace_editor]
       required :name, const: :str_replace_editor
@@ -17,18 +17,20 @@ module Anthropic
       required :type, const: :text_editor_20250124
 
       # @!attribute cache_control
+      #   Create a cache control breakpoint at this content block.
       #
-      #   @return [Anthropic::Models::CacheControlEphemeral, nil]
-      optional :cache_control, -> { Anthropic::Models::CacheControlEphemeral }, nil?: true
+      #   @return [Anthropic::CacheControlEphemeral, nil]
+      optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
 
-      # @!parse
-      #   # @param cache_control [Anthropic::Models::CacheControlEphemeral, nil]
-      #   # @param name [Symbol, :str_replace_editor]
-      #   # @param type [Symbol, :text_editor_20250124]
-      #   #
-      #   def initialize(cache_control: nil, name: :str_replace_editor, type: :text_editor_20250124, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(cache_control: nil, name: :str_replace_editor, type: :text_editor_20250124)
+      #   Some parameter documentations has been truncated, see
+      #   {Anthropic::ToolTextEditor20250124} for more details.
+      #
+      #   @param cache_control [Anthropic::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+      #
+      #   @param name [Symbol, :str_replace_editor] Name of the tool.
+      #
+      #   @param type [Symbol, :text_editor_20250124]
     end
   end
 end

data/lib/anthropic/models/tool_union.rb

@@ -5,15 +5,27 @@ module Anthropic
     module ToolUnion
       extend Anthropic::Internal::Type::Union
 
-      variant -> { Anthropic::Models::Tool }
+      variant -> { Anthropic::Tool }
 
-      variant -> { Anthropic::Models::ToolBash20250124 }
+      variant -> { Anthropic::ToolBash20250124 }
 
-      variant -> { Anthropic::Models::ToolTextEditor20250124 }
+      variant -> { Anthropic::ToolTextEditor20250124 }
 
-      # @!parse
-      #   # @return [Array(Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124)]
-      #   def self.variants; end
+      variant -> { Anthropic::WebSearchTool20250305 }
+
+      # @!method self.variants
+      #   @return [Array(Anthropic::Tool, Anthropic::ToolBash20250124, Anthropic::ToolTextEditor20250124, Anthropic::WebSearchTool20250305)]
+
+      define_sorbet_constant!(:Variants) do
+        T.type_alias do
+          T.any(
+            Anthropic::Tool,
+            Anthropic::ToolBash20250124,
+            Anthropic::ToolTextEditor20250124,
+            Anthropic::WebSearchTool20250305
+          )
+        end
+      end
     end
   end
 end

data/lib/anthropic/models/tool_use_block.rb

@@ -23,15 +23,11 @@ module Anthropic
       #   @return [Symbol, :tool_use]
       required :type, const: :tool_use
 
-      # @!parse
-      #   # @param id [String]
-      #   # @param input [Object]
-      #   # @param name [String]
-      #   # @param type [Symbol, :tool_use]
-      #   #
-      #   def initialize(id:, input:, name:, type: :tool_use, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(id:, input:, name:, type: :tool_use)
+      #   @param id [String]
+      #   @param input [Object]
+      #   @param name [String]
+      #   @param type [Symbol, :tool_use]
     end
   end
 end

data/lib/anthropic/models/tool_use_block_param.rb

@@ -24,20 +24,21 @@ module Anthropic
       required :type, const: :tool_use
 
       # @!attribute cache_control
+      #   Create a cache control breakpoint at this content block.
       #
-      #   @return [Anthropic::Models::CacheControlEphemeral, nil]
-      optional :cache_control, -> { Anthropic::Models::CacheControlEphemeral }, nil?: true
+      #   @return [Anthropic::CacheControlEphemeral, nil]
+      optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
 
-      # @!parse
-      #   # @param id [String]
-      #   # @param input [Object]
-      #   # @param name [String]
-      #   # @param cache_control [Anthropic::Models::CacheControlEphemeral, nil]
-      #   # @param type [Symbol, :tool_use]
-      #   #
-      #   def initialize(id:, input:, name:, cache_control: nil, type: :tool_use, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(id:, input:, name:, cache_control: nil, type: :tool_use)
+      #   @param id [String]
+      #
+      #   @param input [Object]
+      #
+      #   @param name [String]
+      #
+      #   @param cache_control [Anthropic::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+      #
+      #   @param type [Symbol, :tool_use]
     end
   end
 end

data/lib/anthropic/models/url_image_source.rb

@@ -13,13 +13,9 @@ module Anthropic
       #   @return [String]
       required :url, String
 
-      # @!parse
-      #   # @param url [String]
-      #   # @param type [Symbol, :url]
-      #   #
-      #   def initialize(url:, type: :url, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(url:, type: :url)
+      #   @param url [String]
+      #   @param type [Symbol, :url]
     end
   end
 end

data/lib/anthropic/models/url_pdf_source.rb

@@ -13,13 +13,9 @@ module Anthropic
       #   @return [String]
       required :url, String
 
-      # @!parse
-      #   # @param url [String]
-      #   # @param type [Symbol, :url]
-      #   #
-      #   def initialize(url:, type: :url, **) = super
-
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!method initialize(url:, type: :url)
+      #   @param url [String]
+      #   @param type [Symbol, :url]
     end
   end
 end

data/lib/anthropic/models/usage.rb

@@ -27,15 +27,22 @@ module Anthropic
       #   @return [Integer]
       required :output_tokens, Integer
 
-      # @!parse
-      #   # @param cache_creation_input_tokens [Integer, nil]
-      #   # @param cache_read_input_tokens [Integer, nil]
-      #   # @param input_tokens [Integer]
-      #   # @param output_tokens [Integer]
-      #   #
-      #   def initialize(cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, output_tokens:, **) = super
+      # @!attribute server_tool_use
+      #   The number of server tool requests.
+      #
+      #   @return [Anthropic::ServerToolUsage, nil]
+      required :server_tool_use, -> { Anthropic::ServerToolUsage }, nil?: true
 
-      # def initialize: (Hash | Anthropic::Internal::Type::BaseModel) -> void
+      # @!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 number of input tokens used to create the cache entry.
+      #
+      #   @param cache_read_input_tokens [Integer, nil] 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 server_tool_use [Anthropic::ServerToolUsage, nil] The number of server tool requests.
     end
   end
 end