anthropic 1.11.0 → 1.12.0

data/rbi/anthropic/resources/beta/messages.rbi

@@ -21,7 +21,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:
@@ -79,7 +82,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:,
           # Body param: Input messages.
           #
@@ -138,12 +141,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:,
@@ -153,7 +156,10 @@ module Anthropic
           model:,
           # Body param: Container identifier for reuse across requests.
           container: nil,
-          # Body param: Configuration for context management operations.
+          # Body param: 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,
           # Body param: MCP servers to be utilized in this request
           mcp_servers: nil,
@@ -163,7 +169,7 @@ module Anthropic
           # 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.
           service_tier: nil,
           # Body param: Custom text sequences that will cause the model to stop generating.
           #
@@ -179,7 +185,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,
           # Body param: Amount of randomness injected into the response.
           #
@@ -197,7 +203,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,
           # Body param: How the model should use the provided tools. The model can use a
@@ -212,9 +218,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 +283,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,
           # Body param: Only sample from the top K options for each subsequent token.
           #
@@ -320,7 +326,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:
@@ -382,7 +391,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:,
           # Body param: Input messages.
           #
@@ -441,12 +450,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:,
@@ -456,7 +465,10 @@ module Anthropic
           model:,
           # Body param: Container identifier for reuse across requests.
           container: nil,
-          # Body param: Configuration for context management operations.
+          # Body param: 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,
           # Body param: MCP servers to be utilized in this request
           mcp_servers: nil,
@@ -466,7 +478,7 @@ module Anthropic
           # 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.
           service_tier: nil,
           # Body param: Custom text sequences that will cause the model to stop generating.
           #
@@ -482,7 +494,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,
           # Body param: Amount of randomness injected into the response.
           #
@@ -500,7 +512,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,
           # Body param: How the model should use the provided tools. The model can use a
@@ -515,9 +527,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:
           #
@@ -580,7 +592,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,
           # Body param: Only sample from the top K options for each subsequent token.
           #
@@ -721,12 +733,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:,
@@ -734,7 +746,10 @@ module Anthropic
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
-          # Body param: Configuration for context management operations.
+          # Body param: 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,
           # Body param: MCP servers to be utilized in this request
           mcp_servers: nil,
@@ -742,7 +757,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,
           # Body param: Configuration for enabling Claude's extended thinking.
           #
@@ -751,7 +766,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,
           # Body param: How the model should use the provided tools. The model can use a
@@ -766,9 +781,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:
           #
@@ -831,7 +846,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,
           # Header param: Optional header to specify the beta version(s) you want to use.
           betas: nil,

data/rbi/anthropic/resources/beta/skills/versions.rbi

@@ -0,0 +1,124 @@
+# typed: strong
+
+module Anthropic
+  module Resources
+    class Beta
+      class Skills
+        class Versions
+          # Create Skill Version
+          sig do
+            params(
+              skill_id: String,
+              files: T.nilable(T::Array[Anthropic::Internal::FileInput]),
+              betas:
+                T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+              request_options: Anthropic::RequestOptions::OrHash
+            ).returns(Anthropic::Models::Beta::Skills::VersionCreateResponse)
+          end
+          def create(
+            # Path param: Unique identifier for the skill.
+            #
+            # The format and length of IDs may change over time.
+            skill_id,
+            # Body param: 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,
+            # Header param: Optional header to specify the beta version(s) you want to use.
+            betas: nil,
+            request_options: {}
+          )
+          end
+
+          # Get Skill Version
+          sig do
+            params(
+              version: String,
+              skill_id: String,
+              betas:
+                T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+              request_options: Anthropic::RequestOptions::OrHash
+            ).returns(Anthropic::Models::Beta::Skills::VersionRetrieveResponse)
+          end
+          def retrieve(
+            # Path param: Version identifier for the skill.
+            #
+            # Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+            version,
+            # Path param: Unique identifier for the skill.
+            #
+            # The format and length of IDs may change over time.
+            skill_id:,
+            # Header param: Optional header to specify the beta version(s) you want to use.
+            betas: nil,
+            request_options: {}
+          )
+          end
+
+          # List Skill Versions
+          sig do
+            params(
+              skill_id: String,
+              limit: T.nilable(Integer),
+              page: T.nilable(String),
+              betas:
+                T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+              request_options: Anthropic::RequestOptions::OrHash
+            ).returns(
+              Anthropic::Internal::PageCursor[
+                Anthropic::Models::Beta::Skills::VersionListResponse
+              ]
+            )
+          end
+          def list(
+            # Path param: Unique identifier for the skill.
+            #
+            # The format and length of IDs may change over time.
+            skill_id,
+            # Query param: Number of items to return per page.
+            #
+            # Defaults to `20`. Ranges from `1` to `1000`.
+            limit: nil,
+            # Query param: Optionally set to the `next_page` token from the previous response.
+            page: nil,
+            # Header param: Optional header to specify the beta version(s) you want to use.
+            betas: nil,
+            request_options: {}
+          )
+          end
+
+          # Delete Skill Version
+          sig do
+            params(
+              version: String,
+              skill_id: String,
+              betas:
+                T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+              request_options: Anthropic::RequestOptions::OrHash
+            ).returns(Anthropic::Models::Beta::Skills::VersionDeleteResponse)
+          end
+          def delete(
+            # Path param: Version identifier for the skill.
+            #
+            # Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+            version,
+            # Path param: Unique identifier for the skill.
+            #
+            # The format and length of IDs may change over time.
+            skill_id:,
+            # Header param: Optional header to specify the beta version(s) you want to use.
+            betas: nil,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Anthropic::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/resources/beta/skills.rbi

@@ -0,0 +1,118 @@
+# typed: strong
+
+module Anthropic
+  module Resources
+    class Beta
+      class Skills
+        sig { returns(Anthropic::Resources::Beta::Skills::Versions) }
+        attr_reader :versions
+
+        # Create Skill
+        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(Anthropic::Models::Beta::SkillCreateResponse)
+        end
+        def create(
+          # Body param: 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,
+          # Body param: 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,
+          # Header param: Optional header to specify the beta version(s) you want to use.
+          betas: nil,
+          request_options: {}
+        )
+        end
+
+        # Get Skill
+        sig do
+          params(
+            skill_id: String,
+            betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+            request_options: Anthropic::RequestOptions::OrHash
+          ).returns(Anthropic::Models::Beta::SkillRetrieveResponse)
+        end
+        def retrieve(
+          # Unique identifier for the skill.
+          #
+          # The format and length of IDs may change over time.
+          skill_id,
+          # Optional header to specify the beta version(s) you want to use.
+          betas: nil,
+          request_options: {}
+        )
+        end
+
+        # List Skills
+        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(
+            Anthropic::Internal::PageCursor[
+              Anthropic::Models::Beta::SkillListResponse
+            ]
+          )
+        end
+        def list(
+          # Query param: Number of results to return per page.
+          #
+          # Maximum value is 100. Defaults to 20.
+          limit: nil,
+          # Query param: 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,
+          # Query param: 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,
+          # Header param: Optional header to specify the beta version(s) you want to use.
+          betas: nil,
+          request_options: {}
+        )
+        end
+
+        # Delete Skill
+        sig do
+          params(
+            skill_id: String,
+            betas: T::Array[T.any(String, Anthropic::AnthropicBeta::OrSymbol)],
+            request_options: Anthropic::RequestOptions::OrHash
+          ).returns(Anthropic::Models::Beta::SkillDeleteResponse)
+        end
+        def delete(
+          # Unique identifier for the skill.
+          #
+          # The format and length of IDs may change over time.
+          skill_id,
+          # Optional header to specify the beta version(s) you want to use.
+          betas: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Anthropic::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/resources/beta.rbi

@@ -12,6 +12,9 @@ module Anthropic
       sig { returns(Anthropic::Resources::Beta::Files) }
       attr_reader :files
 
+      sig { returns(Anthropic::Resources::Beta::Skills) }
+      attr_reader :skills
+
       # @api private
       sig { params(client: Anthropic::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/anthropic/resources/completions.rbi

@@ -9,10 +9,10 @@ module Anthropic
       # [Legacy] Create a Text Completion.
       #
       # The Text Completions API is a legacy API. We recommend using the
-      # [Messages API](https://docs.anthropic.com/en/api/messages) going forward.
+      # [Messages API](https://docs.claude.com/en/api/messages) going forward.
       #
       # Future models and features will not be compatible with Text Completions. See our
-      # [migration guide](https://docs.anthropic.com/en/api/migrating-from-text-completions-to-messages)
+      # [migration guide](https://docs.claude.com/en/api/migrating-from-text-completions-to-messages)
       # for guidance in migrating from Text Completions to Messages.
       sig do
         params(
@@ -48,10 +48,9 @@ module Anthropic
         # "\n\nHuman: {userQuestion}\n\nAssistant:"
         # ```
         #
-        # See [prompt validation](https://docs.anthropic.com/en/api/prompt-validation) and
-        # our guide to
-        # [prompt design](https://docs.anthropic.com/en/docs/intro-to-prompting) for more
-        # details.
+        # See [prompt validation](https://docs.claude.com/en/api/prompt-validation) and
+        # our guide to [prompt design](https://docs.claude.com/en/docs/intro-to-prompting)
+        # for more details.
         prompt:,
         # Body param: An object describing metadata about the request.
         metadata: nil,
@@ -102,10 +101,10 @@ module Anthropic
       # [Legacy] Create a Text Completion.
       #
       # The Text Completions API is a legacy API. We recommend using the
-      # [Messages API](https://docs.anthropic.com/en/api/messages) going forward.
+      # [Messages API](https://docs.claude.com/en/api/messages) going forward.
       #
       # Future models and features will not be compatible with Text Completions. See our
-      # [migration guide](https://docs.anthropic.com/en/api/migrating-from-text-completions-to-messages)
+      # [migration guide](https://docs.claude.com/en/api/migrating-from-text-completions-to-messages)
       # for guidance in migrating from Text Completions to Messages.
       sig do
         params(
@@ -141,10 +140,9 @@ module Anthropic
         # "\n\nHuman: {userQuestion}\n\nAssistant:"
         # ```
         #
-        # See [prompt validation](https://docs.anthropic.com/en/api/prompt-validation) and
-        # our guide to
-        # [prompt design](https://docs.anthropic.com/en/docs/intro-to-prompting) for more
-        # details.
+        # See [prompt validation](https://docs.claude.com/en/api/prompt-validation) and
+        # our guide to [prompt design](https://docs.claude.com/en/docs/intro-to-prompting)
+        # for more details.
         prompt:,
         # Body param: An object describing metadata about the request.
         metadata: nil,