anthropic 1.38.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5053fea394cb2c14a0692837413c50fdfa520703226d15b1788234b9dd865b53
-  data.tar.gz: ac9ffbef339cb6713fbf68b3c4248562f527ad145e621239d9375d43d8ba8d45
+  metadata.gz: a28aebdd54d31366f32c1d4d6ef29255d82de76cee72340466a6d00a4c00ce93
+  data.tar.gz: 782a11bdf33bb17a714fae90128ed8a47bb2dc58f25a13764a963e80dead26b4
 SHA512:
-  metadata.gz: 74d0c247922c3ae14f23915fbdf95d1e5e66d5b785cc9c3804d594da9d28b7c1bf2d68b56bae8f56e991f18f8f74010b0abe97e8b40611eae99931293b7fa89d
-  data.tar.gz: fe67842d5673483fefac88cfaaa496a56a94914eefed0d947815cbcdde48fb8a9120f0cfb1dd59de37f70e8c8eeb996505e1a024b056ce22845f14704377d7f5
+  metadata.gz: bea1ae610f8b0ecc832c480a05d2d774b1cf67def8112cd24c433d222fd848ef580abf96ade09eb17fed9b206d2f21648aaf9ec50ea03b0132c7a34fdd3d8479
+  data.tar.gz: 322ddef548b47012b960dcc23329b753e1a8b04328ad6eb0a40794c912e33829c4aaca97a6cab2c39a2672f5dcc4139e80dfab8fbf87bfccbe9cd3d8bf9d59ff

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 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.39.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

@@ -173,7 +173,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 +185,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 +208,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

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

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaManagedAgentsMultiagent < Anthropic::Internal::Type::BaseModel
+        # @!attribute agents
+        #   Agents the coordinator may spawn as session threads, each resolved to a specific
+        #   version.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentReference>]
+        required :agents,
+                 -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaManagedAgentsAgentReference] }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaManagedAgentsMultiagent::Type]
+        required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsMultiagent::Type }
+
+        # @!method initialize(agents:, type:)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaManagedAgentsMultiagent} for more details.
+        #
+        #   Resolved coordinator topology with a concrete agent roster.
+        #
+        #   @param agents [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentReference>] Agents the coordinator may spawn as session threads, each resolved to a specific
+        #
+        #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsMultiagent::Type]
+
+        # @see Anthropic::Models::Beta::BetaManagedAgentsMultiagent#type
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          COORDINATOR = :coordinator
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    BetaManagedAgentsMultiagent = Beta::BetaManagedAgentsMultiagent
+  end
+end