context.dev 1.35.0 → 2.0.0

data/lib/context_dev/resources/monitors.rb

@@ -0,0 +1,352 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Resources
+    # Monitor pages, sitemaps, and extracted website data for exact or semantic
+    # changes. The change.detected webhook payload is documented by the
+    # MonitorsChangeDetectedWebhookPayload schema.
+    class Monitors
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorCreateParams} for more details.
+      #
+      # Creates a monitor. The request body is a union of the supported target/change
+      # detection combinations. The monitor runs immediately after creation to create
+      # its initial baseline.
+      #
+      # @overload create(change_detection:, name:, schedule:, target:, mode: nil, tags: nil, webhook: nil, request_options: {})
+      #
+      # @param change_detection [ContextDev::Models::MonitorCreateParams::ChangeDetection::Exact, ContextDev::Models::MonitorCreateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      #
+      # @param name [String]
+      #
+      # @param schedule [ContextDev::Models::MonitorCreateParams::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
+      #
+      # @param target [ContextDev::Models::MonitorCreateParams::Target::Page, ContextDev::Models::MonitorCreateParams::Target::Sitemap, ContextDev::Models::MonitorCreateParams::Target::Extract] Discriminated union describing what the monitor watches.
+      #
+      # @param mode [Symbol, ContextDev::Models::MonitorCreateParams::Mode] Top-level monitor category. Always `web` today; the concrete behavior is describ
+      #
+      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      #
+      # @param webhook [ContextDev::Models::MonitorCreateParams::Webhook, nil]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorCreateResponse]
+      #
+      # @see ContextDev::Models::MonitorCreateParams
+      def create(params)
+        parsed, options = ContextDev::MonitorCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "monitors",
+          body: parsed,
+          model: ContextDev::Models::MonitorCreateResponse,
+          options: options
+        )
+      end
+
+      # Get a monitor
+      #
+      # @overload retrieve(monitor_id, request_options: {})
+      #
+      # @param monitor_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorRetrieveResponse]
+      #
+      # @see ContextDev::Models::MonitorRetrieveParams
+      def retrieve(monitor_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["monitors/%1$s", monitor_id],
+          model: ContextDev::Models::MonitorRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorUpdateParams} for more details.
+      #
+      # Updates a monitor. If `target` or `change_detection` changes, the monitor
+      # creates a new baseline. Unsupported target/change detection combinations are
+      # rejected.
+      #
+      # @overload update(monitor_id, change_detection: nil, name: nil, schedule: nil, status: nil, tags: nil, target: nil, webhook: nil, request_options: {})
+      #
+      # @param monitor_id [String]
+      #
+      # @param change_detection [ContextDev::Models::MonitorUpdateParams::ChangeDetection::Exact, ContextDev::Models::MonitorUpdateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      #
+      # @param name [String]
+      #
+      # @param schedule [ContextDev::Models::MonitorUpdateParams::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorUpdateParams::Status]
+      #
+      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      #
+      # @param target [ContextDev::Models::MonitorUpdateParams::Target::Page, ContextDev::Models::MonitorUpdateParams::Target::Sitemap, ContextDev::Models::MonitorUpdateParams::Target::Extract] Discriminated union describing what the monitor watches.
+      #
+      # @param webhook [ContextDev::Models::MonitorUpdateParams::Webhook, nil] Set to null to remove the webhook.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorUpdateResponse]
+      #
+      # @see ContextDev::Models::MonitorUpdateParams
+      def update(monitor_id, params = {})
+        parsed, options = ContextDev::MonitorUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["monitors/%1$s", monitor_id],
+          body: parsed,
+          model: ContextDev::Models::MonitorUpdateResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorListParams} for more details.
+      #
+      # Lists monitors for the authenticated organization. Supports free-text search
+      # (`q` over `search_by` fields, `prefix` or `exact` via `search_type`) plus
+      # status/type/tag filters. Results are paginated via the opaque `cursor`.
+      #
+      # @overload list(change_detection_type: nil, cursor: nil, limit: nil, q: nil, search_by: nil, search_type: nil, status: nil, tag: nil, tags: nil, target_type: nil, request_options: {})
+      #
+      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListParams::ChangeDetectionType]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param q [String] Free-text search term, matched against the fields named in `search_by`.
+      #
+      # @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>] Comma-separated fields to search with `q`. Defaults to all of them. Note `query`
+      #
+      # @param search_type [Symbol, ContextDev::Models::MonitorListParams::SearchType] `prefix` for as-you-type prefix matching (default), `exact` for full-token match
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorListParams::Status] Monitor lifecycle status. `failed` means the most recent run failed (see the mon
+      #
+      # @param tag [String] Filter to items that have this tag.
+      #
+      # @param tags [Array<String>] Comma-separated list of tags to filter by (matches monitors having any of them).
+      #
+      # @param target_type [Symbol, ContextDev::Models::MonitorListParams::TargetType]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListResponse]
+      #
+      # @see ContextDev::Models::MonitorListParams
+      def list(params = {})
+        parsed, options = ContextDev::MonitorListParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "monitors",
+          query: query,
+          model: ContextDev::Models::MonitorListResponse,
+          options: options
+        )
+      end
+
+      # Delete a monitor
+      #
+      # @overload delete(monitor_id, request_options: {})
+      #
+      # @param monitor_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorDeleteResponse]
+      #
+      # @see ContextDev::Models::MonitorDeleteParams
+      def delete(monitor_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["monitors/%1$s", monitor_id],
+          model: ContextDev::Models::MonitorDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Returns an account-wide feed of detected changes across monitors.
+      #
+      # @overload list_account_changes(change_detection_type: nil, cursor: nil, limit: nil, monitor_id: nil, since: nil, tag: nil, target_type: nil, until_: nil, request_options: {})
+      #
+      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::ChangeDetectionType]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param monitor_id [String]
+      #
+      # @param since [Time]
+      #
+      # @param tag [String] Filter to items that have this tag.
+      #
+      # @param target_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::TargetType]
+      #
+      # @param until_ [Time]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListAccountChangesResponse]
+      #
+      # @see ContextDev::Models::MonitorListAccountChangesParams
+      def list_account_changes(params = {})
+        parsed, options = ContextDev::MonitorListAccountChangesParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "monitors/changes",
+          query: query.transform_keys(until_: "until"),
+          model: ContextDev::Models::MonitorListAccountChangesResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorListAccountRunsParams} for more details.
+      #
+      # Returns an account-wide feed of monitor runs across all monitors.
+      #
+      # @overload list_account_runs(cursor: nil, limit: nil, status: nil, request_options: {})
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorListAccountRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListAccountRunsResponse]
+      #
+      # @see ContextDev::Models::MonitorListAccountRunsParams
+      def list_account_runs(params = {})
+        parsed, options = ContextDev::MonitorListAccountRunsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "monitors/runs",
+          query: query,
+          model: ContextDev::Models::MonitorListAccountRunsResponse,
+          options: options
+        )
+      end
+
+      # List changes for a monitor
+      #
+      # @overload list_changes(monitor_id, cursor: nil, limit: nil, since: nil, tag: nil, until_: nil, request_options: {})
+      #
+      # @param monitor_id [String]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param since [Time]
+      #
+      # @param tag [String] Filter to items that have this tag.
+      #
+      # @param until_ [Time]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListChangesResponse]
+      #
+      # @see ContextDev::Models::MonitorListChangesParams
+      def list_changes(monitor_id, params = {})
+        parsed, options = ContextDev::MonitorListChangesParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["monitors/%1$s/changes", monitor_id],
+          query: query.transform_keys(until_: "until"),
+          model: ContextDev::Models::MonitorListChangesResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorListRunsParams} for more details.
+      #
+      # List monitor runs
+      #
+      # @overload list_runs(monitor_id, cursor: nil, limit: nil, status: nil, request_options: {})
+      #
+      # @param monitor_id [String]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorListRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListRunsResponse]
+      #
+      # @see ContextDev::Models::MonitorListRunsParams
+      def list_runs(monitor_id, params = {})
+        parsed, options = ContextDev::MonitorListRunsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["monitors/%1$s/runs", monitor_id],
+          query: query,
+          model: ContextDev::Models::MonitorListRunsResponse,
+          options: options
+        )
+      end
+
+      # Get a change
+      #
+      # @overload retrieve_change(change_id, request_options: {})
+      #
+      # @param change_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorRetrieveChangeResponse]
+      #
+      # @see ContextDev::Models::MonitorRetrieveChangeParams
+      def retrieve_change(change_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["monitors/changes/%1$s", change_id],
+          model: ContextDev::Models::MonitorRetrieveChangeResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Triggers an immediate run of the monitor outside its normal schedule. The run is
+      # queued and processed asynchronously.
+      #
+      # @overload run(monitor_id, request_options: {})
+      #
+      # @param monitor_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorRunResponse]
+      #
+      # @see ContextDev::Models::MonitorRunParams
+      def run(monitor_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["monitors/%1$s/run", monitor_id],
+          model: ContextDev::Models::MonitorRunResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [ContextDev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/context_dev/resources/utility.rb

@@ -6,12 +6,16 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
-      # Signal that you may fetch brand data for a particular domain soon to improve
-      # latency.
+      # 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).
       #
-      # @overload prefetch(domain:, timeout_ms: nil, request_options: {})
+      # @overload prefetch(identifier:, type:, timeout_ms: nil, request_options: {})
       #
-      # @param domain [String] Domain name to prefetch brand data for
+      # @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 type [Symbol, ContextDev::Models::UtilityPrefetchParams::Type] What to prefetch. Currently only 'brand' is supported.
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
@@ -24,43 +28,13 @@ module ContextDev
         parsed, options = ContextDev::UtilityPrefetchParams.dump_request(params)
         @client.request(
           method: :post,
-          path: "brand/prefetch",
+          path: "utility/prefetch",
           body: parsed,
           model: ContextDev::Models::UtilityPrefetchResponse,
           options: options
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::UtilityPrefetchByEmailParams} for more details.
-      #
-      # Signal that you may fetch brand data for a particular domain soon to improve
-      # latency. This endpoint accepts an email address, extracts the domain from it,
-      # validates that it's not a disposable or free email provider, and queues the
-      # domain for prefetching.
-      #
-      # @overload prefetch_by_email(email:, timeout_ms: nil, request_options: {})
-      #
-      # @param email [String] Email address to prefetch brand data for. The domain will be extracted from the
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
-      #
-      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ContextDev::Models::UtilityPrefetchByEmailResponse]
-      #
-      # @see ContextDev::Models::UtilityPrefetchByEmailParams
-      def prefetch_by_email(params)
-        parsed, options = ContextDev::UtilityPrefetchByEmailParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "brand/prefetch-by-email",
-          body: parsed,
-          model: ContextDev::Models::UtilityPrefetchByEmailResponse,
-          options: options
-        )
-      end
-
       # @api private
       #
       # @param client [ContextDev::Client]

data/lib/context_dev/resources/web.rb

@@ -127,7 +127,9 @@ module ContextDev
       # Extract a comprehensive design system from a website including colors,
       # typography, spacing, shadows, and UI components.
       #
-      # @overload extract_styleguide(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      # @overload extract_styleguide(color_scheme: nil, direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param color_scheme [Symbol, ContextDev::Models::WebExtractStyleguideParams::ColorScheme] Optional browser color scheme to emulate for websites that respond to prefers-co
       #
       # @param direct_url [String] A specific URL to fetch the styleguide from directly, bypassing domain resolutio
       #
@@ -149,6 +151,7 @@ module ContextDev
           method: :get,
           path: "web/styleguide",
           query: query.transform_keys(
+            color_scheme: "colorScheme",
             direct_url: "directUrl",
             max_age_ms: "maxAgeMs",
             timeout_ms: "timeoutMS"
@@ -163,7 +166,11 @@ module ContextDev
       #
       # Capture a screenshot of a website.
       #
-      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: nil, scroll_offset: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
+      # @overload screenshot(color_scheme: nil, country: nil, direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: nil, scroll_offset: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
+      #
+      # @param color_scheme [Symbol, ContextDev::Models::WebScreenshotParams::ColorScheme] Optional parameter to choose the site's visual theme in the screenshot. Use 'lig
+      #
+      # @param country [Symbol, ContextDev::Models::WebScreenshotParams::Country] Two-letter ISO 3166-1 alpha-2 country code for the website request location. Whe
       #
       # @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
@@ -197,6 +204,7 @@ module ContextDev
           method: :get,
           path: "web/screenshot",
           query: query.transform_keys(
+            color_scheme: "colorScheme",
             direct_url: "directUrl",
             full_screenshot: "fullScreenshot",
             handle_cookie_popup: "handleCookiePopup",
@@ -215,9 +223,11 @@ module ContextDev
       #
       # Search the web and optionally scrape each result to Markdown in one round-trip.
       #
-      # @overload search(query:, exclude_domains: nil, freshness: nil, include_domains: nil, markdown_options: nil, query_fanout: nil, timeout_ms: nil, request_options: {})
+      # @overload search(query:, country: nil, exclude_domains: nil, freshness: nil, include_domains: nil, markdown_options: nil, num_results: nil, query_fanout: nil, timeout_ms: nil, request_options: {})
       #
-      # @param query [String] Natural-language search query.
+      # @param query [String] Search query. Accepts natural language as well as Google-style search operators
+      #
+      # @param country [Symbol, ContextDev::Models::WebSearchParams::Country] Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific cou
       #
       # @param exclude_domains [Array<String>] Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.
       #
@@ -227,6 +237,8 @@ module ContextDev
       #
       # @param markdown_options [ContextDev::Models::WebSearchParams::MarkdownOptions] Inline Markdown scraping for each result. Set `enabled: true` to activate.
       #
+      # @param num_results [Integer] Number of results to request and return (10–100). Defaults to 10.
+      #
       # @param query_fanout [Boolean] Expand the query into multiple parallel variants for broader recall.
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -253,10 +265,12 @@ module ContextDev
       # Performs a crawl starting from a given URL, extracts page content as Markdown,
       # and returns results for all crawled pages.
       #
-      # @overload web_crawl_md(url:, exclude_selectors: nil, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, include_selectors: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, shorten_base64_images: nil, stop_after_ms: nil, timeout_ms: nil, url_regex: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_crawl_md(url:, country: nil, exclude_selectors: nil, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, include_selectors: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, settle_animations: nil, shorten_base64_images: nil, stop_after_ms: nil, timeout_ms: nil, url_regex: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] The starting URL for the crawl (must include http:// or https:// protocol)
       #
+      # @param country [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country] Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev r
+      #
       # @param exclude_selectors [Array<String>] CSS selectors to remove before each crawled page is converted to Markdown. Appli
       #
       # @param follow_subdomains [Boolean] When true, follow links on subdomains of the starting URL's domain (e.g. docs.ex
@@ -277,6 +291,8 @@ module ContextDev
       #
       # @param pdf [ContextDev::Models::WebWebCrawlMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
+      # @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
+      #
       # @param shorten_base64_images [Boolean] Truncate base64-encoded image data in the Markdown output
       #
       # @param stop_after_ms [Integer] Soft time budget for the crawl in milliseconds. After each scrape, the crawler c
@@ -310,10 +326,12 @@ module ContextDev
       #
       # Scrapes the given URL and returns the raw HTML content of the page.
       #
-      # @overload web_scrape_html(url:, exclude_selectors: nil, headers: nil, include_frames: nil, include_selectors: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_html(url:, country: nil, exclude_selectors: nil, headers: nil, include_frames: nil, include_selectors: nil, max_age_ms: nil, pdf: nil, settle_animations: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
+      # @param country [Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Country] Two-letter ISO 3166-1 alpha-2 country code for the website request location. Whe
+      #
       # @param exclude_selectors [Array<String>] CSS selectors to remove from the result. Applied after includeSelectors. Exclusi
       #
       # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
@@ -326,6 +344,8 @@ module ContextDev
       #
       # @param pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
+      # @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
+      #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       # @param use_main_content_only [Boolean] When true, return only the page's main content in the HTML response, excluding h
@@ -348,6 +368,7 @@ module ContextDev
             include_frames: "includeFrames",
             include_selectors: "includeSelectors",
             max_age_ms: "maxAgeMs",
+            settle_animations: "settleAnimations",
             timeout_ms: "timeoutMS",
             use_main_content_only: "useMainContentOnly",
             wait_for_ms: "waitForMs"
@@ -365,10 +386,12 @@ 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, headers: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_images(url:, dedupe: nil, 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 dedupe [Boolean] When true, visually duplicate images are removed: every image is loaded and perc
+      #
       # @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
@@ -405,10 +428,12 @@ module ContextDev
       #
       # Scrapes the given URL into LLM usable Markdown.
       #
-      # @overload web_scrape_md(url:, exclude_selectors: nil, headers: nil, include_frames: nil, include_images: nil, include_links: nil, include_selectors: 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:, 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, 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 country [Symbol, ContextDev::Models::WebWebScrapeMdParams::Country] Two-letter ISO 3166-1 alpha-2 country code for the website request location. Whe
+      #
       # @param exclude_selectors [Array<String>] CSS selectors to remove before conversion to Markdown. Applied after includeSele
       #
       # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
@@ -425,6 +450,8 @@ module ContextDev
       #
       # @param pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
+      # @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before conv
+      #
       # @param shorten_base64_images [Boolean] Shorten base64-encoded image data in the Markdown output
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -451,6 +478,7 @@ module ContextDev
             include_links: "includeLinks",
             include_selectors: "includeSelectors",
             max_age_ms: "maxAgeMs",
+            settle_animations: "settleAnimations",
             shorten_base64_images: "shortenBase64Images",
             timeout_ms: "timeoutMS",
             use_main_content_only: "useMainContentOnly",

data/lib/context_dev/version.rb

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

data/lib/context_dev.rb

@@ -52,22 +52,10 @@ require_relative "context_dev/errors"
 require_relative "context_dev/internal/transport/base_client"
 require_relative "context_dev/internal/transport/pooled_net_requester"
 require_relative "context_dev/client"
-require_relative "context_dev/models/ai_ai_query_params"
-require_relative "context_dev/models/ai_ai_query_response"
 require_relative "context_dev/models/ai_extract_product_params"
 require_relative "context_dev/models/ai_extract_product_response"
 require_relative "context_dev/models/ai_extract_products_params"
 require_relative "context_dev/models/ai_extract_products_response"
-require_relative "context_dev/models/brand_identify_from_transaction_params"
-require_relative "context_dev/models/brand_identify_from_transaction_response"
-require_relative "context_dev/models/brand_retrieve_by_email_params"
-require_relative "context_dev/models/brand_retrieve_by_email_response"
-require_relative "context_dev/models/brand_retrieve_by_isin_params"
-require_relative "context_dev/models/brand_retrieve_by_isin_response"
-require_relative "context_dev/models/brand_retrieve_by_name_params"
-require_relative "context_dev/models/brand_retrieve_by_name_response"
-require_relative "context_dev/models/brand_retrieve_by_ticker_params"
-require_relative "context_dev/models/brand_retrieve_by_ticker_response"
 require_relative "context_dev/models/brand_retrieve_params"
 require_relative "context_dev/models/brand_retrieve_response"
 require_relative "context_dev/models/brand_retrieve_simplified_params"
@@ -76,8 +64,28 @@ require_relative "context_dev/models/industry_retrieve_naics_params"
 require_relative "context_dev/models/industry_retrieve_naics_response"
 require_relative "context_dev/models/industry_retrieve_sic_params"
 require_relative "context_dev/models/industry_retrieve_sic_response"
-require_relative "context_dev/models/utility_prefetch_by_email_params"
-require_relative "context_dev/models/utility_prefetch_by_email_response"
+require_relative "context_dev/models/monitor_create_params"
+require_relative "context_dev/models/monitor_create_response"
+require_relative "context_dev/models/monitor_delete_params"
+require_relative "context_dev/models/monitor_delete_response"
+require_relative "context_dev/models/monitor_list_account_changes_params"
+require_relative "context_dev/models/monitor_list_account_changes_response"
+require_relative "context_dev/models/monitor_list_account_runs_params"
+require_relative "context_dev/models/monitor_list_account_runs_response"
+require_relative "context_dev/models/monitor_list_changes_params"
+require_relative "context_dev/models/monitor_list_changes_response"
+require_relative "context_dev/models/monitor_list_params"
+require_relative "context_dev/models/monitor_list_response"
+require_relative "context_dev/models/monitor_list_runs_params"
+require_relative "context_dev/models/monitor_list_runs_response"
+require_relative "context_dev/models/monitor_retrieve_change_params"
+require_relative "context_dev/models/monitor_retrieve_change_response"
+require_relative "context_dev/models/monitor_retrieve_params"
+require_relative "context_dev/models/monitor_retrieve_response"
+require_relative "context_dev/models/monitor_run_params"
+require_relative "context_dev/models/monitor_run_response"
+require_relative "context_dev/models/monitor_update_params"
+require_relative "context_dev/models/monitor_update_response"
 require_relative "context_dev/models/utility_prefetch_params"
 require_relative "context_dev/models/utility_prefetch_response"
 require_relative "context_dev/models/web_extract_competitors_params"
@@ -106,5 +114,6 @@ require_relative "context_dev/models"
 require_relative "context_dev/resources/ai"
 require_relative "context_dev/resources/brand"
 require_relative "context_dev/resources/industry"
+require_relative "context_dev/resources/monitors"
 require_relative "context_dev/resources/utility"
 require_relative "context_dev/resources/web"

data/rbi/context_dev/client.rbi

@@ -28,6 +28,12 @@ module ContextDev
     sig { returns(ContextDev::Resources::Utility) }
     attr_reader :utility
 
+    # Monitor pages, sitemaps, and extracted website data for exact or semantic
+    # changes. The change.detected webhook payload is documented by the
+    # MonitorsChangeDetectedWebhookPayload schema.
+    sig { returns(ContextDev::Resources::Monitors) }
+    attr_reader :monitors
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers