anthropic 1.1.1 → 1.9.0

data/rbi/anthropic/models/usage.rbi

@@ -6,6 +6,15 @@ module Anthropic
       OrHash =
         T.type_alias { T.any(Anthropic::Usage, Anthropic::Internal::AnyHash) }
 
+      # Breakdown of cached tokens by TTL
+      sig { returns(T.nilable(Anthropic::CacheCreation)) }
+      attr_reader :cache_creation
+
+      sig do
+        params(cache_creation: T.nilable(Anthropic::CacheCreation::OrHash)).void
+      end
+      attr_writer :cache_creation
+
       # The number of input tokens used to create the cache entry.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :cache_creation_input_tokens
@@ -39,6 +48,7 @@ module Anthropic
 
       sig do
         params(
+          cache_creation: T.nilable(Anthropic::CacheCreation::OrHash),
           cache_creation_input_tokens: T.nilable(Integer),
           cache_read_input_tokens: T.nilable(Integer),
           input_tokens: Integer,
@@ -48,6 +58,8 @@ module Anthropic
         ).returns(T.attached_class)
       end
       def self.new(
+        # Breakdown of cached tokens by TTL
+        cache_creation:,
         # The number of input tokens used to create the cache entry.
         cache_creation_input_tokens:,
         # The number of input tokens read from the cache.
@@ -66,6 +78,7 @@ module Anthropic
       sig do
         override.returns(
           {
+            cache_creation: T.nilable(Anthropic::CacheCreation),
             cache_creation_input_tokens: T.nilable(Integer),
             cache_read_input_tokens: T.nilable(Integer),
             input_tokens: Integer,

data/rbi/anthropic/models.rbi

@@ -39,6 +39,8 @@ module Anthropic
 
   CacheControlEphemeral = Anthropic::Models::CacheControlEphemeral
 
+  CacheCreation = Anthropic::Models::CacheCreation
+
   CitationCharLocation = Anthropic::Models::CitationCharLocation
 
   CitationCharLocationParam = Anthropic::Models::CitationCharLocationParam
@@ -56,6 +58,12 @@ module Anthropic
 
   CitationsDelta = Anthropic::Models::CitationsDelta
 
+  CitationSearchResultLocationParam =
+    Anthropic::Models::CitationSearchResultLocationParam
+
+  CitationsSearchResultLocation =
+    Anthropic::Models::CitationsSearchResultLocation
+
   CitationsWebSearchResultLocation =
     Anthropic::Models::CitationsWebSearchResultLocation
 
@@ -144,6 +152,8 @@ module Anthropic
 
   RedactedThinkingBlockParam = Anthropic::Models::RedactedThinkingBlockParam
 
+  SearchResultBlockParam = Anthropic::Models::SearchResultBlockParam
+
   ServerToolUsage = Anthropic::Models::ServerToolUsage
 
   ServerToolUseBlock = Anthropic::Models::ServerToolUseBlock
@@ -194,6 +204,10 @@ module Anthropic
 
   ToolTextEditor20250124 = Anthropic::Models::ToolTextEditor20250124
 
+  ToolTextEditor20250429 = Anthropic::Models::ToolTextEditor20250429
+
+  ToolTextEditor20250728 = Anthropic::Models::ToolTextEditor20250728
+
   ToolUnion = Anthropic::Models::ToolUnion
 
   ToolUseBlock = Anthropic::Models::ToolUseBlock

data/rbi/anthropic/resources/beta/messages.rbi

@@ -48,15 +48,18 @@ 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::BetaCodeExecutionTool20250825::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250124::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250429::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20250728::OrHash,
                   Anthropic::Beta::BetaWebSearchTool20250305::OrHash,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash
+                  Anthropic::Beta::BetaWebFetchTool20250910::OrHash
                 )
               ],
             top_k: Integer,
@@ -132,37 +135,14 @@ module Anthropic
           # { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
           # ```
           #
-          # Starting with Claude 3 models, you can also send image content blocks:
-          #
-          # ```json
-          # {
-          #   "role": "user",
-          #   "content": [
-          #     {
-          #       "type": "image",
-          #       "source": {
-          #         "type": "base64",
-          #         "media_type": "image/jpeg",
-          #         "data": "/9j/4AAQSkZJRg..."
-          #       }
-          #     },
-          #     { "type": "text", "text": "What is in this image?" }
-          #   ]
-          # }
-          # ```
-          #
-          # We currently support the `base64` source type for images, and the `image/jpeg`,
-          # `image/png`, `image/gif`, and `image/webp` media types.
-          #
-          # See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for
-          # more input examples.
+          # See [input examples](https://docs.anthropic.com/en/api/messages-examples).
           #
           # Note that if you want to include a
           # [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
           # 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:,
           # Body param: The model that will complete your prompt.\n\nSee
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -225,6 +205,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.
@@ -356,15 +342,18 @@ 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::BetaCodeExecutionTool20250825::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250124::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250429::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20250728::OrHash,
                   Anthropic::Beta::BetaWebSearchTool20250305::OrHash,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash
+                  Anthropic::Beta::BetaWebFetchTool20250910::OrHash
                 )
               ],
             top_k: Integer,
@@ -444,37 +433,14 @@ module Anthropic
           # { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
           # ```
           #
-          # Starting with Claude 3 models, you can also send image content blocks:
-          #
-          # ```json
-          # {
-          #   "role": "user",
-          #   "content": [
-          #     {
-          #       "type": "image",
-          #       "source": {
-          #         "type": "base64",
-          #         "media_type": "image/jpeg",
-          #         "data": "/9j/4AAQSkZJRg..."
-          #       }
-          #     },
-          #     { "type": "text", "text": "What is in this image?" }
-          #   ]
-          # }
-          # ```
-          #
-          # We currently support the `base64` source type for images, and the `image/jpeg`,
-          # `image/png`, `image/gif`, and `image/webp` media types.
-          #
-          # See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for
-          # more input examples.
+          # See [input examples](https://docs.anthropic.com/en/api/messages-examples).
           #
           # Note that if you want to include a
           # [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
           # 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:,
           # Body param: The model that will complete your prompt.\n\nSee
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -537,6 +503,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.
@@ -660,15 +632,18 @@ 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::BetaCodeExecutionTool20250825::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20241022::OrHash,
+                  Anthropic::Beta::BetaToolComputerUse20250124::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20241022::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250124::OrHash,
                   Anthropic::Beta::BetaToolTextEditor20250429::OrHash,
+                  Anthropic::Beta::BetaToolTextEditor20250728::OrHash,
                   Anthropic::Beta::BetaWebSearchTool20250305::OrHash,
-                  Anthropic::Beta::BetaCodeExecutionTool20250522::OrHash
+                  Anthropic::Beta::BetaWebFetchTool20250910::OrHash
                 )
               ],
             betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
@@ -733,37 +708,14 @@ module Anthropic
           # { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
           # ```
           #
-          # Starting with Claude 3 models, you can also send image content blocks:
-          #
-          # ```json
-          # {
-          #   "role": "user",
-          #   "content": [
-          #     {
-          #       "type": "image",
-          #       "source": {
-          #         "type": "base64",
-          #         "media_type": "image/jpeg",
-          #         "data": "/9j/4AAQSkZJRg..."
-          #       }
-          #     },
-          #     { "type": "text", "text": "What is in this image?" }
-          #   ]
-          # }
-          # ```
-          #
-          # We currently support the `base64` source type for images, and the `image/jpeg`,
-          # `image/png`, `image/gif`, and `image/webp` media types.
-          #
-          # See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for
-          # more input examples.
+          # See [input examples](https://docs.anthropic.com/en/api/messages-examples).
           #
           # Note that if you want to include a
           # [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
           # 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:,
           # Body param: The model that will complete your prompt.\n\nSee
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -797,6 +749,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.