anthropic 1.1.1 → 1.6.0

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,16 @@ 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::BetaToolTextEditor20250728,
+                  Anthropic::Beta::BetaWebSearchTool20250305
                 )
               ]
             )
@@ -381,15 +388,16 @@ 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::BetaToolTextEditor20250728::OrHash,
+                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                 )
               ]
           ).void
@@ -473,15 +481,16 @@ 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::BetaToolTextEditor20250728::OrHash,
+                  Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                 )
               ],
             top_k: Integer,
@@ -586,7 +595,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 +658,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 +782,16 @@ 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::BetaToolTextEditor20250728,
+                    Anthropic::Beta::BetaWebSearchTool20250305
                   )
                 ],
               top_k: Integer,

data/rbi/anthropic/models/beta/messages/batch_create_params.rbi

@@ -253,7 +253,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
 
@@ -447,6 +447,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.
@@ -515,15 +521,16 @@ 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::BetaToolTextEditor20250728,
+                        Anthropic::Beta::BetaWebSearchTool20250305
                       )
                     ]
                   )
@@ -537,15 +544,16 @@ 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::BetaToolTextEditor20250728::OrHash,
+                        Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                       )
                     ]
                 ).void
@@ -618,15 +626,16 @@ 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::BetaToolTextEditor20250728::OrHash,
+                        Anthropic::Beta::BetaWebSearchTool20250305::OrHash
                       )
                     ],
                   top_k: Integer,
@@ -729,7 +738,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
@@ -797,6 +806,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.
@@ -916,15 +931,16 @@ 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::BetaToolTextEditor20250728,
+                          Anthropic::Beta::BetaWebSearchTool20250305
                         )
                       ],
                     top_k: Integer,

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/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.