anthropic 1.38.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5053fea394cb2c14a0692837413c50fdfa520703226d15b1788234b9dd865b53
-  data.tar.gz: ac9ffbef339cb6713fbf68b3c4248562f527ad145e621239d9375d43d8ba8d45
+  metadata.gz: b34378dd9395b126e18915a8ee15526d27d7e7002475e401d8c81bae601289fb
+  data.tar.gz: ed103f7d82d22f04cc7a0332a4a24648beaafcbafbf4e16fa19717ce59c9817c
 SHA512:
-  metadata.gz: 74d0c247922c3ae14f23915fbdf95d1e5e66d5b785cc9c3804d594da9d28b7c1bf2d68b56bae8f56e991f18f8f74010b0abe97e8b40611eae99931293b7fa89d
-  data.tar.gz: fe67842d5673483fefac88cfaaa496a56a94914eefed0d947815cbcdde48fb8a9120f0cfb1dd59de37f70e8c8eeb996505e1a024b056ce22845f14704377d7f5
+  metadata.gz: 6740871a358a65e3948a1381ba601ad342f4f1418c19af0e9c6badf1c91e7d4aec51650f5d202a3f31d44b39f4c951a85875d4208227281ceb0d7da0b7a9c0d8
+  data.tar.gz: b596807165dbd16f19fe9902451b0e6e9b346030265214d1c5eece6e1d4eb8ee7c3fd9cf650d06ca7695eac94103b4669f8b130970b0fe5ca61022ea4ba0630f

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.40.0 (2026-05-11)
+
+Full Changelog: [v1.39.0...v1.40.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.39.0...v1.40.0)
+
+### Features
+
+* **aws:** Add AWS client for Claude Platform on AWS ([3c24797](https://github.com/anthropics/anthropic-sdk-ruby/commit/3c2479737666f61f1096b07c30412fffdfabe133))
+
+
+### Bug Fixes
+
+* **aws,bedrock:** materialize streamed request body before SigV4 signing ([#927](https://github.com/anthropics/anthropic-sdk-ruby/issues/927)) ([5b6d9d4](https://github.com/anthropics/anthropic-sdk-ruby/commit/5b6d9d4bfcb2a9e3fcc14a5683f6e25a205791a2))
+
+## 1.39.0 (2026-05-06)
+
+Full Changelog: [v1.38.0...v1.39.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.38.0...v1.39.0)
+
+### Features
+
+* **api:** add support for Managed Agents multiagents and outcomes, webhooks, vault validation ([21230ec](https://github.com/anthropics/anthropic-sdk-ruby/commit/21230ecd2fd7dac66600f984c7e34383cf122d7a))
+* **client:** add aws sso config resolution ([#887](https://github.com/anthropics/anthropic-sdk-ruby/issues/887)) ([4a0476a](https://github.com/anthropics/anthropic-sdk-ruby/commit/4a0476ada4e1549965971fce3272a7a9dee8faaa))
+
+
+### Bug Fixes
+
+* **api:** Adjust webhook configuration ([e587f17](https://github.com/anthropics/anthropic-sdk-ruby/commit/e587f17eae68e656586f73a9a880e4f9ab8b94fe))
+
 ## 1.38.0 (2026-05-05)
 
 Full Changelog: [v1.37.0...v1.38.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.37.0...v1.38.0)

data/README.md

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

data/lib/anthropic/client.rb

@@ -59,6 +59,9 @@ module Anthropic
     # @return [String, nil]
     attr_reader :auth_token
 
+    # @return [String, nil]
+    attr_reader :webhook_key
+
     # @return [Object, nil]
     attr_reader :credentials
 
@@ -159,6 +162,8 @@ module Anthropic
     #   with +credentials:+. For +user_oauth+, must also include
     #   +authentication.credentials_path+.
     #
+    # @param webhook_key [String, nil] Defaults to `ENV["ANTHROPIC_WEBHOOK_SIGNING_KEY"]`
+    #
     # @param base_url [String, nil] Override the default base URL for the API, e.g.,
     #   +"https://api.example.com/v2/"+. Defaults to +ENV["ANTHROPIC_BASE_URL"]+,
     #   then to the profile's +base_url+ if present, then to +https://api.anthropic.com+.
@@ -173,6 +178,7 @@ module Anthropic
     def initialize(
       api_key: nil,
       auth_token: nil,
+      webhook_key: ENV["ANTHROPIC_WEBHOOK_SIGNING_KEY"],
       credentials: nil,
       config: nil,
       base_url: nil,
@@ -251,6 +257,7 @@ module Anthropic
         headers = parsed.merge(headers)
       end
       headers = headers.merge(credential_headers)
+      @webhook_key = webhook_key&.to_s
 
       super(
         base_url: base_url,

data/lib/anthropic/helpers/aws_auth.rb

@@ -159,7 +159,26 @@ module Anthropic
 
         return request unless @use_sig_v4
 
-        sliced = request.slice(:method, :url, :body).transform_keys(method: :http_method)
+        # `Aws::Sigv4::Signer#sign_request` only accepts `String` / `IO` / `nil`
+        # bodies. Multipart and JSONL requests carry a lazy `Enumerable` body
+        # (see `Util.encode_content`), which the signer rejects. Materialize it
+        # to a `String` and replace the request body so the signed payload is
+        # exactly the bytes that go over the wire (the lazy enumerator can only
+        # be consumed once).
+        body = request[:body]
+        body =
+          case body
+          when nil, String, IO, StringIO
+            body
+          when Enumerable
+            materialized = body.to_a.join
+            request = {**request, body: materialized}
+            materialized
+          else
+            body.to_s
+          end
+
+        sliced = {http_method: request.fetch(:method), url: request.fetch(:url), body: body}
         signed = @signer.sign_request({**sliced, headers: headers})
         headers = Anthropic::Internal::Util.normalized_headers(headers, signed.headers)
         headers.delete("connection")
@@ -173,7 +192,7 @@ module Anthropic
       # @param aws_session_token [String, nil]
       # @param aws_profile [String, nil]
       #
-      # @return [Aws::Credentials, Aws::SharedCredentials, Aws::InstanceProfileCredentials]
+      # @return [Aws::Credentials, Aws::SharedCredentials, Aws::SSOCredentials, Aws::InstanceProfileCredentials]
       private def resolve_credentials(
         aws_access_key:,
         aws_secret_access_key:,
@@ -185,7 +204,7 @@ module Anthropic
         end
 
         if aws_profile
-          return Aws::SharedCredentials.new(profile_name: aws_profile)
+          return resolve_profile_credentials(aws_profile)
         end
 
         # Default credential chain: env vars → shared config file → instance profile
@@ -208,6 +227,55 @@ module Anthropic
         Aws::InstanceProfileCredentials.new
       end
 
+      # Resolve credentials for a named AWS profile. Tries the same resolution
+      # order as Aws::CredentialProviderChain for explicit profiles: SSO,
+      # assume-role (including web identity), credential_process, and static
+      # shared credentials.
+      #
+      # Uses Aws.shared_config which is @api private in aws-sdk-core, but is
+      # the only path to load SSO/assume-role/process credentials from a profile
+      # name without re-parsing ~/.aws/config. This is the same approach the
+      # SDK's own CredentialProviderChain uses and has been stable across v3.
+      #
+      # @param aws_profile [String]
+      # @return [Aws::CredentialProvider]
+      # @raise [ArgumentError] if the profile resolves no usable credentials
+      private def resolve_profile_credentials(aws_profile)
+        sc = Aws.shared_config
+
+        # Same order as Aws::CredentialProviderChain for explicit profiles.
+        # The config-file resolvers are gated on config_enabled? since they
+        # read ~/.aws/config; static shared credentials read ~/.aws/credentials
+        # and are always attempted as the final fallback.
+        resolvers = []
+        if sc.config_enabled?
+          resolvers += [
+            -> { sc.assume_role_web_identity_credentials_from_config(profile: aws_profile) },
+            -> { sc.sso_credentials_from_config(profile: aws_profile) },
+            -> { sc.assume_role_credentials_from_config(profile: aws_profile) },
+            -> {
+              process_provider = sc.credential_process(profile: aws_profile)
+              Aws::ProcessCredentials.new([process_provider]) if process_provider
+            }
+          ]
+        end
+        resolvers << -> { Aws::SharedCredentials.new(profile_name: aws_profile) }
+
+        resolvers.each do |resolver|
+          creds = resolver.call
+          return creds if creds&.set?
+        rescue Aws::Errors::NoSuchProfileError
+          # fall through to next strategy
+          nil
+        end
+
+        raise ArgumentError.new(
+          "Could not resolve credentials for profile #{aws_profile.inspect}. " \
+          "If this is an SSO profile, " \
+          "run `aws sso login --profile #{aws_profile}` first."
+        )
+      end
+
       # Returns the first non-empty value from the given env var names.
       #
       # @param names [Array<String, nil>]

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" | "message" | "user.message" | "user.interrupt" | "user.tool_confirmation" | "user.custom_tool_result" | "agent.message" | "agent.thinking" | "agent.tool_use" | "agent.tool_result" | "agent.mcp_tool_use" | "agent.mcp_tool_result" | "agent.custom_tool_use" | "agent.thread_context_compacted" | "session.status_running" | "session.status_idle" | "session.status_rescheduled" | "session.status_terminated" | "session.error" | "session.deleted" | "span.model_request_start" | "span.model_request_end",
+              event: "message_start" | "message_delta" | "message_stop" | "content_block_start" | "content_block_delta" | "content_block_stop" | "message" | "user.message" | "user.interrupt" | "user.tool_confirmation" | "user.custom_tool_result" | "agent.message" | "agent.thinking" | "agent.tool_use" | "agent.tool_result" | "agent.mcp_tool_use" | "agent.mcp_tool_result" | "agent.custom_tool_use" | "agent.thread_context_compacted" | "session.status_running" | "session.status_idle" | "session.status_rescheduled" | "session.status_terminated" | "session.error" | "session.deleted" | "span.model_request_start" | "span.model_request_end" | "span.outcome_evaluation_start" | "span.outcome_evaluation_ongoing" | "span.outcome_evaluation_end" | "user.define_outcome" | "agent.thread_message_received" | "agent.thread_message_sent" | "agent.session_thread_message_received" | "agent.session_thread_message_sent" | "session.thread_created" | "session.thread_status_created" | "session.thread_status_running" | "session.thread_status_idle" | "session.thread_status_rescheduled" | "session.thread_status_terminated",
               data: String => data
             }
               decoded = JSON.parse(data, symbolize_names: true)

data/lib/anthropic/internal/util.rb

@@ -529,7 +529,7 @@ module Anthropic
               write_query_param_element!(collection, "#{key}[#{name}]", value)
             end
           in Array
-            collection[key] = element.map(&:to_s).join(",")
+            collection["#{key}[]"] = element.map(&:to_s)
           else
             collection[key] = element.to_s
           end

data/lib/anthropic/models/anthropic_beta.rb

@@ -53,6 +53,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::ADVISOR_TOOL_2026_03_01 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::MANAGED_AGENTS_2026_04_01 }
+
       # @!method self.variants
       #   @return [Array(String, Symbol)]
 
@@ -85,6 +87,7 @@ module Anthropic
       OUTPUT_300K_2026_03_24 = :"output-300k-2026-03-24"
       USER_PROFILES_2026_03_24 = :"user-profiles-2026-03-24"
       ADVISOR_TOOL_2026_03_01 = :"advisor-tool-2026-03-01"
+      MANAGED_AGENTS_2026_04_01 = :"managed-agents-2026-04-01"
 
       # @!endgroup
     end

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

@@ -44,6 +44,13 @@ module Anthropic
         #   @return [Hash{Symbol=>String}, nil]
         optional :metadata, Anthropic::Internal::Type::HashOf[String]
 
+        # @!attribute multiagent
+        #   A coordinator topology: the session's primary thread orchestrates work by
+        #   spawning session threads, each running an agent drawn from the `agents` roster.
+        #
+        #   @return [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil]
+        optional :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagentParams }, nil?: true
+
         # @!attribute skills
         #   Skills available to the agent. Maximum 20.
         #
@@ -71,7 +78,7 @@ module Anthropic
         #   @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: {})
+        # @!method initialize(model:, name:, description: nil, mcp_servers: nil, metadata: nil, multiagent: 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.
         #
@@ -85,6 +92,8 @@ module Anthropic
         #
         #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up t
         #
+        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] A coordinator topology: the session's primary thread orchestrates work by spawni
+        #
         #   @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.

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

@@ -56,6 +56,13 @@ module Anthropic
         #   @return [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, nil]
         optional :model, union: -> { Anthropic::Beta::AgentUpdateParams::Model }
 
+        # @!attribute multiagent
+        #   A coordinator topology: the session's primary thread orchestrates work by
+        #   spawning session threads, each running an agent drawn from the `agents` roster.
+        #
+        #   @return [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil]
+        optional :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagentParams }, nil?: true
+
         # @!attribute name
         #   Human-readable name. 1-256 characters. Omit to preserve. Cannot be cleared.
         #
@@ -96,7 +103,7 @@ module Anthropic
         #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
-        # @!method initialize(agent_id:, version:, description: nil, mcp_servers: nil, metadata: nil, model: nil, name: nil, skills: nil, system_: nil, tools: nil, betas: nil, request_options: {})
+        # @!method initialize(agent_id:, version:, description: nil, mcp_servers: nil, metadata: nil, model: nil, multiagent: nil, name: nil, skills: nil, system_: nil, tools: nil, betas: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::AgentUpdateParams} for more details.
         #
@@ -112,6 +119,8 @@ module Anthropic
         #
         #   @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 multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] A coordinator topology: the session's primary thread orchestrates work by spawni
+        #
         #   @param name [String] Human-readable name. 1-256 characters. Omit to preserve. Cannot be cleared.
         #
         #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>, nil] Skills. Full replacement. Omit to preserve; send empty array or null to clear. M

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

@@ -5,6 +5,12 @@ module Anthropic
     module Beta
       class BetaCitationContentBlockLocation < Anthropic::Internal::Type::BaseModel
         # @!attribute cited_text
+        #   The full text of the cited block range, concatenated.
+        #
+        #   Always equals the contents of `content[start_block_index:end_block_index]`
+        #   joined together. The text block is the minimal citable unit; this field is never
+        #   a substring of a single block. Not counted toward output tokens, and not counted
+        #   toward input tokens when sent back in subsequent turns.
         #
         #   @return [String]
         required :cited_text, String
@@ -20,6 +26,11 @@ module Anthropic
         required :document_title, String, nil?: true
 
         # @!attribute end_block_index
+        #   Exclusive 0-based end index of the cited block range in the source's `content`
+        #   array.
+        #
+        #   Always greater than `start_block_index`; a single-block citation has
+        #   `end_block_index = start_block_index + 1`.
         #
         #   @return [Integer]
         required :end_block_index, Integer
@@ -30,6 +41,7 @@ module Anthropic
         required :file_id, String, nil?: true
 
         # @!attribute start_block_index
+        #   0-based index of the first cited block in the source's `content` array.
         #
         #   @return [Integer]
         required :start_block_index, Integer
@@ -40,12 +52,21 @@ module Anthropic
         required :type, const: :content_block_location
 
         # @!method initialize(cited_text:, document_index:, document_title:, end_block_index:, file_id:, start_block_index:, type: :content_block_location)
-        #   @param cited_text [String]
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCitationContentBlockLocation} for more details.
+        #
+        #   @param cited_text [String] The full text of the cited block range, concatenated.
+        #
         #   @param document_index [Integer]
+        #
         #   @param document_title [String, nil]
-        #   @param end_block_index [Integer]
+        #
+        #   @param end_block_index [Integer] Exclusive 0-based end index of the cited block range in the source's `content` a
+        #
         #   @param file_id [String, nil]
-        #   @param start_block_index [Integer]
+        #
+        #   @param start_block_index [Integer] 0-based index of the first cited block in the source's `content` array.
+        #
         #   @param type [Symbol, :content_block_location]
       end
     end

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

@@ -5,6 +5,12 @@ module Anthropic
     module Beta
       class BetaCitationContentBlockLocationParam < Anthropic::Internal::Type::BaseModel
         # @!attribute cited_text
+        #   The full text of the cited block range, concatenated.
+        #
+        #   Always equals the contents of `content[start_block_index:end_block_index]`
+        #   joined together. The text block is the minimal citable unit; this field is never
+        #   a substring of a single block. Not counted toward output tokens, and not counted
+        #   toward input tokens when sent back in subsequent turns.
         #
         #   @return [String]
         required :cited_text, String
@@ -20,11 +26,17 @@ module Anthropic
         required :document_title, String, nil?: true
 
         # @!attribute end_block_index
+        #   Exclusive 0-based end index of the cited block range in the source's `content`
+        #   array.
+        #
+        #   Always greater than `start_block_index`; a single-block citation has
+        #   `end_block_index = start_block_index + 1`.
         #
         #   @return [Integer]
         required :end_block_index, Integer
 
         # @!attribute start_block_index
+        #   0-based index of the first cited block in the source's `content` array.
         #
         #   @return [Integer]
         required :start_block_index, Integer
@@ -35,11 +47,20 @@ module Anthropic
         required :type, const: :content_block_location
 
         # @!method initialize(cited_text:, document_index:, document_title:, end_block_index:, start_block_index:, type: :content_block_location)
-        #   @param cited_text [String]
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCitationContentBlockLocationParam} for more
+        #   details.
+        #
+        #   @param cited_text [String] The full text of the cited block range, concatenated.
+        #
         #   @param document_index [Integer]
+        #
         #   @param document_title [String, nil]
-        #   @param end_block_index [Integer]
-        #   @param start_block_index [Integer]
+        #
+        #   @param end_block_index [Integer] Exclusive 0-based end index of the cited block range in the source's `content` a
+        #
+        #   @param start_block_index [Integer] 0-based index of the first cited block in the source's `content` array.
+        #
         #   @param type [Symbol, :content_block_location]
       end
     end

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

@@ -5,16 +5,33 @@ module Anthropic
     module Beta
       class BetaCitationSearchResultLocation < Anthropic::Internal::Type::BaseModel
         # @!attribute cited_text
+        #   The full text of the cited block range, concatenated.
+        #
+        #   Always equals the contents of `content[start_block_index:end_block_index]`
+        #   joined together. The text block is the minimal citable unit; this field is never
+        #   a substring of a single block. Not counted toward output tokens, and not counted
+        #   toward input tokens when sent back in subsequent turns.
         #
         #   @return [String]
         required :cited_text, String
 
         # @!attribute end_block_index
+        #   Exclusive 0-based end index of the cited block range in the source's `content`
+        #   array.
+        #
+        #   Always greater than `start_block_index`; a single-block citation has
+        #   `end_block_index = start_block_index + 1`.
         #
         #   @return [Integer]
         required :end_block_index, Integer
 
         # @!attribute search_result_index
+        #   0-based index of the cited search result among all `search_result` content
+        #   blocks in the request, in the order they appear across messages and tool
+        #   results.
+        #
+        #   Counted separately from `document_index`; server-side web search results are not
+        #   included in this count.
         #
         #   @return [Integer]
         required :search_result_index, Integer
@@ -25,6 +42,7 @@ module Anthropic
         required :source, String
 
         # @!attribute start_block_index
+        #   0-based index of the first cited block in the source's `content` array.
         #
         #   @return [Integer]
         required :start_block_index, Integer
@@ -40,12 +58,21 @@ module Anthropic
         required :type, const: :search_result_location
 
         # @!method initialize(cited_text:, end_block_index:, search_result_index:, source:, start_block_index:, title:, type: :search_result_location)
-        #   @param cited_text [String]
-        #   @param end_block_index [Integer]
-        #   @param search_result_index [Integer]
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCitationSearchResultLocation} for more details.
+        #
+        #   @param cited_text [String] The full text of the cited block range, concatenated.
+        #
+        #   @param end_block_index [Integer] Exclusive 0-based end index of the cited block range in the source's `content` a
+        #
+        #   @param search_result_index [Integer] 0-based index of the cited search result among all `search_result` content block
+        #
         #   @param source [String]
-        #   @param start_block_index [Integer]
+        #
+        #   @param start_block_index [Integer] 0-based index of the first cited block in the source's `content` array.
+        #
         #   @param title [String, nil]
+        #
         #   @param type [Symbol, :search_result_location]
       end
     end

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

@@ -5,16 +5,33 @@ module Anthropic
     module Beta
       class BetaCitationSearchResultLocationParam < Anthropic::Internal::Type::BaseModel
         # @!attribute cited_text
+        #   The full text of the cited block range, concatenated.
+        #
+        #   Always equals the contents of `content[start_block_index:end_block_index]`
+        #   joined together. The text block is the minimal citable unit; this field is never
+        #   a substring of a single block. Not counted toward output tokens, and not counted
+        #   toward input tokens when sent back in subsequent turns.
         #
         #   @return [String]
         required :cited_text, String
 
         # @!attribute end_block_index
+        #   Exclusive 0-based end index of the cited block range in the source's `content`
+        #   array.
+        #
+        #   Always greater than `start_block_index`; a single-block citation has
+        #   `end_block_index = start_block_index + 1`.
         #
         #   @return [Integer]
         required :end_block_index, Integer
 
         # @!attribute search_result_index
+        #   0-based index of the cited search result among all `search_result` content
+        #   blocks in the request, in the order they appear across messages and tool
+        #   results.
+        #
+        #   Counted separately from `document_index`; server-side web search results are not
+        #   included in this count.
         #
         #   @return [Integer]
         required :search_result_index, Integer
@@ -25,6 +42,7 @@ module Anthropic
         required :source, String
 
         # @!attribute start_block_index
+        #   0-based index of the first cited block in the source's `content` array.
         #
         #   @return [Integer]
         required :start_block_index, Integer
@@ -40,12 +58,22 @@ module Anthropic
         required :type, const: :search_result_location
 
         # @!method initialize(cited_text:, end_block_index:, search_result_index:, source:, start_block_index:, title:, type: :search_result_location)
-        #   @param cited_text [String]
-        #   @param end_block_index [Integer]
-        #   @param search_result_index [Integer]
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCitationSearchResultLocationParam} for more
+        #   details.
+        #
+        #   @param cited_text [String] The full text of the cited block range, concatenated.
+        #
+        #   @param end_block_index [Integer] Exclusive 0-based end index of the cited block range in the source's `content` a
+        #
+        #   @param search_result_index [Integer] 0-based index of the cited search result among all `search_result` content block
+        #
         #   @param source [String]
-        #   @param start_block_index [Integer]
+        #
+        #   @param start_block_index [Integer] 0-based index of the first cited block in the source's `content` array.
+        #
         #   @param title [String, nil]
+        #
         #   @param type [Symbol, :search_result_location]
       end
     end

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

@@ -44,6 +44,12 @@ module Anthropic
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsModelConfig]
         required :model, -> { Anthropic::Beta::BetaManagedAgentsModelConfig }
 
+        # @!attribute multiagent
+        #   Resolved coordinator topology with a concrete agent roster.
+        #
+        #   @return [Anthropic::Models::Beta::BetaManagedAgentsMultiagent, nil]
+        required :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagent }, nil?: true
+
         # @!attribute name
         #
         #   @return [String]
@@ -84,7 +90,7 @@ module Anthropic
         #   @return [Integer]
         required :version, Integer
 
-        # @!method initialize(id:, archived_at:, created_at:, description:, mcp_servers:, metadata:, model:, name:, skills:, system_:, tools:, type:, updated_at:, version:)
+        # @!method initialize(id:, archived_at:, created_at:, description:, mcp_servers:, metadata:, model:, multiagent:, name:, skills:, system_:, tools:, type:, updated_at:, version:)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaManagedAgentsAgent} for more details.
         #
@@ -104,6 +110,8 @@ module Anthropic
         #
         #   @param model [Anthropic::Models::Beta::BetaManagedAgentsModelConfig] Model identifier and configuration.
         #
+        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagent, nil] Resolved coordinator topology with a concrete agent roster.
+        #
         #   @param name [String]
         #
         #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkill, Anthropic::Models::Beta::BetaManagedAgentsCustomSkill>]

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaManagedAgentsAgentReference < Anthropic::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaManagedAgentsAgentReference::Type]
+        required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsAgentReference::Type }
+
+        # @!attribute version
+        #
+        #   @return [Integer]
+        required :version, Integer
+
+        # @!method initialize(id:, type:, version:)
+        #   A resolved agent reference with a concrete version.
+        #
+        #   @param id [String]
+        #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsAgentReference::Type]
+        #   @param version [Integer]
+
+        # @see Anthropic::Models::Beta::BetaManagedAgentsAgentReference#type
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          AGENT = :agent
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    BetaManagedAgentsAgentReference = Beta::BetaManagedAgentsAgentReference
+  end
+end