context.dev 1.16.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ba57da748751f653f87b57407326a40a8af9b31dc9c10364c61e536a7eb57a6
-  data.tar.gz: b10761a87783d8544bae6dd0bad6c3f3275af2fd2c39e734e61709d89de8cd9e
+  metadata.gz: e47becb29d02dd213aee4b6b49429685c9d74c35f37d49c026b8bbabc87be191
+  data.tar.gz: 2e76f0c796bf46d9ec0a1f764de47841eabf2cb290c71b279a9740b574393d98
 SHA512:
-  metadata.gz: 53f3f7978e24bcac14e388d76f2ba02b1410354b536264a14074306ce6464725d5741ebf6d59b1d280eeb8b2babc1980c35397c45175213645d38fdbcd89a5c5
-  data.tar.gz: 4d9aa2a1af255cd2352c613bfd3fbbef1532d9ab6eb396d8e9e33d1a41f7b4eabd3601c6406a68d3688a338b1f588f3cf76bc7d17b8966ddff0b358dd1cc6d72
+  metadata.gz: 859d0da8ad2c2e9fd7d0bdb4b783b9e8c75f4323d3a599b42d28ad495342ff1187f6a502449b1a325090f3ccab3f76c1d855e25c5aaaee1e7e98d690e9ac44e4
+  data.tar.gz: 5b30272a7da7dbfeb75475e067f86bb404313ee842aa86b973817ccf359dc07c53fe06890b2e2dc34b689da07ec3b12a2b77a1f871eeaa0c549196f1afbc873d

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 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)

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.16.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

@@ -49,13 +49,13 @@ 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 [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize, nil]
-      optional :prioritize, enum: -> { ContextDev::WebScreenshotParams::Prioritize }
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
 
       # @!attribute viewport
       #   Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
@@ -63,7 +63,15 @@ module ContextDev
       #   @return [ContextDev::Models::WebScreenshotParams::Viewport, nil]
       optional :viewport, -> { ContextDev::WebScreenshotParams::Viewport }
 
-      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, prioritize: nil, viewport: 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.
       #
@@ -77,10 +85,12 @@ module ContextDev
       #
       #   @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}]
 
       # Optional parameter to determine screenshot type. If 'true', takes a full page
@@ -117,19 +127,6 @@ 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>]
-      end
-
       class Viewport < ContextDev::Internal::Type::BaseModel
         # @!attribute height
         #   Viewport height in pixels.

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, max_age_ms: nil, page: nil, prioritize: nil, viewport: 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
       #
@@ -82,10 +82,12 @@ module ContextDev
       #
       # @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]
       #
       # @return [ContextDev::Models::WebScreenshotResponse]
@@ -100,7 +102,9 @@ module ContextDev
           query: query.transform_keys(
             direct_url: "directUrl",
             full_screenshot: "fullScreenshot",
-            max_age_ms: "maxAgeMs"
+            max_age_ms: "maxAgeMs",
+            timeout_ms: "timeoutMS",
+            wait_for_ms: "waitForMs"
           ),
           model: ContextDev::Models::WebScreenshotResponse,
           options: options
@@ -113,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)
       #
@@ -135,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]
@@ -160,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)
       #
@@ -170,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]
@@ -184,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
@@ -199,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://.
       #
@@ -207,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]
@@ -218,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
         )
@@ -229,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
       #
@@ -245,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]
@@ -265,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
@@ -277,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]
@@ -296,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.16.0"
+  VERSION = "1.17.0"
 end

data/rbi/context_dev/models/ai_extract_product_params.rbi

@@ -27,8 +27,9 @@ module ContextDev
       sig { params(max_age_ms: Integer).void }
       attr_writer :max_age_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).
       sig { returns(T.nilable(Integer)) }
       attr_reader :timeout_ms
 
@@ -50,8 +51,9 @@ module ContextDev
         # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
         # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
         max_age_ms: nil,
-        # 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).
         timeout_ms: nil,
         request_options: {}
       )

data/rbi/context_dev/models/ai_extract_products_params.rbi

@@ -92,8 +92,9 @@ module ContextDev
           sig { params(max_products: Integer).void }
           attr_writer :max_products
 
-          # 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).
           sig { returns(T.nilable(Integer)) }
           attr_reader :timeout_ms
 
@@ -117,8 +118,9 @@ module ContextDev
             max_age_ms: nil,
             # Maximum number of products to extract.
             max_products: nil,
-            # 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).
             timeout_ms: nil
           )
           end
@@ -167,8 +169,9 @@ module ContextDev
           sig { params(max_products: Integer).void }
           attr_writer :max_products
 
-          # 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).
           sig { returns(T.nilable(Integer)) }
           attr_reader :timeout_ms
 
@@ -193,8 +196,9 @@ module ContextDev
             max_age_ms: nil,
             # Maximum number of products to extract.
             max_products: nil,
-            # 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).
             timeout_ms: nil
           )
           end