anthropic 1.1.1 → 1.9.0

data/rbi/anthropic/models/cache_control_ephemeral.rbi

@@ -11,13 +11,78 @@ module Anthropic
       sig { returns(Symbol) }
       attr_accessor :type
 
-      sig { params(type: Symbol).returns(T.attached_class) }
-      def self.new(type: :ephemeral)
+      # The time-to-live for the cache control breakpoint.
+      #
+      # This may be one the following values:
+      #
+      # - `5m`: 5 minutes
+      # - `1h`: 1 hour
+      #
+      # Defaults to `5m`.
+      sig do
+        returns(T.nilable(Anthropic::CacheControlEphemeral::TTL::OrSymbol))
       end
+      attr_reader :ttl
 
-      sig { override.returns({ type: Symbol }) }
+      sig { params(ttl: Anthropic::CacheControlEphemeral::TTL::OrSymbol).void }
+      attr_writer :ttl
+
+      sig do
+        params(
+          ttl: Anthropic::CacheControlEphemeral::TTL::OrSymbol,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The time-to-live for the cache control breakpoint.
+        #
+        # This may be one the following values:
+        #
+        # - `5m`: 5 minutes
+        # - `1h`: 1 hour
+        #
+        # Defaults to `5m`.
+        ttl: nil,
+        type: :ephemeral
+      )
+      end
+
+      sig do
+        override.returns(
+          { type: Symbol, ttl: Anthropic::CacheControlEphemeral::TTL::OrSymbol }
+        )
+      end
       def to_hash
       end
+
+      # The time-to-live for the cache control breakpoint.
+      #
+      # This may be one the following values:
+      #
+      # - `5m`: 5 minutes
+      # - `1h`: 1 hour
+      #
+      # Defaults to `5m`.
+      module TTL
+        extend Anthropic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Anthropic::CacheControlEphemeral::TTL) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TTL_5M =
+          T.let(:"5m", Anthropic::CacheControlEphemeral::TTL::TaggedSymbol)
+        TTL_1H =
+          T.let(:"1h", Anthropic::CacheControlEphemeral::TTL::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Anthropic::CacheControlEphemeral::TTL::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/anthropic/models/cache_creation.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    class CacheCreation < Anthropic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Anthropic::CacheCreation, Anthropic::Internal::AnyHash)
+        end
+
+      # The number of input tokens used to create the 1 hour cache entry.
+      sig { returns(Integer) }
+      attr_accessor :ephemeral_1h_input_tokens
+
+      # The number of input tokens used to create the 5 minute cache entry.
+      sig { returns(Integer) }
+      attr_accessor :ephemeral_5m_input_tokens
+
+      sig do
+        params(
+          ephemeral_1h_input_tokens: Integer,
+          ephemeral_5m_input_tokens: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The number of input tokens used to create the 1 hour cache entry.
+        ephemeral_1h_input_tokens:,
+        # The number of input tokens used to create the 5 minute cache entry.
+        ephemeral_5m_input_tokens:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            ephemeral_1h_input_tokens: Integer,
+            ephemeral_5m_input_tokens: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/anthropic/models/citation_char_location.rbi

@@ -20,6 +20,9 @@ module Anthropic
       sig { returns(Integer) }
       attr_accessor :end_char_index
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :file_id
+
       sig { returns(Integer) }
       attr_accessor :start_char_index
 
@@ -32,6 +35,7 @@ module Anthropic
           document_index: Integer,
           document_title: T.nilable(String),
           end_char_index: Integer,
+          file_id: T.nilable(String),
           start_char_index: Integer,
           type: Symbol
         ).returns(T.attached_class)
@@ -41,6 +45,7 @@ module Anthropic
         document_index:,
         document_title:,
         end_char_index:,
+        file_id:,
         start_char_index:,
         type: :char_location
       )
@@ -53,6 +58,7 @@ module Anthropic
             document_index: Integer,
             document_title: T.nilable(String),
             end_char_index: Integer,
+            file_id: T.nilable(String),
             start_char_index: Integer,
             type: Symbol
           }

data/rbi/anthropic/models/citation_content_block_location.rbi

@@ -23,6 +23,9 @@ module Anthropic
       sig { returns(Integer) }
       attr_accessor :end_block_index
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :file_id
+
       sig { returns(Integer) }
       attr_accessor :start_block_index
 
@@ -35,6 +38,7 @@ module Anthropic
           document_index: Integer,
           document_title: T.nilable(String),
           end_block_index: Integer,
+          file_id: T.nilable(String),
           start_block_index: Integer,
           type: Symbol
         ).returns(T.attached_class)
@@ -44,6 +48,7 @@ module Anthropic
         document_index:,
         document_title:,
         end_block_index:,
+        file_id:,
         start_block_index:,
         type: :content_block_location
       )
@@ -56,6 +61,7 @@ module Anthropic
             document_index: Integer,
             document_title: T.nilable(String),
             end_block_index: Integer,
+            file_id: T.nilable(String),
             start_block_index: Integer,
             type: Symbol
           }

data/rbi/anthropic/models/citation_page_location.rbi

@@ -20,6 +20,9 @@ module Anthropic
       sig { returns(Integer) }
       attr_accessor :end_page_number
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :file_id
+
       sig { returns(Integer) }
       attr_accessor :start_page_number
 
@@ -32,6 +35,7 @@ module Anthropic
           document_index: Integer,
           document_title: T.nilable(String),
           end_page_number: Integer,
+          file_id: T.nilable(String),
           start_page_number: Integer,
           type: Symbol
         ).returns(T.attached_class)
@@ -41,6 +45,7 @@ module Anthropic
         document_index:,
         document_title:,
         end_page_number:,
+        file_id:,
         start_page_number:,
         type: :page_location
       )
@@ -53,6 +58,7 @@ module Anthropic
             document_index: Integer,
             document_title: T.nilable(String),
             end_page_number: Integer,
+            file_id: T.nilable(String),
             start_page_number: Integer,
             type: Symbol
           }

data/rbi/anthropic/models/citation_search_result_location_param.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    class CitationSearchResultLocationParam < Anthropic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Anthropic::CitationSearchResultLocationParam,
+            Anthropic::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :cited_text
+
+      sig { returns(Integer) }
+      attr_accessor :end_block_index
+
+      sig { returns(Integer) }
+      attr_accessor :search_result_index
+
+      sig { returns(String) }
+      attr_accessor :source
+
+      sig { returns(Integer) }
+      attr_accessor :start_block_index
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :title
+
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig do
+        params(
+          cited_text: String,
+          end_block_index: Integer,
+          search_result_index: Integer,
+          source: String,
+          start_block_index: Integer,
+          title: T.nilable(String),
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        cited_text:,
+        end_block_index:,
+        search_result_index:,
+        source:,
+        start_block_index:,
+        title:,
+        type: :search_result_location
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            cited_text: String,
+            end_block_index: Integer,
+            search_result_index: Integer,
+            source: String,
+            start_block_index: Integer,
+            title: T.nilable(String),
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/anthropic/models/citations_delta.rbi

@@ -21,7 +21,8 @@ module Anthropic
               Anthropic::CitationCharLocation::OrHash,
               Anthropic::CitationPageLocation::OrHash,
               Anthropic::CitationContentBlockLocation::OrHash,
-              Anthropic::CitationsWebSearchResultLocation::OrHash
+              Anthropic::CitationsWebSearchResultLocation::OrHash,
+              Anthropic::CitationsSearchResultLocation::OrHash
             ),
           type: Symbol
         ).returns(T.attached_class)
@@ -49,7 +50,8 @@ module Anthropic
               Anthropic::CitationCharLocation,
               Anthropic::CitationPageLocation,
               Anthropic::CitationContentBlockLocation,
-              Anthropic::CitationsWebSearchResultLocation
+              Anthropic::CitationsWebSearchResultLocation,
+              Anthropic::CitationsSearchResultLocation
             )
           end
 

data/rbi/anthropic/models/citations_search_result_location.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    class CitationsSearchResultLocation < Anthropic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Anthropic::CitationsSearchResultLocation,
+            Anthropic::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :cited_text
+
+      sig { returns(Integer) }
+      attr_accessor :end_block_index
+
+      sig { returns(Integer) }
+      attr_accessor :search_result_index
+
+      sig { returns(String) }
+      attr_accessor :source
+
+      sig { returns(Integer) }
+      attr_accessor :start_block_index
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :title
+
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig do
+        params(
+          cited_text: String,
+          end_block_index: Integer,
+          search_result_index: Integer,
+          source: String,
+          start_block_index: Integer,
+          title: T.nilable(String),
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        cited_text:,
+        end_block_index:,
+        search_result_index:,
+        source:,
+        start_block_index:,
+        title:,
+        type: :search_result_location
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            cited_text: String,
+            end_block_index: Integer,
+            search_result_index: Integer,
+            source: String,
+            start_block_index: Integer,
+            title: T.nilable(String),
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/anthropic/models/content_block.rbi

@@ -9,11 +9,11 @@ module Anthropic
         T.type_alias do
           T.any(
             Anthropic::TextBlock,
+            Anthropic::ThinkingBlock,
+            Anthropic::RedactedThinkingBlock,
             Anthropic::ToolUseBlock,
             Anthropic::ServerToolUseBlock,
-            Anthropic::WebSearchToolResultBlock,
-            Anthropic::ThinkingBlock,
-            Anthropic::RedactedThinkingBlock
+            Anthropic::WebSearchToolResultBlock
           )
         end
 

data/rbi/anthropic/models/content_block_param.rbi

@@ -9,15 +9,16 @@ module Anthropic
       Variants =
         T.type_alias do
           T.any(
-            Anthropic::ServerToolUseBlockParam,
-            Anthropic::WebSearchToolResultBlockParam,
             Anthropic::TextBlockParam,
             Anthropic::ImageBlockParam,
-            Anthropic::ToolUseBlockParam,
-            Anthropic::ToolResultBlockParam,
             Anthropic::DocumentBlockParam,
+            Anthropic::SearchResultBlockParam,
             Anthropic::ThinkingBlockParam,
-            Anthropic::RedactedThinkingBlockParam
+            Anthropic::RedactedThinkingBlockParam,
+            Anthropic::ToolUseBlockParam,
+            Anthropic::ToolResultBlockParam,
+            Anthropic::ServerToolUseBlockParam,
+            Anthropic::WebSearchToolResultBlockParam
           )
         end
 

data/rbi/anthropic/models/document_block_param.rbi

@@ -37,7 +37,11 @@ module Anthropic
       sig { returns(T.nilable(Anthropic::CitationsConfigParam)) }
       attr_reader :citations
 
-      sig { params(citations: Anthropic::CitationsConfigParam::OrHash).void }
+      sig do
+        params(
+          citations: T.nilable(Anthropic::CitationsConfigParam::OrHash)
+        ).void
+      end
       attr_writer :citations
 
       sig { returns(T.nilable(String)) }
@@ -56,7 +60,7 @@ module Anthropic
               Anthropic::URLPDFSource::OrHash
             ),
           cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash),
-          citations: Anthropic::CitationsConfigParam::OrHash,
+          citations: T.nilable(Anthropic::CitationsConfigParam::OrHash),
           context: T.nilable(String),
           title: T.nilable(String),
           type: Symbol
@@ -85,7 +89,7 @@ module Anthropic
               ),
             type: Symbol,
             cache_control: T.nilable(Anthropic::CacheControlEphemeral),
-            citations: Anthropic::CitationsConfigParam,
+            citations: T.nilable(Anthropic::CitationsConfigParam),
             context: T.nilable(String),
             title: T.nilable(String)
           }

data/rbi/anthropic/models/error_response.rbi

@@ -11,6 +11,9 @@ module Anthropic
       sig { returns(Anthropic::ErrorObject::Variants) }
       attr_accessor :error
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :request_id
+
       sig { returns(Symbol) }
       attr_accessor :type
 
@@ -28,15 +31,20 @@ module Anthropic
               Anthropic::APIErrorObject::OrHash,
               Anthropic::OverloadedError::OrHash
             ),
+          request_id: T.nilable(String),
           type: Symbol
         ).returns(T.attached_class)
       end
-      def self.new(error:, type: :error)
+      def self.new(error:, request_id:, type: :error)
       end
 
       sig do
         override.returns(
-          { error: Anthropic::ErrorObject::Variants, type: Symbol }
+          {
+            error: Anthropic::ErrorObject::Variants,
+            request_id: T.nilable(String),
+            type: Symbol
+          }
         )
       end
       def to_hash

data/rbi/anthropic/models/message.rbi

@@ -67,6 +67,10 @@ module Anthropic
       # - `"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
+      # - `"pause_turn"`: we paused a long-running turn. You may provide the response
+      #   back as-is in a subsequent request to let the model continue.
+      # - `"refusal"`: when streaming classifiers intervene to handle potential policy
+      #   violations
       #
       # 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.
@@ -114,11 +118,11 @@ module Anthropic
             T::Array[
               T.any(
                 Anthropic::TextBlock::OrHash,
+                Anthropic::ThinkingBlock::OrHash,
+                Anthropic::RedactedThinkingBlock::OrHash,
                 Anthropic::ToolUseBlock::OrHash,
                 Anthropic::ServerToolUseBlock::OrHash,
-                Anthropic::WebSearchToolResultBlock::OrHash,
-                Anthropic::ThinkingBlock::OrHash,
-                Anthropic::RedactedThinkingBlock::OrHash
+                Anthropic::WebSearchToolResultBlock::OrHash
               )
             ],
           model: T.any(Anthropic::Model::OrSymbol, String),
@@ -179,6 +183,10 @@ module Anthropic
         # - `"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
+        # - `"pause_turn"`: we paused a long-running turn. You may provide the response
+        #   back as-is in a subsequent request to let the model continue.
+        # - `"refusal"`: when streaming classifiers intervene to handle potential policy
+        #   violations
         #
         # 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.

data/rbi/anthropic/models/message_count_tokens_params.rbi

@@ -71,37 +71,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.
       sig { returns(T::Array[Anthropic::MessageParam]) }
       attr_accessor :messages
 
@@ -198,6 +175,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.
@@ -268,6 +251,8 @@ module Anthropic
                 Anthropic::Tool,
                 Anthropic::ToolBash20250124,
                 Anthropic::ToolTextEditor20250124,
+                Anthropic::ToolTextEditor20250429,
+                Anthropic::ToolTextEditor20250728,
                 Anthropic::WebSearchTool20250305
               )
             ]
@@ -284,6 +269,8 @@ module Anthropic
                 Anthropic::Tool::OrHash,
                 Anthropic::ToolBash20250124::OrHash,
                 Anthropic::ToolTextEditor20250124::OrHash,
+                Anthropic::ToolTextEditor20250429::OrHash,
+                Anthropic::ToolTextEditor20250728::OrHash,
                 Anthropic::WebSearchTool20250305::OrHash
               )
             ]
@@ -314,6 +301,8 @@ module Anthropic
                 Anthropic::Tool::OrHash,
                 Anthropic::ToolBash20250124::OrHash,
                 Anthropic::ToolTextEditor20250124::OrHash,
+                Anthropic::ToolTextEditor20250429::OrHash,
+                Anthropic::ToolTextEditor20250728::OrHash,
                 Anthropic::WebSearchTool20250305::OrHash
               )
             ],
@@ -378,37 +367,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:,
         # The model that will complete your prompt.\n\nSee
         # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -440,6 +406,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.
@@ -531,6 +503,8 @@ module Anthropic
                   Anthropic::Tool,
                   Anthropic::ToolBash20250124,
                   Anthropic::ToolTextEditor20250124,
+                  Anthropic::ToolTextEditor20250429,
+                  Anthropic::ToolTextEditor20250728,
                   Anthropic::WebSearchTool20250305
                 )
               ],

data/rbi/anthropic/models/message_count_tokens_tool.rbi

@@ -11,6 +11,8 @@ module Anthropic
             Anthropic::Tool,
             Anthropic::ToolBash20250124,
             Anthropic::ToolTextEditor20250124,
+            Anthropic::ToolTextEditor20250429,
+            Anthropic::ToolTextEditor20250728,
             Anthropic::WebSearchTool20250305
           )
         end