anthropic 1.37.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9eacf10bf13feb1eb221fe82ee801d2754524985991959c858db721b5cfd825e
-  data.tar.gz: 6e70a7c6d4ee0dd18a892272017f73e524ace1a943579b9694c23c94331ad421
+  metadata.gz: a28aebdd54d31366f32c1d4d6ef29255d82de76cee72340466a6d00a4c00ce93
+  data.tar.gz: 782a11bdf33bb17a714fae90128ed8a47bb2dc58f25a13764a963e80dead26b4
 SHA512:
-  metadata.gz: '002489936b1fa9dda322c5dd604bea0eb371ef4a25a8e091e8a7204db4acca6d3dfa7e4840666a1042b0052271215abc18499a99ab5d9a5589401ad1df9626c1'
-  data.tar.gz: 95b904d78f29eb0b36f694c628c52c686775349ca3ba9cb6746ce33758558dc48a624ca925bc72661bf54b033272cf14d57babea6d86ffed7b6d37531fada262
+  metadata.gz: bea1ae610f8b0ecc832c480a05d2d774b1cf67def8112cd24c433d222fd848ef580abf96ade09eb17fed9b206d2f21648aaf9ec50ea03b0132c7a34fdd3d8479
+  data.tar.gz: 322ddef548b47012b960dcc23329b753e1a8b04328ad6eb0a40794c912e33829c4aaca97a6cab2c39a2672f5dcc4139e80dfab8fbf87bfccbe9cd3d8bf9d59ff

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # 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)
+
+### Features
+
+* **client:** allow targeting a workspace for OIDC federation token exchange ([85f4668](https://github.com/anthropics/anthropic-sdk-ruby/commit/85f46687b798714bed259e6b78e07bc4df114046))
+
 ## 1.37.0 (2026-05-04)
 
 Full Changelog: [v1.36.0...v1.37.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.36.0...v1.37.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.37.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/credentials/config_provider.rb

@@ -74,6 +74,9 @@ module Anthropic
         headers = {}
 
         auth_type = config[:authentication][:type]
+        # For federation profiles workspace_id is sent in the jwt-bearer
+        # exchange body, not as a request header (the minted token is already
+        # workspace-scoped, so the header would be ignored).
         if auth_type != AUTH_TYPE_OIDC_FEDERATION
           workspace_id = config[:workspace_id]
           headers["anthropic-workspace-id"] = workspace_id.to_s if workspace_id
@@ -193,6 +196,7 @@ module Anthropic
           federation_rule_id: federation_rule_id,
           organization_id: organization_id,
           service_account_id: auth[:service_account_id],
+          workspace_id: @config[:workspace_id],
           scope: auth[:scope]
         )
 
@@ -394,6 +398,7 @@ module Anthropic
       def fill_missing_from_env(config, auth)
         fill(config, :base_url, ENV_BASE_URL)
         fill(config, :organization_id, ENV_ORGANIZATION_ID)
+        fill(config, :workspace_id, ENV_WORKSPACE_ID)
 
         auth_type = auth[:type]
         if auth_type == AUTH_TYPE_OIDC_FEDERATION

data/lib/anthropic/credentials/constants.rb

@@ -62,6 +62,9 @@ module Anthropic
     # Environment variable for service account ID.
     ENV_SERVICE_ACCOUNT_ID = "ANTHROPIC_SERVICE_ACCOUNT_ID"
 
+    # Environment variable for workspace ID.
+    ENV_WORKSPACE_ID = "ANTHROPIC_WORKSPACE_ID"
+
     # Environment variable for OAuth scope.
     ENV_SCOPE = "ANTHROPIC_SCOPE"
 

data/lib/anthropic/credentials/in_memory_config.rb

@@ -103,6 +103,7 @@ module Anthropic
           federation_rule_id: federation_rule_id,
           organization_id: organization_id,
           service_account_id: auth[:service_account_id],
+          workspace_id: config[:workspace_id],
           scope: auth[:scope]
         )
 

data/lib/anthropic/credentials/workload_identity.rb

@@ -53,6 +53,16 @@ module Anthropic
       # @param organization_id [String] the organization's raw UUID string
       # @param service_account_id [String, nil] optional service account ID to
       #   impersonate
+      # @param workspace_id [String, nil] Optional +wrkspc_*+ tagged ID, or the
+      #   literal +"default"+ to scope the token to the organization's default
+      #   workspace. When omitted the server picks the rule's sole enabled
+      #   workspace, else the org default if the rule covers it. Required when
+      #   the rule enables more than one non-default workspace, or to target a
+      #   specific workspace other than the one the server would pick. The
+      #   minted token is workspace-scoped: per-request workspace selection
+      #   (the +anthropic-workspace-id+ header) is not supported for federation
+      #   tokens — switching workspaces requires a new token exchange with a
+      #   different +workspace_id+.
       # @param scope [String, nil] optional OAuth scope (informational only for
       #   federation; the server derives the effective scope from the federation rule)
       def initialize(
@@ -60,12 +70,14 @@ module Anthropic
         federation_rule_id:,
         organization_id:,
         service_account_id: nil,
+        workspace_id: nil,
         scope: nil # rubocop:disable Lint/UnusedMethodArgument
       )
         @identity_token_provider = identity_token_provider
         @federation_rule_id = federation_rule_id
         @organization_id = organization_id
         @service_account_id = service_account_id
+        @workspace_id = workspace_id
         @bound_base_url = nil
       end
 
@@ -128,6 +140,7 @@ module Anthropic
           "organization_id" => @organization_id
         }
         body["service_account_id"] = @service_account_id if @service_account_id
+        body["workspace_id"] = @workspace_id if @workspace_id
 
         request = Net::HTTP::Post.new(uri.path)
         request["Content-Type"] = "application/json"
@@ -173,8 +186,23 @@ module Anthropic
           response.body&.slice(0, 256)
         end
 
+        message = "Token exchange failed (HTTP #{response.code}): #{body}"
+        # An ambiguous 401 is usually a federation-rule misconfiguration.
+        # Surface the fix in the error rather than making the user dig through docs.
+        if response.code.to_i == 401
+          hint_parts = ["Ensure your federation rule matches your identity token"]
+          if @workspace_id.nil?
+            hint_parts << "If your federation rule is scoped to multiple workspaces, set the " \
+                          "ANTHROPIC_WORKSPACE_ID environment variable, the 'workspace_id' " \
+                          "config key, or the workspace_id: keyword argument"
+          end
+          hint_parts << "View your authentication events in the Workload identity page of " \
+                        "Claude Console for more details"
+          message += " #{hint_parts.join('. ')}."
+        end
+
         raise WorkloadIdentityError.new(
-          "Token exchange failed (HTTP #{response.code}): #{body}",
+          message,
           status_code: response.code.to_i,
           body: body,
           request_id: request_id

data/lib/anthropic/credentials.rb

@@ -146,6 +146,10 @@ module Anthropic
           federation_rule_id: federation_rule_id,
           organization_id: organization_id,
           service_account_id: ENV[ENV_SERVICE_ACCOUNT_ID],
+          # Coerce empty string to nil so a defaulted-but-empty CI variable doesn't
+          # put "workspace_id" => "" on the wire — matches the blank-skip in
+          # ConfigProvider#fill.
+          workspace_id: ENV[ENV_WORKSPACE_ID].then { _1 unless _1.to_s.empty? },
           scope: ENV[ENV_SCOPE]
         )
         provider.bind_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