context.dev 1.15.0 → 1.17.0

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

data/rbi/context_dev/models/web_screenshot_params.rbi

@@ -47,6 +47,15 @@ module ContextDev
       end
       attr_writer :full_screenshot
 
+      # 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.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :max_age_ms
+
+      sig { params(max_age_ms: Integer).void }
+      attr_writer :max_age_ms
+
       # 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
@@ -60,22 +69,32 @@ module ContextDev
       sig { params(page: ContextDev::WebScreenshotParams::Page::OrSymbol).void }
       attr_writer :page
 
-      # 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.
-      sig do
-        returns(
-          T.nilable(ContextDev::WebScreenshotParams::Prioritize::OrSymbol)
-        )
-      end
-      attr_reader :prioritize
+      # 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
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      sig { returns(T.nilable(ContextDev::WebScreenshotParams::Viewport)) }
+      attr_reader :viewport
 
       sig do
-        params(
-          prioritize: ContextDev::WebScreenshotParams::Prioritize::OrSymbol
-        ).void
+        params(viewport: ContextDev::WebScreenshotParams::Viewport::OrHash).void
       end
-      attr_writer :prioritize
+      attr_writer :viewport
+
+      # 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.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :wait_for_ms
+
+      sig { params(wait_for_ms: Integer).void }
+      attr_writer :wait_for_ms
 
       sig do
         params(
@@ -83,8 +102,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(T.attached_class)
       end
@@ -101,16 +123,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
@@ -122,8 +154,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,
+            wait_for_ms: Integer,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -202,35 +237,43 @@ module ContextDev
         end
       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
-
-        TaggedSymbol =
+      class Viewport < ContextDev::Internal::Type::BaseModel
+        OrHash =
           T.type_alias do
-            T.all(Symbol, ContextDev::WebScreenshotParams::Prioritize)
+            T.any(
+              ContextDev::WebScreenshotParams::Viewport,
+              ContextDev::Internal::AnyHash
+            )
           end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-        SPEED =
-          T.let(
-            :speed,
-            ContextDev::WebScreenshotParams::Prioritize::TaggedSymbol
-          )
-        QUALITY =
-          T.let(
-            :quality,
-            ContextDev::WebScreenshotParams::Prioritize::TaggedSymbol
-          )
+        # Viewport height in pixels.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :height
+
+        sig { params(height: Integer).void }
+        attr_writer :height
+
+        # Viewport width in pixels.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :width
 
+        sig { params(width: Integer).void }
+        attr_writer :width
+
+        # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
         sig do
-          override.returns(
-            T::Array[ContextDev::WebScreenshotParams::Prioritize::TaggedSymbol]
-          )
+          params(height: Integer, width: Integer).returns(T.attached_class)
         end
-        def self.values
+        def self.new(
+          # Viewport height in pixels.
+          height: nil,
+          # Viewport width in pixels.
+          width: nil
+        )
+        end
+
+        sig { override.returns({ height: Integer, width: Integer }) }
+        def to_hash
         end
       end
     end

data/rbi/context_dev/models/web_screenshot_response.rbi

@@ -25,6 +25,13 @@ module ContextDev
       sig { params(domain: String).void }
       attr_writer :domain
 
+      # Height in pixels of the returned screenshot image
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :height
+
+      sig { params(height: Integer).void }
+      attr_writer :height
+
       # Public URL of the uploaded screenshot image
       sig { returns(T.nilable(String)) }
       attr_reader :screenshot
@@ -57,14 +64,23 @@ module ContextDev
       sig { params(status: String).void }
       attr_writer :status
 
+      # Width in pixels of the returned screenshot image
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :width
+
+      sig { params(width: Integer).void }
+      attr_writer :width
+
       sig do
         params(
           code: Integer,
           domain: String,
+          height: Integer,
           screenshot: String,
           screenshot_type:
             ContextDev::Models::WebScreenshotResponse::ScreenshotType::OrSymbol,
-          status: String
+          status: String,
+          width: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -72,12 +88,16 @@ module ContextDev
         code: nil,
         # The normalized domain that was processed
         domain: nil,
+        # Height in pixels of the returned screenshot image
+        height: nil,
         # Public URL of the uploaded screenshot image
         screenshot: nil,
         # Type of screenshot that was captured
         screenshot_type: nil,
         # Status of the response, e.g., 'ok'
-        status: nil
+        status: nil,
+        # Width in pixels of the returned screenshot image
+        width: nil
       )
       end
 
@@ -86,10 +106,12 @@ module ContextDev
           {
             code: Integer,
             domain: String,
+            height: Integer,
             screenshot: String,
             screenshot_type:
               ContextDev::Models::WebScreenshotResponse::ScreenshotType::TaggedSymbol,
-            status: String
+            status: String,
+            width: Integer
           }
         )
       end

data/rbi/context_dev/models/web_web_crawl_md_params.rbi

@@ -85,6 +85,15 @@ module ContextDev
       sig { params(shorten_base64_images: T::Boolean).void }
       attr_writer :shorten_base64_images
 
+      # 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
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
       # Regex pattern. Only URLs matching this pattern will be followed and scraped.
       sig { returns(T.nilable(String)) }
       attr_reader :url_regex
@@ -100,6 +109,14 @@ module ContextDev
       sig { params(use_main_content_only: T::Boolean).void }
       attr_writer :use_main_content_only
 
+      # Optional browser wait time in milliseconds after initial page load for each
+      # crawled page. Min: 0. Max: 30000 (30 seconds).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :wait_for_ms
+
+      sig { params(wait_for_ms: Integer).void }
+      attr_writer :wait_for_ms
+
       sig do
         params(
           url: String,
@@ -112,8 +129,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(T.attached_class)
       end
@@ -145,11 +164,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
@@ -167,8 +193,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
           }
         )

data/rbi/context_dev/models/web_web_scrape_html_params.rbi

@@ -43,12 +43,31 @@ module ContextDev
       sig { params(parse_pdf: T::Boolean).void }
       attr_writer :parse_pdf
 
+      # 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
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      # Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
+      # 30000 (30 seconds).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :wait_for_ms
+
+      sig { params(wait_for_ms: Integer).void }
+      attr_writer :wait_for_ms
+
       sig do
         params(
           url: String,
           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(T.attached_class)
       end
@@ -65,6 +84,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
@@ -76,6 +102,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
           }
         )

data/rbi/context_dev/models/web_web_scrape_images_params.rbi

@@ -40,11 +40,30 @@ module ContextDev
       sig { params(max_age_ms: Integer).void }
       attr_writer :max_age_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).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      # Optional browser wait time in milliseconds after initial page load before
+      # collecting images. Min: 0. Max: 30000 (30 seconds).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :wait_for_ms
+
+      sig { params(wait_for_ms: Integer).void }
+      attr_writer :wait_for_ms
+
       sig do
         params(
           url: String,
           enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment::OrHash,
           max_age_ms: Integer,
+          timeout_ms: Integer,
+          wait_for_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -57,6 +76,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
@@ -67,6 +93,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/rbi/context_dev/models/web_web_scrape_md_params.rbi

@@ -62,6 +62,15 @@ module ContextDev
       sig { params(shorten_base64_images: T::Boolean).void }
       attr_writer :shorten_base64_images
 
+      # 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
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
       # Extract only the main content of the page, excluding headers, footers, sidebars,
       # and navigation
       sig { returns(T.nilable(T::Boolean)) }
@@ -70,6 +79,14 @@ module ContextDev
       sig { params(use_main_content_only: T::Boolean).void }
       attr_writer :use_main_content_only
 
+      # Optional browser wait time in milliseconds after initial page load before
+      # converting the page to Markdown. Min: 0. Max: 30000 (30 seconds).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :wait_for_ms
+
+      sig { params(wait_for_ms: Integer).void }
+      attr_writer :wait_for_ms
+
       sig do
         params(
           url: String,
@@ -79,7 +96,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(T.attached_class)
       end
@@ -103,9 +122,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
@@ -120,7 +146,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
           }
         )

data/rbi/context_dev/models/web_web_scrape_sitemap_params.rbi

@@ -26,6 +26,15 @@ module ContextDev
       sig { params(max_links: Integer).void }
       attr_writer :max_links
 
+      # 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
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
       # Optional RE2-compatible regex pattern. Only URLs matching this pattern are
       # returned and counted against maxLinks.
       sig { returns(T.nilable(String)) }
@@ -38,6 +47,7 @@ module ContextDev
         params(
           domain: String,
           max_links: Integer,
+          timeout_ms: Integer,
           url_regex: String,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -48,6 +58,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,
@@ -60,6 +74,7 @@ module ContextDev
           {
             domain: String,
             max_links: Integer,
+            timeout_ms: Integer,
             url_regex: String,
             request_options: ContextDev::RequestOptions
           }

data/rbi/context_dev/resources/ai.rbi

@@ -48,8 +48,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: {}
       )