context.dev 1.15.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84cc2c8157b82ddbf49757ced0e0f6bbc55fb1cf67ffe3db1725bdbf7db89c46
-  data.tar.gz: a1783d6a9fb36f14a61d4c201066e25986249ca36d64f4bfa06e3acfb400ab33
+  metadata.gz: e47becb29d02dd213aee4b6b49429685c9d74c35f37d49c026b8bbabc87be191
+  data.tar.gz: 2e76f0c796bf46d9ec0a1f764de47841eabf2cb290c71b279a9740b574393d98
 SHA512:
-  metadata.gz: c76dc1a666b1765f26e679707344ef82ffc004850e0fa8d1fa9565571a0784a2cfb408c110c3463f4dcd75a2df86d7036178694cd17c39e1d0c93f41a6db2cfa
-  data.tar.gz: 7babec26bd5a654a9c10e2da55ebf39835c2078c8e06ce0f54fd3d1022adb6f65008b7a007594d8ba8547292dc75597bf184a1d499b175936a6f50df1245db0a
+  metadata.gz: 859d0da8ad2c2e9fd7d0bdb4b783b9e8c75f4323d3a599b42d28ad495342ff1187f6a502449b1a325090f3ccab3f76c1d855e25c5aaaee1e7e98d690e9ac44e4
+  data.tar.gz: 5b30272a7da7dbfeb75475e067f86bb404313ee842aa86b973817ccf359dc07c53fe06890b2e2dc34b689da07ec3b12a2b77a1f871eeaa0c549196f1afbc873d

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.17.0 (2026-05-09)
+
+Full Changelog: [v1.16.0...v1.17.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.16.0...v1.17.0)
+
+### Features
+
+* **api:** api update ([ae638b0](https://github.com/context-dot-dev/context-ruby-sdk/commit/ae638b04d0e08bf93e2cdd1211236d841d5313b1))
+* **api:** api update ([8376344](https://github.com/context-dot-dev/context-ruby-sdk/commit/8376344a7a72a7ff01906bc3d6a5913a4de60bcb))
+
+## 1.16.0 (2026-05-07)
+
+Full Changelog: [v1.15.0...v1.16.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.15.0...v1.16.0)
+
+### Features
+
+* **api:** api update ([f0b1f3a](https://github.com/context-dot-dev/context-ruby-sdk/commit/f0b1f3afd885c44cb464393b57d944fa27a6c0b5))
+
 ## 1.15.0 (2026-05-06)
 
 Full Changelog: [v1.14.0...v1.15.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.14.0...v1.15.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.15.0"
+gem "context.dev", "~> 1.17.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/ai_extract_product_params.rb

@@ -22,8 +22,9 @@ module ContextDev
       optional :max_age_ms, Integer, api_name: :maxAgeMs
 
       # @!attribute timeout_ms
-      #   Optional timeout in milliseconds for the request. Maximum allowed value is
-      #   300000ms (5 minutes).
+      #   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).
       #
       #   @return [Integer, nil]
       optional :timeout_ms, Integer, api_name: :timeoutMS
@@ -36,7 +37,7 @@ module ContextDev
       #
       #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
       #
-      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+      #   @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}]
     end

data/lib/context_dev/models/ai_extract_products_params.rb

@@ -45,8 +45,9 @@ module ContextDev
           optional :max_products, Integer, api_name: :maxProducts
 
           # @!attribute timeout_ms
-          #   Optional timeout in milliseconds for the request. Maximum allowed value is
-          #   300000ms (5 minutes).
+          #   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).
           #
           #   @return [Integer, nil]
           optional :timeout_ms, Integer, api_name: :timeoutMS
@@ -61,7 +62,7 @@ module ContextDev
           #
           #   @param max_products [Integer] Maximum number of products to extract.
           #
-          #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+          #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
         end
 
         class ByDirectURL < ContextDev::Internal::Type::BaseModel
@@ -87,8 +88,9 @@ module ContextDev
           optional :max_products, Integer, api_name: :maxProducts
 
           # @!attribute timeout_ms
-          #   Optional timeout in milliseconds for the request. Maximum allowed value is
-          #   300000ms (5 minutes).
+          #   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).
           #
           #   @return [Integer, nil]
           optional :timeout_ms, Integer, api_name: :timeoutMS
@@ -104,7 +106,7 @@ module ContextDev
           #
           #   @param max_products [Integer] Maximum number of products to extract.
           #
-          #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+          #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
         end
 
         # @!method self.variants

data/lib/context_dev/models/web_screenshot_params.rb

@@ -31,6 +31,14 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot, nil]
       optional :full_screenshot, enum: -> { ContextDev::WebScreenshotParams::FullScreenshot }
 
+      # @!attribute max_age_ms
+      #   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.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute page
       #   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
@@ -41,15 +49,29 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Page, nil]
       optional :page, enum: -> { ContextDev::WebScreenshotParams::Page }
 
-      # @!attribute prioritize
-      #   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.
+      # @!attribute timeout_ms
+      #   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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
+      # @!attribute viewport
+      #   Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
       #
-      #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize, nil]
-      optional :prioritize, enum: -> { ContextDev::WebScreenshotParams::Prioritize }
+      #   @return [ContextDev::Models::WebScreenshotParams::Viewport, nil]
+      optional :viewport, -> { ContextDev::WebScreenshotParams::Viewport }
 
-      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
+      # @!attribute wait_for_ms
+      #   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.
+      #
+      #   @return [Integer, nil]
+      optional :wait_for_ms, Integer
+
+      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotParams} for more details.
       #
@@ -59,9 +81,15 @@ module ContextDev
       #
       #   @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      #   @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
+      #
       #   @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
       #
-      #   @param prioritize [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize] Optional parameter to prioritize screenshot capture. If 'speed', optimizes for f
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
+      #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load before taking
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
@@ -99,17 +127,25 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
-      # 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.
-      module Prioritize
-        extend ContextDev::Internal::Type::Enum
-
-        SPEED = :speed
-        QUALITY = :quality
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
+      class Viewport < ContextDev::Internal::Type::BaseModel
+        # @!attribute height
+        #   Viewport height in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :height, Integer
+
+        # @!attribute width
+        #   Viewport width in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :width, Integer
+
+        # @!method initialize(height: nil, width: nil)
+        #   Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+        #
+        #   @param height [Integer] Viewport height in pixels.
+        #
+        #   @param width [Integer] Viewport width in pixels.
       end
     end
   end

data/lib/context_dev/models/web_screenshot_response.rb

@@ -16,6 +16,12 @@ module ContextDev
       #   @return [String, nil]
       optional :domain, String
 
+      # @!attribute height
+      #   Height in pixels of the returned screenshot image
+      #
+      #   @return [Integer, nil]
+      optional :height, Integer
+
       # @!attribute screenshot
       #   Public URL of the uploaded screenshot image
       #
@@ -36,16 +42,26 @@ module ContextDev
       #   @return [String, nil]
       optional :status, String
 
-      # @!method initialize(code: nil, domain: nil, screenshot: nil, screenshot_type: nil, status: nil)
+      # @!attribute width
+      #   Width in pixels of the returned screenshot image
+      #
+      #   @return [Integer, nil]
+      optional :width, Integer
+
+      # @!method initialize(code: nil, domain: nil, height: nil, screenshot: nil, screenshot_type: nil, status: nil, width: nil)
       #   @param code [Integer] HTTP status code
       #
       #   @param domain [String] The normalized domain that was processed
       #
+      #   @param height [Integer] Height in pixels of the returned screenshot image
+      #
       #   @param screenshot [String] Public URL of the uploaded screenshot image
       #
       #   @param screenshot_type [Symbol, ContextDev::Models::WebScreenshotResponse::ScreenshotType] Type of screenshot that was captured
       #
       #   @param status [String] Status of the response, e.g., 'ok'
+      #
+      #   @param width [Integer] Width in pixels of the returned screenshot image
 
       # Type of screenshot that was captured
       #

data/lib/context_dev/models/web_web_crawl_md_params.rb

@@ -74,6 +74,14 @@ module ContextDev
       #   @return [Boolean, nil]
       optional :shorten_base64_images, ContextDev::Internal::Type::Boolean, api_name: :shortenBase64Images
 
+      # @!attribute timeout_ms
+      #   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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer, api_name: :timeoutMS
+
       # @!attribute url_regex
       #   Regex pattern. Only URLs matching this pattern will be followed and scraped.
       #
@@ -87,7 +95,14 @@ module ContextDev
       #   @return [Boolean, nil]
       optional :use_main_content_only, ContextDev::Internal::Type::Boolean, api_name: :useMainContentOnly
 
-      # @!method initialize(url:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, parse_pdf: nil, shorten_base64_images: nil, url_regex: nil, use_main_content_only: nil, request_options: {})
+      # @!attribute wait_for_ms
+      #   Optional browser wait time in milliseconds after initial page load for each
+      #   crawled page. Min: 0. Max: 30000 (30 seconds).
+      #
+      #   @return [Integer, nil]
+      optional :wait_for_ms, Integer, api_name: :waitForMs
+
+      # @!method initialize(url:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, parse_pdf: nil, shorten_base64_images: nil, timeout_ms: nil, url_regex: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebCrawlMdParams} for more details.
       #
@@ -111,10 +126,14 @@ module ContextDev
       #
       #   @param shorten_base64_images [Boolean] Truncate 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
+      #
       #   @param url_regex [String] Regex pattern. Only URLs matching this pattern will be followed and scraped.
       #
       #   @param use_main_content_only [Boolean] Extract only the main content, stripping headers, footers, sidebars, and navigat
       #
+      #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load for each craw
+      #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -35,7 +35,22 @@ module ContextDev
       #   @return [Boolean, nil]
       optional :parse_pdf, ContextDev::Internal::Type::Boolean
 
-      # @!method initialize(url:, include_frames: nil, max_age_ms: nil, parse_pdf: nil, request_options: {})
+      # @!attribute timeout_ms
+      #   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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
+      # @!attribute wait_for_ms
+      #   Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
+      #   30000 (30 seconds).
+      #
+      #   @return [Integer, nil]
+      optional :wait_for_ms, Integer
+
+      # @!method initialize(url:, include_frames: nil, max_age_ms: nil, parse_pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeHTMLParams} for more details.
       #
@@ -47,6 +62,10 @@ module ContextDev
       #
       #   @param parse_pdf [Boolean] When true (default), PDF URLs are fetched and their text layer is extracted and
       #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
+      #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/context_dev/models/web_web_scrape_images_params.rb

@@ -27,7 +27,22 @@ module ContextDev
       #   @return [Integer, nil]
       optional :max_age_ms, Integer
 
-      # @!method initialize(url:, enrichment: nil, max_age_ms: nil, request_options: {})
+      # @!attribute timeout_ms
+      #   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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
+      # @!attribute wait_for_ms
+      #   Optional browser wait time in milliseconds after initial page load before
+      #   collecting images. Min: 0. Max: 30000 (30 seconds).
+      #
+      #   @return [Integer, nil]
+      optional :wait_for_ms, Integer
+
+      # @!method initialize(url:, enrichment: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeImagesParams} for more details.
       #
@@ -37,6 +52,10 @@ module ContextDev
       #
       #   @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load before collec
+      #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
       class Enrichment < ContextDev::Internal::Type::BaseModel

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -54,6 +54,14 @@ module ContextDev
       #   @return [Boolean, nil]
       optional :shorten_base64_images, ContextDev::Internal::Type::Boolean
 
+      # @!attribute timeout_ms
+      #   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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
       # @!attribute use_main_content_only
       #   Extract only the main content of the page, excluding headers, footers, sidebars,
       #   and navigation
@@ -61,7 +69,14 @@ module ContextDev
       #   @return [Boolean, nil]
       optional :use_main_content_only, ContextDev::Internal::Type::Boolean
 
-      # @!method initialize(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, parse_pdf: nil, shorten_base64_images: nil, use_main_content_only: nil, request_options: {})
+      # @!attribute wait_for_ms
+      #   Optional browser wait time in milliseconds after initial page load before
+      #   converting the page to Markdown. Min: 0. Max: 30000 (30 seconds).
+      #
+      #   @return [Integer, nil]
+      optional :wait_for_ms, Integer
+
+      # @!method initialize(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, parse_pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdParams} for more details.
       #
@@ -79,8 +94,12 @@ module ContextDev
       #
       #   @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
+      #
       #   @param use_main_content_only [Boolean] Extract only the main content of the page, excluding headers, footers, sidebars,
       #
+      #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load before conver
+      #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/context_dev/models/web_web_scrape_sitemap_params.rb

@@ -20,6 +20,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :max_links, Integer
 
+      # @!attribute timeout_ms
+      #   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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
       # @!attribute url_regex
       #   Optional RE2-compatible regex pattern. Only URLs matching this pattern are
       #   returned and counted against maxLinks.
@@ -27,7 +35,7 @@ module ContextDev
       #   @return [String, nil]
       optional :url_regex, String
 
-      # @!method initialize(domain:, max_links: nil, url_regex: nil, request_options: {})
+      # @!method initialize(domain:, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeSitemapParams} for more details.
       #
@@ -35,6 +43,8 @@ module ContextDev
       #
       #   @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
       #   @param url_regex [String] Optional RE2-compatible regex pattern. Only URLs matching this pattern are retur
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]

data/lib/context_dev/resources/ai.rb

@@ -48,7 +48,7 @@ module ContextDev
       #
       # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
       #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+      # @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]
       #

data/lib/context_dev/resources/web.rb

@@ -70,7 +70,7 @@ module ContextDev
       #
       # Capture a screenshot of a website.
       #
-      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
+      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
       #
       # @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
@@ -78,9 +78,15 @@ module ContextDev
       #
       # @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      # @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
+      #
       # @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
       #
-      # @param prioritize [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize] Optional parameter to prioritize screenshot capture. If 'speed', optimizes for f
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
+      # @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load before taking
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -93,7 +99,13 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/screenshot",
-          query: query.transform_keys(direct_url: "directUrl", full_screenshot: "fullScreenshot"),
+          query: query.transform_keys(
+            direct_url: "directUrl",
+            full_screenshot: "fullScreenshot",
+            max_age_ms: "maxAgeMs",
+            timeout_ms: "timeoutMS",
+            wait_for_ms: "waitForMs"
+          ),
           model: ContextDev::Models::WebScreenshotResponse,
           options: options
         )
@@ -105,7 +117,7 @@ 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:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, parse_pdf: nil, shorten_base64_images: nil, url_regex: nil, use_main_content_only: nil, request_options: {})
+      # @overload web_crawl_md(url:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, parse_pdf: nil, shorten_base64_images: 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)
       #
@@ -127,10 +139,14 @@ module ContextDev
       #
       # @param shorten_base64_images [Boolean] Truncate 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
+      #
       # @param url_regex [String] Regex pattern. Only URLs matching this pattern will be followed and scraped.
       #
       # @param use_main_content_only [Boolean] Extract only the main content, stripping headers, footers, sidebars, and navigat
       #
+      # @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load for each craw
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebWebCrawlMdResponse]
@@ -152,7 +168,7 @@ module ContextDev
       #
       # Scrapes the given URL and returns the raw HTML content of the page.
       #
-      # @overload web_scrape_html(url:, include_frames: nil, max_age_ms: nil, parse_pdf: nil, request_options: {})
+      # @overload web_scrape_html(url:, include_frames: nil, max_age_ms: nil, parse_pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
@@ -162,6 +178,10 @@ module ContextDev
       #
       # @param parse_pdf [Boolean] When true (default), PDF URLs are fetched and their text layer is extracted and
       #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebWebScrapeHTMLResponse]
@@ -176,7 +196,9 @@ module ContextDev
           query: query.transform_keys(
             include_frames: "includeFrames",
             max_age_ms: "maxAgeMs",
-            parse_pdf: "parsePDF"
+            parse_pdf: "parsePDF",
+            timeout_ms: "timeoutMS",
+            wait_for_ms: "waitForMs"
           ),
           model: ContextDev::Models::WebWebScrapeHTMLResponse,
           options: options
@@ -191,7 +213,7 @@ module ContextDev
       # embeds. The base request costs 1 credit; enrichment costs 1 credit per returned
       # image.
       #
-      # @overload web_scrape_images(url:, enrichment: nil, max_age_ms: nil, request_options: {})
+      # @overload web_scrape_images(url:, enrichment: 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://.
       #
@@ -199,6 +221,10 @@ module ContextDev
       #
       # @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load before collec
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebWebScrapeImagesResponse]
@@ -210,7 +236,11 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/scrape/images",
-          query: query.transform_keys(max_age_ms: "maxAgeMs"),
+          query: query.transform_keys(
+            max_age_ms: "maxAgeMs",
+            timeout_ms: "timeoutMS",
+            wait_for_ms: "waitForMs"
+          ),
           model: ContextDev::Models::WebWebScrapeImagesResponse,
           options: options
         )
@@ -221,7 +251,7 @@ module ContextDev
       #
       # Scrapes the given URL into LLM usable Markdown.
       #
-      # @overload web_scrape_md(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, parse_pdf: nil, shorten_base64_images: nil, use_main_content_only: nil, request_options: {})
+      # @overload web_scrape_md(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, parse_pdf: 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
       #
@@ -237,8 +267,12 @@ module ContextDev
       #
       # @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
+      #
       # @param use_main_content_only [Boolean] Extract only the main content of the page, excluding headers, footers, sidebars,
       #
+      # @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load before conver
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebWebScrapeMdResponse]
@@ -257,7 +291,9 @@ module ContextDev
             max_age_ms: "maxAgeMs",
             parse_pdf: "parsePDF",
             shorten_base64_images: "shortenBase64Images",
-            use_main_content_only: "useMainContentOnly"
+            timeout_ms: "timeoutMS",
+            use_main_content_only: "useMainContentOnly",
+            wait_for_ms: "waitForMs"
           ),
           model: ContextDev::Models::WebWebScrapeMdResponse,
           options: options
@@ -269,12 +305,14 @@ module ContextDev
       #
       # Crawl an entire website's sitemap and return all discovered page URLs.
       #
-      # @overload web_scrape_sitemap(domain:, max_links: nil, url_regex: nil, request_options: {})
+      # @overload web_scrape_sitemap(domain:, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
       #
       # @param domain [String] Domain to build a sitemap for
       #
       # @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
       # @param url_regex [String] Optional RE2-compatible regex pattern. Only URLs matching this pattern are retur
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -288,7 +326,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/scrape/sitemap",
-          query: query.transform_keys(max_links: "maxLinks", url_regex: "urlRegex"),
+          query: query.transform_keys(max_links: "maxLinks", timeout_ms: "timeoutMS", url_regex: "urlRegex"),
           model: ContextDev::Models::WebWebScrapeSitemapResponse,
           options: options
         )

data/lib/context_dev/version.rb

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