context.dev 2.14.0 → 2.16.0

data/rbi/context_dev/models/web_extract_response.rbi

@@ -39,6 +39,11 @@ module ContextDev
       end
       attr_writer :metadata
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Status of the response, e.g., 'ok'
       sig { returns(String) }
       attr_accessor :status
@@ -51,8 +56,7 @@ module ContextDev
       sig { returns(T::Array[String]) }
       attr_accessor :urls_analyzed
 
-      # Metadata about the API key used for the request. Included in every response
-      # whenever a valid API key is provided, even when the response status is not 200.
+      # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(T.nilable(ContextDev::Models::WebExtractResponse::KeyMetadata))
       end
@@ -72,6 +76,7 @@ module ContextDev
             ContextDev::Models::WebExtractResponse::CacheMetadata::OrHash,
           data: T::Hash[Symbol, T.anything],
           metadata: ContextDev::Models::WebExtractResponse::Metadata::OrHash,
+          request_id: String,
           status: String,
           url: String,
           urls_analyzed: T::Array[String],
@@ -87,14 +92,16 @@ module ContextDev
         # Extracted data matching the request schema
         data:,
         metadata:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Status of the response, e.g., 'ok'
         status:,
         # The starting URL that was analyzed
         url:,
         # List of URLs whose Markdown was used for extraction
         urls_analyzed:,
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil
       )
       end
@@ -106,6 +113,7 @@ module ContextDev
               ContextDev::Models::WebExtractResponse::CacheMetadata,
             data: T::Hash[Symbol, T.anything],
             metadata: ContextDev::Models::WebExtractResponse::Metadata,
+            request_id: String,
             status: String,
             url: String,
             urls_analyzed: T::Array[String],
@@ -456,25 +464,24 @@ module ContextDev
             )
           end
 
-        # The number of credits consumed by this request.
+        # Credits used by this request.
         sig { returns(Integer) }
         attr_accessor :credits_consumed
 
-        # The number of credits remaining for your organization after this request.
+        # Credits remaining for your organization.
         sig { returns(Integer) }
         attr_accessor :credits_remaining
 
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         sig do
           params(credits_consumed: Integer, credits_remaining: Integer).returns(
             T.attached_class
           )
         end
         def self.new(
-          # The number of credits consumed by this request.
+          # Credits used by this request.
           credits_consumed:,
-          # The number of credits remaining for your organization after this request.
+          # Credits remaining for your organization.
           credits_remaining:
         )
         end

data/rbi/context_dev/models/web_extract_styleguide_params.rbi

@@ -59,9 +59,8 @@ module ContextDev
       sig { returns(T.nilable(Integer)) }
       attr_accessor :max_age_ms
 
-      # Optional comma-separated caller-defined tags for tracking this request. Tags are
-      # recorded on the request's usage log and can be used to filter usage on the
-      # dashboard usage page. Up to 20 tags, each 1-50 characters.
+      # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+      # characters.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -107,9 +106,8 @@ module ContextDev
         # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
         # year.
         max_age_ms: nil,
-        # Optional comma-separated caller-defined tags for tracking this request. Tags are
-        # recorded on the request's usage log and can be used to filter usage on the
-        # dashboard usage page. Up to 20 tags, each 1-50 characters.
+        # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+        # characters.
         tags: 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

data/rbi/context_dev/models/web_extract_styleguide_response.rbi

@@ -27,6 +27,11 @@ module ContextDev
       end
       attr_writer :cache_metadata
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # HTTP status code
       sig { returns(T.nilable(Integer)) }
       attr_reader :code
@@ -41,8 +46,7 @@ module ContextDev
       sig { params(domain: String).void }
       attr_writer :domain
 
-      # Metadata about the API key used for the request. Included in every response
-      # whenever a valid API key is provided, even when the response status is not 200.
+      # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(
           T.nilable(
@@ -89,6 +93,7 @@ module ContextDev
         params(
           cache_metadata:
             ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::OrHash,
+          request_id: String,
           code: Integer,
           domain: String,
           key_metadata:
@@ -103,12 +108,14 @@ module ContextDev
         # cache-controlled fetch contributing to the output was a hit; age_ms is the
         # oldest contributing hit.
         cache_metadata:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # HTTP status code
         code: nil,
         # The normalized domain that was processed
         domain: nil,
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil,
         # Status of the response, e.g., 'ok'
         status: nil,
@@ -122,6 +129,7 @@ module ContextDev
           {
             cache_metadata:
               ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata,
+            request_id: String,
             code: Integer,
             domain: String,
             key_metadata:
@@ -239,25 +247,24 @@ module ContextDev
             )
           end
 
-        # The number of credits consumed by this request.
+        # Credits used by this request.
         sig { returns(Integer) }
         attr_accessor :credits_consumed
 
-        # The number of credits remaining for your organization after this request.
+        # Credits remaining for your organization.
         sig { returns(Integer) }
         attr_accessor :credits_remaining
 
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         sig do
           params(credits_consumed: Integer, credits_remaining: Integer).returns(
             T.attached_class
           )
         end
         def self.new(
-          # The number of credits consumed by this request.
+          # Credits used by this request.
           credits_consumed:,
-          # The number of credits remaining for your organization after this request.
+          # Credits remaining for your organization.
           credits_remaining:
         )
         end

data/rbi/context_dev/models/web_screenshot_params.rbi

@@ -123,9 +123,8 @@ module ContextDev
       sig { returns(T.nilable(Integer)) }
       attr_accessor :scroll_offset
 
-      # Optional comma-separated caller-defined tags for tracking this request. Tags are
-      # recorded on the request's usage log and can be used to filter usage on the
-      # dashboard usage page. Up to 20 tags, each 1-50 characters.
+      # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+      # characters.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -152,7 +151,8 @@ module ContextDev
 
       # 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.
+      # omitted. When combined with timeoutMS, timeoutMS must be at least waitForMs +
+      # 10000 ms; a shorter deadline is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :wait_for_ms
 
@@ -233,9 +233,8 @@ module ContextDev
         # top to bottom). The final slice may be shorter than the viewport height. Takes
         # precedence over fullScreenshot. Max: 100000.
         scroll_offset: nil,
-        # Optional comma-separated caller-defined tags for tracking this request. Tags are
-        # recorded on the request's usage log and can be used to filter usage on the
-        # dashboard usage page. Up to 20 tags, each 1-50 characters.
+        # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+        # characters.
         tags: 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
@@ -245,7 +244,8 @@ module ContextDev
         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.
+        # omitted. When combined with timeoutMS, timeoutMS must be at least waitForMs +
+        # 10000 ms; a shorter deadline is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
         wait_for_ms: nil,
         # Set to enabled to bypass shared caches and omit request and response content
         # from retained usage logs. Requires zero data retention to be enabled for your

data/rbi/context_dev/models/web_screenshot_response.rbi

@@ -25,6 +25,11 @@ module ContextDev
       end
       attr_writer :cache_metadata
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # HTTP status code
       sig { returns(T.nilable(Integer)) }
       attr_reader :code
@@ -46,8 +51,7 @@ module ContextDev
       sig { params(height: Integer).void }
       attr_writer :height
 
-      # Metadata about the API key used for the request. Included in every response
-      # whenever a valid API key is provided, even when the response status is not 200.
+      # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(
           T.nilable(ContextDev::Models::WebScreenshotResponse::KeyMetadata)
@@ -107,6 +111,7 @@ module ContextDev
         params(
           cache_metadata:
             ContextDev::Models::WebScreenshotResponse::CacheMetadata::OrHash,
+          request_id: String,
           code: Integer,
           domain: String,
           height: Integer,
@@ -124,14 +129,16 @@ module ContextDev
         # cache-controlled fetch contributing to the output was a hit; age_ms is the
         # oldest contributing hit.
         cache_metadata:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # HTTP status code
         code: nil,
         # The normalized domain that was processed
         domain: nil,
         # Height in pixels of the returned screenshot image
         height: nil,
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil,
         # Public image URL for standard requests, or an in-memory data URL when ZDR is
         # enabled.
@@ -150,6 +157,7 @@ module ContextDev
           {
             cache_metadata:
               ContextDev::Models::WebScreenshotResponse::CacheMetadata,
+            request_id: String,
             code: Integer,
             domain: String,
             height: Integer,
@@ -270,25 +278,24 @@ module ContextDev
             )
           end
 
-        # The number of credits consumed by this request.
+        # Credits used by this request.
         sig { returns(Integer) }
         attr_accessor :credits_consumed
 
-        # The number of credits remaining for your organization after this request.
+        # Credits remaining for your organization.
         sig { returns(Integer) }
         attr_accessor :credits_remaining
 
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         sig do
           params(credits_consumed: Integer, credits_remaining: Integer).returns(
             T.attached_class
           )
         end
         def self.new(
-          # The number of credits consumed by this request.
+          # Credits used by this request.
           credits_consumed:,
-          # The number of credits remaining for your organization after this request.
+          # Credits remaining for your organization.
           credits_remaining:
         )
         end

data/rbi/context_dev/models/web_search_response.rbi

@@ -29,11 +29,15 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :query
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       sig { returns(T::Array[ContextDev::Models::WebSearchResponse::Result]) }
       attr_accessor :results
 
-      # Metadata about the API key used for the request. Included in every response
-      # whenever a valid API key is provided, even when the response status is not 200.
+      # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(T.nilable(ContextDev::Models::WebSearchResponse::KeyMetadata))
       end
@@ -52,6 +56,7 @@ module ContextDev
           cache_metadata:
             ContextDev::Models::WebSearchResponse::CacheMetadata::OrHash,
           query: String,
+          request_id: String,
           results:
             T::Array[ContextDev::Models::WebSearchResponse::Result::OrHash],
           key_metadata:
@@ -65,9 +70,11 @@ module ContextDev
         cache_metadata:,
         # Echo of the original query (useful when fanout was enabled).
         query:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         results:,
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil
       )
       end
@@ -78,6 +85,7 @@ module ContextDev
             cache_metadata:
               ContextDev::Models::WebSearchResponse::CacheMetadata,
             query: String,
+            request_id: String,
             results: T::Array[ContextDev::Models::WebSearchResponse::Result],
             key_metadata: ContextDev::Models::WebSearchResponse::KeyMetadata
           }
@@ -419,25 +427,24 @@ module ContextDev
             )
           end
 
-        # The number of credits consumed by this request.
+        # Credits used by this request.
         sig { returns(Integer) }
         attr_accessor :credits_consumed
 
-        # The number of credits remaining for your organization after this request.
+        # Credits remaining for your organization.
         sig { returns(Integer) }
         attr_accessor :credits_remaining
 
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         sig do
           params(credits_consumed: Integer, credits_remaining: Integer).returns(
             T.attached_class
           )
         end
         def self.new(
-          # The number of credits consumed by this request.
+          # Credits used by this request.
           credits_consumed:,
-          # The number of credits remaining for your organization after this request.
+          # Credits remaining for your organization.
           credits_remaining:
         )
         end

data/rbi/context_dev/models/web_web_crawl_md_response.rbi

@@ -35,13 +35,17 @@ module ContextDev
       end
       attr_writer :metadata
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       sig do
         returns(T::Array[ContextDev::Models::WebWebCrawlMdResponse::Result])
       end
       attr_accessor :results
 
-      # Metadata about the API key used for the request. Included in every response
-      # whenever a valid API key is provided, even when the response status is not 200.
+      # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(
           T.nilable(ContextDev::Models::WebWebCrawlMdResponse::KeyMetadata)
@@ -62,6 +66,7 @@ module ContextDev
           cache_metadata:
             ContextDev::Models::WebWebCrawlMdResponse::CacheMetadata::OrHash,
           metadata: ContextDev::Models::WebWebCrawlMdResponse::Metadata::OrHash,
+          request_id: String,
           results:
             T::Array[ContextDev::Models::WebWebCrawlMdResponse::Result::OrHash],
           key_metadata:
@@ -74,9 +79,11 @@ module ContextDev
         # oldest contributing hit.
         cache_metadata:,
         metadata:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         results:,
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil
       )
       end
@@ -87,6 +94,7 @@ module ContextDev
             cache_metadata:
               ContextDev::Models::WebWebCrawlMdResponse::CacheMetadata,
             metadata: ContextDev::Models::WebWebCrawlMdResponse::Metadata,
+            request_id: String,
             results:
               T::Array[ContextDev::Models::WebWebCrawlMdResponse::Result],
             key_metadata: ContextDev::Models::WebWebCrawlMdResponse::KeyMetadata
@@ -875,25 +883,24 @@ module ContextDev
             )
           end
 
-        # The number of credits consumed by this request.
+        # Credits used by this request.
         sig { returns(Integer) }
         attr_accessor :credits_consumed
 
-        # The number of credits remaining for your organization after this request.
+        # Credits remaining for your organization.
         sig { returns(Integer) }
         attr_accessor :credits_remaining
 
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         sig do
           params(credits_consumed: Integer, credits_remaining: Integer).returns(
             T.attached_class
           )
         end
         def self.new(
-          # The number of credits consumed by this request.
+          # Credits used by this request.
           credits_consumed:,
-          # The number of credits remaining for your organization after this request.
+          # Credits remaining for your organization.
           credits_remaining:
         )
         end

data/rbi/context_dev/models/web_web_scrape_html_params.rbi

@@ -103,9 +103,8 @@ module ContextDev
       sig { params(settle_animations: T::Boolean).void }
       attr_writer :settle_animations
 
-      # Optional comma-separated caller-defined tags for tracking this request. Tags are
-      # recorded on the request's usage log and can be used to filter usage on the
-      # dashboard usage page. Up to 20 tags, each 1-50 characters.
+      # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+      # characters.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -130,7 +129,9 @@ module ContextDev
       attr_writer :use_main_content_only
 
       # Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
-      # 30000 (30 seconds).
+      # 30000 (30 seconds). When combined with timeoutMS, timeoutMS must be at least
+      # waitForMs + 10000 ms; a shorter deadline is rejected with 400
+      # TIMEOUT_TOO_SHORT_FOR_WAIT.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :wait_for_ms
 
@@ -212,9 +213,8 @@ module ContextDev
         # extracting HTML. Defaults to false. This adds a bit of latency in exchange for
         # more stable output on animated pages.
         settle_animations: nil,
-        # Optional comma-separated caller-defined tags for tracking this request. Tags are
-        # recorded on the request's usage log and can be used to filter usage on the
-        # dashboard usage page. Up to 20 tags, each 1-50 characters.
+        # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+        # characters.
         tags: 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
@@ -224,7 +224,9 @@ module ContextDev
         # headers, footers, sidebars, and navigation when detectable.
         use_main_content_only: nil,
         # Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
-        # 30000 (30 seconds).
+        # 30000 (30 seconds). When combined with timeoutMS, timeoutMS must be at least
+        # waitForMs + 10000 ms; a shorter deadline is rejected with 400
+        # TIMEOUT_TOO_SHORT_FOR_WAIT.
         wait_for_ms: nil,
         # Set to enabled to bypass shared caches and omit request and response content
         # from retained usage logs. Requires zero data retention to be enabled for your

data/rbi/context_dev/models/web_web_scrape_html_response.rbi

@@ -45,6 +45,11 @@ module ContextDev
       end
       attr_writer :metadata
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Indicates success
       sig do
         returns(
@@ -98,8 +103,7 @@ module ContextDev
       sig { params(actions_html_stale: T::Boolean).void }
       attr_writer :actions_html_stale
 
-      # Metadata about the API key used for the request. Included in every response
-      # whenever a valid API key is provided, even when the response status is not 200.
+      # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(
           T.nilable(ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata)
@@ -122,6 +126,7 @@ module ContextDev
           html: String,
           metadata:
             ContextDev::Models::WebWebScrapeHTMLResponse::Metadata::OrHash,
+          request_id: String,
           success:
             ContextDev::Models::WebWebScrapeHTMLResponse::Success::OrBoolean,
           type: ContextDev::Models::WebWebScrapeHTMLResponse::Type::OrSymbol,
@@ -146,6 +151,9 @@ module ContextDev
         html:,
         # Metadata extracted from the scraped page HTML.
         metadata:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Indicates success
         success:,
         # Detected content type of the returned `html` field. Sitemaps and feeds are
@@ -160,8 +168,7 @@ module ContextDev
         # True when an action was applied but the returned content could not be refreshed
         # afterward.
         actions_html_stale: nil,
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil
       )
       end
@@ -173,6 +180,7 @@ module ContextDev
               ContextDev::Models::WebWebScrapeHTMLResponse::CacheMetadata,
             html: String,
             metadata: ContextDev::Models::WebWebScrapeHTMLResponse::Metadata,
+            request_id: String,
             success:
               ContextDev::Models::WebWebScrapeHTMLResponse::Success::TaggedBoolean,
             type:
@@ -1080,25 +1088,24 @@ module ContextDev
             )
           end
 
-        # The number of credits consumed by this request.
+        # Credits used by this request.
         sig { returns(Integer) }
         attr_accessor :credits_consumed
 
-        # The number of credits remaining for your organization after this request.
+        # Credits remaining for your organization.
         sig { returns(Integer) }
         attr_accessor :credits_remaining
 
-        # Metadata about the API key used for the request. Included in every response
-        # whenever a valid API key is provided, even when the response status is not 200.
+        # Credit usage, included whenever a valid API key is provided.
         sig do
           params(credits_consumed: Integer, credits_remaining: Integer).returns(
             T.attached_class
           )
         end
         def self.new(
-          # The number of credits consumed by this request.
+          # Credits used by this request.
           credits_consumed:,
-          # The number of credits remaining for your organization after this request.
+          # Credits remaining for your organization.
           credits_remaining:
         )
         end

data/rbi/context_dev/models/web_web_scrape_images_params.rbi

@@ -75,9 +75,8 @@ module ContextDev
       sig { returns(T.nilable(Integer)) }
       attr_accessor :max_age_ms
 
-      # Optional comma-separated caller-defined tags for tracking this request. Tags are
-      # recorded on the request's usage log and can be used to filter usage on the
-      # dashboard usage page. Up to 20 tags, each 1-50 characters.
+      # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+      # characters.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -94,7 +93,9 @@ module ContextDev
       attr_writer :timeout_ms
 
       # Optional browser wait time in milliseconds after initial page load before
-      # collecting images. Min: 0. Max: 30000 (30 seconds).
+      # collecting images. Min: 0. Max: 30000 (30 seconds). When combined with
+      # timeoutMS, timeoutMS must be at least waitForMs + 10000 ms; a shorter deadline
+      # is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :wait_for_ms
 
@@ -144,16 +145,17 @@ 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 comma-separated caller-defined tags for tracking this request. Tags are
-        # recorded on the request's usage log and can be used to filter usage on the
-        # dashboard usage page. Up to 20 tags, each 1-50 characters.
+        # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+        # characters.
         tags: 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).
+        # collecting images. Min: 0. Max: 30000 (30 seconds). When combined with
+        # timeoutMS, timeoutMS must be at least waitForMs + 10000 ms; a shorter deadline
+        # is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
         wait_for_ms: nil,
         request_options: {}
       )