context.dev 1.15.0 → 1.17.0

data/rbi/context_dev/resources/web.rbi

@@ -65,8 +65,11 @@ module ContextDev
           domain: String,
           full_screenshot:
             ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
+          max_age_ms: Integer,
           page: ContextDev::WebScreenshotParams::Page::OrSymbol,
-          prioritize: ContextDev::WebScreenshotParams::Prioritize::OrSymbol,
+          timeout_ms: Integer,
+          viewport: ContextDev::WebScreenshotParams::Viewport::OrHash,
+          wait_for_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebScreenshotResponse)
       end
@@ -83,16 +86,26 @@ module ContextDev
         # screenshot capturing all content. If 'false' or not provided, takes a viewport
         # screenshot (standard browser view).
         full_screenshot: 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.
+        max_age_ms: nil,
         # 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
         # provided, screenshots the main domain landing page. Only applicable when using
         # 'domain', not 'directUrl'.
         page: nil,
-        # Optional parameter to prioritize screenshot capture. If 'speed', optimizes for
-        # faster capture with basic quality. If 'quality', optimizes for higher quality
-        # with longer wait times. Defaults to 'quality' if not provided.
-        prioritize: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+        viewport: nil,
+        # Optional browser wait time in milliseconds after initial page load before taking
+        # the screenshot. Min: 0. Max: 30000 (30 seconds). Defaults to 3000 ms when
+        # omitted.
+        wait_for_ms: nil,
         request_options: {}
       )
       end
@@ -111,8 +124,10 @@ module ContextDev
           max_pages: Integer,
           parse_pdf: T::Boolean,
           shorten_base64_images: T::Boolean,
+          timeout_ms: Integer,
           url_regex: String,
           use_main_content_only: T::Boolean,
+          wait_for_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebCrawlMdResponse)
       end
@@ -144,11 +159,18 @@ module ContextDev
         parse_pdf: nil,
         # Truncate base64-encoded image data in the Markdown output
         shorten_base64_images: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
         # Regex pattern. Only URLs matching this pattern will be followed and scraped.
         url_regex: nil,
         # Extract only the main content, stripping headers, footers, sidebars, and
         # navigation
         use_main_content_only: nil,
+        # Optional browser wait time in milliseconds after initial page load for each
+        # crawled page. Min: 0. Max: 30000 (30 seconds).
+        wait_for_ms: nil,
         request_options: {}
       )
       end
@@ -160,6 +182,8 @@ module ContextDev
           include_frames: T::Boolean,
           max_age_ms: Integer,
           parse_pdf: T::Boolean,
+          timeout_ms: Integer,
+          wait_for_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebScrapeHTMLResponse)
       end
@@ -176,6 +200,13 @@ module ContextDev
         # returned wrapped in <html><pdf>…</pdf></html>. When false, PDF URLs are skipped
         # and a 400 WEBSITE_ACCESS_ERROR is returned.
         parse_pdf: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        # Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
+        # 30000 (30 seconds).
+        wait_for_ms: nil,
         request_options: {}
       )
       end
@@ -189,6 +220,8 @@ module ContextDev
           url: String,
           enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment::OrHash,
           max_age_ms: Integer,
+          timeout_ms: Integer,
+          wait_for_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebScrapeImagesResponse)
       end
@@ -201,6 +234,13 @@ module ContextDev
         # Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
         # day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
         max_age_ms: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        # Optional browser wait time in milliseconds after initial page load before
+        # collecting images. Min: 0. Max: 30000 (30 seconds).
+        wait_for_ms: nil,
         request_options: {}
       )
       end
@@ -215,7 +255,9 @@ module ContextDev
           max_age_ms: Integer,
           parse_pdf: T::Boolean,
           shorten_base64_images: T::Boolean,
+          timeout_ms: Integer,
           use_main_content_only: T::Boolean,
+          wait_for_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebScrapeMdResponse)
       end
@@ -239,9 +281,16 @@ module ContextDev
         parse_pdf: nil,
         # Shorten base64-encoded image data in the Markdown output
         shorten_base64_images: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
         # Extract only the main content of the page, excluding headers, footers, sidebars,
         # and navigation
         use_main_content_only: nil,
+        # Optional browser wait time in milliseconds after initial page load before
+        # converting the page to Markdown. Min: 0. Max: 30000 (30 seconds).
+        wait_for_ms: nil,
         request_options: {}
       )
       end
@@ -251,6 +300,7 @@ module ContextDev
         params(
           domain: String,
           max_links: Integer,
+          timeout_ms: Integer,
           url_regex: String,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebScrapeSitemapResponse)
@@ -261,6 +311,10 @@ module ContextDev
         # Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
         # Minimum is 1, maximum is 100,000.
         max_links: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
         # Optional RE2-compatible regex pattern. Only URLs matching this pattern are
         # returned and counted against maxLinks.
         url_regex: nil,

data/sig/context_dev/models/web_screenshot_params.rbs

@@ -5,8 +5,11 @@ module ContextDev
         direct_url: String,
         domain: String,
         full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        max_age_ms: Integer,
         page: ContextDev::Models::WebScreenshotParams::page,
-        prioritize: ContextDev::Models::WebScreenshotParams::prioritize
+        timeout_ms: Integer,
+        viewport: ContextDev::WebScreenshotParams::Viewport,
+        wait_for_ms: Integer
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -28,24 +31,39 @@ module ContextDev
         ContextDev::Models::WebScreenshotParams::full_screenshot
       ) -> ContextDev::Models::WebScreenshotParams::full_screenshot
 
+      attr_reader max_age_ms: Integer?
+
+      def max_age_ms=: (Integer) -> Integer
+
       attr_reader page: ContextDev::Models::WebScreenshotParams::page?
 
       def page=: (
         ContextDev::Models::WebScreenshotParams::page
       ) -> ContextDev::Models::WebScreenshotParams::page
 
-      attr_reader prioritize: ContextDev::Models::WebScreenshotParams::prioritize?
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      attr_reader viewport: ContextDev::WebScreenshotParams::Viewport?
+
+      def viewport=: (
+        ContextDev::WebScreenshotParams::Viewport
+      ) -> ContextDev::WebScreenshotParams::Viewport
 
-      def prioritize=: (
-        ContextDev::Models::WebScreenshotParams::prioritize
-      ) -> ContextDev::Models::WebScreenshotParams::prioritize
+      attr_reader wait_for_ms: Integer?
+
+      def wait_for_ms=: (Integer) -> Integer
 
       def initialize: (
         ?direct_url: String,
         ?domain: String,
         ?full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        ?max_age_ms: Integer,
         ?page: ContextDev::Models::WebScreenshotParams::page,
-        ?prioritize: ContextDev::Models::WebScreenshotParams::prioritize,
+        ?timeout_ms: Integer,
+        ?viewport: ContextDev::WebScreenshotParams::Viewport,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -53,8 +71,11 @@ module ContextDev
         direct_url: String,
         domain: String,
         full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        max_age_ms: Integer,
         page: ContextDev::Models::WebScreenshotParams::page,
-        prioritize: ContextDev::Models::WebScreenshotParams::prioritize,
+        timeout_ms: Integer,
+        viewport: ContextDev::WebScreenshotParams::Viewport,
+        wait_for_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
 
@@ -94,15 +115,20 @@ module ContextDev
         def self?.values: -> ::Array[ContextDev::Models::WebScreenshotParams::page]
       end
 
-      type prioritize = :speed | :quality
+      type viewport = { height: Integer, width: Integer }
 
-      module Prioritize
-        extend ContextDev::Internal::Type::Enum
+      class Viewport < ContextDev::Internal::Type::BaseModel
+        attr_reader height: Integer?
+
+        def height=: (Integer) -> Integer
+
+        attr_reader width: Integer?
+
+        def width=: (Integer) -> Integer
 
-        SPEED: :speed
-        QUALITY: :quality
+        def initialize: (?height: Integer, ?width: Integer) -> void
 
-        def self?.values: -> ::Array[ContextDev::Models::WebScreenshotParams::prioritize]
+        def to_hash: -> { height: Integer, width: Integer }
       end
     end
   end

data/sig/context_dev/models/web_screenshot_response.rbs

@@ -4,9 +4,11 @@ module ContextDev
       {
         code: Integer,
         domain: String,
+        height: Integer,
         screenshot: String,
         screenshot_type: ContextDev::Models::WebScreenshotResponse::screenshot_type,
-        status: String
+        status: String,
+        width: Integer
       }
 
     class WebScreenshotResponse < ContextDev::Internal::Type::BaseModel
@@ -18,6 +20,10 @@ module ContextDev
 
       def domain=: (String) -> String
 
+      attr_reader height: Integer?
+
+      def height=: (Integer) -> Integer
+
       attr_reader screenshot: String?
 
       def screenshot=: (String) -> String
@@ -32,20 +38,28 @@ module ContextDev
 
       def status=: (String) -> String
 
+      attr_reader width: Integer?
+
+      def width=: (Integer) -> Integer
+
       def initialize: (
         ?code: Integer,
         ?domain: String,
+        ?height: Integer,
         ?screenshot: String,
         ?screenshot_type: ContextDev::Models::WebScreenshotResponse::screenshot_type,
-        ?status: String
+        ?status: String,
+        ?width: Integer
       ) -> void
 
       def to_hash: -> {
         code: Integer,
         domain: String,
+        height: Integer,
         screenshot: String,
         screenshot_type: ContextDev::Models::WebScreenshotResponse::screenshot_type,
-        status: String
+        status: String,
+        width: Integer
       }
 
       type screenshot_type = :viewport | :fullPage

data/sig/context_dev/models/web_web_crawl_md_params.rbs

@@ -12,8 +12,10 @@ module ContextDev
         max_pages: Integer,
         parse_pdf: bool,
         :shorten_base64_images => bool,
+        timeout_ms: Integer,
         url_regex: String,
-        use_main_content_only: bool
+        use_main_content_only: bool,
+        wait_for_ms: Integer
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -59,6 +61,10 @@ module ContextDev
 
       def shorten_base64_images=: (bool) -> bool
 
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
       attr_reader url_regex: String?
 
       def url_regex=: (String) -> String
@@ -67,6 +73,10 @@ module ContextDev
 
       def use_main_content_only=: (bool) -> bool
 
+      attr_reader wait_for_ms: Integer?
+
+      def wait_for_ms=: (Integer) -> Integer
+
       def initialize: (
         url: String,
         ?follow_subdomains: bool,
@@ -78,8 +88,10 @@ module ContextDev
         ?max_pages: Integer,
         ?parse_pdf: bool,
         ?shorten_base64_images: bool,
+        ?timeout_ms: Integer,
         ?url_regex: String,
         ?use_main_content_only: bool,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -94,8 +106,10 @@ module ContextDev
         max_pages: Integer,
         parse_pdf: bool,
         :shorten_base64_images => bool,
+        timeout_ms: Integer,
         url_regex: String,
         use_main_content_only: bool,
+        wait_for_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
     end

data/sig/context_dev/models/web_web_scrape_html_params.rbs

@@ -5,7 +5,9 @@ module ContextDev
         url: String,
         include_frames: bool,
         max_age_ms: Integer,
-        parse_pdf: bool
+        parse_pdf: bool,
+        timeout_ms: Integer,
+        wait_for_ms: Integer
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -27,11 +29,21 @@ module ContextDev
 
       def parse_pdf=: (bool) -> bool
 
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      attr_reader wait_for_ms: Integer?
+
+      def wait_for_ms=: (Integer) -> Integer
+
       def initialize: (
         url: String,
         ?include_frames: bool,
         ?max_age_ms: Integer,
         ?parse_pdf: bool,
+        ?timeout_ms: Integer,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -40,6 +52,8 @@ module ContextDev
         include_frames: bool,
         max_age_ms: Integer,
         parse_pdf: bool,
+        timeout_ms: Integer,
+        wait_for_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
     end

data/sig/context_dev/models/web_web_scrape_images_params.rbs

@@ -4,7 +4,9 @@ module ContextDev
       {
         url: String,
         enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
-        max_age_ms: Integer
+        max_age_ms: Integer,
+        timeout_ms: Integer,
+        wait_for_ms: Integer
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -24,10 +26,20 @@ module ContextDev
 
       def max_age_ms=: (Integer) -> Integer
 
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      attr_reader wait_for_ms: Integer?
+
+      def wait_for_ms=: (Integer) -> Integer
+
       def initialize: (
         url: String,
         ?enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
         ?max_age_ms: Integer,
+        ?timeout_ms: Integer,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -35,6 +47,8 @@ module ContextDev
         url: String,
         enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
         max_age_ms: Integer,
+        timeout_ms: Integer,
+        wait_for_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
 

data/sig/context_dev/models/web_web_scrape_md_params.rbs

@@ -9,7 +9,9 @@ module ContextDev
         max_age_ms: Integer,
         parse_pdf: bool,
         :shorten_base64_images => bool,
-        use_main_content_only: bool
+        timeout_ms: Integer,
+        use_main_content_only: bool,
+        wait_for_ms: Integer
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -43,10 +45,18 @@ module ContextDev
 
       def shorten_base64_images=: (bool) -> bool
 
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
       attr_reader use_main_content_only: bool?
 
       def use_main_content_only=: (bool) -> bool
 
+      attr_reader wait_for_ms: Integer?
+
+      def wait_for_ms=: (Integer) -> Integer
+
       def initialize: (
         url: String,
         ?include_frames: bool,
@@ -55,7 +65,9 @@ module ContextDev
         ?max_age_ms: Integer,
         ?parse_pdf: bool,
         ?shorten_base64_images: bool,
+        ?timeout_ms: Integer,
         ?use_main_content_only: bool,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -67,7 +79,9 @@ module ContextDev
         max_age_ms: Integer,
         parse_pdf: bool,
         :shorten_base64_images => bool,
+        timeout_ms: Integer,
         use_main_content_only: bool,
+        wait_for_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
     end

data/sig/context_dev/models/web_web_scrape_sitemap_params.rbs

@@ -1,7 +1,12 @@
 module ContextDev
   module Models
     type web_web_scrape_sitemap_params =
-      { domain: String, max_links: Integer, url_regex: String }
+      {
+        domain: String,
+        max_links: Integer,
+        timeout_ms: Integer,
+        url_regex: String
+      }
       & ContextDev::Internal::Type::request_parameters
 
     class WebWebScrapeSitemapParams < ContextDev::Internal::Type::BaseModel
@@ -14,6 +19,10 @@ module ContextDev
 
       def max_links=: (Integer) -> Integer
 
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
       attr_reader url_regex: String?
 
       def url_regex=: (String) -> String
@@ -21,6 +30,7 @@ module ContextDev
       def initialize: (
         domain: String,
         ?max_links: Integer,
+        ?timeout_ms: Integer,
         ?url_regex: String,
         ?request_options: ContextDev::request_opts
       ) -> void
@@ -28,6 +38,7 @@ module ContextDev
       def to_hash: -> {
         domain: String,
         max_links: Integer,
+        timeout_ms: Integer,
         url_regex: String,
         request_options: ContextDev::RequestOptions
       }

data/sig/context_dev/resources/web.rbs

@@ -19,8 +19,11 @@ module ContextDev
         ?direct_url: String,
         ?domain: String,
         ?full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        ?max_age_ms: Integer,
         ?page: ContextDev::Models::WebScreenshotParams::page,
-        ?prioritize: ContextDev::Models::WebScreenshotParams::prioritize,
+        ?timeout_ms: Integer,
+        ?viewport: ContextDev::WebScreenshotParams::Viewport,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebScreenshotResponse
 
@@ -35,8 +38,10 @@ module ContextDev
         ?max_pages: Integer,
         ?parse_pdf: bool,
         ?shorten_base64_images: bool,
+        ?timeout_ms: Integer,
         ?url_regex: String,
         ?use_main_content_only: bool,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebWebCrawlMdResponse
 
@@ -45,6 +50,8 @@ module ContextDev
         ?include_frames: bool,
         ?max_age_ms: Integer,
         ?parse_pdf: bool,
+        ?timeout_ms: Integer,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebWebScrapeHTMLResponse
 
@@ -52,6 +59,8 @@ module ContextDev
         url: String,
         ?enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
         ?max_age_ms: Integer,
+        ?timeout_ms: Integer,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebWebScrapeImagesResponse
 
@@ -63,13 +72,16 @@ module ContextDev
         ?max_age_ms: Integer,
         ?parse_pdf: bool,
         ?shorten_base64_images: bool,
+        ?timeout_ms: Integer,
         ?use_main_content_only: bool,
+        ?wait_for_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebWebScrapeMdResponse
 
       def web_scrape_sitemap: (
         domain: String,
         ?max_links: Integer,
+        ?timeout_ms: Integer,
         ?url_regex: String,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebWebScrapeSitemapResponse

metadata

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