context.dev 2.8.0 → 2.10.0

data/lib/context_dev/models/utility_prefetch_params.rb

@@ -8,13 +8,14 @@ module ContextDev
       include ContextDev::Internal::Type::RequestParameters
 
       # @!attribute identifier
-      #   Identifier of the brand to prefetch. Provide exactly one of domain or email.
+      #   Identifier of the target to prefetch. Provide exactly one of domain or email.
       #
       #   @return [ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier, ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier]
       required :identifier, union: -> { ContextDev::UtilityPrefetchParams::Identifier }
 
       # @!attribute type
-      #   What to prefetch. Currently only 'brand' is supported.
+      #   What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the
+      #   styleguide cache.
       #
       #   @return [Symbol, ContextDev::Models::UtilityPrefetchParams::Type]
       required :type, enum: -> { ContextDev::UtilityPrefetchParams::Type }
@@ -37,9 +38,9 @@ module ContextDev
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
-      #   @param identifier [ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier, ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier] Identifier of the brand to prefetch. Provide exactly one of domain or email.
+      #   @param identifier [ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier, ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier] Identifier of the target to prefetch. Provide exactly one of domain or email.
       #
-      #   @param type [Symbol, ContextDev::Models::UtilityPrefetchParams::Type] What to prefetch. Currently only 'brand' is supported.
+      #   @param type [Symbol, ContextDev::Models::UtilityPrefetchParams::Type] What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the sty
       #
       #   @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
       #
@@ -47,34 +48,34 @@ module ContextDev
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
-      # Identifier of the brand to prefetch. Provide exactly one of domain or email.
+      # Identifier of the target to prefetch. Provide exactly one of domain or email.
       module Identifier
         extend ContextDev::Internal::Type::Union
 
-        # Prefetch brand data by domain.
+        # Prefetch by domain.
         variant -> { ContextDev::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier }
 
-        # Prefetch brand data by email. The domain will be extracted and validated.
+        # Prefetch by email. The domain will be extracted and validated.
         variant -> { ContextDev::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier }
 
         class UtilityPrefetchDomainIdentifier < ContextDev::Internal::Type::BaseModel
           # @!attribute domain
-          #   Domain name to prefetch brand data for
+          #   Domain name to prefetch data for
           #
           #   @return [String]
           required :domain, String
 
           # @!method initialize(domain:)
-          #   Prefetch brand data by domain.
+          #   Prefetch by domain.
           #
-          #   @param domain [String] Domain name to prefetch brand data for
+          #   @param domain [String] Domain name to prefetch data for
         end
 
         class UtilityPrefetchEmailIdentifier < ContextDev::Internal::Type::BaseModel
           # @!attribute email
-          #   Email address to prefetch brand data for. The domain will be extracted from the
-          #   email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email
-          #   addresses are not allowed.
+          #   Email address to prefetch data for. The domain will be extracted from the email.
+          #   Free email providers (gmail.com, yahoo.com, etc.) and disposable email addresses
+          #   are not allowed.
           #
           #   @return [String]
           required :email, String
@@ -84,20 +85,22 @@ module ContextDev
           #   {ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier}
           #   for more details.
           #
-          #   Prefetch brand data by email. The domain will be extracted and validated.
+          #   Prefetch by email. The domain will be extracted and validated.
           #
-          #   @param email [String] Email address to prefetch brand data for. The domain will be extracted from the
+          #   @param email [String] Email address to prefetch data for. The domain will be extracted from the email.
         end
 
         # @!method self.variants
         #   @return [Array(ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier, ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier)]
       end
 
-      # What to prefetch. Currently only 'brand' is supported.
+      # What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the
+      # styleguide cache.
       module Type
         extend ContextDev::Internal::Type::Enum
 
         BRAND = :brand
+        STYLEGUIDE = :styleguide
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/context_dev/models/utility_prefetch_response.rb

@@ -30,8 +30,7 @@ module ContextDev
       optional :status, String
 
       # @!attribute type
-      #   The type of prefetch that was queued, echoed from the request (currently always
-      #   'brand')
+      #   The type of prefetch that was queued, echoed from the request
       #
       #   @return [Symbol, ContextDev::Models::UtilityPrefetchResponse::Type, nil]
       optional :type, enum: -> { ContextDev::Models::UtilityPrefetchResponse::Type }
@@ -48,7 +47,7 @@ module ContextDev
       #
       #   @param status [String] Status of the response, e.g., 'ok'
       #
-      #   @param type [Symbol, ContextDev::Models::UtilityPrefetchResponse::Type] The type of prefetch that was queued, echoed from the request (currently always
+      #   @param type [Symbol, ContextDev::Models::UtilityPrefetchResponse::Type] The type of prefetch that was queued, echoed from the request
 
       # @see ContextDev::Models::UtilityPrefetchResponse#key_metadata
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
@@ -73,14 +72,14 @@ module ContextDev
         #   @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
       end
 
-      # The type of prefetch that was queued, echoed from the request (currently always
-      # 'brand')
+      # The type of prefetch that was queued, echoed from the request
       #
       # @see ContextDev::Models::UtilityPrefetchResponse#type
       module Type
         extend ContextDev::Internal::Type::Enum
 
         BRAND = :brand
+        STYLEGUIDE = :styleguide
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/context_dev/models/web_screenshot_params.rb

@@ -50,8 +50,8 @@ module ContextDev
       #   dismiss cookie banner before capture. If 'false' or not provided, captures the
       #   page without that step.
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebScreenshotParams::HandleCookiePopup, nil]
-      optional :handle_cookie_popup, union: -> { ContextDev::WebScreenshotParams::HandleCookiePopup }
+      #   @return [Boolean, nil]
+      optional :handle_cookie_popup, ContextDev::Internal::Type::Boolean
 
       # @!attribute max_age_ms
       #   Return a cached screenshot if a prior screenshot for the same parameters exists
@@ -135,7 +135,7 @@ module ContextDev
       #
       #   @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
-      #   @param handle_cookie_popup [Boolean, Symbol, ContextDev::Models::WebScreenshotParams::HandleCookiePopup] Optional parameter to control cookie/consent popup handling. If 'true', we dismi
+      #   @param handle_cookie_popup [Boolean] Optional parameter to control cookie/consent popup handling. If 'true', we dismi
       #
       #   @param max_age_ms [Integer, nil] Return a cached screenshot if a prior screenshot for the same parameters exists
       #
@@ -394,33 +394,6 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
-      # Optional parameter to control cookie/consent popup handling. If 'true', we
-      # dismiss cookie banner before capture. If 'false' or not provided, captures the
-      # page without that step.
-      module HandleCookiePopup
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebScreenshotParams::HandleCookiePopup::TRUE }
-
-        variant const: -> { ContextDev::Models::WebScreenshotParams::HandleCookiePopup::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebScreenshotParams::HandleCookiePopup::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
-      end
-
       # Optional parameter to specify which page type to screenshot. If provided, the
       # system will scrape the domain's links and use heuristics to find the most
       # appropriate URL for the specified page type (30 supported languages). If not

data/lib/context_dev/models/web_search_response.rb

@@ -109,6 +109,7 @@ module ContextDev
             SUCCESS = :SUCCESS
             NOT_REQUESTED = :NOT_REQUESTED
             TIMEOUT = :TIMEOUT
+            CONTENT_TOO_LARGE = :CONTENT_TOO_LARGE
             WEBSITE_ACCESS_ERROR = :WEBSITE_ACCESS_ERROR
             ERROR = :ERROR
 

data/lib/context_dev/models/web_web_crawl_md_params.rb

@@ -428,9 +428,10 @@ module ContextDev
         optional :end_, Integer, api_name: :end
 
         # @!attribute ocr
-        #   When true, detect and OCR images embedded in the selected PDF pages, inserting
-        #   recognized text at each image's position in page reading order while preserving
-        #   the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
+        #   When true, OCR the selected PDF pages that have no usable text layer (scans),
+        #   replacing each recovered page's text with the OCR result while pages with a real
+        #   text layer keep it. Billed at 1 credit per page OCR actually recovered, on top
+        #   of the base request cost.
         #
         #   @return [Boolean, nil]
         optional :ocr, ContextDev::Internal::Type::Boolean
@@ -457,7 +458,7 @@ module ContextDev
         #
         #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
         #
-        #   @param ocr [Boolean] When true, detect and OCR images embedded in the selected PDF pages, inserting r
+        #   @param ocr [Boolean] When true, OCR the selected PDF pages that have no usable text layer (scans), re
         #
         #   @param should_parse [Boolean] When true, PDF pages are fetched and parsed. When false, PDF pages are skipped e
         #

data/lib/context_dev/models/web_web_crawl_md_response.rb

@@ -181,6 +181,14 @@ module ContextDev
           #   @return [String, nil]
           optional :favicon, String
 
+          # @!attribute headings
+          #   Page headings (h1–h6) in document order, extracted from the unfiltered document.
+          #   Capped at the first 500 headings. Omitted when the page has none.
+          #
+          #   @return [Array<ContextDev::Models::WebWebCrawlMdResponse::Result::Metadata::Heading>, nil]
+          optional :headings,
+                   -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebWebCrawlMdResponse::Result::Metadata::Heading] }
+
           # @!attribute image
           #   Primary resolved preview image from Open Graph, Twitter, or image metadata.
           #
@@ -246,7 +254,7 @@ module ContextDev
           optional :twitter,
                    -> { ContextDev::Internal::Type::HashOf[union: ContextDev::Models::WebWebCrawlMdResponse::Result::Metadata::Twitter] }
 
-          # @!method initialize(crawl_depth:, final_url:, source_url:, status_code:, success:, title:, url:, additional_meta: nil, alternates: nil, author: nil, canonical_url: nil, description: nil, favicon: nil, image: nil, json_ld: nil, keywords: nil, language: nil, modified_time: nil, open_graph: nil, published_time: nil, robots: nil, site_name: nil, twitter: nil)
+          # @!method initialize(crawl_depth:, final_url:, source_url:, status_code:, success:, title:, url:, additional_meta: nil, alternates: nil, author: nil, canonical_url: nil, description: nil, favicon: nil, headings: nil, image: nil, json_ld: nil, keywords: nil, language: nil, modified_time: nil, open_graph: nil, published_time: nil, robots: nil, site_name: nil, twitter: nil)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::WebWebCrawlMdResponse::Result::Metadata} for more details.
           #
@@ -276,6 +284,8 @@ module ContextDev
           #
           #   @param favicon [String] Resolved favicon URL, when present.
           #
+          #   @param headings [Array<ContextDev::Models::WebWebCrawlMdResponse::Result::Metadata::Heading>] Page headings (h1–h6) in document order, extracted from the unfiltered document.
+          #
           #   @param image [String] Primary resolved preview image from Open Graph, Twitter, or image metadata.
           #
           #   @param json_ld [Array<Hash{Symbol=>Object}>] JSON-LD structured data blocks parsed from the page.
@@ -345,6 +355,25 @@ module ContextDev
             #   @param type [String] Alternate resource MIME type, when present.
           end
 
+          class Heading < ContextDev::Internal::Type::BaseModel
+            # @!attribute level
+            #   Heading level, 1–6 (from h1–h6).
+            #
+            #   @return [Integer]
+            required :level, Integer
+
+            # @!attribute text
+            #   Heading text with whitespace collapsed, truncated to 1000 characters.
+            #
+            #   @return [String]
+            required :text, String
+
+            # @!method initialize(level:, text:)
+            #   @param level [Integer] Heading level, 1–6 (from h1–h6).
+            #
+            #   @param text [String] Heading text with whitespace collapsed, truncated to 1000 characters.
+          end
+
           module OpenGraph
             extend ContextDev::Internal::Type::Union
 

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -49,8 +49,8 @@ module ContextDev
       # @!attribute include_frames
       #   When true, iframes are rendered inline into the returned HTML.
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::IncludeFrames, nil]
-      optional :include_frames, union: -> { ContextDev::WebWebScrapeHTMLParams::IncludeFrames }
+      #   @return [Boolean, nil]
+      optional :include_frames, ContextDev::Internal::Type::Boolean
 
       # @!attribute include_selectors
       #   CSS selectors. When provided, only matching subtrees (and their descendants) are
@@ -80,8 +80,8 @@ module ContextDev
       #   extracting HTML. Defaults to false. This adds a bit of latency in exchange for
       #   more stable output on animated pages.
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::SettleAnimations, nil]
-      optional :settle_animations, union: -> { ContextDev::WebWebScrapeHTMLParams::SettleAnimations }
+      #   @return [Boolean, nil]
+      optional :settle_animations, ContextDev::Internal::Type::Boolean
 
       # @!attribute tags
       #   Optional comma-separated caller-defined tags for tracking this request. Tags are
@@ -103,8 +103,8 @@ module ContextDev
       #   When true, return only the page's main content in the HTML response, excluding
       #   headers, footers, sidebars, and navigation when detectable.
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::UseMainContentOnly, nil]
-      optional :use_main_content_only, union: -> { ContextDev::WebWebScrapeHTMLParams::UseMainContentOnly }
+      #   @return [Boolean, nil]
+      optional :use_main_content_only, ContextDev::Internal::Type::Boolean
 
       # @!attribute wait_for_ms
       #   Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
@@ -136,7 +136,7 @@ module ContextDev
       #
       #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
       #
-      #   @param include_frames [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::IncludeFrames] When true, iframes are rendered inline into the returned HTML.
+      #   @param include_frames [Boolean] When true, iframes are rendered inline into the returned HTML.
       #
       #   @param include_selectors [Array<String>, nil] CSS selectors. When provided, only matching subtrees (and their descendants) are
       #
@@ -144,13 +144,13 @@ module ContextDev
       #
       #   @param pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
-      #   @param settle_animations [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::SettleAnimations] When true, waits briefly for CSS and transition animations to settle before extr
+      #   @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
       #
       #   @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
-      #   @param use_main_content_only [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::UseMainContentOnly] When true, return only the page's main content in the HTML response, excluding h
+      #   @param use_main_content_only [Boolean] When true, return only the page's main content in the HTML response, excluding h
       #
       #   @param wait_for_ms [Integer, nil] Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
       #
@@ -425,31 +425,6 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
-      # When true, iframes are rendered inline into the returned HTML.
-      module IncludeFrames
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::IncludeFrames::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::IncludeFrames::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeHTMLParams::IncludeFrames::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
-      end
-
       class Pdf < ContextDev::Internal::Type::BaseModel
         # @!attribute end_
         #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
@@ -459,21 +434,20 @@ module ContextDev
         optional :end_, Integer, api_name: :end
 
         # @!attribute ocr
-        #   When true, detect and OCR images embedded in the selected PDF pages, inserting
-        #   recognized text at each image's position in page reading order while preserving
-        #   the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
+        #   When true, OCR the selected PDF pages that have no usable text layer (scans),
+        #   replacing each recovered page's text with the OCR result while pages with a real
+        #   text layer keep it. Billed at 1 credit per page OCR actually recovered, on top
+        #   of the base request cost. When false, no OCR runs.
         #
-        #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Pdf::Ocr, nil]
-        optional :ocr, union: -> { ContextDev::WebWebScrapeHTMLParams::Pdf::Ocr }
+        #   @return [Boolean, nil]
+        optional :ocr, ContextDev::Internal::Type::Boolean
 
         # @!attribute should_parse
         #   When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
-        #   a 400 WEBSITE_ACCESS_ERROR is returned.
+        #   a 400 PDF_SKIPPED is returned.
         #
-        #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Pdf::ShouldParse, nil]
-        optional :should_parse,
-                 union: -> { ContextDev::WebWebScrapeHTMLParams::Pdf::ShouldParse },
-                 api_name: :shouldParse
+        #   @return [Boolean, nil]
+        optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
 
         # @!attribute start
         #   First 1-based PDF page to parse. When omitted, parsing starts at the first page.
@@ -490,121 +464,11 @@ module ContextDev
         #
         #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
         #
-        #   @param ocr [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Pdf::Ocr] When true, detect and OCR images embedded in the selected PDF pages, inserting r
+        #   @param ocr [Boolean] When true, OCR the selected PDF pages that have no usable text layer (scans), re
         #
-        #   @param should_parse [Boolean, Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Pdf::ShouldParse] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+        #   @param should_parse [Boolean] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
         #
         #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
-
-        # When true, detect and OCR images embedded in the selected PDF pages, inserting
-        # recognized text at each image's position in page reading order while preserving
-        # the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
-        #
-        # @see ContextDev::Models::WebWebScrapeHTMLParams::Pdf#ocr
-        module Ocr
-          extend ContextDev::Internal::Type::Union
-
-          variant ContextDev::Internal::Type::Boolean
-
-          variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::Pdf::Ocr::TRUE }
-
-          variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::Pdf::Ocr::FALSE }
-
-          # @!method self.variants
-          #   @return [Array(Boolean, Symbol)]
-
-          define_sorbet_constant!(:Variants) do
-            T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeHTMLParams::Pdf::Ocr::TaggedSymbol) }
-          end
-
-          # @!group
-
-          TRUE = :true
-          FALSE = :false
-
-          # @!endgroup
-        end
-
-        # When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
-        # a 400 WEBSITE_ACCESS_ERROR is returned.
-        #
-        # @see ContextDev::Models::WebWebScrapeHTMLParams::Pdf#should_parse
-        module ShouldParse
-          extend ContextDev::Internal::Type::Union
-
-          variant ContextDev::Internal::Type::Boolean
-
-          variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::Pdf::ShouldParse::TRUE }
-
-          variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::Pdf::ShouldParse::FALSE }
-
-          # @!method self.variants
-          #   @return [Array(Boolean, Symbol)]
-
-          define_sorbet_constant!(:Variants) do
-            T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeHTMLParams::Pdf::ShouldParse::TaggedSymbol) }
-          end
-
-          # @!group
-
-          TRUE = :true
-          FALSE = :false
-
-          # @!endgroup
-        end
-      end
-
-      # When true, waits briefly for CSS and transition animations to settle before
-      # extracting HTML. Defaults to false. This adds a bit of latency in exchange for
-      # more stable output on animated pages.
-      module SettleAnimations
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::SettleAnimations::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::SettleAnimations::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeHTMLParams::SettleAnimations::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
-      end
-
-      # When true, return only the page's main content in the HTML response, excluding
-      # headers, footers, sidebars, and navigation when detectable.
-      module UseMainContentOnly
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::UseMainContentOnly::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeHTMLParams::UseMainContentOnly::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeHTMLParams::UseMainContentOnly::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
       end
 
       # Set to enabled to bypass shared caches and omit request and response content

data/lib/context_dev/models/web_web_scrape_html_response.rb

@@ -135,6 +135,14 @@ module ContextDev
         #   @return [String, nil]
         optional :favicon, String
 
+        # @!attribute headings
+        #   Page headings (h1–h6) in document order, extracted from the unfiltered document.
+        #   Capped at the first 500 headings. Omitted when the page has none.
+        #
+        #   @return [Array<ContextDev::Models::WebWebScrapeHTMLResponse::Metadata::Heading>, nil]
+        optional :headings,
+                 -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebWebScrapeHTMLResponse::Metadata::Heading] }
+
         # @!attribute image
         #   Primary resolved preview image from Open Graph, Twitter, or image metadata.
         #
@@ -206,7 +214,7 @@ module ContextDev
         optional :twitter,
                  -> { ContextDev::Internal::Type::HashOf[union: ContextDev::Models::WebWebScrapeHTMLResponse::Metadata::Twitter] }
 
-        # @!method initialize(final_url:, source_url:, additional_meta: nil, alternates: nil, author: nil, canonical_url: nil, description: nil, favicon: nil, image: nil, json_ld: nil, keywords: nil, language: nil, modified_time: nil, open_graph: nil, published_time: nil, robots: nil, site_name: nil, title: nil, twitter: nil)
+        # @!method initialize(final_url:, source_url:, additional_meta: nil, alternates: nil, author: nil, canonical_url: nil, description: nil, favicon: nil, headings: nil, image: nil, json_ld: nil, keywords: nil, language: nil, modified_time: nil, open_graph: nil, published_time: nil, robots: nil, site_name: nil, title: nil, twitter: nil)
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::WebWebScrapeHTMLResponse::Metadata} for more details.
         #
@@ -228,6 +236,8 @@ module ContextDev
         #
         #   @param favicon [String] Resolved favicon URL, when present.
         #
+        #   @param headings [Array<ContextDev::Models::WebWebScrapeHTMLResponse::Metadata::Heading>] Page headings (h1–h6) in document order, extracted from the unfiltered document.
+        #
         #   @param image [String] Primary resolved preview image from Open Graph, Twitter, or image metadata.
         #
         #   @param json_ld [Array<Hash{Symbol=>Object}>] JSON-LD structured data blocks parsed from the page.
@@ -299,6 +309,25 @@ module ContextDev
           #   @param type [String] Alternate resource MIME type, when present.
         end
 
+        class Heading < ContextDev::Internal::Type::BaseModel
+          # @!attribute level
+          #   Heading level, 1–6 (from h1–h6).
+          #
+          #   @return [Integer]
+          required :level, Integer
+
+          # @!attribute text
+          #   Heading text with whitespace collapsed, truncated to 1000 characters.
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!method initialize(level:, text:)
+          #   @param level [Integer] Heading level, 1–6 (from h1–h6).
+          #
+          #   @param text [String] Heading text with whitespace collapsed, truncated to 1000 characters.
+        end
+
         module OpenGraph
           extend ContextDev::Internal::Type::Union