anthropic 1.29.0 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9903ffc6a65a97e1aecd5d543076498736d593e5e415b6858b735f43212071ce
-  data.tar.gz: dd482586dd325a06e741621608b8bcf6a609e1f094b7ac2b8da740da1f3d6af6
+  metadata.gz: 8aab10e21c0279e597f589729ae1c75eea479e40c20230c1dce25277e60e5c5e
+  data.tar.gz: d8fabdc1a69bf3f1306913776d8025363288328d0a2f293953e13736f8833bb2
 SHA512:
-  metadata.gz: 552efd90cf4c12ac0bc67fdf37043e6507d73e4532e8619b47c36eaf1dd87e2cf8ba6585f9fa03b6b2f6dfed7a185530255781e35cb229467b26faa20b1c95a5
-  data.tar.gz: e6b42808531ee1b092b83b2c03381c215b3165f3528420b171aa99cd4a75c95697e5250ad2b65e8cf0b12164ec9fd5698fa34f6f068486a09684cf357adbce68
+  metadata.gz: 7768d7acc3a779b8a599854bf04ca18ee8c2d66888fcfc9702d926d903d9866ec84f092d06ca5d9fc55dcf5aed3101056e76048ceaf0435ae6bfae067eeee392
+  data.tar.gz: fca1a27acd1ac6d990f4008e8575d8b9d8b193da7f0ca70563a3fb30328dfa059aad62a1c075f1f35c3cb0d5136d6860be55c955866912dca08e6cc7703f29d0

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.31.0 (2026-04-08)
+
+Full Changelog: [v1.30.0...v1.31.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.30.0...v1.31.0)
+
+### Features
+
+* **api:** add support for Claude Managed Agents ([29ea039](https://github.com/anthropics/anthropic-sdk-ruby/commit/29ea03965f33fb0ed07472f7f061c70357f2c8f5))
+
+## 1.30.0 (2026-04-07)
+
+Full Changelog: [v1.29.0...v1.30.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.29.0...v1.30.0)
+
+### Features
+
+* **bedrock:** Create Bedrock Mantle client ([#874](https://github.com/anthropics/anthropic-sdk-ruby/issues/874)) ([627135f](https://github.com/anthropics/anthropic-sdk-ruby/commit/627135fbcf4fd02ed1370c3d209be7c23736f3d8))
+
 ## 1.29.0 (2026-04-07)
 
 Full Changelog: [v1.28.0...v1.29.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.28.0...v1.29.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.29.0"
+gem "anthropic", "~> 1.31.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/anthropic/bedrock_mantle.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Anthropic
+  BedrockMantleClient = Anthropic::Helpers::Bedrock::MantleClient
+end

data/lib/anthropic/helpers/aws_auth.rb

@@ -32,14 +32,14 @@ module Anthropic
         aws_session_token:,
         aws_profile:,
         aws_region:,
-        workspace_id:,
         skip_auth:,
         base_url:,
         service_name:,
         env_api_key:,
-        env_workspace_id:,
         derive_base_url:,
+        workspace_id: nil,
         env_api_key_fallback: nil,
+        env_workspace_id: nil,
         env_workspace_id_fallback: nil
       )
         begin
@@ -101,17 +101,19 @@ module Anthropic
         end
 
         # Workspace ID: constructor > primary env > fallback env
-        resolved_workspace_id = workspace_id
-        if resolved_workspace_id.to_s.empty?
-          resolved_workspace_id = env_lookup(env_workspace_id, env_workspace_id_fallback)
-        end
-        @workspace_id = resolved_workspace_id.to_s.empty? ? nil : resolved_workspace_id.to_s
-
-        unless @skip_auth
-          if @workspace_id.nil?
-            # rubocop:disable Layout/LineLength
-            raise ArgumentError.new("No workspace ID found. Set the `workspace_id` argument or the `#{env_workspace_id}` environment variable.")
-            # rubocop:enable Layout/LineLength
+        if env_workspace_id
+          resolved_workspace_id = workspace_id
+          if resolved_workspace_id.to_s.empty?
+            resolved_workspace_id = env_lookup(env_workspace_id, env_workspace_id_fallback)
+          end
+          @workspace_id = resolved_workspace_id.to_s.empty? ? nil : resolved_workspace_id.to_s
+
+          unless @skip_auth
+            if @workspace_id.nil?
+              # rubocop:disable Layout/LineLength
+              raise ArgumentError.new("No workspace ID found. Set the `workspace_id` argument or the `#{env_workspace_id}` environment variable.")
+              # rubocop:enable Layout/LineLength
+            end
           end
         end
 

data/lib/anthropic/helpers/bedrock/mantle_client.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    module Bedrock
+      # Client for the Anthropic Bedrock Mantle API. Only the Messages API (/v1/messages)
+      # and its subpaths are supported.
+      #
+      # Auth is resolved by the same precedence as the AWS gateway client, with
+      # Mantle-specific environment variables that fall back to the AWS equivalents:
+      #
+      #   1. `api_key` constructor arg → API key mode (x-api-key header, no SigV4)
+      #   2. `aws_access_key` + `aws_secret_access_key` args → SigV4 with explicit credentials
+      #   3. `aws_profile` arg → SigV4 with named AWS profile
+      #   4. `AWS_BEARER_TOKEN_BEDROCK` env (then `ANTHROPIC_AWS_API_KEY`) → API key mode
+      #   5. Default AWS credential chain → SigV4
+      class MantleClient < Anthropic::Client
+        include Anthropic::Helpers::AWSAuth
+
+        # @return [String, nil]
+        attr_reader :aws_region
+
+        # @return [Anthropic::Resources::Messages]
+        attr_reader :messages
+
+        # @return [Anthropic::Helpers::Bedrock::MantleClient::MantleBeta]
+        attr_reader :beta
+
+        # Creates and returns a new client for interacting with Anthropic models via Bedrock Mantle.
+        # Only the Messages API (/v1/messages) is supported.
+        #
+        # @param api_key [String, nil] Anthropic API key (bypasses SigV4, uses x-api-key header)
+        #
+        # @param aws_access_key [String, nil] AWS access key ID for SigV4 signing
+        #
+        # @param aws_secret_access_key [String, nil] AWS secret access key for SigV4 signing
+        #
+        # @param aws_session_token [String, nil] Optional AWS session token for temporary credentials
+        #
+        # @param aws_profile [String, nil] AWS profile name (uses SigV4 with named profile)
+        #
+        # @param aws_region [String, nil] AWS region for the base URL and SigV4 signing.
+        #   Defaults to `ENV["AWS_REGION"]`, then `ENV["AWS_DEFAULT_REGION"]`. Required in SigV4 mode.
+        #
+        # @param skip_auth [Boolean] When true, skip all auth.
+        #   Note: the base SDK may still send an X-Api-Key header if ANTHROPIC_API_KEY is set.
+        #
+        # @param base_url [String, nil] Override the default base URL for the API.
+        #   Defaults to `ENV["ANTHROPIC_BEDROCK_MANTLE_BASE_URL"]`, then
+        #   `https://bedrock-mantle.{region}.api.aws/anthropic`.
+        #
+        # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
+        #
+        # @param timeout [Float]
+        #
+        # @param initial_retry_delay [Float]
+        #
+        # @param max_retry_delay [Float]
+        #
+        def initialize(
+          api_key: nil,
+          aws_access_key: nil,
+          aws_secret_access_key: nil,
+          aws_session_token: nil,
+          aws_profile: nil,
+          aws_region: ENV["AWS_REGION"] || ENV["AWS_DEFAULT_REGION"],
+          skip_auth: false,
+          base_url: ENV["ANTHROPIC_BEDROCK_MANTLE_BASE_URL"],
+          max_retries: self.class::DEFAULT_MAX_RETRIES,
+          timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
+          initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
+          max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
+        )
+          effective_api_key, resolved_base_url = setup_aws_auth(
+            api_key: api_key,
+            aws_access_key: aws_access_key,
+            aws_secret_access_key: aws_secret_access_key,
+            aws_session_token: aws_session_token,
+            aws_profile: aws_profile,
+            aws_region: aws_region,
+            skip_auth: skip_auth,
+            base_url: base_url,
+            service_name: "bedrock-mantle",
+            env_api_key: "AWS_BEARER_TOKEN_BEDROCK",
+            env_api_key_fallback: "ANTHROPIC_AWS_API_KEY",
+            derive_base_url: ->(region) { "https://bedrock-mantle.#{region}.api.aws/anthropic" }
+          )
+
+          super(
+            api_key: effective_api_key,
+            base_url: resolved_base_url,
+            max_retries: max_retries,
+            timeout: timeout,
+            initial_retry_delay: initial_retry_delay,
+            max_retry_delay: max_retry_delay
+          )
+
+          # Only initialize supported resources
+          @messages = Anthropic::Resources::Messages.new(client: self)
+          @beta = MantleBeta.new(client: self)
+        end
+
+        # Completions are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported.
+        def completions
+          raise NotImplementedError, "Completions are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
+        end
+
+        # Models listing is not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported.
+        def models
+          raise NotImplementedError, "Models listing is not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
+        end
+
+        # @api private
+        private def transform_request(request)
+          aws_auth_transform_request(request)
+        end
+
+        # Restricted Beta service that only exposes messages. Other beta resources
+        # (models, files, skills) are not supported on Bedrock Mantle.
+        class MantleBeta
+          # @return [Anthropic::Resources::Beta::Messages]
+          attr_reader :messages
+
+          # @api private
+          def initialize(client:)
+            @messages = Anthropic::Resources::Beta::Messages.new(client: client)
+          end
+
+          def models
+            raise NotImplementedError, "Beta models are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
+          end
+
+          def files
+            raise NotImplementedError, "Beta files are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
+          end
+
+          def skills
+            raise NotImplementedError, "Beta skills are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/internal/page_cursor.rb

@@ -10,8 +10,8 @@ module Anthropic
     #   end
     #
     # @example
-    #   page_cursor.auto_paging_each do |skill|
-    #     puts(skill)
+    #   page_cursor.auto_paging_each do |agent|
+    #     puts(agent)
     #   end
     class PageCursor
       include Anthropic::Internal::Type::BasePage
@@ -19,15 +19,12 @@ module Anthropic
       # @return [Array<generic<Elem>>, nil]
       attr_accessor :data
 
-      # @return [Boolean]
-      attr_accessor :has_more
-
       # @return [String, nil]
       attr_accessor :next_page_
 
       # @return [Boolean]
       def next_page?
-        has_more
+        !data.to_a.empty? && !next_page_.to_s.empty?
       end
 
       # @raise [Anthropic::HTTP::Error]
@@ -73,7 +70,6 @@ module Anthropic
           @data = data.map { Anthropic::Internal::Type::Converter.coerce(@model, _1) }
         else
         end
-        @has_more = page_data[:has_more]
         @next_page_ = page_data[:next_page]
       end
 
@@ -81,11 +77,9 @@ module Anthropic
       #
       # @return [String]
       def inspect
-        # rubocop:disable Layout/LineLength
         model = Anthropic::Internal::Type::Converter.inspect(@model, depth: 1)
 
-        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} has_more=#{has_more.inspect} next_page_=#{next_page_.inspect}>"
-        # rubocop:enable Layout/LineLength
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} next_page_=#{next_page_.inspect}>"
       end
     end
   end

data/lib/anthropic/internal/stream.rb

@@ -26,7 +26,7 @@ module Anthropic
               unwrapped = Anthropic::Internal::Util.dig(decoded, @unwrap)
               y << Anthropic::Internal::Type::Converter.coerce(@model, unwrapped)
             in {
-              event: "message_start" | "message_delta" | "message_stop" | "content_block_start" | "content_block_delta" | "content_block_stop",
+              event: "message_start" | "message_delta" | "message_stop" | "content_block_start" | "content_block_delta" | "content_block_stop" | "message",
               data: String => data
             }
               decoded = JSON.parse(data, symbolize_names: true)

data/lib/anthropic/internal/util.rb

@@ -621,7 +621,7 @@ module Anthropic
                 case val
                 in Array if val.all? { primitive?(_1) }
                   val.each do |v|
-                    write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
+                    write_multipart_chunk(y, boundary: boundary, key: :"#{key}[]", val: v, closing: closing)
                   end
                 else
                   write_multipart_chunk(y, boundary: boundary, key: key, val: val, closing: closing)

data/lib/anthropic/models/beta/agent_archive_params.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # @see Anthropic::Resources::Beta::Agents#archive
+      class AgentArchiveParams < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Internal::Type::RequestParameters::Converter
+        include Anthropic::Internal::Type::RequestParameters
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute betas
+        #   Optional header to specify the beta version(s) you want to use.
+        #
+        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
+
+        # @!method initialize(agent_id:, betas: nil, request_options: {})
+        #   @param agent_id [String]
+        #
+        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/agent_create_params.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # @see Anthropic::Resources::Beta::Agents#create
+      class AgentCreateParams < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Internal::Type::RequestParameters::Converter
+        include Anthropic::Internal::Type::RequestParameters
+
+        # @!attribute model
+        #   Model identifier. Accepts the
+        #   [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
+        #   e.g. `claude-opus-4-6`, or a `model_config` object for additional configuration
+        #   control
+        #
+        #   @return [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams]
+        required :model, union: -> { Anthropic::Beta::AgentCreateParams::Model }
+
+        # @!attribute name
+        #   Human-readable name for the agent. 1-256 characters.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute description
+        #   Description of what the agent does. Up to 2048 characters.
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!attribute mcp_servers
+        #   MCP servers this agent connects to. Maximum 20. Names must be unique within the
+        #   array.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>, nil]
+        optional :mcp_servers,
+                 -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaManagedAgentsURLMCPServerParams] }
+
+        # @!attribute metadata
+        #   Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up
+        #   to 512 chars.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :metadata, Anthropic::Internal::Type::HashOf[String]
+
+        # @!attribute skills
+        #   Skills available to the agent. Maximum 20.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>, nil]
+        optional :skills,
+                 -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaManagedAgentsSkillParams] }
+
+        # @!attribute system_
+        #   System prompt for the agent. Up to 100,000 characters.
+        #
+        #   @return [String, nil]
+        optional :system_, String, api_name: :system, nil?: true
+
+        # @!attribute tools
+        #   Tool configurations available to the agent. Maximum of 128 tools across all
+        #   toolsets allowed.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams>, nil]
+        optional :tools,
+                 -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::AgentCreateParams::Tool] }
+
+        # @!attribute betas
+        #   Optional header to specify the beta version(s) you want to use.
+        #
+        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
+
+        # @!method initialize(model:, name:, description: nil, mcp_servers: nil, metadata: nil, skills: nil, system_: nil, tools: nil, betas: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::AgentCreateParams} for more details.
+        #
+        #   @param model [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams] Model identifier. Accepts the [model string](https://platform.claude.com/docs/en
+        #
+        #   @param name [String] Human-readable name for the agent. 1-256 characters.
+        #
+        #   @param description [String, nil] Description of what the agent does. Up to 2048 characters.
+        #
+        #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>] MCP servers this agent connects to. Maximum 20. Names must be unique within the
+        #
+        #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up t
+        #
+        #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>] Skills available to the agent. Maximum 20.
+        #
+        #   @param system_ [String, nil] System prompt for the agent. Up to 100,000 characters.
+        #
+        #   @param tools [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams>] Tool configurations available to the agent. Maximum of 128 tools across all tool
+        #
+        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+
+        # Model identifier. Accepts the
+        # [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
+        # e.g. `claude-opus-4-6`, or a `model_config` object for additional configuration
+        # control
+        module Model
+          extend Anthropic::Internal::Type::Union
+
+          # The model that will power your agent.\n\nSee [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
+          variant union: -> { Anthropic::Beta::BetaManagedAgentsModel }
+
+          # An object that defines additional configuration control over model use
+          variant -> { Anthropic::Beta::BetaManagedAgentsModelConfigParams }
+
+          # @!method self.variants
+          #   @return [Array(Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams)]
+        end
+
+        # Union type for tool configurations in the tools array.
+        module Tool
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          # Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
+          variant :agent_toolset_20260401, -> { Anthropic::Beta::BetaManagedAgentsAgentToolset20260401Params }
+
+          # Configuration for tools from an MCP server defined in `mcp_servers`.
+          variant :mcp_toolset, -> { Anthropic::Beta::BetaManagedAgentsMCPToolsetParams }
+
+          # A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
+          variant :custom, -> { Anthropic::Beta::BetaManagedAgentsCustomToolParams }
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams)]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/agent_list_params.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # @see Anthropic::Resources::Beta::Agents#list
+      class AgentListParams < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Internal::Type::RequestParameters::Converter
+        include Anthropic::Internal::Type::RequestParameters
+
+        # @!attribute created_at_gte
+        #   Return agents created at or after this time (inclusive).
+        #
+        #   @return [Time, nil]
+        optional :created_at_gte, Time
+
+        # @!attribute created_at_lte
+        #   Return agents created at or before this time (inclusive).
+        #
+        #   @return [Time, nil]
+        optional :created_at_lte, Time
+
+        # @!attribute include_archived
+        #   Include archived agents in results. Defaults to false.
+        #
+        #   @return [Boolean, nil]
+        optional :include_archived, Anthropic::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum results per page. Default 20, maximum 100.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute page
+        #   Opaque pagination cursor from a previous response.
+        #
+        #   @return [String, nil]
+        optional :page, String
+
+        # @!attribute betas
+        #   Optional header to specify the beta version(s) you want to use.
+        #
+        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
+
+        # @!method initialize(created_at_gte: nil, created_at_lte: nil, include_archived: nil, limit: nil, page: nil, betas: nil, request_options: {})
+        #   @param created_at_gte [Time] Return agents created at or after this time (inclusive).
+        #
+        #   @param created_at_lte [Time] Return agents created at or before this time (inclusive).
+        #
+        #   @param include_archived [Boolean] Include archived agents in results. Defaults to false.
+        #
+        #   @param limit [Integer] Maximum results per page. Default 20, maximum 100.
+        #
+        #   @param page [String] Opaque pagination cursor from a previous response.
+        #
+        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/agent_retrieve_params.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # @see Anthropic::Resources::Beta::Agents#retrieve
+      class AgentRetrieveParams < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Internal::Type::RequestParameters::Converter
+        include Anthropic::Internal::Type::RequestParameters
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute version
+        #   Agent version. Omit for the most recent version. Must be at least 1 if
+        #   specified.
+        #
+        #   @return [Integer, nil]
+        optional :version, Integer
+
+        # @!attribute betas
+        #   Optional header to specify the beta version(s) you want to use.
+        #
+        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
+
+        # @!method initialize(agent_id:, version: nil, betas: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::AgentRetrieveParams} for more details.
+        #
+        #   @param agent_id [String]
+        #
+        #   @param version [Integer] Agent version. Omit for the most recent version. Must be at least 1 if specified
+        #
+        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end