anthropic 1.1.1 → 1.3.0

data/rbi/anthropic/models/beta/beta_request_document_block.rbi

@@ -0,0 +1,140 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaRequestDocumentBlock = Beta::BetaRequestDocumentBlock
+
+    module Beta
+      class BetaRequestDocumentBlock < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaRequestDocumentBlock,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(
+            T.any(
+              Anthropic::Beta::BetaBase64PDFSource,
+              Anthropic::Beta::BetaPlainTextSource,
+              Anthropic::Beta::BetaContentBlockSource,
+              Anthropic::Beta::BetaURLPDFSource,
+              Anthropic::Beta::BetaFileDocumentSource
+            )
+          )
+        end
+        attr_accessor :source
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Create a cache control breakpoint at this content block.
+        sig { returns(T.nilable(Anthropic::Beta::BetaCacheControlEphemeral)) }
+        attr_reader :cache_control
+
+        sig do
+          params(
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash)
+          ).void
+        end
+        attr_writer :cache_control
+
+        sig { returns(T.nilable(Anthropic::Beta::BetaCitationsConfigParam)) }
+        attr_reader :citations
+
+        sig do
+          params(
+            citations: Anthropic::Beta::BetaCitationsConfigParam::OrHash
+          ).void
+        end
+        attr_writer :citations
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :context
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :title
+
+        sig do
+          params(
+            source:
+              T.any(
+                Anthropic::Beta::BetaBase64PDFSource::OrHash,
+                Anthropic::Beta::BetaPlainTextSource::OrHash,
+                Anthropic::Beta::BetaContentBlockSource::OrHash,
+                Anthropic::Beta::BetaURLPDFSource::OrHash,
+                Anthropic::Beta::BetaFileDocumentSource::OrHash
+              ),
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
+            citations: Anthropic::Beta::BetaCitationsConfigParam::OrHash,
+            context: T.nilable(String),
+            title: T.nilable(String),
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          source:,
+          # Create a cache control breakpoint at this content block.
+          cache_control: nil,
+          citations: nil,
+          context: nil,
+          title: nil,
+          type: :document
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              source:
+                T.any(
+                  Anthropic::Beta::BetaBase64PDFSource,
+                  Anthropic::Beta::BetaPlainTextSource,
+                  Anthropic::Beta::BetaContentBlockSource,
+                  Anthropic::Beta::BetaURLPDFSource,
+                  Anthropic::Beta::BetaFileDocumentSource
+                ),
+              type: Symbol,
+              cache_control:
+                T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
+              citations: Anthropic::Beta::BetaCitationsConfigParam,
+              context: T.nilable(String),
+              title: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Source
+          extend Anthropic::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                Anthropic::Beta::BetaBase64PDFSource,
+                Anthropic::Beta::BetaPlainTextSource,
+                Anthropic::Beta::BetaContentBlockSource,
+                Anthropic::Beta::BetaURLPDFSource,
+                Anthropic::Beta::BetaFileDocumentSource
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[
+                Anthropic::Beta::BetaRequestDocumentBlock::Source::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_search_result_block_param.rbi

@@ -0,0 +1,91 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaSearchResultBlockParam = Beta::BetaSearchResultBlockParam
+
+    module Beta
+      class BetaSearchResultBlockParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaSearchResultBlockParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T::Array[Anthropic::Beta::BetaTextBlockParam]) }
+        attr_accessor :content
+
+        sig { returns(String) }
+        attr_accessor :source
+
+        sig { returns(String) }
+        attr_accessor :title
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Create a cache control breakpoint at this content block.
+        sig { returns(T.nilable(Anthropic::Beta::BetaCacheControlEphemeral)) }
+        attr_reader :cache_control
+
+        sig do
+          params(
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash)
+          ).void
+        end
+        attr_writer :cache_control
+
+        sig { returns(T.nilable(Anthropic::Beta::BetaCitationsConfigParam)) }
+        attr_reader :citations
+
+        sig do
+          params(
+            citations: Anthropic::Beta::BetaCitationsConfigParam::OrHash
+          ).void
+        end
+        attr_writer :citations
+
+        sig do
+          params(
+            content: T::Array[Anthropic::Beta::BetaTextBlockParam::OrHash],
+            source: String,
+            title: String,
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
+            citations: Anthropic::Beta::BetaCitationsConfigParam::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          content:,
+          source:,
+          title:,
+          # Create a cache control breakpoint at this content block.
+          cache_control: nil,
+          citations: nil,
+          type: :search_result
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              content: T::Array[Anthropic::Beta::BetaTextBlockParam],
+              source: String,
+              title: String,
+              type: Symbol,
+              cache_control:
+                T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
+              citations: Anthropic::Beta::BetaCitationsConfigParam
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_text_block.rbi

@@ -38,7 +38,8 @@ module Anthropic
                     Anthropic::Beta::BetaCitationCharLocation::OrHash,
                     Anthropic::Beta::BetaCitationPageLocation::OrHash,
                     Anthropic::Beta::BetaCitationContentBlockLocation::OrHash,
-                    Anthropic::Beta::BetaCitationsWebSearchResultLocation::OrHash
+                    Anthropic::Beta::BetaCitationsWebSearchResultLocation::OrHash,
+                    Anthropic::Beta::BetaCitationSearchResultLocation::OrHash
                   )
                 ]
               ),

data/rbi/anthropic/models/beta/beta_text_block_param.rbi

@@ -40,7 +40,8 @@ module Anthropic
                   Anthropic::Beta::BetaCitationCharLocationParam,
                   Anthropic::Beta::BetaCitationPageLocationParam,
                   Anthropic::Beta::BetaCitationContentBlockLocationParam,
-                  Anthropic::Beta::BetaCitationWebSearchResultLocationParam
+                  Anthropic::Beta::BetaCitationWebSearchResultLocationParam,
+                  Anthropic::Beta::BetaCitationSearchResultLocationParam
                 )
               ]
             )
@@ -60,7 +61,8 @@ module Anthropic
                     Anthropic::Beta::BetaCitationCharLocationParam::OrHash,
                     Anthropic::Beta::BetaCitationPageLocationParam::OrHash,
                     Anthropic::Beta::BetaCitationContentBlockLocationParam::OrHash,
-                    Anthropic::Beta::BetaCitationWebSearchResultLocationParam::OrHash
+                    Anthropic::Beta::BetaCitationWebSearchResultLocationParam::OrHash,
+                    Anthropic::Beta::BetaCitationSearchResultLocationParam::OrHash
                   )
                 ]
               ),
@@ -90,7 +92,8 @@ module Anthropic
                       Anthropic::Beta::BetaCitationCharLocationParam,
                       Anthropic::Beta::BetaCitationPageLocationParam,
                       Anthropic::Beta::BetaCitationContentBlockLocationParam,
-                      Anthropic::Beta::BetaCitationWebSearchResultLocationParam
+                      Anthropic::Beta::BetaCitationWebSearchResultLocationParam,
+                      Anthropic::Beta::BetaCitationSearchResultLocationParam
                     )
                   ]
                 )

data/rbi/anthropic/models/beta/beta_text_citation.rbi

@@ -14,7 +14,8 @@ module Anthropic
               Anthropic::Beta::BetaCitationCharLocation,
               Anthropic::Beta::BetaCitationPageLocation,
               Anthropic::Beta::BetaCitationContentBlockLocation,
-              Anthropic::Beta::BetaCitationsWebSearchResultLocation
+              Anthropic::Beta::BetaCitationsWebSearchResultLocation,
+              Anthropic::Beta::BetaCitationSearchResultLocation
             )
           end
 

data/rbi/anthropic/models/beta/beta_text_citation_param.rbi

@@ -14,7 +14,8 @@ module Anthropic
               Anthropic::Beta::BetaCitationCharLocationParam,
               Anthropic::Beta::BetaCitationPageLocationParam,
               Anthropic::Beta::BetaCitationContentBlockLocationParam,
-              Anthropic::Beta::BetaCitationWebSearchResultLocationParam
+              Anthropic::Beta::BetaCitationWebSearchResultLocationParam,
+              Anthropic::Beta::BetaCitationSearchResultLocationParam
             )
           end
 

data/rbi/anthropic/models/beta/beta_tool.rbi

@@ -121,21 +121,30 @@ module Anthropic
           sig { returns(T.nilable(T.anything)) }
           attr_accessor :properties
 
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_accessor :required
+
           # [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.
           sig do
-            params(properties: T.nilable(T.anything), type: Symbol).returns(
-              T.attached_class
-            )
+            params(
+              properties: T.nilable(T.anything),
+              required: T.nilable(T::Array[String]),
+              type: Symbol
+            ).returns(T.attached_class)
           end
-          def self.new(properties: nil, type: :object)
+          def self.new(properties: nil, required: nil, type: :object)
           end
 
           sig do
             override.returns(
-              { type: Symbol, properties: T.nilable(T.anything) }
+              {
+                type: Symbol,
+                properties: T.nilable(T.anything),
+                required: T.nilable(T::Array[String])
+              }
             )
           end
           def to_hash

data/rbi/anthropic/models/beta/beta_tool_result_block_param.rbi

@@ -112,7 +112,8 @@ module Anthropic
               T.type_alias do
                 T.any(
                   Anthropic::Beta::BetaTextBlockParam,
-                  Anthropic::Beta::BetaImageBlockParam
+                  Anthropic::Beta::BetaImageBlockParam,
+                  Anthropic::Beta::BetaSearchResultBlockParam
                 )
               end
 

data/rbi/anthropic/models/beta/beta_tool_union.rbi

@@ -12,15 +12,15 @@ module Anthropic
           T.type_alias do
             T.any(
               Anthropic::Beta::BetaTool,
-              Anthropic::Beta::BetaToolComputerUse20241022,
               Anthropic::Beta::BetaToolBash20241022,
-              Anthropic::Beta::BetaToolTextEditor20241022,
-              Anthropic::Beta::BetaToolComputerUse20250124,
               Anthropic::Beta::BetaToolBash20250124,
+              Anthropic::Beta::BetaCodeExecutionTool20250522,
+              Anthropic::Beta::BetaToolComputerUse20241022,
+              Anthropic::Beta::BetaToolComputerUse20250124,
+              Anthropic::Beta::BetaToolTextEditor20241022,
               Anthropic::Beta::BetaToolTextEditor20250124,
               Anthropic::Beta::BetaToolTextEditor20250429,
-              Anthropic::Beta::BetaWebSearchTool20250305,
-              Anthropic::Beta::BetaCodeExecutionTool20250522
+              Anthropic::Beta::BetaWebSearchTool20250305
             )
           end
 

data/rbi/anthropic/models/beta/message_count_tokens_params.rbi

@@ -102,7 +102,7 @@ module Anthropic
         # the top-level `system` parameter — there is no `"system"` role for input
         # messages in the Messages API.
         #
-        # There is a limit of 100000 messages in a single request.
+        # There is a limit of 100,000 messages in a single request.
         sig { returns(T::Array[Anthropic::Beta::BetaMessageParam]) }
         attr_accessor :messages
 
@@ -221,6 +221,12 @@ module Anthropic
         # those tools using the tool input generated by the model and then optionally
         # return results back to the model using `tool_result` content blocks.
         #
+        # There are two types of tools: **client tools** and **server tools**. The
+        # behavior described below applies to client tools. For
+        # [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+        # see their individual documentation as each has its own behavior (e.g., the
+        # [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+        #
         # Each tool definition includes:
         #
         # - `name`: Name of the tool.
@@ -289,15 +295,15 @@ module Anthropic
               T::Array[
                 T.any(
                   Anthropic::Beta::BetaTool,
-                  Anthropic::Beta::BetaToolComputerUse20241022,
                   Anthropic::Beta::BetaToolBash20241022,
-                  Anthropic::Beta::BetaToolTextEditor20241022,
-                  Anthropic::Beta::BetaToolComputerUse20250124,
                   Anthropic::Beta::BetaToolBash20250124,
+                  Anthropic::Beta::BetaCodeExecutionTool20250522,
+                  Anthropic::Beta::BetaToolComputerUse20241022,
+                  Anthropic::Beta::BetaToolComputerUse20250124,
+                  Anthropic::Beta::BetaToolTextEditor20241022,
                   Anthropic::Beta::BetaToolTextEditor20250124,
                   Anthropic::Beta::BetaToolTextEditor20250429,
-                  Anthropic::Beta::BetaWebSearchTool20250305,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522
+                  Anthropic::Beta::BetaWebSearchTool20250305
                 )
               ]
             )
@@ -311,15 +317,15 @@ module Anthropic
               T::Array[
                 T.any(
                   Anthropic::Beta::BetaTool::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
                   Anthropic::Beta::BetaToolBash20241022::OrHash,
-                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
                   Anthropic::Beta::BetaToolBash20250124::OrHash,
+                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250124::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250429::OrHash,
-                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash
+                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                 )
               ]
           ).void
@@ -369,15 +375,15 @@ module Anthropic
               T::Array[
                 T.any(
                   Anthropic::Beta::BetaTool::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
                   Anthropic::Beta::BetaToolBash20241022::OrHash,
-                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
                   Anthropic::Beta::BetaToolBash20250124::OrHash,
+                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250124::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250429::OrHash,
-                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash
+                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                 )
               ],
             betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
@@ -472,7 +478,7 @@ module Anthropic
           # the top-level `system` parameter — there is no `"system"` role for input
           # messages in the Messages API.
           #
-          # There is a limit of 100000 messages in a single request.
+          # There is a limit of 100,000 messages in a single request.
           messages:,
           # The model that will complete your prompt.\n\nSee
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -506,6 +512,12 @@ module Anthropic
           # those tools using the tool input generated by the model and then optionally
           # return results back to the model using `tool_result` content blocks.
           #
+          # There are two types of tools: **client tools** and **server tools**. The
+          # behavior described below applies to client tools. For
+          # [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+          # see their individual documentation as each has its own behavior (e.g., the
+          # [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+          #
           # Each tool definition includes:
           #
           # - `name`: Name of the tool.
@@ -600,15 +612,15 @@ module Anthropic
                 T::Array[
                   T.any(
                     Anthropic::Beta::BetaTool,
-                    Anthropic::Beta::BetaToolComputerUse20241022,
                     Anthropic::Beta::BetaToolBash20241022,
-                    Anthropic::Beta::BetaToolTextEditor20241022,
-                    Anthropic::Beta::BetaToolComputerUse20250124,
                     Anthropic::Beta::BetaToolBash20250124,
+                    Anthropic::Beta::BetaCodeExecutionTool20250522,
+                    Anthropic::Beta::BetaToolComputerUse20241022,
+                    Anthropic::Beta::BetaToolComputerUse20250124,
+                    Anthropic::Beta::BetaToolTextEditor20241022,
                     Anthropic::Beta::BetaToolTextEditor20250124,
                     Anthropic::Beta::BetaToolTextEditor20250429,
-                    Anthropic::Beta::BetaWebSearchTool20250305,
-                    Anthropic::Beta::BetaCodeExecutionTool20250522
+                    Anthropic::Beta::BetaWebSearchTool20250305
                   )
                 ],
               betas:
@@ -659,15 +671,15 @@ module Anthropic
             T.type_alias do
               T.any(
                 Anthropic::Beta::BetaTool,
-                Anthropic::Beta::BetaToolComputerUse20241022,
                 Anthropic::Beta::BetaToolBash20241022,
-                Anthropic::Beta::BetaToolTextEditor20241022,
-                Anthropic::Beta::BetaToolComputerUse20250124,
                 Anthropic::Beta::BetaToolBash20250124,
+                Anthropic::Beta::BetaCodeExecutionTool20250522,
+                Anthropic::Beta::BetaToolComputerUse20241022,
+                Anthropic::Beta::BetaToolComputerUse20250124,
+                Anthropic::Beta::BetaToolTextEditor20241022,
                 Anthropic::Beta::BetaToolTextEditor20250124,
                 Anthropic::Beta::BetaToolTextEditor20250429,
-                Anthropic::Beta::BetaWebSearchTool20250305,
-                Anthropic::Beta::BetaCodeExecutionTool20250522
+                Anthropic::Beta::BetaWebSearchTool20250305
               )
             end
 

data/rbi/anthropic/models/beta/message_create_params.rbi

@@ -112,7 +112,7 @@ module Anthropic
         # the top-level `system` parameter — there is no `"system"` role for input
         # messages in the Messages API.
         #
-        # There is a limit of 100000 messages in a single request.
+        # There is a limit of 100,000 messages in a single request.
         sig { returns(T::Array[Anthropic::Beta::BetaMessageParam]) }
         attr_accessor :messages
 
@@ -291,6 +291,12 @@ module Anthropic
         # those tools using the tool input generated by the model and then optionally
         # return results back to the model using `tool_result` content blocks.
         #
+        # There are two types of tools: **client tools** and **server tools**. The
+        # behavior described below applies to client tools. For
+        # [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+        # see their individual documentation as each has its own behavior (e.g., the
+        # [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+        #
         # Each tool definition includes:
         #
         # - `name`: Name of the tool.
@@ -359,15 +365,15 @@ module Anthropic
               T::Array[
                 T.any(
                   Anthropic::Beta::BetaTool,
-                  Anthropic::Beta::BetaToolComputerUse20241022,
                   Anthropic::Beta::BetaToolBash20241022,
-                  Anthropic::Beta::BetaToolTextEditor20241022,
-                  Anthropic::Beta::BetaToolComputerUse20250124,
                   Anthropic::Beta::BetaToolBash20250124,
+                  Anthropic::Beta::BetaCodeExecutionTool20250522,
+                  Anthropic::Beta::BetaToolComputerUse20241022,
+                  Anthropic::Beta::BetaToolComputerUse20250124,
+                  Anthropic::Beta::BetaToolTextEditor20241022,
                   Anthropic::Beta::BetaToolTextEditor20250124,
                   Anthropic::Beta::BetaToolTextEditor20250429,
-                  Anthropic::Beta::BetaWebSearchTool20250305,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522
+                  Anthropic::Beta::BetaWebSearchTool20250305
                 )
               ]
             )
@@ -381,15 +387,15 @@ module Anthropic
               T::Array[
                 T.any(
                   Anthropic::Beta::BetaTool::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
                   Anthropic::Beta::BetaToolBash20241022::OrHash,
-                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
                   Anthropic::Beta::BetaToolBash20250124::OrHash,
+                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250124::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250429::OrHash,
-                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash
+                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                 )
               ]
           ).void
@@ -473,15 +479,15 @@ module Anthropic
               T::Array[
                 T.any(
                   Anthropic::Beta::BetaTool::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
                   Anthropic::Beta::BetaToolBash20241022::OrHash,
-                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
-                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
                   Anthropic::Beta::BetaToolBash20250124::OrHash,
+                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250124::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250429::OrHash,
-                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash
+                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                 )
               ],
             top_k: Integer,
@@ -586,7 +592,7 @@ module Anthropic
           # the top-level `system` parameter — there is no `"system"` role for input
           # messages in the Messages API.
           #
-          # There is a limit of 100000 messages in a single request.
+          # There is a limit of 100,000 messages in a single request.
           messages:,
           # The model that will complete your prompt.\n\nSee
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -649,6 +655,12 @@ module Anthropic
           # those tools using the tool input generated by the model and then optionally
           # return results back to the model using `tool_result` content blocks.
           #
+          # There are two types of tools: **client tools** and **server tools**. The
+          # behavior described below applies to client tools. For
+          # [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+          # see their individual documentation as each has its own behavior (e.g., the
+          # [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+          #
           # Each tool definition includes:
           #
           # - `name`: Name of the tool.
@@ -767,15 +779,15 @@ module Anthropic
                 T::Array[
                   T.any(
                     Anthropic::Beta::BetaTool,
-                    Anthropic::Beta::BetaToolComputerUse20241022,
                     Anthropic::Beta::BetaToolBash20241022,
-                    Anthropic::Beta::BetaToolTextEditor20241022,
-                    Anthropic::Beta::BetaToolComputerUse20250124,
                     Anthropic::Beta::BetaToolBash20250124,
+                    Anthropic::Beta::BetaCodeExecutionTool20250522,
+                    Anthropic::Beta::BetaToolComputerUse20241022,
+                    Anthropic::Beta::BetaToolComputerUse20250124,
+                    Anthropic::Beta::BetaToolTextEditor20241022,
                     Anthropic::Beta::BetaToolTextEditor20250124,
                     Anthropic::Beta::BetaToolTextEditor20250429,
-                    Anthropic::Beta::BetaWebSearchTool20250305,
-                    Anthropic::Beta::BetaCodeExecutionTool20250522
+                    Anthropic::Beta::BetaWebSearchTool20250305
                   )
                 ],
               top_k: Integer,