context.dev 2.9.0 → 2.10.0

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -50,20 +50,28 @@ module ContextDev
       # @!attribute include_frames
       #   When true, the contents of iframes are rendered to Markdown.
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::IncludeFrames, nil]
-      optional :include_frames, union: -> { ContextDev::WebWebScrapeMdParams::IncludeFrames }
+      #   @return [Boolean, nil]
+      optional :include_frames, ContextDev::Internal::Type::Boolean
+
+      # @!attribute include_html
+      #   When true, the response also includes an `html` field with the page HTML the
+      #   Markdown was converted from — the same body the Scrape HTML endpoint returns for
+      #   the equivalent request.
+      #
+      #   @return [Boolean, nil]
+      optional :include_html, ContextDev::Internal::Type::Boolean
 
       # @!attribute include_images
       #   Include image references in Markdown output
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::IncludeImages, nil]
-      optional :include_images, union: -> { ContextDev::WebWebScrapeMdParams::IncludeImages }
+      #   @return [Boolean, nil]
+      optional :include_images, ContextDev::Internal::Type::Boolean
 
       # @!attribute include_links
       #   Preserve hyperlinks in Markdown output
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::IncludeLinks, nil]
-      optional :include_links, union: -> { ContextDev::WebWebScrapeMdParams::IncludeLinks }
+      #   @return [Boolean, nil]
+      optional :include_links, ContextDev::Internal::Type::Boolean
 
       # @!attribute include_selectors
       #   CSS selectors. When provided, only matching HTML subtrees (and their
@@ -93,14 +101,14 @@ module ContextDev
       #   converting to Markdown. Defaults to false. This adds a bit of latency in
       #   exchange for more stable output on animated pages.
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::SettleAnimations, nil]
-      optional :settle_animations, union: -> { ContextDev::WebWebScrapeMdParams::SettleAnimations }
+      #   @return [Boolean, nil]
+      optional :settle_animations, ContextDev::Internal::Type::Boolean
 
       # @!attribute shorten_base64_images
       #   Shorten base64-encoded image data in the Markdown output
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::ShortenBase64Images, nil]
-      optional :shorten_base64_images, union: -> { ContextDev::WebWebScrapeMdParams::ShortenBase64Images }
+      #   @return [Boolean, nil]
+      optional :shorten_base64_images, ContextDev::Internal::Type::Boolean
 
       # @!attribute tags
       #   Optional comma-separated caller-defined tags for tracking this request. Tags are
@@ -122,8 +130,8 @@ module ContextDev
       #   Extract only the main content of the page, excluding headers, footers, sidebars,
       #   and navigation
       #
-      #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::UseMainContentOnly, nil]
-      optional :use_main_content_only, union: -> { ContextDev::WebWebScrapeMdParams::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 before
@@ -141,7 +149,7 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebWebScrapeMdParams::Zdr, nil]
       optional :zdr, enum: -> { ContextDev::WebWebScrapeMdParams::Zdr }
 
-      # @!method initialize(url:, actions: nil, country: nil, exclude_selectors: nil, headers: nil, include_frames: nil, include_images: nil, include_links: nil, include_selectors: nil, max_age_ms: nil, pdf: nil, settle_animations: nil, shorten_base64_images: nil, tags: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, zdr: nil, request_options: {})
+      # @!method initialize(url:, actions: nil, country: nil, exclude_selectors: nil, headers: nil, include_frames: nil, include_html: nil, include_images: nil, include_links: nil, include_selectors: nil, max_age_ms: nil, pdf: nil, settle_animations: nil, shorten_base64_images: nil, tags: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, zdr: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdParams} for more details.
       #
@@ -155,11 +163,13 @@ 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::WebWebScrapeMdParams::IncludeFrames] When true, the contents of iframes are rendered to Markdown.
+      #   @param include_frames [Boolean] When true, the contents of iframes are rendered to Markdown.
       #
-      #   @param include_images [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::IncludeImages] Include image references in Markdown output
+      #   @param include_html [Boolean] When true, the response also includes an `html` field with the page HTML the Mar
       #
-      #   @param include_links [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::IncludeLinks] Preserve hyperlinks in Markdown output
+      #   @param include_images [Boolean] Include image references in Markdown output
+      #
+      #   @param include_links [Boolean] Preserve hyperlinks in Markdown output
       #
       #   @param include_selectors [Array<String>, nil] CSS selectors. When provided, only matching HTML subtrees (and their descendants
       #
@@ -167,15 +177,15 @@ module ContextDev
       #
       #   @param pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
-      #   @param settle_animations [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::SettleAnimations] When true, waits briefly for CSS and transition animations to settle before conv
+      #   @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before conv
       #
-      #   @param shorten_base64_images [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::ShortenBase64Images] Shorten base64-encoded image data in the Markdown output
+      #   @param shorten_base64_images [Boolean] Shorten base64-encoded image data in the Markdown output
       #
       #   @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::WebWebScrapeMdParams::UseMainContentOnly] Extract only the main content of the page, excluding headers, footers, sidebars,
+      #   @param use_main_content_only [Boolean] Extract only the main content of the page, excluding headers, footers, sidebars,
       #
       #   @param wait_for_ms [Integer, nil] Optional browser wait time in milliseconds after initial page load before conver
       #
@@ -450,81 +460,6 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
-      # When true, the contents of iframes are rendered to Markdown.
-      module IncludeFrames
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::IncludeFrames::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::IncludeFrames::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::IncludeFrames::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
-      end
-
-      # Include image references in Markdown output
-      module IncludeImages
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::IncludeImages::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::IncludeImages::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::IncludeImages::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
-      end
-
-      # Preserve hyperlinks in Markdown output
-      module IncludeLinks
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::IncludeLinks::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::IncludeLinks::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::IncludeLinks::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.
@@ -539,17 +474,15 @@ module ContextDev
         #   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::WebWebScrapeMdParams::Pdf::Ocr, nil]
-        optional :ocr, union: -> { ContextDev::WebWebScrapeMdParams::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 PDF_SKIPPED is returned.
         #
-        #   @return [Boolean, Symbol, ContextDev::Models::WebWebScrapeMdParams::Pdf::ShouldParse, nil]
-        optional :should_parse,
-                 union: -> { ContextDev::WebWebScrapeMdParams::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.
@@ -566,147 +499,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::WebWebScrapeMdParams::Pdf::Ocr] When true, OCR the selected PDF pages that have no usable text layer (scans), re
+        #   @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::WebWebScrapeMdParams::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, 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.
-        #
-        # @see ContextDev::Models::WebWebScrapeMdParams::Pdf#ocr
-        module Ocr
-          extend ContextDev::Internal::Type::Union
-
-          variant ContextDev::Internal::Type::Boolean
-
-          variant const: -> { ContextDev::Models::WebWebScrapeMdParams::Pdf::Ocr::TRUE }
-
-          variant const: -> { ContextDev::Models::WebWebScrapeMdParams::Pdf::Ocr::FALSE }
-
-          # @!method self.variants
-          #   @return [Array(Boolean, Symbol)]
-
-          define_sorbet_constant!(:Variants) do
-            T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::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 PDF_SKIPPED is returned.
-        #
-        # @see ContextDev::Models::WebWebScrapeMdParams::Pdf#should_parse
-        module ShouldParse
-          extend ContextDev::Internal::Type::Union
-
-          variant ContextDev::Internal::Type::Boolean
-
-          variant const: -> { ContextDev::Models::WebWebScrapeMdParams::Pdf::ShouldParse::TRUE }
-
-          variant const: -> { ContextDev::Models::WebWebScrapeMdParams::Pdf::ShouldParse::FALSE }
-
-          # @!method self.variants
-          #   @return [Array(Boolean, Symbol)]
-
-          define_sorbet_constant!(:Variants) do
-            T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::TaggedSymbol) }
-          end
-
-          # @!group
-
-          TRUE = :true
-          FALSE = :false
-
-          # @!endgroup
-        end
-      end
-
-      # When true, waits briefly for CSS and transition animations to settle before
-      # converting to Markdown. 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::WebWebScrapeMdParams::SettleAnimations::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::SettleAnimations::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::SettleAnimations::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
-      end
-
-      # Shorten base64-encoded image data in the Markdown output
-      module ShortenBase64Images
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::ShortenBase64Images::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::ShortenBase64Images::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::ShortenBase64Images::TaggedSymbol) }
-        end
-
-        # @!group
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!endgroup
-      end
-
-      # Extract only the main content of the page, excluding headers, footers, sidebars,
-      # and navigation
-      module UseMainContentOnly
-        extend ContextDev::Internal::Type::Union
-
-        variant ContextDev::Internal::Type::Boolean
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::UseMainContentOnly::TRUE }
-
-        variant const: -> { ContextDev::Models::WebWebScrapeMdParams::UseMainContentOnly::FALSE }
-
-        # @!method self.variants
-        #   @return [Array(Boolean, Symbol)]
-
-        define_sorbet_constant!(:Variants) do
-          T.type_alias { T.any(T::Boolean, ContextDev::WebWebScrapeMdParams::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_md_response.rb

@@ -51,6 +51,14 @@ module ContextDev
       #   @return [Boolean, nil]
       optional :actions_html_stale, ContextDev::Internal::Type::Boolean, api_name: :actionsHtmlStale
 
+      # @!attribute html
+      #   Only present when includeHTML=true: the page HTML the Markdown was converted
+      #   from — the same body the Scrape HTML endpoint returns for the equivalent
+      #   request.
+      #
+      #   @return [String, nil]
+      optional :html, String
+
       # @!attribute key_metadata
       #   Metadata about the API key used for the request. Included in every response
       #   whenever a valid API key is provided, even when the response status is not 200.
@@ -58,7 +66,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata }
 
-      # @!method initialize(content_length:, markdown:, metadata:, success:, url:, actions_applied: nil, actions_html_stale: nil, key_metadata: nil)
+      # @!method initialize(content_length:, markdown:, metadata:, success:, url:, actions_applied: nil, actions_html_stale: nil, html: nil, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdResponse} for more details.
       #
@@ -76,6 +84,8 @@ module ContextDev
       #
       #   @param actions_html_stale [Boolean] True when an action was applied but the returned content could not be refreshed
       #
+      #   @param html [String] Only present when includeHTML=true: the page HTML the Markdown was converted fro
+      #
       #   @param key_metadata [ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
 
       # @see ContextDev::Models::WebWebScrapeMdResponse#metadata
@@ -132,6 +142,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::WebWebScrapeMdResponse::Metadata::Heading>, nil]
+        optional :headings,
+                 -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebWebScrapeMdResponse::Metadata::Heading] }
+
         # @!attribute image
         #   Primary resolved preview image from Open Graph, Twitter, or image metadata.
         #
@@ -203,7 +221,7 @@ module ContextDev
         optional :twitter,
                  -> { ContextDev::Internal::Type::HashOf[union: ContextDev::Models::WebWebScrapeMdResponse::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::WebWebScrapeMdResponse::Metadata} for more details.
         #
@@ -225,6 +243,8 @@ module ContextDev
         #
         #   @param favicon [String] Resolved favicon URL, when present.
         #
+        #   @param headings [Array<ContextDev::Models::WebWebScrapeMdResponse::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.
@@ -296,6 +316,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.rb

@@ -97,6 +97,8 @@ module ContextDev
 
   MonitorUpdateParams = ContextDev::Models::MonitorUpdateParams
 
+  NewsSearchParams = ContextDev::Models::NewsSearchParams
+
   PageErrorCount = ContextDev::Models::PageErrorCount
 
   ParseHandleParams = ContextDev::Models::ParseHandleParams

data/lib/context_dev/resources/brand.rb

@@ -68,21 +68,20 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::BrandSearchParams} for more details.
       #
-      # Search brands by name or domain and get back up to 10 lightweight matches
-      # (domain, name, logo). Name matches rank ahead of domain matches; within each
-      # group the most popular brands come first: by Tranco rank, then market cap for
-      # brands outside the Tranco list, with text relevance breaking ties. Matching is
-      # prefix-based with no typo tolerance, so it is suited to autocomplete. Only
-      # brands already in the Context.dev index are returned — use /brand/retrieve to
-      # fetch (and index) a specific domain. Free on Pro and Scale plans; costs 1 credit
-      # per request on the Free and Starter plans.
+      # Search indexed brands by name or domain
       #
-      # @overload search(query:, tags: nil, request_options: {})
+      # @overload search(query:, autocomplete: nil, query_by: nil, tags: nil, typo_tolerance: nil, request_options: {})
       #
-      # @param query [String] Search term, matched against brand names and domains by prefix (e.g. 'nike', 'ni
+      # @param query [String] Search term, matched against the fields selected by queryBy (e.g. 'nike', 'nike.
+      #
+      # @param autocomplete [Boolean] Whether the search term matches by prefix, so partial words match as they are ty
+      #
+      # @param query_by [Array<Symbol, ContextDev::Models::BrandSearchParams::QueryBy>] Fields to match the search term against, as a comma-separated list or repeated p
       #
       # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
       #
+      # @param typo_tolerance [Integer] Maximum number of typos tolerated when matching, from 0 to 2. Defaults to 0 (no
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::BrandSearchResponse]
@@ -94,7 +93,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "brand/search",
-          query: query,
+          query: query.transform_keys(query_by: "queryBy", typo_tolerance: "typoTolerance"),
           model: ContextDev::Models::BrandSearchResponse,
           options: options
         )

data/lib/context_dev/resources/news.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Resources
+    # Search live first-party RSS and free historical news data by company identity.
+    class News
+      # Searches live and historical company news for one company, identified in
+      # searchBy by name, domain, ticker (optionally disambiguated by exchange), or
+      # ISIN. Results can be filtered by publisher domain, publisher country, article
+      # language, article type, and published-at date, and include stable story IDs,
+      # source metadata, verified entity relevance, and cursor pagination.
+      #
+      # @overload search(search_by:, cursor: nil, filter_by: nil, limit: nil, sort_by: nil, tags: nil, request_options: {})
+      #
+      # @param search_by [ContextDev::Models::NewsSearchParams::SearchBy] What to search for.
+      #
+      # @param cursor [String, nil] Opaque next_cursor from the previous response, or null for the first page.
+      #
+      # @param filter_by [ContextDev::Models::NewsSearchParams::FilterBy] Optional result filters.
+      #
+      # @param limit [Integer] Maximum results to return. Defaults to 10.
+      #
+      # @param sort_by [ContextDev::Models::NewsSearchParams::SortBy] Result ordering. Defaults to newest.
+      #
+      # @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::NewsSearchResponse]
+      #
+      # @see ContextDev::Models::NewsSearchParams
+      def search(params)
+        parsed, options = ContextDev::NewsSearchParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "news/search",
+          body: parsed,
+          model: ContextDev::Models::NewsSearchResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [ContextDev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/context_dev/resources/parse.rb

@@ -17,19 +17,19 @@ module ContextDev
       #
       # @param extension [Symbol, ContextDev::Models::ParseHandleParams::Extension] Query param: Optional file extension hint, such as pdf, docx, xlsx, pptx, html,
       #
-      # @param include_images [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeImages] Query param: Include image references in Markdown output
+      # @param include_images [Boolean] Query param: Include image references in Markdown output
       #
-      # @param include_links [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeLinks] Query param: Preserve hyperlinks in Markdown output
+      # @param include_links [Boolean] Query param: Preserve hyperlinks in Markdown output
       #
-      # @param ocr [Boolean, Symbol, ContextDev::Models::ParseHandleParams::Ocr] Query param: When true for PDF inputs, OCR the selected pages that have no usabl
+      # @param ocr [Boolean] Query param: When true for PDF inputs, OCR the selected pages that have no usabl
       #
       # @param pdf [ContextDev::Models::ParseHandleParams::Pdf] Query param: PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5
       #
-      # @param shorten_base64_images [Boolean, Symbol, ContextDev::Models::ParseHandleParams::ShortenBase64Images] Query param: Shorten base64-encoded image data in the Markdown output
+      # @param shorten_base64_images [Boolean] Query param: Shorten base64-encoded image data in the Markdown output
       #
       # @param tags [Array<String>] Query param: Optional comma-separated caller-defined tags for tracking this requ
       #
-      # @param use_main_content_only [Boolean, Symbol, ContextDev::Models::ParseHandleParams::UseMainContentOnly] Query param: Extract only the main content from HTML-like inputs
+      # @param use_main_content_only [Boolean] Query param: Extract only the main content from HTML-like inputs
       #
       # @param zdr [Symbol, ContextDev::Models::ParseHandleParams::Zdr] Query param: Set to enabled to bypass shared caches and omit request and respons
       #

data/lib/context_dev/resources/utility.rb

@@ -6,16 +6,17 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
-      # Signal that you may fetch brand data soon to improve latency. The type field
-      # selects what to prefetch (currently only 'brand') and identifier carries exactly
-      # one lookup key: a domain, or an email whose domain is extracted and validated
-      # (free email providers and disposable email addresses are not allowed).
+      # Signal that you may fetch data soon to improve latency. The type field selects
+      # what to prefetch ('brand' queues a brand data fetch, 'styleguide' queues a
+      # styleguide extraction) and identifier carries exactly one lookup key: a domain,
+      # or an email whose domain is extracted and validated (free email providers and
+      # disposable email addresses are not allowed).
       #
       # @overload prefetch(identifier:, type:, tags: nil, timeout_ms: nil, request_options: {})
       #
-      # @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.
       #