anthropic 1.49.0 → 1.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45df9830dd4224180e2702068ad79b01ad5f045a6499969bbddfc5a49f29cec9
-  data.tar.gz: f501463bdb25da9354140ada09b8c638064fcf1c57ae751e9156c526b5281acb
+  metadata.gz: 8a4c0796098c3ebac37542205f404f39263436276c044cd39be1662a1ded8678
+  data.tar.gz: 7ca2ad565fec49876126eb5fbe9844d4b6bafb17e458affe3bd55dd886fb3d08
 SHA512:
-  metadata.gz: d4521d3d6191009cd99cd92898d6cfdca44ae99908d06ddaafee22665f21ba4751c6c02c5fb705ddea04827251769b69c53e62734e9edb04f60f9aa7dffe6802
-  data.tar.gz: 7d917f565b12839a5755d0e9638d2d57a05a489bd022d3284f2ba4bd812d488f5b2b635e38f8a3ad12fb24f8c305a7dcb16aed77d9c7ca17f66386183e607c39
+  metadata.gz: 6c20d2fda644c967e8a35b355af2507e077e974799b9ff74c52a2541bf713aee633f5bf9a1a15313d9bed76bb17659c5c5bf7ebb423284aefa785548a9a53a2d
+  data.tar.gz: 85c59aa18c96f05734279721f01cba261791f4196e1fde65a4e6ee939ca5a8adc9ba11efae83fde00aff36e4f41cd55e8d5596c8142359343655c9d88bb7d3c7

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 1.51.0 (2026-06-29)
+
+Full Changelog: [v1.50.0...v1.51.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.50.0...v1.51.0)
+
+### Features
+
+* **api:** add support for 20260318 web fetch and support tools ([bb82831](https://github.com/anthropics/anthropic-sdk-ruby/commit/bb828319b6d9b5965f45c1988c6a182c234abba7))
+
+
+### Bug Fixes
+
+* **client:** merge anthropic-beta header across sources instead of overwriting ([#60](https://github.com/anthropics/anthropic-sdk-ruby/issues/60)) ([fe31ce8](https://github.com/anthropics/anthropic-sdk-ruby/commit/fe31ce853146173fcd00872b1d6dc4db50bbe23c))
+
+
+### Chores
+
+* **api:** accept user profile ID's when counting tokens ([b5f48bb](https://github.com/anthropics/anthropic-sdk-ruby/commit/b5f48bb2236f17f0c8bca19b2722c78e40acc671))
+* **docs:** updates to descriptions and example values ([e8c63fe](https://github.com/anthropics/anthropic-sdk-ruby/commit/e8c63fee97b136259b6f193fbe856886266096a6))
+
+## 1.50.0 (2026-06-24)
+
+Full Changelog: [v1.49.0...v1.50.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.49.0...v1.50.0)
+
+### Features
+
+* **client:** add support for system.message streaming events ([2333173](https://github.com/anthropics/anthropic-sdk-ruby/commit/23331737588b1942dfda599a04ccb23109824f80))
+* **helpers:** single source for x-stainless-helper + tag the BetaToolRunner ([#36](https://github.com/anthropics/anthropic-sdk-ruby/issues/36)) ([95124e5](https://github.com/anthropics/anthropic-sdk-ruby/commit/95124e582c1f413b5dd05f4cc5dafecfe87b6666))
+
+
+### Chores
+
+* **api:** add support for new refusal category ([9b5050f](https://github.com/anthropics/anthropic-sdk-ruby/commit/9b5050f677532d60ee8b47e08c62b3e59aacdc7b))
+* **api:** add support for sending User Profile ID in request headers ([4a263e8](https://github.com/anthropics/anthropic-sdk-ruby/commit/4a263e8b43096c92533701eb4423c2abc21e3408))
+
 ## 1.49.0 (2026-06-18)
 
 Full Changelog: [v1.48.2...v1.49.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.48.2...v1.49.0)

data/README.md

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

data/lib/anthropic/helpers/stainless_helper_header.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    # Single source of truth for the `x-stainless-helper` telemetry header — the
+    # key, the closed value vocabulary shared across SDKs, and the comma-append
+    # merge.
+    #
+    # @api private
+    module StainlessHelperHeader
+      # Telemetry header naming the SDK helper(s) a request came from. Always
+      # this lowercase form; header lookups are case-insensitive but a single
+      # canonical casing keeps every call site greppable.
+      HEADER = "x-stainless-helper"
+
+      # Closed value vocabulary. Existing values keep their original spellings —
+      # telemetry consumers match on them, so renames lose history. New tags are
+      # hyphenated lowercase.
+      BETA_TOOL_RUNNER = "BetaToolRunner"
+
+      class << self
+        # The {HEADER} value to set after appending `value` to whatever is
+        # already present in `headers` — existing tags keep their position, the
+        # new tag goes at the end, duplicates are dropped, joined as one
+        # comma-separated string. The backend logs the header as one opaque
+        # string, so a second header line or a clobbered value loses data.
+        #
+        # @param headers [Hash{String => String}]
+        # @param value [String]
+        # @return [String]
+        def merged_value(headers, value)
+          existing =
+            headers
+            .filter_map { |k, v| v if k.to_s.casecmp?(HEADER) }
+            .flat_map { _1.to_s.split(",") }
+            .map(&:strip)
+            .reject(&:empty?)
+          (existing + [value]).uniq.join(", ")
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/helpers/tools/runner.rb

@@ -25,7 +25,7 @@ module Anthropic
           message = nil
           unless finished?
             fold do
-              message = @client.beta.messages.create(with_helper_header(_1, "runner"))
+              message = @client.beta.messages.create(with_helper_header(_1, StainlessHelperHeader::BETA_TOOL_RUNNER))
               [true, message]
             end
           end
@@ -46,7 +46,7 @@ module Anthropic
           end
 
           fold do
-            message = @client.beta.messages.create(with_helper_header(_1, "runner"))
+            message = @client.beta.messages.create(with_helper_header(_1, StainlessHelperHeader::BETA_TOOL_RUNNER))
             blk.call(message)
             [false, message]
           end
@@ -59,7 +59,7 @@ module Anthropic
           end
 
           fold do
-            stream = @client.beta.messages.stream(with_helper_header(_1, "runner"))
+            stream = @client.beta.messages.stream(with_helper_header(_1, StainlessHelperHeader::BETA_TOOL_RUNNER))
             blk.call(stream)
             [false, stream.accumulated_message]
           ensure
@@ -260,8 +260,12 @@ module Anthropic
         private def with_helper_header(params, helper)
           options = params[:request_options] || {}
           headers = options[:extra_headers] || {}
+          merged = StainlessHelperHeader.merged_value(headers, helper)
 
-          {**params, request_options: {**options, extra_headers: {**headers, "x-stainless-helper" => helper}}}
+          {
+            **params,
+            request_options: {**options, extra_headers: {**headers, StainlessHelperHeader::HEADER => merged}}
+          }
         end
       end
     end

data/lib/anthropic/internal/stream.rb

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

data/lib/anthropic/internal/util.rb

@@ -412,19 +412,28 @@ module Anthropic
       class << self
         # @api private
         #
+        # Later hashes take precedence on key collision, except `anthropic-beta`
+        # which is additive: values from every input are collected so endpoint
+        # defaults don't drop the caller's `betas:` or the client OAuth beta.
+        #
         # @param headers [Hash{String=>String, Integer, Array<String, Integer, nil>, nil}]
         #
         # @return [Hash{String=>String}]
         def normalized_headers(*headers)
-          {}.merge(*headers.compact).to_h do |key, val|
-            value =
-              case val
-              in Array
-                val.filter_map { _1&.to_s&.strip }.join(", ")
-              else
-                val&.to_s&.strip
-              end
-            [key.downcase, value]
+          merged = {}
+          headers.each do |hdrs|
+            hdrs.to_h.each do |key, val|
+              k = key.to_s.downcase
+              merged[k] = k == "anthropic-beta" && merged.key?(k) ? [*merged[k], *val] : val
+            end
+          end
+          merged.transform_values do |val|
+            case val
+            in Array
+              val.filter_map { _1&.to_s&.strip }.join(", ")
+            else
+              val&.to_s&.strip
+            end
           end
         end
       end

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

@@ -31,7 +31,9 @@ module Anthropic
 
         # @!attribute mcp_servers
         #   MCP servers this agent connects to. Maximum 20. Names must be unique within the
-        #   array.
+        #   array. Every server must be referenced by an `mcp_toolset` in `tools`;
+        #   unreferenced servers are rejected. See the
+        #   [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
         #
         #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>, nil]
         optional :mcp_servers,

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

@@ -28,8 +28,11 @@ module Anthropic
         optional :description, String, nil?: true
 
         # @!attribute mcp_servers
-        #   MCP servers. Full replacement. Omit to preserve; send empty array or null to
-        #   clear. Names must be unique. Maximum 20.
+        #   MCP servers. Full replacement. Omit to preserve; send empty array or `null` to
+        #   clear. Names must be unique. Maximum 20. Every server must be referenced by an
+        #   `mcp_toolset` in the agent's resulting `tools`; unreferenced servers are
+        #   rejected. See the
+        #   [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
         #
         #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>, nil]
         optional :mcp_servers,
@@ -110,7 +113,7 @@ module Anthropic
         #
         #   @param description [String, nil] Description. Omit to preserve; send empty string or null to clear.
         #
-        #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>, nil] MCP servers. Full replacement. Omit to preserve; send empty array or null to cle
+        #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>, nil] MCP servers. Full replacement. Omit to preserve; send empty array or `null` to c
         #
         #   @param metadata [Hash{Symbol=>String, nil}, nil] Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omi
         #

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

@@ -17,7 +17,9 @@ module Anthropic
         #   - `5m`: 5 minutes
         #   - `1h`: 1 hour
         #
-        #   Defaults to `5m`.
+        #   Defaults to `5m`. See
+        #   [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
+        #   for details.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaCacheControlEphemeral::TTL, nil]
         optional :ttl, enum: -> { Anthropic::Beta::BetaCacheControlEphemeral::TTL }
@@ -37,7 +39,9 @@ module Anthropic
         # - `5m`: 5 minutes
         # - `1h`: 1 hour
         #
-        # Defaults to `5m`.
+        # Defaults to `5m`. See
+        # [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
+        # for details.
         #
         # @see Anthropic::Models::Beta::BetaCacheControlEphemeral#ttl
         module TTL

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

@@ -32,6 +32,7 @@ module Anthropic
           BIO = :bio
           FRONTIER_LLM = :frontier_llm
           REASONING_EXTRACTION = :reasoning_extraction
+          MILITARY_WEAPONS = :military_weapons
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -108,6 +108,7 @@ module Anthropic
           BIO = :bio
           FRONTIER_LLM = :frontier_llm
           REASONING_EXTRACTION = :reasoning_extraction
+          MILITARY_WEAPONS = :military_weapons
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -12,7 +12,7 @@ module Anthropic
         #   Must be ≥1024 and less than `max_tokens`.
         #
         #   See
-        #   [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+        #   [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
         #   for details.
         #
         #   @return [Integer]

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

@@ -10,7 +10,7 @@ module Anthropic
       # tokens and counts towards your `max_tokens` limit.
       #
       # See
-      # [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+      # [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
       # for details.
       module BetaThinkingConfigParam
         extend Anthropic::Internal::Type::Union

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

@@ -51,6 +51,10 @@ module Anthropic
         # Web fetch tool with use_cache parameter for bypassing cached content.
         variant -> { Anthropic::Beta::BetaWebFetchTool20260309 }
 
+        variant -> { Anthropic::Beta::BetaWebSearchTool20260318 }
+
+        variant -> { Anthropic::Beta::BetaWebFetchTool20260318 }
+
         variant -> { Anthropic::Beta::BetaAdvisorTool20260301 }
 
         variant -> { Anthropic::Beta::BetaToolSearchToolBm25_20251119 }
@@ -64,7 +68,7 @@ module Anthropic
         variant -> { Anthropic::Beta::BetaMCPToolset }
 
         # @!method self.variants
-        #   @return [Array(Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset)]
+        #   @return [Array(Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaWebSearchTool20260318, Anthropic::Models::Beta::BetaWebFetchTool20260318, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset)]
       end
     end
 

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

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaWebFetchTool20260318 < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #   Name of the tool.
+        #
+        #   This is how the tool will be called by the model and in `tool_use` blocks.
+        #
+        #   @return [Symbol, :web_fetch]
+        required :name, const: :web_fetch
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :web_fetch_20260318]
+        required :type, const: :web_fetch_20260318
+
+        # @!attribute allowed_callers
+        #
+        #   @return [Array<Symbol, Anthropic::Models::Beta::BetaWebFetchTool20260318::AllowedCaller>, nil]
+        optional :allowed_callers,
+                 -> { Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::BetaWebFetchTool20260318::AllowedCaller] }
+
+        # @!attribute allowed_domains
+        #   List of domains to allow fetching from
+        #
+        #   @return [Array<String>, nil]
+        optional :allowed_domains, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!attribute blocked_domains
+        #   List of domains to block fetching from
+        #
+        #   @return [Array<String>, nil]
+        optional :blocked_domains, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!attribute citations
+        #   Citations configuration for fetched documents. Citations are disabled by
+        #   default.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCitationsConfigParam, nil]
+        optional :citations, -> { Anthropic::Beta::BetaCitationsConfigParam }, nil?: true
+
+        # @!attribute defer_loading
+        #   If true, tool will not be included in initial system prompt. Only loaded when
+        #   returned via tool_reference from tool search.
+        #
+        #   @return [Boolean, nil]
+        optional :defer_loading, Anthropic::Internal::Type::Boolean
+
+        # @!attribute max_content_tokens
+        #   Maximum number of tokens used by including web page text content in the context.
+        #   The limit is approximate and does not apply to binary content such as PDFs.
+        #
+        #   @return [Integer, nil]
+        optional :max_content_tokens, Integer, nil?: true
+
+        # @!attribute max_uses
+        #   Maximum number of times the tool can be used in the API request.
+        #
+        #   @return [Integer, nil]
+        optional :max_uses, Integer, nil?: true
+
+        # @!attribute response_inclusion
+        #   How this tool's result blocks appear in the API response when the result was
+        #   consumed by a completed code_execution call in the same turn. 'full' returns the
+        #   complete content (default). 'excluded' drops the nested server_tool_use and
+        #   result block pair entirely. Results from direct calls, or from code_execution
+        #   calls that paused before completing, are always returned in full so they can be
+        #   sent back on the next turn.
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaWebFetchTool20260318::ResponseInclusion, nil]
+        optional :response_inclusion, enum: -> { Anthropic::Beta::BetaWebFetchTool20260318::ResponseInclusion }
+
+        # @!attribute strict
+        #   When true, guarantees schema validation on tool names and inputs
+        #
+        #   @return [Boolean, nil]
+        optional :strict, Anthropic::Internal::Type::Boolean
+
+        # @!attribute use_cache
+        #   Whether to use cached content. Set to false to bypass the cache and fetch fresh
+        #   content. Only set to false when the user explicitly requests fresh content or
+        #   when fetching rapidly-changing sources.
+        #
+        #   @return [Boolean, nil]
+        optional :use_cache, Anthropic::Internal::Type::Boolean
+
+        # @!method initialize(allowed_callers: nil, allowed_domains: nil, blocked_domains: nil, cache_control: nil, citations: nil, defer_loading: nil, max_content_tokens: nil, max_uses: nil, response_inclusion: nil, strict: nil, use_cache: nil, name: :web_fetch, type: :web_fetch_20260318)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaWebFetchTool20260318} for more details.
+        #
+        #   @param allowed_callers [Array<Symbol, Anthropic::Models::Beta::BetaWebFetchTool20260318::AllowedCaller>]
+        #
+        #   @param allowed_domains [Array<String>, nil] List of domains to allow fetching from
+        #
+        #   @param blocked_domains [Array<String>, nil] List of domains to block fetching from
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param citations [Anthropic::Models::Beta::BetaCitationsConfigParam, nil] Citations configuration for fetched documents. Citations are disabled by default
+        #
+        #   @param defer_loading [Boolean] If true, tool will not be included in initial system prompt. Only loaded when re
+        #
+        #   @param max_content_tokens [Integer, nil] Maximum number of tokens used by including web page text content in the context.
+        #
+        #   @param max_uses [Integer, nil] Maximum number of times the tool can be used in the API request.
+        #
+        #   @param response_inclusion [Symbol, Anthropic::Models::Beta::BetaWebFetchTool20260318::ResponseInclusion] How this tool's result blocks appear in the API response when the result was con
+        #
+        #   @param strict [Boolean] When true, guarantees schema validation on tool names and inputs
+        #
+        #   @param use_cache [Boolean] Whether to use cached content. Set to false to bypass the cache and fetch fresh
+        #
+        #   @param name [Symbol, :web_fetch] Name of the tool.
+        #
+        #   @param type [Symbol, :web_fetch_20260318]
+
+        # Specifies who can invoke a tool.
+        #
+        # Values: direct: The model can call this tool directly. code_execution_20250825:
+        # The tool can be called from the code execution environment (v1).
+        # code_execution_20260120: The tool can be called from the code execution
+        # environment (v2 with persistence). code_execution_20260521: The tool can be
+        # called from the code execution environment (v2 with persistence).
+        module AllowedCaller
+          extend Anthropic::Internal::Type::Enum
+
+          DIRECT = :direct
+          CODE_EXECUTION_20250825 = :code_execution_20250825
+          CODE_EXECUTION_20260120 = :code_execution_20260120
+          CODE_EXECUTION_20260521 = :code_execution_20260521
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How this tool's result blocks appear in the API response when the result was
+        # consumed by a completed code_execution call in the same turn. 'full' returns the
+        # complete content (default). 'excluded' drops the nested server_tool_use and
+        # result block pair entirely. Results from direct calls, or from code_execution
+        # calls that paused before completing, are always returned in full so they can be
+        # sent back on the next turn.
+        #
+        # @see Anthropic::Models::Beta::BetaWebFetchTool20260318#response_inclusion
+        module ResponseInclusion
+          extend Anthropic::Internal::Type::Enum
+
+          FULL = :full
+          EXCLUDED = :excluded
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    BetaWebFetchTool20260318 = Beta::BetaWebFetchTool20260318
+  end
+end

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

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaWebSearchTool20260318 < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #   Name of the tool.
+        #
+        #   This is how the tool will be called by the model and in `tool_use` blocks.
+        #
+        #   @return [Symbol, :web_search]
+        required :name, const: :web_search
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :web_search_20260318]
+        required :type, const: :web_search_20260318
+
+        # @!attribute allowed_callers
+        #
+        #   @return [Array<Symbol, Anthropic::Models::Beta::BetaWebSearchTool20260318::AllowedCaller>, nil]
+        optional :allowed_callers,
+                 -> { Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::BetaWebSearchTool20260318::AllowedCaller] }
+
+        # @!attribute allowed_domains
+        #   If provided, only these domains will be included in results. Cannot be used
+        #   alongside `blocked_domains`.
+        #
+        #   @return [Array<String>, nil]
+        optional :allowed_domains, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!attribute blocked_domains
+        #   If provided, these domains will never appear in results. Cannot be used
+        #   alongside `allowed_domains`.
+        #
+        #   @return [Array<String>, nil]
+        optional :blocked_domains, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!attribute defer_loading
+        #   If true, tool will not be included in initial system prompt. Only loaded when
+        #   returned via tool_reference from tool search.
+        #
+        #   @return [Boolean, nil]
+        optional :defer_loading, Anthropic::Internal::Type::Boolean
+
+        # @!attribute max_uses
+        #   Maximum number of times the tool can be used in the API request.
+        #
+        #   @return [Integer, nil]
+        optional :max_uses, Integer, nil?: true
+
+        # @!attribute response_inclusion
+        #   How this tool's result blocks appear in the API response when the result was
+        #   consumed by a completed code_execution call in the same turn. 'full' returns the
+        #   complete content (default). 'excluded' drops the nested server_tool_use and
+        #   result block pair entirely. Results from direct calls, or from code_execution
+        #   calls that paused before completing, are always returned in full so they can be
+        #   sent back on the next turn.
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaWebSearchTool20260318::ResponseInclusion, nil]
+        optional :response_inclusion, enum: -> { Anthropic::Beta::BetaWebSearchTool20260318::ResponseInclusion }
+
+        # @!attribute strict
+        #   When true, guarantees schema validation on tool names and inputs
+        #
+        #   @return [Boolean, nil]
+        optional :strict, Anthropic::Internal::Type::Boolean
+
+        # @!attribute user_location
+        #   Parameters for the user's location. Used to provide more relevant search
+        #   results.
+        #
+        #   @return [Anthropic::Models::Beta::BetaUserLocation, nil]
+        optional :user_location, -> { Anthropic::Beta::BetaUserLocation }, nil?: true
+
+        # @!method initialize(allowed_callers: nil, allowed_domains: nil, blocked_domains: nil, cache_control: nil, defer_loading: nil, max_uses: nil, response_inclusion: nil, strict: nil, user_location: nil, name: :web_search, type: :web_search_20260318)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaWebSearchTool20260318} for more details.
+        #
+        #   @param allowed_callers [Array<Symbol, Anthropic::Models::Beta::BetaWebSearchTool20260318::AllowedCaller>]
+        #
+        #   @param allowed_domains [Array<String>, nil] If provided, only these domains will be included in results. Cannot be used alon
+        #
+        #   @param blocked_domains [Array<String>, nil] If provided, these domains will never appear in results. Cannot be used alongsid
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param defer_loading [Boolean] If true, tool will not be included in initial system prompt. Only loaded when re
+        #
+        #   @param max_uses [Integer, nil] Maximum number of times the tool can be used in the API request.
+        #
+        #   @param response_inclusion [Symbol, Anthropic::Models::Beta::BetaWebSearchTool20260318::ResponseInclusion] How this tool's result blocks appear in the API response when the result was con
+        #
+        #   @param strict [Boolean] When true, guarantees schema validation on tool names and inputs
+        #
+        #   @param user_location [Anthropic::Models::Beta::BetaUserLocation, nil] Parameters for the user's location. Used to provide more relevant search results
+        #
+        #   @param name [Symbol, :web_search] Name of the tool.
+        #
+        #   @param type [Symbol, :web_search_20260318]
+
+        # Specifies who can invoke a tool.
+        #
+        # Values: direct: The model can call this tool directly. code_execution_20250825:
+        # The tool can be called from the code execution environment (v1).
+        # code_execution_20260120: The tool can be called from the code execution
+        # environment (v2 with persistence). code_execution_20260521: The tool can be
+        # called from the code execution environment (v2 with persistence).
+        module AllowedCaller
+          extend Anthropic::Internal::Type::Enum
+
+          DIRECT = :direct
+          CODE_EXECUTION_20250825 = :code_execution_20250825
+          CODE_EXECUTION_20260120 = :code_execution_20260120
+          CODE_EXECUTION_20260521 = :code_execution_20260521
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How this tool's result blocks appear in the API response when the result was
+        # consumed by a completed code_execution call in the same turn. 'full' returns the
+        # complete content (default). 'excluded' drops the nested server_tool_use and
+        # result block pair entirely. Results from direct calls, or from code_execution
+        # calls that paused before completing, are always returned in full so they can be
+        # sent back on the next turn.
+        #
+        # @see Anthropic::Models::Beta::BetaWebSearchTool20260318#response_inclusion
+        module ResponseInclusion
+          extend Anthropic::Internal::Type::Enum
+
+          FULL = :full
+          EXCLUDED = :excluded
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    BetaWebSearchTool20260318 = Beta::BetaWebSearchTool20260318
+  end
+end