context.dev 2.18.0 → 2.19.0

data/rbi/context_dev/models/web_screenshot_params.rbi

@@ -95,6 +95,19 @@ module ContextDev
       sig { params(handle_cookie_popup: T::Boolean).void }
       attr_writer :handle_cookie_popup
 
+      # Optional outbound HTTP headers, using the same JSON object or deep-object query
+      # format as other scrape endpoints (for example headers[Authorization]=Bearer
+      # token). Headers are scoped to the target origin during capture. For domain/page
+      # requests, discovery receives no custom headers and only pages on the resolved
+      # origin are eligible. Non-empty headers bypass screenshot caching and return an
+      # in-memory data URL; no screenshot is uploaded. Empty objects behave like omitted
+      # headers.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :headers
+
+      sig { params(headers: T::Hash[Symbol, String]).void }
+      attr_writer :headers
+
       # Return a cached screenshot if a prior screenshot for the same parameters exists
       # and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
       # omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
@@ -182,6 +195,7 @@ module ContextDev
           full_screenshot:
             ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
           handle_cookie_popup: T::Boolean,
+          headers: T::Hash[Symbol, String],
           max_age_ms: T.nilable(Integer),
           page: ContextDev::WebScreenshotParams::Page::OrSymbol,
           scroll_offset: T.nilable(Integer),
@@ -222,6 +236,14 @@ module ContextDev
         # dismiss cookie banner before capture. If 'false' or not provided, captures the
         # page without that step.
         handle_cookie_popup: nil,
+        # Optional outbound HTTP headers, using the same JSON object or deep-object query
+        # format as other scrape endpoints (for example headers[Authorization]=Bearer
+        # token). Headers are scoped to the target origin during capture. For domain/page
+        # requests, discovery receives no custom headers and only pages on the resolved
+        # origin are eligible. Non-empty headers bypass screenshot caching and return an
+        # in-memory data URL; no screenshot is uploaded. Empty objects behave like omitted
+        # headers.
+        headers: nil,
         # Return a cached screenshot if a prior screenshot for the same parameters exists
         # and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
         # omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
@@ -276,6 +298,7 @@ module ContextDev
             full_screenshot:
               ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
             handle_cookie_popup: T::Boolean,
+            headers: T::Hash[Symbol, String],
             max_age_ms: T.nilable(Integer),
             page: ContextDev::WebScreenshotParams::Page::OrSymbol,
             scroll_offset: T.nilable(Integer),

data/rbi/context_dev/models/web_screenshot_response.rbi

@@ -89,8 +89,8 @@ module ContextDev
       end
       attr_writer :key_metadata
 
-      # Public image URL for standard requests, or an in-memory data URL when ZDR is
-      # enabled.
+      # Public image URL for standard requests, or an in-memory data URL when ZDR or
+      # non-empty custom headers are supplied.
       sig { returns(T.nilable(String)) }
       attr_reader :screenshot
 
@@ -170,8 +170,8 @@ module ContextDev
         height: nil,
         # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil,
-        # Public image URL for standard requests, or an in-memory data URL when ZDR is
-        # enabled.
+        # Public image URL for standard requests, or an in-memory data URL when ZDR or
+        # non-empty custom headers are supplied.
         screenshot: nil,
         # Type of screenshot that was captured
         screenshot_type: nil,

data/rbi/context_dev/models.rbi

@@ -1,10 +1,6 @@
 # typed: strong
 
 module ContextDev
-  AIExtractProductParams = ContextDev::Models::AIExtractProductParams
-
-  AIExtractProductsParams = ContextDev::Models::AIExtractProductsParams
-
   BatchCancelParams = ContextDev::Models::BatchCancelParams
 
   BatchDeleteParams = ContextDev::Models::BatchDeleteParams
@@ -19,9 +15,6 @@ module ContextDev
 
   BrandRetrieveParams = ContextDev::Models::BrandRetrieveParams
 
-  BrandRetrieveSimplifiedParams =
-    ContextDev::Models::BrandRetrieveSimplifiedParams
-
   BrandSearchParams = ContextDev::Models::BrandSearchParams
 
   CrawlControls = ContextDev::Models::CrawlControls
@@ -62,6 +55,11 @@ module ContextDev
 
   MonitorRetrieveParams = ContextDev::Models::MonitorRetrieveParams
 
+  MonitorRetrieveRunParams = ContextDev::Models::MonitorRetrieveRunParams
+
+  MonitorRotateWebhookSecretParams =
+    ContextDev::Models::MonitorRotateWebhookSecretParams
+
   MonitorRunParams = ContextDev::Models::MonitorRunParams
 
   MonitorUpdateParams = ContextDev::Models::MonitorUpdateParams
@@ -82,32 +80,19 @@ module ContextDev
 
   WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
 
-  WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
-
-  WebExtractParams = ContextDev::Models::WebExtractParams
-
   WebExtractStyleguideParams = ContextDev::Models::WebExtractStyleguideParams
 
   WebhookDelivery = ContextDev::Models::WebhookDelivery
 
   Webhooks = ContextDev::Models::Webhooks
 
+  WebMapURLsParams = ContextDev::Models::WebMapURLsParams
+
+  WebScrapeParams = ContextDev::Models::WebScrapeParams
+
   WebScreenshotParams = ContextDev::Models::WebScreenshotParams
 
   WebSearchParams = ContextDev::Models::WebSearchParams
 
   WebWebCrawlMdParams = ContextDev::Models::WebWebCrawlMdParams
-
-  WebWebScrapeBytesParams = ContextDev::Models::WebWebScrapeBytesParams
-
-  WebWebScrapeHTMLParams = ContextDev::Models::WebWebScrapeHTMLParams
-
-  WebWebScrapeImagesParams = ContextDev::Models::WebWebScrapeImagesParams
-
-  WebWebScrapeMdParams = ContextDev::Models::WebWebScrapeMdParams
-
-  WebWebScrapeScreenshotParams =
-    ContextDev::Models::WebWebScrapeScreenshotParams
-
-  WebWebScrapeSitemapParams = ContextDev::Models::WebWebScrapeSitemapParams
 end

data/rbi/context_dev/resources/brand.rbi

@@ -29,41 +29,6 @@ module ContextDev
       )
       end
 
-      # Returns a simplified version of brand data containing only essential
-      # information: domain, title, colors, logos, and backdrops. Optimized for faster
-      # responses and reduced data transfer.
-      sig do
-        params(
-          domain: String,
-          max_age_ms: T.nilable(Integer),
-          tags: T::Array[String],
-          theme: ContextDev::BrandRetrieveSimplifiedParams::Theme::OrSymbol,
-          timeout_opts:
-            ContextDev::BrandRetrieveSimplifiedParams::TimeoutOpts::OrHash,
-          request_options: ContextDev::RequestOptions::OrHash
-        ).returns(ContextDev::Models::BrandRetrieveSimplifiedResponse)
-      end
-      def retrieve_simplified(
-        # Domain name to retrieve simplified brand data for
-        domain:,
-        # Maximum age in milliseconds for cached brand data before the API performs a hard
-        # refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard
-        # refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms)
-        # are clamped to 1 year.
-        max_age_ms: nil,
-        # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
-        # characters.
-        tags: nil,
-        # Optional theme preference used when selecting brand assets.
-        theme: nil,
-        # Optional request deadline and behavior on timeout. For GET requests, use
-        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
-        # timeoutOpts object.
-        timeout_opts: nil,
-        request_options: {}
-      )
-      end
-
       # Search indexed brands by name or domain
       sig do
         params(

data/rbi/context_dev/resources/monitors.rbi

@@ -311,6 +311,30 @@ module ContextDev
       def retrieve_change(change_id, request_options: {})
       end
 
+      # Fetches one run for a monitor, including lifecycle status, timing, credits
+      # charged, and any detected change.
+      sig do
+        params(
+          run_id: String,
+          monitor_id: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::MonitorRetrieveRunResponse)
+      end
+      def retrieve_run(run_id, monitor_id:, request_options: {})
+      end
+
+      # Generates a new signing secret for the monitor's webhook and returns the updated
+      # monitor (including the new `webhook.secret`). The previous secret stops signing
+      # deliveries immediately, so update your endpoint before rotating.
+      sig do
+        params(
+          monitor_id: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::MonitorRotateWebhookSecretResponse)
+      end
+      def rotate_webhook_secret(monitor_id, request_options: {})
+      end
+
       # Triggers an immediate run of the monitor outside its normal schedule. The run is
       # queued and processed asynchronously.
       sig do