context.dev 2.21.0 → 2.22.0

data/lib/context_dev/models/web_screenshot_params.rb

@@ -25,8 +25,7 @@ module ContextDev
       optional :color_scheme, enum: -> { ContextDev::WebScreenshotParams::ColorScheme }
 
       # @!attribute country
-      #   Fetch the target page through a residential proxy in this country (ISO 3166-1
-      #   alpha-2).
+      #   Fetch from this country (ISO 3166-1 alpha-2).
       #
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Country, nil]
       optional :country, enum: -> { ContextDev::WebScreenshotParams::Country }
@@ -105,16 +104,13 @@ module ContextDev
       optional :scroll_offset, Integer, nil?: true
 
       # @!attribute tags
-      #   Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
-      #   characters.
+      #   Comma-separated labels for filtering usage, e.g. `production,team-alpha`.
       #
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
       # @!attribute timeout_opts
-      #   Optional request deadline and behavior on timeout. For GET requests, use
-      #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
-      #   timeoutOpts object.
+      #   Request deadline and what to return when it passes.
       #
       #   @return [ContextDev::Models::WebScreenshotParams::TimeoutOpts, nil]
       optional :timeout_opts, -> { ContextDev::WebScreenshotParams::TimeoutOpts }
@@ -136,11 +132,8 @@ module ContextDev
       optional :wait_for_ms, Integer, nil?: true
 
       # @!attribute zdr
-      #   Set to enabled to bypass shared caches and omit request and response content
-      #   from retained usage logs. Asset uploads are skipped, so hosted image URLs are
-      #   omitted. Requires zero data retention to be enabled for your organization
-      #   (contact support@context.dev), otherwise the request fails with ZDR_NOT_ENABLED.
-      #   Successful ZDR responses include X-Context-ZDR: true.
+      #   `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless
+      #   your organization has ZDR.
       #
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Zdr, nil]
       optional :zdr, enum: -> { ContextDev::WebScreenshotParams::Zdr }
@@ -153,7 +146,7 @@ module ContextDev
       #
       #   @param color_scheme [Symbol, ContextDev::Models::WebScreenshotParams::ColorScheme] Optional parameter to choose the site's visual theme in the screenshot. Use 'lig
       #
-      #   @param country [Symbol, ContextDev::Models::WebScreenshotParams::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
+      #   @param country [Symbol, ContextDev::Models::WebScreenshotParams::Country] Fetch from this country (ISO 3166-1 alpha-2).
       #
       #   @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
@@ -171,15 +164,15 @@ module ContextDev
       #
       #   @param scroll_offset [Integer, nil] Optional vertical scroll offset in pixels for capturing a long page in viewport-
       #
-      #   @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
+      #   @param tags [Array<String>] Comma-separated labels for filtering usage, e.g. `production,team-alpha`.
       #
-      #   @param timeout_opts [ContextDev::Models::WebScreenshotParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      #   @param timeout_opts [ContextDev::Models::WebScreenshotParams::TimeoutOpts] Request deadline and what to return when it passes.
       #
       #   @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
       #
       #   @param wait_for_ms [Integer, nil] Optional browser wait time in milliseconds after initial page load before taking
       #
-      #   @param zdr [Symbol, ContextDev::Models::WebScreenshotParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #   @param zdr [Symbol, ContextDev::Models::WebScreenshotParams::Zdr] `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless you
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
@@ -195,8 +188,7 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
-      # Fetch the target page through a residential proxy in this country (ISO 3166-1
-      # alpha-2).
+      # Fetch from this country (ISO 3166-1 alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum
 
@@ -445,17 +437,14 @@ module ContextDev
 
       class TimeoutOpts < ContextDev::Internal::Type::BaseModel
         # @!attribute milliseconds
-        #   Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #   Deadline in milliseconds.
         #
         #   @return [Integer]
         required :milliseconds, Integer
 
         # @!attribute behavior
-        #   What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
-        #   credits. "return-partial" returns usable results collected so far; if none are
-        #   available, the request still fails without charging credits. Partial results are
-        #   not cached as complete results. "return-partial" requires milliseconds of at
-        #   least 5000.
+        #   "fail" returns 408 at the deadline. "return-partial" returns available results;
+        #   inspect the response’s partial flag. "return-partial" requires at least 5000 ms.
         #
         #   @return [Symbol, ContextDev::Models::WebScreenshotParams::TimeoutOpts::Behavior, nil]
         optional :behavior, enum: -> { ContextDev::WebScreenshotParams::TimeoutOpts::Behavior }
@@ -464,19 +453,14 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::WebScreenshotParams::TimeoutOpts} for more details.
         #
-        #   Optional request deadline and behavior on timeout. For GET requests, use
-        #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
-        #   timeoutOpts object.
+        #   Request deadline and what to return when it passes.
         #
-        #   @param milliseconds [Integer] Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #   @param milliseconds [Integer] Deadline in milliseconds.
         #
-        #   @param behavior [Symbol, ContextDev::Models::WebScreenshotParams::TimeoutOpts::Behavior] What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        #   @param behavior [Symbol, ContextDev::Models::WebScreenshotParams::TimeoutOpts::Behavior] "fail" returns 408 at the deadline. "return-partial" returns available results;
 
-        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
-        # credits. "return-partial" returns usable results collected so far; if none are
-        # available, the request still fails without charging credits. Partial results are
-        # not cached as complete results. "return-partial" requires milliseconds of at
-        # least 5000.
+        # "fail" returns 408 at the deadline. "return-partial" returns available results;
+        # inspect the response’s partial flag. "return-partial" requires at least 5000 ms.
         #
         # @see ContextDev::Models::WebScreenshotParams::TimeoutOpts#behavior
         module Behavior
@@ -511,11 +495,8 @@ module ContextDev
         #   @param width [Integer] Viewport width in pixels.
       end
 
-      # Set to enabled to bypass shared caches and omit request and response content
-      # from retained usage logs. Asset uploads are skipped, so hosted image URLs are
-      # omitted. Requires zero data retention to be enabled for your organization
-      # (contact support@context.dev), otherwise the request fails with ZDR_NOT_ENABLED.
-      # Successful ZDR responses include X-Context-ZDR: true.
+      # `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless
+      # your organization has ZDR.
       module Zdr
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/web_screenshot_response.rb

@@ -5,16 +5,14 @@ module ContextDev
     # @see ContextDev::Resources::Web#screenshot
     class WebScreenshotResponse < ContextDev::Internal::Type::BaseModel
       # @!attribute cache_metadata
-      #   Cache outcome for this response. Composite responses are hits only when every
-      #   cache-controlled fetch contributing to the output was a hit; age_ms is the
-      #   oldest contributing hit.
+      #   Whether this response came from cache.
       #
       #   @return [ContextDev::Models::WebScreenshotResponse::CacheMetadata]
       required :cache_metadata, -> { ContextDev::Models::WebScreenshotResponse::CacheMetadata }
 
       # @!attribute request_id
-      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
-      #   it when contacting support about a failed request.
+      #   Unique ID of this request, also in `X-Request-Id`. Include it when contacting
+      #   support.
       #
       #   @return [String]
       required :request_id, String
@@ -32,11 +30,8 @@ module ContextDev
       optional :domain, String
 
       # @!attribute final_dom_state
-      #   How complete the returned content is. `loaded` means the page finished the waits
-      #   the request asked for. `still-loading` only occurs with
-      #   timeoutOpts.behavior=return-partial: the timeoutOpts.milliseconds deadline was
-      #   reached first, so the content reflects the DOM at that moment and late-rendering
-      #   parts may be missing. Partial results are billed at the base request cost.
+      #   `loaded`, or `still-loading` when capture ended before the page finished
+      #   loading.
       #
       #   @return [Symbol, ContextDev::Models::WebScreenshotResponse::FinalDomState, nil]
       optional :final_dom_state,
@@ -50,7 +45,7 @@ module ContextDev
       optional :height, Integer
 
       # @!attribute key_metadata
-      #   Credit usage, included whenever a valid API key is provided.
+      #   Credits this request used and your remaining balance.
       #
       #   @return [ContextDev::Models::WebScreenshotResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebScreenshotResponse::KeyMetadata }
@@ -71,7 +66,7 @@ module ContextDev
                api_name: :screenshotType
 
       # @!attribute status
-      #   Status of the response, e.g., 'ok'
+      #   Always `ok` on success.
       #
       #   @return [String, nil]
       optional :status, String
@@ -86,25 +81,25 @@ module ContextDev
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotResponse} for more details.
       #
-      #   @param cache_metadata [ContextDev::Models::WebScreenshotResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
+      #   @param cache_metadata [ContextDev::Models::WebScreenshotResponse::CacheMetadata] Whether this response came from cache.
       #
-      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   @param request_id [String] Unique ID of this request, also in `X-Request-Id`. Include it when contacting su
       #
       #   @param code [Integer] HTTP status code
       #
       #   @param domain [String] The normalized domain that was processed
       #
-      #   @param final_dom_state [Symbol, ContextDev::Models::WebScreenshotResponse::FinalDomState] How complete the returned content is. `loaded` means the page finished the waits
+      #   @param final_dom_state [Symbol, ContextDev::Models::WebScreenshotResponse::FinalDomState] `loaded`, or `still-loading` when capture ended before the page finished loading
       #
       #   @param height [Integer] Height in pixels of the returned screenshot image
       #
-      #   @param key_metadata [ContextDev::Models::WebScreenshotResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
+      #   @param key_metadata [ContextDev::Models::WebScreenshotResponse::KeyMetadata] Credits this request used and your remaining balance.
       #
       #   @param screenshot [String] Public image URL for standard requests, or an in-memory data URL when ZDR or non
       #
       #   @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 status [String] Always `ok` on success.
       #
       #   @param width [Integer] Width in pixels of the returned screenshot image
 
@@ -127,9 +122,7 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::WebScreenshotResponse::CacheMetadata} for more details.
         #
-        #   Cache outcome for this response. Composite responses are hits only when every
-        #   cache-controlled fetch contributing to the output was a hit; age_ms is the
-        #   oldest contributing hit.
+        #   Whether this response came from cache.
         #
         #   @param age_ms [Integer] Age of the cached data in milliseconds. Zero for miss and zdr responses.
         #
@@ -151,11 +144,8 @@ module ContextDev
         end
       end
 
-      # How complete the returned content is. `loaded` means the page finished the waits
-      # the request asked for. `still-loading` only occurs with
-      # timeoutOpts.behavior=return-partial: the timeoutOpts.milliseconds deadline was
-      # reached first, so the content reflects the DOM at that moment and late-rendering
-      # parts may be missing. Partial results are billed at the base request cost.
+      # `loaded`, or `still-loading` when capture ended before the page finished
+      # loading.
       #
       # @see ContextDev::Models::WebScreenshotResponse#final_dom_state
       module FinalDomState
@@ -171,7 +161,7 @@ module ContextDev
       # @see ContextDev::Models::WebScreenshotResponse#key_metadata
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
         # @!attribute credits_consumed
-        #   Credits used by this request.
+        #   Credits charged for this request.
         #
         #   @return [Integer]
         required :credits_consumed, Integer
@@ -183,9 +173,9 @@ module ContextDev
         required :credits_remaining, Integer
 
         # @!method initialize(credits_consumed:, credits_remaining:)
-        #   Credit usage, included whenever a valid API key is provided.
+        #   Credits this request used and your remaining balance.
         #
-        #   @param credits_consumed [Integer] Credits used by this request.
+        #   @param credits_consumed [Integer] Credits charged for this request.
         #
         #   @param credits_remaining [Integer] Credits remaining for your organization.
       end

data/lib/context_dev/models/web_search_params.rb

@@ -22,8 +22,8 @@ module ContextDev
       optional :country, enum: -> { ContextDev::WebSearchParams::Country }
 
       # @!attribute exclude_domains
-      #   Blocklist — drop results from these domains. Example: ["pinterest.com",
-      #   "reddit.com"].
+      #   Blocklist — drop results from these domains. Up to 100 domains. Example:
+      #   ["pinterest.com", "reddit.com"].
       #
       #   @return [Array<String>, nil]
       optional :exclude_domains, ContextDev::Internal::Type::ArrayOf[String], api_name: :excludeDomains
@@ -34,9 +34,18 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebSearchParams::Freshness, nil]
       optional :freshness, enum: -> { ContextDev::WebSearchParams::Freshness }
 
+      # @!attribute highlights_options
+      #   Passages from each result page that are relevant to the query. Pages are read
+      #   with the `markdownOptions` settings.
+      #
+      #   @return [ContextDev::Models::WebSearchParams::HighlightsOptions, nil]
+      optional :highlights_options,
+               -> { ContextDev::WebSearchParams::HighlightsOptions },
+               api_name: :highlightsOptions
+
       # @!attribute include_domains
-      #   Allowlist — only return results from these domains. Example: ["arxiv.org",
-      #   "github.com"].
+      #   Allowlist — only return results from these domains. Up to 100 domains. Example:
+      #   ["arxiv.org", "github.com"].
       #
       #   @return [Array<String>, nil]
       optional :include_domains, ContextDev::Internal::Type::ArrayOf[String], api_name: :includeDomains
@@ -56,36 +65,31 @@ module ContextDev
       optional :num_results, Integer, api_name: :numResults
 
       # @!attribute query_fanout
-      #   Expand the query into multiple parallel variants for broader recall.
+      #   Currently has no effect.
       #
       #   @return [Boolean, nil]
       optional :query_fanout, ContextDev::Internal::Type::Boolean, api_name: :queryFanout
 
       # @!attribute tags
-      #   Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      #   Labels for filtering usage in the dashboard.
       #
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
       # @!attribute timeout_opts
-      #   Optional request deadline and behavior on timeout. For GET requests, use
-      #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
-      #   timeoutOpts object.
+      #   Request deadline and what to return when it passes.
       #
       #   @return [ContextDev::Models::WebSearchParams::TimeoutOpts, nil]
       optional :timeout_opts, -> { ContextDev::WebSearchParams::TimeoutOpts }, api_name: :timeoutOpts
 
       # @!attribute zdr
-      #   Set to enabled to bypass shared caches and omit request and response content
-      #   from retained usage logs. Asset uploads are skipped, so hosted image URLs are
-      #   omitted. Requires zero data retention to be enabled for your organization
-      #   (contact support@context.dev), otherwise the request fails with ZDR_NOT_ENABLED.
-      #   Successful ZDR responses include X-Context-ZDR: true.
+      #   `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless
+      #   your organization has ZDR.
       #
       #   @return [Symbol, ContextDev::Models::WebSearchParams::Zdr, nil]
       optional :zdr, enum: -> { ContextDev::WebSearchParams::Zdr }
 
-      # @!method initialize(query:, country: nil, exclude_domains: nil, freshness: nil, include_domains: nil, markdown_options: nil, num_results: nil, query_fanout: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
+      # @!method initialize(query:, country: nil, exclude_domains: nil, freshness: nil, highlights_options: nil, include_domains: nil, markdown_options: nil, num_results: nil, query_fanout: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebSearchParams} for more details.
       #
@@ -93,23 +97,25 @@ module ContextDev
       #
       #   @param country [Symbol, ContextDev::Models::WebSearchParams::Country] Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific cou
       #
-      #   @param exclude_domains [Array<String>] Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.
+      #   @param exclude_domains [Array<String>] Blocklist — drop results from these domains. Up to 100 domains. Example: ["pinte
       #
       #   @param freshness [Symbol, ContextDev::Models::WebSearchParams::Freshness] Restrict results to content published within this window.
       #
-      #   @param include_domains [Array<String>] Allowlist — only return results from these domains. Example: ["arxiv.org", "gith
+      #   @param highlights_options [ContextDev::Models::WebSearchParams::HighlightsOptions] Passages from each result page that are relevant to the query. Pages are read wi
+      #
+      #   @param include_domains [Array<String>] Allowlist — only return results from these domains. Up to 100 domains. Example:
       #
       #   @param markdown_options [ContextDev::Models::WebSearchParams::MarkdownOptions] Inline Markdown scraping for each result. Set `enabled: true` to activate.
       #
       #   @param num_results [Integer] Number of results to request and return (10–100). Defaults to 10.
       #
-      #   @param query_fanout [Boolean] Expand the query into multiple parallel variants for broader recall.
+      #   @param query_fanout [Boolean] Currently has no effect.
       #
-      #   @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      #   @param tags [Array<String>] Labels for filtering usage in the dashboard.
       #
-      #   @param timeout_opts [ContextDev::Models::WebSearchParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      #   @param timeout_opts [ContextDev::Models::WebSearchParams::TimeoutOpts] Request deadline and what to return when it passes.
       #
-      #   @param zdr [Symbol, ContextDev::Models::WebSearchParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #   @param zdr [Symbol, ContextDev::Models::WebSearchParams::Zdr] `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless you
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
@@ -375,9 +381,31 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
+      class HighlightsOptions < ContextDev::Internal::Type::BaseModel
+        # @!attribute enabled
+        #   Return relevant passages for each result. Adds 1 credit per 10 results.
+        #
+        #   @return [Boolean, nil]
+        optional :enabled, ContextDev::Internal::Type::Boolean
+
+        # @!attribute max_characters
+        #   Maximum combined length of passages per result.
+        #
+        #   @return [Integer, nil]
+        optional :max_characters, Integer, api_name: :maxCharacters
+
+        # @!method initialize(enabled: nil, max_characters: nil)
+        #   Passages from each result page that are relevant to the query. Pages are read
+        #   with the `markdownOptions` settings.
+        #
+        #   @param enabled [Boolean] Return relevant passages for each result. Adds 1 credit per 10 results.
+        #
+        #   @param max_characters [Integer] Maximum combined length of passages per result.
+      end
+
       class MarkdownOptions < ContextDev::Internal::Type::BaseModel
         # @!attribute enabled
-        #   Scrape each result to Markdown. Off by default to keep search cheap and fast.
+        #   Scrape each result to Markdown. Adds 1 credit per 10 results.
         #
         #   @return [Boolean, nil]
         optional :enabled, ContextDev::Internal::Type::Boolean
@@ -401,8 +429,10 @@ module ContextDev
         optional :include_links, ContextDev::Internal::Type::Boolean, api_name: :includeLinks
 
         # @!attribute max_age_ms
-        #   Cache TTL in ms for scraped Markdown keyed by URL + options. Default 1 day, max
-        #   30 days. Set to 0 to force a fresh scrape.
+        #   Maximum cache age in milliseconds for result page content. Defaults to 180 days
+        #   (15552000000 ms) when Markdown is requested, or 365 days (31536000000 ms) when
+        #   only highlights are requested. Explicit values override either default. Maximum:
+        #   365 days. Set to 0 to force a fresh scrape.
         #
         #   @return [Integer, nil]
         optional :max_age_ms, Integer, api_name: :maxAgeMs
@@ -420,9 +450,7 @@ module ContextDev
         optional :shorten_base64_images, ContextDev::Internal::Type::Boolean, api_name: :shortenBase64Images
 
         # @!attribute timeout_opts
-        #   Optional request deadline and behavior on timeout. For GET requests, use
-        #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
-        #   timeoutOpts object.
+        #   Request deadline and what to return when it passes.
         #
         #   @return [ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts, nil]
         optional :timeout_opts,
@@ -448,7 +476,7 @@ module ContextDev
         #
         #   Inline Markdown scraping for each result. Set `enabled: true` to activate.
         #
-        #   @param enabled [Boolean] Scrape each result to Markdown. Off by default to keep search cheap and fast.
+        #   @param enabled [Boolean] Scrape each result to Markdown. Adds 1 credit per 10 results.
         #
         #   @param include_frames [Boolean] Render iframe contents into the Markdown.
         #
@@ -456,13 +484,13 @@ module ContextDev
         #
         #   @param include_links [Boolean] Keep hyperlinks in the Markdown.
         #
-        #   @param max_age_ms [Integer] Cache TTL in ms for scraped Markdown keyed by URL + options. Default 1 day, max
+        #   @param max_age_ms [Integer] Maximum cache age in milliseconds for result page content. Defaults to 180 days
         #
         #   @param pdf [ContextDev::Models::WebSearchParams::MarkdownOptions::Pdf] PDF handling. Use start/end to bound text extraction and OCR to a page range.
         #
         #   @param shorten_base64_images [Boolean] Truncate inline base64 image payloads to keep responses small.
         #
-        #   @param timeout_opts [ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+        #   @param timeout_opts [ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts] Request deadline and what to return when it passes.
         #
         #   @param use_main_content_only [Boolean] Strip nav, header, footer, and sidebar — keep only the primary article content.
         #
@@ -505,17 +533,14 @@ module ContextDev
         # @see ContextDev::Models::WebSearchParams::MarkdownOptions#timeout_opts
         class TimeoutOpts < ContextDev::Internal::Type::BaseModel
           # @!attribute milliseconds
-          #   Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+          #   Deadline in milliseconds.
           #
           #   @return [Integer]
           required :milliseconds, Integer
 
           # @!attribute behavior
-          #   What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
-          #   credits. "return-partial" returns usable results collected so far; if none are
-          #   available, the request still fails without charging credits. Partial results are
-          #   not cached as complete results. "return-partial" requires milliseconds of at
-          #   least 5000.
+          #   "fail" returns 408 at the deadline. "return-partial" returns available results;
+          #   inspect the response’s partial flag. "return-partial" requires at least 5000 ms.
           #
           #   @return [Symbol, ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts::Behavior, nil]
           optional :behavior, enum: -> { ContextDev::WebSearchParams::MarkdownOptions::TimeoutOpts::Behavior }
@@ -525,19 +550,14 @@ module ContextDev
           #   {ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts} for more
           #   details.
           #
-          #   Optional request deadline and behavior on timeout. For GET requests, use
-          #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
-          #   timeoutOpts object.
+          #   Request deadline and what to return when it passes.
           #
-          #   @param milliseconds [Integer] Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+          #   @param milliseconds [Integer] Deadline in milliseconds.
           #
-          #   @param behavior [Symbol, ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts::Behavior] What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+          #   @param behavior [Symbol, ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts::Behavior] "fail" returns 408 at the deadline. "return-partial" returns available results;
 
-          # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
-          # credits. "return-partial" returns usable results collected so far; if none are
-          # available, the request still fails without charging credits. Partial results are
-          # not cached as complete results. "return-partial" requires milliseconds of at
-          # least 5000.
+          # "fail" returns 408 at the deadline. "return-partial" returns available results;
+          # inspect the response’s partial flag. "return-partial" requires at least 5000 ms.
           #
           # @see ContextDev::Models::WebSearchParams::MarkdownOptions::TimeoutOpts#behavior
           module Behavior
@@ -554,16 +574,14 @@ module ContextDev
 
       class TimeoutOpts < ContextDev::Internal::Type::BaseModel
         # @!attribute milliseconds
-        #   Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #   Deadline in milliseconds.
         #
         #   @return [Integer]
         required :milliseconds, Integer
 
         # @!attribute behavior
-        #   What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
-        #   credits. "return-partial" returns usable results collected so far; if none are
-        #   available, the request still fails without charging credits. Partial results are
-        #   not cached as complete results.
+        #   "fail" returns 408 at the deadline. "return-partial" returns available results;
+        #   inspect the response’s partial flag.
         #
         #   @return [Symbol, ContextDev::Models::WebSearchParams::TimeoutOpts::Behavior, nil]
         optional :behavior, enum: -> { ContextDev::WebSearchParams::TimeoutOpts::Behavior }
@@ -572,18 +590,14 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::WebSearchParams::TimeoutOpts} for more details.
         #
-        #   Optional request deadline and behavior on timeout. For GET requests, use
-        #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
-        #   timeoutOpts object.
+        #   Request deadline and what to return when it passes.
         #
-        #   @param milliseconds [Integer] Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #   @param milliseconds [Integer] Deadline in milliseconds.
         #
-        #   @param behavior [Symbol, ContextDev::Models::WebSearchParams::TimeoutOpts::Behavior] What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        #   @param behavior [Symbol, ContextDev::Models::WebSearchParams::TimeoutOpts::Behavior] "fail" returns 408 at the deadline. "return-partial" returns available results;
 
-        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
-        # credits. "return-partial" returns usable results collected so far; if none are
-        # available, the request still fails without charging credits. Partial results are
-        # not cached as complete results.
+        # "fail" returns 408 at the deadline. "return-partial" returns available results;
+        # inspect the response’s partial flag.
         #
         # @see ContextDev::Models::WebSearchParams::TimeoutOpts#behavior
         module Behavior
@@ -597,11 +611,8 @@ module ContextDev
         end
       end
 
-      # Set to enabled to bypass shared caches and omit request and response content
-      # from retained usage logs. Asset uploads are skipped, so hosted image URLs are
-      # omitted. Requires zero data retention to be enabled for your organization
-      # (contact support@context.dev), otherwise the request fails with ZDR_NOT_ENABLED.
-      # Successful ZDR responses include X-Context-ZDR: true.
+      # `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless
+      # your organization has ZDR.
       module Zdr
         extend ContextDev::Internal::Type::Enum