anthropic 1.11.0 → 1.13.0

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

data/rbi/anthropic/models/beta/skill_create_response.rbi

@@ -0,0 +1,118 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      class SkillCreateResponse < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Models::Beta::SkillCreateResponse,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Unique identifier for the skill.
+        #
+        # The format and length of IDs may change over time.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # ISO 8601 timestamp of when the skill was created.
+        sig { returns(String) }
+        attr_accessor :created_at
+
+        # 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
+
+        # The latest version identifier for the skill.
+        #
+        # This represents the most recent version of the skill that has been created.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :latest_version
+
+        # Source of the skill.
+        #
+        # This may be one of the following values:
+        #
+        # - `"custom"`: the skill was created by a user
+        # - `"anthropic"`: the skill was created by Anthropic
+        sig { returns(String) }
+        attr_accessor :source
+
+        # Object type.
+        #
+        # For Skills, this is always `"skill"`.
+        sig { returns(String) }
+        attr_accessor :type
+
+        # ISO 8601 timestamp of when the skill was last updated.
+        sig { returns(String) }
+        attr_accessor :updated_at
+
+        sig do
+          params(
+            id: String,
+            created_at: String,
+            display_title: T.nilable(String),
+            latest_version: T.nilable(String),
+            source: String,
+            type: String,
+            updated_at: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Unique identifier for the skill.
+          #
+          # The format and length of IDs may change over time.
+          id:,
+          # ISO 8601 timestamp of when the skill was created.
+          created_at:,
+          # Display title for the skill.
+          #
+          # This is a human-readable label that is not included in the prompt sent to the
+          # model.
+          display_title:,
+          # The latest version identifier for the skill.
+          #
+          # This represents the most recent version of the skill that has been created.
+          latest_version:,
+          # Source of the skill.
+          #
+          # This may be one of the following values:
+          #
+          # - `"custom"`: the skill was created by a user
+          # - `"anthropic"`: the skill was created by Anthropic
+          source:,
+          # Object type.
+          #
+          # For Skills, this is always `"skill"`.
+          type:,
+          # ISO 8601 timestamp of when the skill was last updated.
+          updated_at:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: String,
+              display_title: T.nilable(String),
+              latest_version: T.nilable(String),
+              source: String,
+              type: String,
+              updated_at: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/skill_delete_params.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      class SkillDeleteParams < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Internal::Type::RequestParameters::Converter
+        include Anthropic::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::SkillDeleteParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # 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(
+            betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+            request_options: Anthropic::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Optional header to specify the beta version(s) you want to use.
+          betas: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              betas:
+                T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+              request_options: Anthropic::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/skill_delete_response.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      class SkillDeleteResponse < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Models::Beta::SkillDeleteResponse,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Unique identifier for the skill.
+        #
+        # The format and length of IDs may change over time.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Deleted object type.
+        #
+        # For Skills, this is always `"skill_deleted"`.
+        sig { returns(String) }
+        attr_accessor :type
+
+        sig { params(id: String, type: String).returns(T.attached_class) }
+        def self.new(
+          # Unique identifier for the skill.
+          #
+          # The format and length of IDs may change over time.
+          id:,
+          # Deleted object type.
+          #
+          # For Skills, this is always `"skill_deleted"`.
+          type:
+        )
+        end
+
+        sig { override.returns({ id: String, type: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/skill_list_params.rbi

@@ -0,0 +1,109 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      class SkillListParams < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Internal::Type::RequestParameters::Converter
+        include Anthropic::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::SkillListParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Number of results to return per page.
+        #
+        # Maximum value is 100. Defaults to 20.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :limit
+
+        sig { params(limit: Integer).void }
+        attr_writer :limit
+
+        # Pagination token for fetching a specific page of results.
+        #
+        # Pass the value from a previous response's `next_page` field to get the next page
+        # of results.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :page
+
+        # Filter skills by source.
+        #
+        # If provided, only skills from the specified source will be returned:
+        #
+        # - `"custom"`: only return user-created skills
+        # - `"anthropic"`: only return Anthropic-created skills
+        sig { returns(T.nilable(String)) }
+        attr_accessor :source
+
+        # 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(
+            limit: Integer,
+            page: T.nilable(String),
+            source: T.nilable(String),
+            betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+            request_options: Anthropic::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Number of results to return per page.
+          #
+          # Maximum value is 100. Defaults to 20.
+          limit: nil,
+          # Pagination token for fetching a specific page of results.
+          #
+          # Pass the value from a previous response's `next_page` field to get the next page
+          # of results.
+          page: nil,
+          # Filter skills by source.
+          #
+          # If provided, only skills from the specified source will be returned:
+          #
+          # - `"custom"`: only return user-created skills
+          # - `"anthropic"`: only return Anthropic-created skills
+          source: nil,
+          # Optional header to specify the beta version(s) you want to use.
+          betas: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              limit: Integer,
+              page: T.nilable(String),
+              source: T.nilable(String),
+              betas:
+                T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+              request_options: Anthropic::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end