anthropic 1.11.0 → 1.12.0

data/lib/anthropic.rb

@@ -58,6 +58,8 @@ require_relative "anthropic/vertex"
 require_relative "anthropic/internal/stream"
 require_relative "anthropic/internal/jsonl_stream"
 require_relative "anthropic/internal/page"
+require_relative "anthropic/internal/page_cursor"
+require_relative "anthropic/internal/token_page"
 require_relative "anthropic/models/beta/beta_request_document_block"
 require_relative "anthropic/models/anthropic_beta"
 require_relative "anthropic/models/api_error_object"
@@ -106,6 +108,7 @@ require_relative "anthropic/models/beta/beta_code_execution_tool_result_error"
 require_relative "anthropic/models/beta/beta_code_execution_tool_result_error_code"
 require_relative "anthropic/models/beta/beta_code_execution_tool_result_error_param"
 require_relative "anthropic/models/beta/beta_container"
+require_relative "anthropic/models/beta/beta_container_params"
 require_relative "anthropic/models/beta/beta_container_upload_block"
 require_relative "anthropic/models/beta/beta_container_upload_block_param"
 require_relative "anthropic/models/beta/beta_content_block"
@@ -158,6 +161,8 @@ require_relative "anthropic/models/beta/beta_server_tool_usage"
 require_relative "anthropic/models/beta/beta_server_tool_use_block"
 require_relative "anthropic/models/beta/beta_server_tool_use_block_param"
 require_relative "anthropic/models/beta/beta_signature_delta"
+require_relative "anthropic/models/beta/beta_skill"
+require_relative "anthropic/models/beta/beta_skill_params"
 require_relative "anthropic/models/beta/beta_stop_reason"
 require_relative "anthropic/models/beta/beta_text_block"
 require_relative "anthropic/models/beta/beta_text_block_param"
@@ -247,6 +252,22 @@ require_relative "anthropic/models/beta/messages/beta_message_batch_result"
 require_relative "anthropic/models/beta/messages/beta_message_batch_succeeded_result"
 require_relative "anthropic/models/beta/model_list_params"
 require_relative "anthropic/models/beta/model_retrieve_params"
+require_relative "anthropic/models/beta/skill_create_params"
+require_relative "anthropic/models/beta/skill_create_response"
+require_relative "anthropic/models/beta/skill_delete_params"
+require_relative "anthropic/models/beta/skill_delete_response"
+require_relative "anthropic/models/beta/skill_list_params"
+require_relative "anthropic/models/beta/skill_list_response"
+require_relative "anthropic/models/beta/skill_retrieve_params"
+require_relative "anthropic/models/beta/skill_retrieve_response"
+require_relative "anthropic/models/beta/skills/version_create_params"
+require_relative "anthropic/models/beta/skills/version_create_response"
+require_relative "anthropic/models/beta/skills/version_delete_params"
+require_relative "anthropic/models/beta/skills/version_delete_response"
+require_relative "anthropic/models/beta/skills/version_list_params"
+require_relative "anthropic/models/beta/skills/version_list_response"
+require_relative "anthropic/models/beta/skills/version_retrieve_params"
+require_relative "anthropic/models/beta/skills/version_retrieve_response"
 require_relative "anthropic/models/beta_api_error"
 require_relative "anthropic/models/beta_authentication_error"
 require_relative "anthropic/models/beta_billing_error"
@@ -381,6 +402,8 @@ require_relative "anthropic/resources/beta/files"
 require_relative "anthropic/resources/beta/messages"
 require_relative "anthropic/resources/beta/messages/batches"
 require_relative "anthropic/resources/beta/models"
+require_relative "anthropic/resources/beta/skills"
+require_relative "anthropic/resources/beta/skills/versions"
 require_relative "anthropic/resources/completions"
 require_relative "anthropic/resources/messages"
 require_relative "anthropic/resources/messages/batches"

data/rbi/anthropic/internal/page_cursor.rbi

@@ -0,0 +1,25 @@
+# typed: strong
+
+module Anthropic
+  module Internal
+    class PageCursor
+      include Anthropic::Internal::Type::BasePage
+
+      Elem = type_member
+
+      sig { returns(T.nilable(T::Array[Elem])) }
+      attr_accessor :data
+
+      sig { returns(T::Boolean) }
+      attr_accessor :has_more
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :next_page_
+
+      # @api private
+      sig { returns(String) }
+      def inspect
+      end
+    end
+  end
+end

data/rbi/anthropic/internal/token_page.rbi

@@ -0,0 +1,25 @@
+# typed: strong
+
+module Anthropic
+  module Internal
+    class TokenPage
+      include Anthropic::Internal::Type::BasePage
+
+      Elem = type_member
+
+      sig { returns(T.nilable(T::Array[Elem])) }
+      attr_accessor :data
+
+      sig { returns(T::Boolean) }
+      attr_accessor :has_more
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :next_page_
+
+      # @api private
+      sig { returns(String) }
+      def inspect
+      end
+    end
+  end
+end

data/rbi/anthropic/models/anthropic_beta.rbi

@@ -85,6 +85,8 @@ module Anthropic
           :"model-context-window-exceeded-2025-08-26",
           Anthropic::AnthropicBeta::TaggedSymbol
         )
+      SKILLS_2025_10_02 =
+        T.let(:"skills-2025-10-02", Anthropic::AnthropicBeta::TaggedSymbol)
     end
   end
 end

data/rbi/anthropic/models/beta/beta_clear_tool_uses_20250919_edit_response.rbi

@@ -27,7 +27,6 @@ module Anthropic
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # Results for clear_tool_uses_20250919 edit.
         sig do
           params(
             cleared_input_tokens: Integer,

data/rbi/anthropic/models/beta/beta_container.rbi

@@ -19,18 +19,38 @@ module Anthropic
         sig { returns(Time) }
         attr_accessor :expires_at
 
+        # Skills loaded in the container
+        sig { returns(T.nilable(T::Array[Anthropic::Beta::BetaSkill])) }
+        attr_accessor :skills
+
         # Information about the container used in the request (for the code execution
         # tool)
-        sig { params(id: String, expires_at: Time).returns(T.attached_class) }
+        sig do
+          params(
+            id: String,
+            expires_at: Time,
+            skills: T.nilable(T::Array[Anthropic::Beta::BetaSkill::OrHash])
+          ).returns(T.attached_class)
+        end
         def self.new(
           # Identifier for the container used in this request
           id:,
           # The time at which the container will expire.
-          expires_at:
+          expires_at:,
+          # Skills loaded in the container
+          skills:
         )
         end
 
-        sig { override.returns({ id: String, expires_at: Time }) }
+        sig do
+          override.returns(
+            {
+              id: String,
+              expires_at: Time,
+              skills: T.nilable(T::Array[Anthropic::Beta::BetaSkill])
+            }
+          )
+        end
         def to_hash
         end
       end

data/rbi/anthropic/models/beta/beta_container_params.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaContainerParams = Beta::BetaContainerParams
+
+    module Beta
+      class BetaContainerParams < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaContainerParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Container id
+        sig { returns(T.nilable(String)) }
+        attr_accessor :id
+
+        # List of skills to load in the container
+        sig { returns(T.nilable(T::Array[Anthropic::Beta::BetaSkillParams])) }
+        attr_accessor :skills
+
+        # Container parameters with skills to be loaded.
+        sig do
+          params(
+            id: T.nilable(String),
+            skills:
+              T.nilable(T::Array[Anthropic::Beta::BetaSkillParams::OrHash])
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Container id
+          id: nil,
+          # List of skills to load in the container
+          skills: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: T.nilable(String),
+              skills: T.nilable(T::Array[Anthropic::Beta::BetaSkillParams])
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_context_management_config.rbi

@@ -30,7 +30,6 @@ module Anthropic
         end
         attr_writer :edits
 
-        # Configuration for context management operations.
         sig do
           params(
             edits:

data/rbi/anthropic/models/beta/beta_context_management_response.rbi

@@ -22,7 +22,6 @@ module Anthropic
         end
         attr_accessor :applied_edits
 
-        # Information about context management operations applied during the request.
         sig do
           params(
             applied_edits:

data/rbi/anthropic/models/beta/beta_message.rbi

@@ -64,7 +64,9 @@ module Anthropic
         sig { returns(T::Array[Anthropic::Beta::BetaContentBlock::Variants]) }
         attr_accessor :content
 
-        # Information about context management operations applied during the request.
+        # Context management response.
+        #
+        # Information about context management strategies applied during the request.
         sig do
           returns(T.nilable(Anthropic::Beta::BetaContextManagementResponse))
         end
@@ -217,7 +219,9 @@ module Anthropic
           # [{ "type": "text", "text": "B)" }]
           # ```
           content:,
-          # Information about context management operations applied during the request.
+          # Context management response.
+          #
+          # Information about context management strategies applied during the request.
           context_management:,
           # The model that will complete your prompt.\n\nSee
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional

data/rbi/anthropic/models/beta/beta_raw_message_delta_event.rbi

@@ -14,7 +14,7 @@ module Anthropic
             )
           end
 
-        # Information about context management operations applied during the request.
+        # Information about context management strategies applied during the request
         sig do
           returns(T.nilable(Anthropic::Beta::BetaContextManagementResponse))
         end
@@ -74,7 +74,7 @@ module Anthropic
           ).returns(T.attached_class)
         end
         def self.new(
-          # Information about context management operations applied during the request.
+          # Information about context management strategies applied during the request
           context_management:,
           delta:,
           # Billing and rate-limit usage.

data/rbi/anthropic/models/beta/beta_skill.rbi

@@ -0,0 +1,80 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaSkill = Beta::BetaSkill
+
+    module Beta
+      class BetaSkill < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Anthropic::Beta::BetaSkill, Anthropic::Internal::AnyHash)
+          end
+
+        # Skill ID
+        sig { returns(String) }
+        attr_accessor :skill_id
+
+        # Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+        sig { returns(Anthropic::Beta::BetaSkill::Type::TaggedSymbol) }
+        attr_accessor :type
+
+        # Skill version or 'latest' for most recent version
+        sig { returns(String) }
+        attr_accessor :version
+
+        # A skill that was loaded in a container (response model).
+        sig do
+          params(
+            skill_id: String,
+            type: Anthropic::Beta::BetaSkill::Type::OrSymbol,
+            version: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Skill ID
+          skill_id:,
+          # Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+          type:,
+          # Skill version or 'latest' for most recent version
+          version:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              skill_id: String,
+              type: Anthropic::Beta::BetaSkill::Type::TaggedSymbol,
+              version: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias { T.all(Symbol, Anthropic::Beta::BetaSkill::Type) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          ANTHROPIC =
+            T.let(:anthropic, Anthropic::Beta::BetaSkill::Type::TaggedSymbol)
+          CUSTOM =
+            T.let(:custom, Anthropic::Beta::BetaSkill::Type::TaggedSymbol)
+
+          sig do
+            override.returns(
+              T::Array[Anthropic::Beta::BetaSkill::Type::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_skill_params.rbi

@@ -0,0 +1,91 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaSkillParams = Beta::BetaSkillParams
+
+    module Beta
+      class BetaSkillParams < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaSkillParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Skill ID
+        sig { returns(String) }
+        attr_accessor :skill_id
+
+        # Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+        sig { returns(Anthropic::Beta::BetaSkillParams::Type::OrSymbol) }
+        attr_accessor :type
+
+        # Skill version or 'latest' for most recent version
+        sig { returns(T.nilable(String)) }
+        attr_reader :version
+
+        sig { params(version: String).void }
+        attr_writer :version
+
+        # Specification for a skill to be loaded in a container (request model).
+        sig do
+          params(
+            skill_id: String,
+            type: Anthropic::Beta::BetaSkillParams::Type::OrSymbol,
+            version: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Skill ID
+          skill_id:,
+          # Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+          type:,
+          # Skill version or 'latest' for most recent version
+          version: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              skill_id: String,
+              type: Anthropic::Beta::BetaSkillParams::Type::OrSymbol,
+              version: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Anthropic::Beta::BetaSkillParams::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          ANTHROPIC =
+            T.let(
+              :anthropic,
+              Anthropic::Beta::BetaSkillParams::Type::TaggedSymbol
+            )
+          CUSTOM =
+            T.let(:custom, Anthropic::Beta::BetaSkillParams::Type::TaggedSymbol)
+
+          sig do
+            override.returns(
+              T::Array[Anthropic::Beta::BetaSkillParams::Type::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_thinking_config_enabled.rbi

@@ -21,7 +21,7 @@ module Anthropic
         # Must be ≥1024 and less than `max_tokens`.
         #
         # 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 { returns(Integer) }
         attr_accessor :budget_tokens
@@ -40,7 +40,7 @@ module Anthropic
           # Must be ≥1024 and less than `max_tokens`.
           #
           # 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.
           budget_tokens:,
           type: :enabled

data/rbi/anthropic/models/beta/beta_thinking_config_param.rbi

@@ -12,7 +12,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.
       module BetaThinkingConfigParam
         extend Anthropic::Internal::Type::Union

data/rbi/anthropic/models/beta/message_count_tokens_params.rbi

@@ -72,12 +72,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]) }
@@ -89,7 +89,10 @@ module Anthropic
         sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
         attr_accessor :model
 
-        # 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
 
@@ -125,7 +128,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(
@@ -149,7 +152,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(
@@ -212,9 +215,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:
         #
@@ -277,7 +280,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(
@@ -451,12 +454,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:,
@@ -464,7 +467,10 @@ module Anthropic
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
-          # 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,
@@ -472,7 +478,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,
           # Configuration for enabling Claude's extended thinking.
           #
@@ -481,7 +487,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,
@@ -496,9 +502,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:
           #
@@ -561,7 +567,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,
           # Optional header to specify the beta version(s) you want to use.
           betas: nil,
@@ -624,7 +630,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