anthropic 1.11.0 → 1.12.0

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

@@ -21,7 +21,7 @@ module Anthropic
         # only specifies the absolute maximum number of tokens to generate.
         #
         # Different models have different maximum values for this parameter. See
-        # [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+        # [models](https://docs.claude.com/en/docs/models-overview) for details.
         sig { returns(Integer) }
         attr_accessor :max_tokens
 
@@ -82,12 +82,12 @@ module Anthropic
         # { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
         # ```
         #
-        # See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+        # See [input examples](https://docs.claude.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.
+        # [system prompt](https://docs.claude.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 100,000 messages in a single request.
         sig { returns(T::Array[Anthropic::Beta::BetaMessageParam]) }
@@ -100,10 +100,17 @@ module Anthropic
         attr_accessor :model
 
         # Container identifier for reuse across requests.
-        sig { returns(T.nilable(String)) }
+        sig do
+          returns(
+            T.nilable(T.any(Anthropic::Beta::BetaContainerParams, String))
+          )
+        end
         attr_accessor :container
 
-        # Configuration for context management operations.
+        # Context management configuration.
+        #
+        # This allows you to control how Claude manages context across multiple requests,
+        # such as whether to clear function results or not.
         sig { returns(T.nilable(Anthropic::Beta::BetaContextManagementConfig)) }
         attr_reader :context_management
 
@@ -146,7 +153,7 @@ module Anthropic
         # for this request.
         #
         # Anthropic offers different levels of service for your API requests. See
-        # [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+        # [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
         sig do
           returns(
             T.nilable(
@@ -183,7 +190,7 @@ module Anthropic
         #
         # A system prompt is a way of providing context and instructions to Claude, such
         # as specifying a particular goal or role. See our
-        # [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+        # [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
         sig do
           returns(
             T.nilable(Anthropic::Beta::MessageCreateParams::System::Variants)
@@ -219,7 +226,7 @@ module Anthropic
         # tokens and counts towards your `max_tokens` limit.
         #
         # See
-        # [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+        # [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
         # for details.
         sig do
           returns(
@@ -282,9 +289,9 @@ module Anthropic
         #
         # 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),
+        # [server tools](https://docs.claude.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)).
+        # [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
         #
         # Each tool definition includes:
         #
@@ -347,7 +354,7 @@ module Anthropic
         # functions, or more generally whenever you want the model to produce a particular
         # JSON structure of output.
         #
-        # See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+        # See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
         sig do
           returns(
             T.nilable(
@@ -449,7 +456,10 @@ module Anthropic
             max_tokens: Integer,
             messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
             model: T.any(Anthropic::Model::OrSymbol, String),
-            container: T.nilable(String),
+            container:
+              T.nilable(
+                T.any(Anthropic::Beta::BetaContainerParams::OrHash, String)
+              ),
             context_management:
               T.nilable(Anthropic::Beta::BetaContextManagementConfig::OrHash),
             mcp_servers:
@@ -506,7 +516,7 @@ module Anthropic
           # only specifies the absolute maximum number of tokens to generate.
           #
           # Different models have different maximum values for this parameter. See
-          # [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+          # [models](https://docs.claude.com/en/docs/models-overview) for details.
           max_tokens:,
           # Input messages.
           #
@@ -565,12 +575,12 @@ module Anthropic
           # { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
           # ```
           #
-          # See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+          # See [input examples](https://docs.claude.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.
+          # [system prompt](https://docs.claude.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 100,000 messages in a single request.
           messages:,
@@ -580,7 +590,10 @@ module Anthropic
           model:,
           # Container identifier for reuse across requests.
           container: nil,
-          # Configuration for context management operations.
+          # Context management configuration.
+          #
+          # This allows you to control how Claude manages context across multiple requests,
+          # such as whether to clear function results or not.
           context_management: nil,
           # MCP servers to be utilized in this request
           mcp_servers: nil,
@@ -590,7 +603,7 @@ module Anthropic
           # for this request.
           #
           # Anthropic offers different levels of service for your API requests. See
-          # [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+          # [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
           service_tier: nil,
           # Custom text sequences that will cause the model to stop generating.
           #
@@ -606,7 +619,7 @@ module Anthropic
           #
           # A system prompt is a way of providing context and instructions to Claude, such
           # as specifying a particular goal or role. See our
-          # [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+          # [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
           system_: nil,
           # Amount of randomness injected into the response.
           #
@@ -624,7 +637,7 @@ module Anthropic
           # tokens and counts towards your `max_tokens` limit.
           #
           # See
-          # [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+          # [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
           # for details.
           thinking: nil,
           # How the model should use the provided tools. The model can use a specific tool,
@@ -639,9 +652,9 @@ module Anthropic
           #
           # 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),
+          # [server tools](https://docs.claude.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)).
+          # [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
           #
           # Each tool definition includes:
           #
@@ -704,7 +717,7 @@ module Anthropic
           # functions, or more generally whenever you want the model to produce a particular
           # JSON structure of output.
           #
-          # See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+          # See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
           tools: nil,
           # Only sample from the top K options for each subsequent token.
           #
@@ -736,7 +749,8 @@ module Anthropic
               max_tokens: Integer,
               messages: T::Array[Anthropic::Beta::BetaMessageParam],
               model: T.any(Anthropic::Model::OrSymbol, String),
-              container: T.nilable(String),
+              container:
+                T.nilable(T.any(Anthropic::Beta::BetaContainerParams, String)),
               context_management:
                 T.nilable(Anthropic::Beta::BetaContextManagementConfig),
               mcp_servers:
@@ -789,11 +803,29 @@ module Anthropic
         def to_hash
         end
 
+        # Container identifier for reuse across requests.
+        module Container
+          extend Anthropic::Internal::Type::Union
+
+          Variants =
+            T.type_alias { T.any(Anthropic::Beta::BetaContainerParams, String) }
+
+          sig do
+            override.returns(
+              T::Array[
+                Anthropic::Beta::MessageCreateParams::Container::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
+
         # Determines whether to use priority capacity (if available) or standard capacity
         # for this request.
         #
         # Anthropic offers different levels of service for your API requests. See
-        # [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+        # [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
         module ServiceTier
           extend Anthropic::Internal::Type::Enum
 
@@ -829,7 +861,7 @@ module Anthropic
         #
         # A system prompt is a way of providing context and instructions to Claude, such
         # as specifying a particular goal or role. See our
-        # [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+        # [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
         module System
           extend Anthropic::Internal::Type::Union
 

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

@@ -162,7 +162,7 @@ module Anthropic
               # only specifies the absolute maximum number of tokens to generate.
               #
               # Different models have different maximum values for this parameter. See
-              # [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+              # [models](https://docs.claude.com/en/docs/models-overview) for details.
               sig { returns(Integer) }
               attr_accessor :max_tokens
 
@@ -223,12 +223,12 @@ module Anthropic
               # { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               # ```
               #
-              # See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              # See [input examples](https://docs.claude.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.
+              # [system prompt](https://docs.claude.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 100,000 messages in a single request.
               sig { returns(T::Array[Anthropic::Beta::BetaMessageParam]) }
@@ -241,10 +241,17 @@ module Anthropic
               attr_accessor :model
 
               # Container identifier for reuse across requests.
-              sig { returns(T.nilable(String)) }
+              sig do
+                returns(
+                  T.nilable(T.any(Anthropic::Beta::BetaContainerParams, String))
+                )
+              end
               attr_accessor :container
 
-              # Configuration for context management operations.
+              # Context management configuration.
+              #
+              # This allows you to control how Claude manages context across multiple requests,
+              # such as whether to clear function results or not.
               sig do
                 returns(T.nilable(Anthropic::Beta::BetaContextManagementConfig))
               end
@@ -293,7 +300,7 @@ module Anthropic
               # for this request.
               #
               # Anthropic offers different levels of service for your API requests. See
-              # [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              # [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
               sig do
                 returns(
                   T.nilable(
@@ -328,8 +335,7 @@ module Anthropic
 
               # Whether to incrementally stream the response using server-sent events.
               #
-              # See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-              # details.
+              # See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
               sig { returns(T.nilable(T::Boolean)) }
               attr_reader :stream
 
@@ -340,7 +346,7 @@ module Anthropic
               #
               # A system prompt is a way of providing context and instructions to Claude, such
               # as specifying a particular goal or role. See our
-              # [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              # [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
               sig do
                 returns(
                   T.nilable(
@@ -379,7 +385,7 @@ module Anthropic
               # tokens and counts towards your `max_tokens` limit.
               #
               # See
-              # [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              # [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               # for details.
               sig do
                 returns(
@@ -442,9 +448,9 @@ module Anthropic
               #
               # 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),
+              # [server tools](https://docs.claude.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)).
+              # [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
               #
               # Each tool definition includes:
               #
@@ -507,7 +513,7 @@ module Anthropic
               # functions, or more generally whenever you want the model to produce a particular
               # JSON structure of output.
               #
-              # See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              # See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
               sig do
                 returns(
                   T.nilable(
@@ -596,7 +602,13 @@ module Anthropic
                   max_tokens: Integer,
                   messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
                   model: T.any(Anthropic::Model::OrSymbol, String),
-                  container: T.nilable(String),
+                  container:
+                    T.nilable(
+                      T.any(
+                        Anthropic::Beta::BetaContainerParams::OrHash,
+                        String
+                      )
+                    ),
                   context_management:
                     T.nilable(
                       Anthropic::Beta::BetaContextManagementConfig::OrHash
@@ -655,7 +667,7 @@ module Anthropic
                 # only specifies the absolute maximum number of tokens to generate.
                 #
                 # Different models have different maximum values for this parameter. See
-                # [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+                # [models](https://docs.claude.com/en/docs/models-overview) for details.
                 max_tokens:,
                 # Input messages.
                 #
@@ -714,12 +726,12 @@ module Anthropic
                 # { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
                 # ```
                 #
-                # See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+                # See [input examples](https://docs.claude.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.
+                # [system prompt](https://docs.claude.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 100,000 messages in a single request.
                 messages:,
@@ -729,7 +741,10 @@ module Anthropic
                 model:,
                 # Container identifier for reuse across requests.
                 container: nil,
-                # Configuration for context management operations.
+                # Context management configuration.
+                #
+                # This allows you to control how Claude manages context across multiple requests,
+                # such as whether to clear function results or not.
                 context_management: nil,
                 # MCP servers to be utilized in this request
                 mcp_servers: nil,
@@ -739,7 +754,7 @@ module Anthropic
                 # for this request.
                 #
                 # Anthropic offers different levels of service for your API requests. See
-                # [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+                # [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
                 service_tier: nil,
                 # Custom text sequences that will cause the model to stop generating.
                 #
@@ -753,14 +768,13 @@ module Anthropic
                 stop_sequences: nil,
                 # Whether to incrementally stream the response using server-sent events.
                 #
-                # See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-                # details.
+                # See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
                 stream: nil,
                 # System prompt.
                 #
                 # A system prompt is a way of providing context and instructions to Claude, such
                 # as specifying a particular goal or role. See our
-                # [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+                # [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
                 system_: nil,
                 # Amount of randomness injected into the response.
                 #
@@ -778,7 +792,7 @@ module Anthropic
                 # tokens and counts towards your `max_tokens` limit.
                 #
                 # See
-                # [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+                # [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
                 # for details.
                 thinking: nil,
                 # How the model should use the provided tools. The model can use a specific tool,
@@ -793,9 +807,9 @@ module Anthropic
                 #
                 # 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),
+                # [server tools](https://docs.claude.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)).
+                # [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
                 #
                 # Each tool definition includes:
                 #
@@ -858,7 +872,7 @@ module Anthropic
                 # functions, or more generally whenever you want the model to produce a particular
                 # JSON structure of output.
                 #
-                # See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+                # See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
                 tools: nil,
                 # Only sample from the top K options for each subsequent token.
                 #
@@ -887,7 +901,10 @@ module Anthropic
                     max_tokens: Integer,
                     messages: T::Array[Anthropic::Beta::BetaMessageParam],
                     model: T.any(Anthropic::Model::OrSymbol, String),
-                    container: T.nilable(String),
+                    container:
+                      T.nilable(
+                        T.any(Anthropic::Beta::BetaContainerParams, String)
+                      ),
                     context_management:
                       T.nilable(Anthropic::Beta::BetaContextManagementConfig),
                     mcp_servers:
@@ -941,11 +958,31 @@ module Anthropic
               def to_hash
               end
 
+              # Container identifier for reuse across requests.
+              module Container
+                extend Anthropic::Internal::Type::Union
+
+                Variants =
+                  T.type_alias do
+                    T.any(Anthropic::Beta::BetaContainerParams, String)
+                  end
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Anthropic::Beta::Messages::BatchCreateParams::Request::Params::Container::Variants
+                    ]
+                  )
+                end
+                def self.variants
+                end
+              end
+
               # Determines whether to use priority capacity (if available) or standard capacity
               # for this request.
               #
               # Anthropic offers different levels of service for your API requests. See
-              # [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              # [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
               module ServiceTier
                 extend Anthropic::Internal::Type::Enum
 
@@ -984,7 +1021,7 @@ module Anthropic
               #
               # A system prompt is a way of providing context and instructions to Claude, such
               # as specifying a particular goal or role. See our
-              # [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              # [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
               module System
                 extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/skill_create_params.rbi

@@ -0,0 +1,90 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      class SkillCreateParams < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Internal::Type::RequestParameters::Converter
+        include Anthropic::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::SkillCreateParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Display title for the skill.
+        #
+        # This is a human-readable label that is not included in the prompt sent to the
+        # model.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :display_title
+
+        # Files to upload for the skill.
+        #
+        # All files must be in the same top-level directory and must include a SKILL.md
+        # file at the root of that directory.
+        sig { returns(T.nilable(T::Array[Anthropic::Internal::FileInput])) }
+        attr_accessor :files
+
+        # Optional header to specify the beta version(s) you want to use.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)]
+            )
+          )
+        end
+        attr_reader :betas
+
+        sig do
+          params(
+            betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)]
+          ).void
+        end
+        attr_writer :betas
+
+        sig do
+          params(
+            display_title: T.nilable(String),
+            files: T.nilable(T::Array[Anthropic::Internal::FileInput]),
+            betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+            request_options: Anthropic::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Display title for the skill.
+          #
+          # This is a human-readable label that is not included in the prompt sent to the
+          # model.
+          display_title: nil,
+          # Files to upload for the skill.
+          #
+          # All files must be in the same top-level directory and must include a SKILL.md
+          # file at the root of that directory.
+          files: nil,
+          # Optional header to specify the beta version(s) you want to use.
+          betas: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              display_title: T.nilable(String),
+              files: T.nilable(T::Array[Anthropic::Internal::FileInput]),
+              betas:
+                T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+              request_options: Anthropic::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end