context.dev 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f2f6c8c373d61ab07f5969d5f7f9bb52539093279b41b09a5e7bbefc6d4bd9e
-  data.tar.gz: d4afbf2bb5144a50a0b9930321c3ab8b3d193fd1a01da993ae2285a226a32597
+  metadata.gz: d3053b0240426586c72a3ff1876ef8965d555cc938b5cf82bc69dc8d728b3c13
+  data.tar.gz: 3cbe46d917bc4abca8abe5f1af719b66de6eb2c78b912f5846ed769412975579
 SHA512:
-  metadata.gz: 6e38d8989d26cecb219a1dcbb39d29c4f7bc92d9dda81de355959267ceeaa1c1587ea778163a1ce5267afcff70d36ac666b6b442226ba359ca0c82465b8bb05a
-  data.tar.gz: b9a94c13fc5cc8bf84c84bfbd46277e519d878bfc74f6d82f4e941bf01adf4bb9b9197f2eb32f06d722624a410ee703b351beb7f1d0ff51f7228f7addd5ea75d
+  metadata.gz: 36f207582130d9e38c3704b516f4927062f00f3b5b5f60cfbcf6a171f5081afed1c0c540810611a000d6a869bf9127a97b50d5a69c723da8aa18d2ae1ebda5b1
+  data.tar.gz: 1a27a3872ba648463b321aee475780bf0c42142a33ae6d39453364727ec290645be4e53750afb9db0d3fe3b2a15b722338a1494d3a2271c483eea43d460fd70f

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.28.0 (2026-06-06)
+
+Full Changelog: [v1.27.0...v1.28.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.27.0...v1.28.0)
+
+### Features
+
+* **api:** api update ([22eb08f](https://github.com/context-dot-dev/context-ruby-sdk/commit/22eb08f65d1001052f1bd247a4d60e2680bb33ea))
+
 ## 1.27.0 (2026-06-01)
 
 Full Changelog: [v1.26.0...v1.27.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.26.0...v1.27.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.27.0"
+gem "context.dev", "~> 1.28.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -13,6 +13,14 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute include_frames
       #   When true, iframes are rendered inline into the returned HTML.
       #
@@ -49,12 +57,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, headers: nil, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeHTMLParams} for more details.
       #
       #   @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param include_frames [Boolean] When true, iframes are rendered inline into the returned HTML.
       #
       #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y

data/lib/context_dev/models/web_web_scrape_images_params.rb

@@ -20,6 +20,14 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeImagesParams::Enrichment, nil]
       optional :enrichment, -> { ContextDev::WebWebScrapeImagesParams::Enrichment }
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute max_age_ms
       #   Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #   day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
@@ -42,7 +50,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, enrichment: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, enrichment: nil, headers: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeImagesParams} for more details.
       #
@@ -50,6 +58,8 @@ module ContextDev
       #
       #   @param enrichment [ContextDev::Models::WebWebScrapeImagesParams::Enrichment] Optional per-image processing, sent as deep-object query params such as enrichme
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -14,6 +14,14 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute include_frames
       #   When true, the contents of iframes are rendered to Markdown.
       #
@@ -75,12 +83,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, headers: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdParams} for more details.
       #
       #   @param url [String] Full URL to scrape into LLM usable Markdown (must include http:// or https:// pr
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param include_frames [Boolean] When true, the contents of iframes are rendered to Markdown.
       #
       #   @param include_images [Boolean] Include image references in Markdown output

data/lib/context_dev/models/web_web_scrape_sitemap_params.rb

@@ -13,6 +13,14 @@ module ContextDev
       #   @return [String]
       required :domain, String
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute max_links
       #   Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
       #   Minimum is 1, maximum is 100,000.
@@ -35,12 +43,14 @@ module ContextDev
       #   @return [String, nil]
       optional :url_regex, String
 
-      # @!method initialize(domain:, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
+      # @!method initialize(domain:, headers: nil, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeSitemapParams} for more details.
       #
       #   @param domain [String] Domain to build a sitemap for
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/resources/web.rb

@@ -299,10 +299,12 @@ module ContextDev
       #
       # Scrapes the given URL and returns the raw HTML content of the page.
       #
-      # @overload web_scrape_html(url:, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_html(url:, headers: nil, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param include_frames [Boolean] When true, iframes are rendered inline into the returned HTML.
       #
       # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
@@ -343,12 +345,14 @@ module ContextDev
       # embeds. The base request costs 1 credit. When enrichment is enabled, the entire
       # call costs 5 credits.
       #
-      # @overload web_scrape_images(url:, enrichment: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_images(url:, enrichment: nil, headers: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Page URL to inspect. Must include http:// or https://.
       #
       # @param enrichment [ContextDev::Models::WebWebScrapeImagesParams::Enrichment] Optional per-image processing, sent as deep-object query params such as enrichme
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -381,10 +385,12 @@ module ContextDev
       #
       # Scrapes the given URL into LLM usable Markdown.
       #
-      # @overload web_scrape_md(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_md(url:, headers: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape into LLM usable Markdown (must include http:// or https:// pr
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param include_frames [Boolean] When true, the contents of iframes are rendered to Markdown.
       #
       # @param include_images [Boolean] Include image references in Markdown output
@@ -434,10 +440,12 @@ module ContextDev
       #
       # Crawl an entire website's sitemap and return all discovered page URLs.
       #
-      # @overload web_scrape_sitemap(domain:, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
+      # @overload web_scrape_sitemap(domain:, headers: nil, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
       #
       # @param domain [String] Domain to build a sitemap for
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "1.27.0"
+  VERSION = "1.28.0"
 end

data/rbi/context_dev/models/web_web_scrape_html_params.rbi

@@ -18,6 +18,15 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # Optional outbound HTTP headers forwarded only to the target URL, sent as
+      # deep-object query params such as headers[X-Custom]=value. When provided, caching
+      # is bypassed: the result is neither read from nor written to cache.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :headers
+
+      sig { params(headers: T::Hash[Symbol, String]).void }
+      attr_writer :headers
+
       # When true, iframes are rendered inline into the returned HTML.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :include_frames
@@ -62,6 +71,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          headers: T::Hash[Symbol, String],
           include_frames: T::Boolean,
           max_age_ms: Integer,
           pdf: ContextDev::WebWebScrapeHTMLParams::Pdf::OrHash,
@@ -73,6 +83,10 @@ module ContextDev
       def self.new(
         # Full URL to scrape (must include http:// or https:// protocol)
         url:,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # When true, iframes are rendered inline into the returned HTML.
         include_frames: nil,
         # Return a cached result if a prior scrape for the same parameters exists and is
@@ -97,6 +111,7 @@ module ContextDev
         override.returns(
           {
             url: String,
+            headers: T::Hash[Symbol, String],
             include_frames: T::Boolean,
             max_age_ms: Integer,
             pdf: ContextDev::WebWebScrapeHTMLParams::Pdf,

data/rbi/context_dev/models/web_web_scrape_images_params.rbi

@@ -32,6 +32,15 @@ module ContextDev
       end
       attr_writer :enrichment
 
+      # Optional outbound HTTP headers forwarded only to the target URL, sent as
+      # deep-object query params such as headers[X-Custom]=value. When provided, caching
+      # is bypassed: the result is neither read from nor written to cache.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :headers
+
+      sig { params(headers: T::Hash[Symbol, String]).void }
+      attr_writer :headers
+
       # Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       # day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
       sig { returns(T.nilable(Integer)) }
@@ -61,6 +70,7 @@ module ContextDev
         params(
           url: String,
           enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment::OrHash,
+          headers: T::Hash[Symbol, String],
           max_age_ms: Integer,
           timeout_ms: Integer,
           wait_for_ms: Integer,
@@ -73,6 +83,10 @@ module ContextDev
         # Optional per-image processing, sent as deep-object query params such as
         # enrichment[resolution]=true.
         enrichment: nil,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
         # day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
         max_age_ms: nil,
@@ -92,6 +106,7 @@ module ContextDev
           {
             url: String,
             enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+            headers: T::Hash[Symbol, String],
             max_age_ms: Integer,
             timeout_ms: Integer,
             wait_for_ms: Integer,

data/rbi/context_dev/models/web_web_scrape_md_params.rbi

@@ -16,6 +16,15 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # Optional outbound HTTP headers forwarded only to the target URL, sent as
+      # deep-object query params such as headers[X-Custom]=value. When provided, caching
+      # is bypassed: the result is neither read from nor written to cache.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :headers
+
+      sig { params(headers: T::Hash[Symbol, String]).void }
+      attr_writer :headers
+
       # When true, the contents of iframes are rendered to Markdown.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :include_frames
@@ -89,6 +98,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          headers: T::Hash[Symbol, String],
           include_frames: T::Boolean,
           include_images: T::Boolean,
           include_links: T::Boolean,
@@ -105,6 +115,10 @@ module ContextDev
         # Full URL to scrape into LLM usable Markdown (must include http:// or https://
         # protocol)
         url:,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # When true, the contents of iframes are rendered to Markdown.
         include_frames: nil,
         # Include image references in Markdown output
@@ -138,6 +152,7 @@ module ContextDev
         override.returns(
           {
             url: String,
+            headers: T::Hash[Symbol, String],
             include_frames: T::Boolean,
             include_images: T::Boolean,
             include_links: T::Boolean,

data/rbi/context_dev/models/web_web_scrape_sitemap_params.rbi

@@ -18,6 +18,15 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :domain
 
+      # Optional outbound HTTP headers forwarded only to the target URL, sent as
+      # deep-object query params such as headers[X-Custom]=value. When provided, caching
+      # is bypassed: the result is neither read from nor written to cache.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :headers
+
+      sig { params(headers: T::Hash[Symbol, String]).void }
+      attr_writer :headers
+
       # Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
       # Minimum is 1, maximum is 100,000.
       sig { returns(T.nilable(Integer)) }
@@ -46,6 +55,7 @@ module ContextDev
       sig do
         params(
           domain: String,
+          headers: T::Hash[Symbol, String],
           max_links: Integer,
           timeout_ms: Integer,
           url_regex: String,
@@ -55,6 +65,10 @@ module ContextDev
       def self.new(
         # Domain to build a sitemap for
         domain:,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
         # Minimum is 1, maximum is 100,000.
         max_links: nil,
@@ -73,6 +87,7 @@ module ContextDev
         override.returns(
           {
             domain: String,
+            headers: T::Hash[Symbol, String],
             max_links: Integer,
             timeout_ms: Integer,
             url_regex: String,

data/rbi/context_dev/resources/web.rbi

@@ -320,6 +320,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          headers: T::Hash[Symbol, String],
           include_frames: T::Boolean,
           max_age_ms: Integer,
           pdf: ContextDev::WebWebScrapeHTMLParams::Pdf::OrHash,
@@ -331,6 +332,10 @@ module ContextDev
       def web_scrape_html(
         # Full URL to scrape (must include http:// or https:// protocol)
         url:,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # When true, iframes are rendered inline into the returned HTML.
         include_frames: nil,
         # Return a cached result if a prior scrape for the same parameters exists and is
@@ -359,6 +364,7 @@ module ContextDev
         params(
           url: String,
           enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment::OrHash,
+          headers: T::Hash[Symbol, String],
           max_age_ms: Integer,
           timeout_ms: Integer,
           wait_for_ms: Integer,
@@ -371,6 +377,10 @@ module ContextDev
         # Optional per-image processing, sent as deep-object query params such as
         # enrichment[resolution]=true.
         enrichment: nil,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
         # day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
         max_age_ms: nil,
@@ -389,6 +399,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          headers: T::Hash[Symbol, String],
           include_frames: T::Boolean,
           include_images: T::Boolean,
           include_links: T::Boolean,
@@ -405,6 +416,10 @@ module ContextDev
         # Full URL to scrape into LLM usable Markdown (must include http:// or https://
         # protocol)
         url:,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # When true, the contents of iframes are rendered to Markdown.
         include_frames: nil,
         # Include image references in Markdown output
@@ -438,6 +453,7 @@ module ContextDev
       sig do
         params(
           domain: String,
+          headers: T::Hash[Symbol, String],
           max_links: Integer,
           timeout_ms: Integer,
           url_regex: String,
@@ -447,6 +463,10 @@ module ContextDev
       def web_scrape_sitemap(
         # Domain to build a sitemap for
         domain:,
+        # Optional outbound HTTP headers forwarded only to the target URL, sent as
+        # deep-object query params such as headers[X-Custom]=value. When provided, caching
+        # is bypassed: the result is neither read from nor written to cache.
+        headers: nil,
         # Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
         # Minimum is 1, maximum is 100,000.
         max_links: nil,

data/sig/context_dev/models/web_web_scrape_html_params.rbs

@@ -3,6 +3,7 @@ module ContextDev
     type web_web_scrape_html_params =
       {
         url: String,
+        headers: ::Hash[Symbol, String],
         include_frames: bool,
         max_age_ms: Integer,
         pdf: ContextDev::WebWebScrapeHTMLParams::Pdf,
@@ -17,6 +18,10 @@ module ContextDev
 
       attr_accessor url: String
 
+      attr_reader headers: ::Hash[Symbol, String]?
+
+      def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
       attr_reader include_frames: bool?
 
       def include_frames=: (bool) -> bool
@@ -41,6 +46,7 @@ module ContextDev
 
       def initialize: (
         url: String,
+        ?headers: ::Hash[Symbol, String],
         ?include_frames: bool,
         ?max_age_ms: Integer,
         ?pdf: ContextDev::WebWebScrapeHTMLParams::Pdf,
@@ -51,6 +57,7 @@ module ContextDev
 
       def to_hash: -> {
         url: String,
+        headers: ::Hash[Symbol, String],
         include_frames: bool,
         max_age_ms: Integer,
         pdf: ContextDev::WebWebScrapeHTMLParams::Pdf,

data/sig/context_dev/models/web_web_scrape_images_params.rbs

@@ -4,6 +4,7 @@ module ContextDev
       {
         url: String,
         enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        headers: ::Hash[Symbol, String],
         max_age_ms: Integer,
         timeout_ms: Integer,
         wait_for_ms: Integer
@@ -22,6 +23,10 @@ module ContextDev
         ContextDev::WebWebScrapeImagesParams::Enrichment
       ) -> ContextDev::WebWebScrapeImagesParams::Enrichment
 
+      attr_reader headers: ::Hash[Symbol, String]?
+
+      def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
       attr_reader max_age_ms: Integer?
 
       def max_age_ms=: (Integer) -> Integer
@@ -37,6 +42,7 @@ module ContextDev
       def initialize: (
         url: String,
         ?enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        ?headers: ::Hash[Symbol, String],
         ?max_age_ms: Integer,
         ?timeout_ms: Integer,
         ?wait_for_ms: Integer,
@@ -46,6 +52,7 @@ module ContextDev
       def to_hash: -> {
         url: String,
         enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        headers: ::Hash[Symbol, String],
         max_age_ms: Integer,
         timeout_ms: Integer,
         wait_for_ms: Integer,

data/sig/context_dev/models/web_web_scrape_md_params.rbs

@@ -3,6 +3,7 @@ module ContextDev
     type web_web_scrape_md_params =
       {
         url: String,
+        headers: ::Hash[Symbol, String],
         include_frames: bool,
         include_images: bool,
         include_links: bool,
@@ -21,6 +22,10 @@ module ContextDev
 
       attr_accessor url: String
 
+      attr_reader headers: ::Hash[Symbol, String]?
+
+      def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
       attr_reader include_frames: bool?
 
       def include_frames=: (bool) -> bool
@@ -61,6 +66,7 @@ module ContextDev
 
       def initialize: (
         url: String,
+        ?headers: ::Hash[Symbol, String],
         ?include_frames: bool,
         ?include_images: bool,
         ?include_links: bool,
@@ -75,6 +81,7 @@ module ContextDev
 
       def to_hash: -> {
         url: String,
+        headers: ::Hash[Symbol, String],
         include_frames: bool,
         include_images: bool,
         include_links: bool,

data/sig/context_dev/models/web_web_scrape_sitemap_params.rbs

@@ -3,6 +3,7 @@ module ContextDev
     type web_web_scrape_sitemap_params =
       {
         domain: String,
+        headers: ::Hash[Symbol, String],
         max_links: Integer,
         timeout_ms: Integer,
         url_regex: String
@@ -15,6 +16,10 @@ module ContextDev
 
       attr_accessor domain: String
 
+      attr_reader headers: ::Hash[Symbol, String]?
+
+      def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
       attr_reader max_links: Integer?
 
       def max_links=: (Integer) -> Integer
@@ -29,6 +34,7 @@ module ContextDev
 
       def initialize: (
         domain: String,
+        ?headers: ::Hash[Symbol, String],
         ?max_links: Integer,
         ?timeout_ms: Integer,
         ?url_regex: String,
@@ -37,6 +43,7 @@ module ContextDev
 
       def to_hash: -> {
         domain: String,
+        headers: ::Hash[Symbol, String],
         max_links: Integer,
         timeout_ms: Integer,
         url_regex: String,

data/sig/context_dev/resources/web.rbs

@@ -84,6 +84,7 @@ module ContextDev
 
       def web_scrape_html: (
         url: String,
+        ?headers: ::Hash[Symbol, String],
         ?include_frames: bool,
         ?max_age_ms: Integer,
         ?pdf: ContextDev::WebWebScrapeHTMLParams::Pdf,
@@ -95,6 +96,7 @@ module ContextDev
       def web_scrape_images: (
         url: String,
         ?enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        ?headers: ::Hash[Symbol, String],
         ?max_age_ms: Integer,
         ?timeout_ms: Integer,
         ?wait_for_ms: Integer,
@@ -103,6 +105,7 @@ module ContextDev
 
       def web_scrape_md: (
         url: String,
+        ?headers: ::Hash[Symbol, String],
         ?include_frames: bool,
         ?include_images: bool,
         ?include_links: bool,
@@ -117,6 +120,7 @@ module ContextDev
 
       def web_scrape_sitemap: (
         domain: String,
+        ?headers: ::Hash[Symbol, String],
         ?max_links: Integer,
         ?timeout_ms: Integer,
         ?url_regex: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: context.dev
 version: !ruby/object:Gem::Version
-  version: 1.27.0
+  version: 1.28.0
 platform: ruby
 authors:
 - Context Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-01 00:00:00.000000000 Z
+date: 2026-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi