context.dev 2.21.0 → 2.22.0

data/lib/context_dev/models/batch_submit_params.rb

@@ -20,8 +20,8 @@ module ContextDev
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
       # @!attribute webhook
-      #   Completion webhook settings. Cannot be combined with webhookUrl. Omitting retry
-      #   preserves legacy delivery; retry: {} opts into durable retries.
+      #   Where to send the batch's final-status event. Omit `retry` for one attempt; `{}`
+      #   uses the default retry schedule.
       #
       #   @return [ContextDev::Models::BatchSubmitParams::Webhook, nil]
       optional :webhook, -> { ContextDev::BatchSubmitParams::Webhook }
@@ -34,8 +34,8 @@ module ContextDev
       optional :webhook_url, String, api_name: :webhookUrl
 
       # @!attribute idempotency_key
-      #   Any string unique to this submission. Retries with the same key return the
-      #   original batch.
+      #   Unique key per submission. Retrying with the same key and body returns the
+      #   original batch; a different body returns `409`.
       #
       #   @return [String, nil]
       optional :idempotency_key, String
@@ -48,11 +48,11 @@ module ContextDev
       #
       #   @param tags [Array<String>] Tags stored on the batch. Filter the batch list by them later.
       #
-      #   @param webhook [ContextDev::Models::BatchSubmitParams::Webhook] Completion webhook settings. Cannot be combined with webhookUrl. Omitting retry
+      #   @param webhook [ContextDev::Models::BatchSubmitParams::Webhook] Where to send the batch's final-status event. Omit `retry` for one attempt; `{}`
       #
       #   @param webhook_url [String] Legacy URL notified when the batch finishes. Preserves one best-effort attempt.
       #
-      #   @param idempotency_key [String] Any string unique to this submission. Retries with the same key return the origi
+      #   @param idempotency_key [String] Unique key per submission. Retrying with the same key and body returns the origi
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
@@ -62,7 +62,7 @@ module ContextDev
 
         discriminator :mode
 
-        # Scrape up to 25K URLs in one batch.
+        # Scrape a list of up to 25,000 URLs.
         variant :scrape, -> { ContextDev::BatchSubmitParams::Input::Scrape }
 
         # Crawl pages starting from a URL or from a domain's sitemap.
@@ -82,7 +82,7 @@ module ContextDev
           required :mode, const: :scrape
 
           # @!method initialize(data:, mode: :scrape)
-          #   Scrape up to 25K URLs in one batch.
+          #   Scrape a list of up to 25,000 URLs.
           #
           #   @param data [ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::Markdown, ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::HTML] Pages to scrape and their output format.
           #
@@ -168,8 +168,7 @@ module ContextDev
               # @see ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::Markdown#options
               class Options < ContextDev::Internal::Type::BaseModel
                 # @!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::BatchSubmitParams::Input::Scrape::Data::Markdown::Options::Country, nil]
                 optional :country,
@@ -186,8 +185,7 @@ module ContextDev
                          nil?: true
 
                 # @!attribute include_html
-                #   Also include each page's HTML in its result record, as an `html` field alongside
-                #   the Markdown.
+                #   Also return each page's HTML in `html`.
                 #
                 #   @return [Boolean, nil]
                 optional :include_html, ContextDev::Internal::Type::Boolean, api_name: :includeHTML
@@ -205,8 +203,8 @@ module ContextDev
                 optional :include_links, ContextDev::Internal::Type::Boolean, api_name: :includeLinks
 
                 # @!attribute include_selectors
-                #   Keep only the subtrees matching these CSS selectors. Filtered pages are always
-                #   fetched fresh, ignoring `maxAgeMs`.
+                #   Keep only elements matching these CSS selectors. Filtered pages ignore
+                #   `maxAgeMs`.
                 #
                 #   @return [Array<String>, nil]
                 optional :include_selectors,
@@ -215,9 +213,8 @@ module ContextDev
                          nil?: true
 
                 # @!attribute max_age_ms
-                #   Return a cached result if a prior scrape 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 scrape fresh.
+                #   Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
+                #   year (31536000000 ms). `0` fetches fresh.
                 #
                 #   @return [Integer, nil]
                 optional :max_age_ms, Integer, api_name: :maxAgeMs, nil?: true
@@ -230,8 +227,7 @@ module ContextDev
                 optional :pdf, -> { ContextDev::BatchSubmitParams::Input::Scrape::Data::Markdown::Options::Pdf }
 
                 # @!attribute settle_animations
-                #   Wait briefly for CSS and transition animations to settle before extraction, on
-                #   pages that render in a browser.
+                #   Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @return [Boolean, nil]
                 optional :settle_animations, ContextDev::Internal::Type::Boolean, api_name: :settleAnimations
@@ -265,23 +261,23 @@ module ContextDev
                 #
                 #   Options for Markdown output.
                 #
-                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::Markdown::Options::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
+                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::Markdown::Options::Country] Fetch from this country (ISO 3166-1 alpha-2).
                 #
                 #   @param exclude_selectors [Array<String>, nil] Remove elements matching these CSS selectors. Applied after `includeSelectors`,
                 #
-                #   @param include_html [Boolean] Also include each page's HTML in its result record, as an `html` field alongside
+                #   @param include_html [Boolean] Also return each page's HTML in `html`.
                 #
                 #   @param include_images [Boolean] Include image references in the Markdown.
                 #
                 #   @param include_links [Boolean] Include links in the Markdown.
                 #
-                #   @param include_selectors [Array<String>, nil] Keep only the subtrees matching these CSS selectors. Filtered pages are always f
+                #   @param include_selectors [Array<String>, nil] Keep only elements matching these CSS selectors. Filtered pages ignore `maxAgeMs
                 #
-                #   @param max_age_ms [Integer, nil] Return a cached result if a prior scrape for the same parameters exists and is y
+                #   @param max_age_ms [Integer, nil] Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
                 #
                 #   @param pdf [ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::Markdown::Options::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
                 #
-                #   @param settle_animations [Boolean] Wait briefly for CSS and transition animations to settle before extraction, on p
+                #   @param settle_animations [Boolean] Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @param shorten_base64_images [Boolean] Shorten inline base64 image data.
                 #
@@ -289,8 +285,7 @@ module ContextDev
                 #
                 #   @param wait_for_ms [Integer] How long to wait after initial page load, in milliseconds. `0` waits 500 ms.
 
-                # 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).
                 #
                 # @see ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::Markdown::Options#country
                 module Country
@@ -515,17 +510,13 @@ module ContextDev
                   optional :end_, Integer, api_name: :end
 
                   # @!attribute ocr
-                  #   When true, OCR the selected PDF pages that have no usable text layer (scans),
-                  #   replacing each recovered page's text with the OCR result while pages with a real
-                  #   text layer keep it. Billed at 1 credit per page OCR actually recovered, on top
-                  #   of the base request cost. When false, no OCR runs.
+                  #   Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
                   #   @return [Boolean, nil]
                   optional :ocr, ContextDev::Internal::Type::Boolean
 
                   # @!attribute should_parse
-                  #   When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
-                  #   a 400 PDF_SKIPPED is returned.
+                  #   Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @return [Boolean, nil]
                   optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
@@ -546,9 +537,9 @@ module ContextDev
                   #
                   #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
                   #
-                  #   @param ocr [Boolean] When true, OCR the selected PDF pages that have no usable text layer (scans), re
+                  #   @param ocr [Boolean] Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
-                  #   @param should_parse [Boolean] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+                  #   @param should_parse [Boolean] Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
                 end
@@ -621,8 +612,7 @@ module ContextDev
               # @see ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::HTML#options
               class Options < ContextDev::Internal::Type::BaseModel
                 # @!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::BatchSubmitParams::Input::Scrape::Data::HTML::Options::Country, nil]
                 optional :country, enum: -> { ContextDev::BatchSubmitParams::Input::Scrape::Data::HTML::Options::Country }
@@ -638,8 +628,8 @@ module ContextDev
                          nil?: true
 
                 # @!attribute include_selectors
-                #   Keep only the subtrees matching these CSS selectors. Filtered pages are always
-                #   fetched fresh, ignoring `maxAgeMs`.
+                #   Keep only elements matching these CSS selectors. Filtered pages ignore
+                #   `maxAgeMs`.
                 #
                 #   @return [Array<String>, nil]
                 optional :include_selectors,
@@ -648,9 +638,8 @@ module ContextDev
                          nil?: true
 
                 # @!attribute max_age_ms
-                #   Return a cached result if a prior scrape 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 scrape fresh.
+                #   Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
+                #   year (31536000000 ms). `0` fetches fresh.
                 #
                 #   @return [Integer, nil]
                 optional :max_age_ms, Integer, api_name: :maxAgeMs, nil?: true
@@ -663,8 +652,7 @@ module ContextDev
                 optional :pdf, -> { ContextDev::BatchSubmitParams::Input::Scrape::Data::HTML::Options::Pdf }
 
                 # @!attribute settle_animations
-                #   Wait briefly for CSS and transition animations to settle before extraction, on
-                #   pages that render in a browser.
+                #   Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @return [Boolean, nil]
                 optional :settle_animations, ContextDev::Internal::Type::Boolean, api_name: :settleAnimations
@@ -690,24 +678,23 @@ module ContextDev
                 #
                 #   Options for HTML output.
                 #
-                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::HTML::Options::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
+                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::HTML::Options::Country] Fetch from this country (ISO 3166-1 alpha-2).
                 #
                 #   @param exclude_selectors [Array<String>, nil] Remove elements matching these CSS selectors. Applied after `includeSelectors`,
                 #
-                #   @param include_selectors [Array<String>, nil] Keep only the subtrees matching these CSS selectors. Filtered pages are always f
+                #   @param include_selectors [Array<String>, nil] Keep only elements matching these CSS selectors. Filtered pages ignore `maxAgeMs
                 #
-                #   @param max_age_ms [Integer, nil] Return a cached result if a prior scrape for the same parameters exists and is y
+                #   @param max_age_ms [Integer, nil] Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
                 #
                 #   @param pdf [ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::HTML::Options::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
                 #
-                #   @param settle_animations [Boolean] Wait briefly for CSS and transition animations to settle before extraction, on p
+                #   @param settle_animations [Boolean] Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @param use_main_content_only [Boolean] Return the main content without navigation or footers.
                 #
                 #   @param wait_for_ms [Integer] How long to wait after initial page load, in milliseconds. `0` waits 500 ms.
 
-                # 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).
                 #
                 # @see ContextDev::Models::BatchSubmitParams::Input::Scrape::Data::HTML::Options#country
                 module Country
@@ -932,17 +919,13 @@ module ContextDev
                   optional :end_, Integer, api_name: :end
 
                   # @!attribute ocr
-                  #   When true, OCR the selected PDF pages that have no usable text layer (scans),
-                  #   replacing each recovered page's text with the OCR result while pages with a real
-                  #   text layer keep it. Billed at 1 credit per page OCR actually recovered, on top
-                  #   of the base request cost. When false, no OCR runs.
+                  #   Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
                   #   @return [Boolean, nil]
                   optional :ocr, ContextDev::Internal::Type::Boolean
 
                   # @!attribute should_parse
-                  #   When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
-                  #   a 400 PDF_SKIPPED is returned.
+                  #   Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @return [Boolean, nil]
                   optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
@@ -963,9 +946,9 @@ module ContextDev
                   #
                   #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
                   #
-                  #   @param ocr [Boolean] When true, OCR the selected PDF pages that have no usable text layer (scans), re
+                  #   @param ocr [Boolean] Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
-                  #   @param should_parse [Boolean] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+                  #   @param should_parse [Boolean] Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
                 end
@@ -1190,8 +1173,7 @@ module ContextDev
               # @see ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::Markdown#options
               class Options < ContextDev::Internal::Type::BaseModel
                 # @!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::BatchSubmitParams::Input::Crawl::Data::Markdown::Options::Country, nil]
                 optional :country,
@@ -1208,8 +1190,7 @@ module ContextDev
                          nil?: true
 
                 # @!attribute include_html
-                #   Also include each page's HTML in its result record, as an `html` field alongside
-                #   the Markdown.
+                #   Also return each page's HTML in `html`.
                 #
                 #   @return [Boolean, nil]
                 optional :include_html, ContextDev::Internal::Type::Boolean, api_name: :includeHTML
@@ -1227,8 +1208,8 @@ module ContextDev
                 optional :include_links, ContextDev::Internal::Type::Boolean, api_name: :includeLinks
 
                 # @!attribute include_selectors
-                #   Keep only the subtrees matching these CSS selectors. Filtered pages are always
-                #   fetched fresh, ignoring `maxAgeMs`.
+                #   Keep only elements matching these CSS selectors. Filtered pages ignore
+                #   `maxAgeMs`.
                 #
                 #   @return [Array<String>, nil]
                 optional :include_selectors,
@@ -1237,9 +1218,8 @@ module ContextDev
                          nil?: true
 
                 # @!attribute max_age_ms
-                #   Return a cached result if a prior scrape 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 scrape fresh.
+                #   Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
+                #   year (31536000000 ms). `0` fetches fresh.
                 #
                 #   @return [Integer, nil]
                 optional :max_age_ms, Integer, api_name: :maxAgeMs, nil?: true
@@ -1252,8 +1232,7 @@ module ContextDev
                 optional :pdf, -> { ContextDev::BatchSubmitParams::Input::Crawl::Data::Markdown::Options::Pdf }
 
                 # @!attribute settle_animations
-                #   Wait briefly for CSS and transition animations to settle before extraction, on
-                #   pages that render in a browser.
+                #   Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @return [Boolean, nil]
                 optional :settle_animations, ContextDev::Internal::Type::Boolean, api_name: :settleAnimations
@@ -1287,23 +1266,23 @@ module ContextDev
                 #
                 #   Options for Markdown output.
                 #
-                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::Markdown::Options::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
+                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::Markdown::Options::Country] Fetch from this country (ISO 3166-1 alpha-2).
                 #
                 #   @param exclude_selectors [Array<String>, nil] Remove elements matching these CSS selectors. Applied after `includeSelectors`,
                 #
-                #   @param include_html [Boolean] Also include each page's HTML in its result record, as an `html` field alongside
+                #   @param include_html [Boolean] Also return each page's HTML in `html`.
                 #
                 #   @param include_images [Boolean] Include image references in the Markdown.
                 #
                 #   @param include_links [Boolean] Include links in the Markdown.
                 #
-                #   @param include_selectors [Array<String>, nil] Keep only the subtrees matching these CSS selectors. Filtered pages are always f
+                #   @param include_selectors [Array<String>, nil] Keep only elements matching these CSS selectors. Filtered pages ignore `maxAgeMs
                 #
-                #   @param max_age_ms [Integer, nil] Return a cached result if a prior scrape for the same parameters exists and is y
+                #   @param max_age_ms [Integer, nil] Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
                 #
                 #   @param pdf [ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::Markdown::Options::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
                 #
-                #   @param settle_animations [Boolean] Wait briefly for CSS and transition animations to settle before extraction, on p
+                #   @param settle_animations [Boolean] Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @param shorten_base64_images [Boolean] Shorten inline base64 image data.
                 #
@@ -1311,8 +1290,7 @@ module ContextDev
                 #
                 #   @param wait_for_ms [Integer] How long to wait after initial page load, in milliseconds. `0` waits 500 ms.
 
-                # 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).
                 #
                 # @see ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::Markdown::Options#country
                 module Country
@@ -1537,17 +1515,13 @@ module ContextDev
                   optional :end_, Integer, api_name: :end
 
                   # @!attribute ocr
-                  #   When true, OCR the selected PDF pages that have no usable text layer (scans),
-                  #   replacing each recovered page's text with the OCR result while pages with a real
-                  #   text layer keep it. Billed at 1 credit per page OCR actually recovered, on top
-                  #   of the base request cost. When false, no OCR runs.
+                  #   Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
                   #   @return [Boolean, nil]
                   optional :ocr, ContextDev::Internal::Type::Boolean
 
                   # @!attribute should_parse
-                  #   When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
-                  #   a 400 PDF_SKIPPED is returned.
+                  #   Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @return [Boolean, nil]
                   optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
@@ -1568,9 +1542,9 @@ module ContextDev
                   #
                   #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
                   #
-                  #   @param ocr [Boolean] When true, OCR the selected PDF pages that have no usable text layer (scans), re
+                  #   @param ocr [Boolean] Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
-                  #   @param should_parse [Boolean] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+                  #   @param should_parse [Boolean] Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
                 end
@@ -1756,8 +1730,7 @@ module ContextDev
               # @see ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::HTML#options
               class Options < ContextDev::Internal::Type::BaseModel
                 # @!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::BatchSubmitParams::Input::Crawl::Data::HTML::Options::Country, nil]
                 optional :country, enum: -> { ContextDev::BatchSubmitParams::Input::Crawl::Data::HTML::Options::Country }
@@ -1773,8 +1746,8 @@ module ContextDev
                          nil?: true
 
                 # @!attribute include_selectors
-                #   Keep only the subtrees matching these CSS selectors. Filtered pages are always
-                #   fetched fresh, ignoring `maxAgeMs`.
+                #   Keep only elements matching these CSS selectors. Filtered pages ignore
+                #   `maxAgeMs`.
                 #
                 #   @return [Array<String>, nil]
                 optional :include_selectors,
@@ -1783,9 +1756,8 @@ module ContextDev
                          nil?: true
 
                 # @!attribute max_age_ms
-                #   Return a cached result if a prior scrape 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 scrape fresh.
+                #   Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
+                #   year (31536000000 ms). `0` fetches fresh.
                 #
                 #   @return [Integer, nil]
                 optional :max_age_ms, Integer, api_name: :maxAgeMs, nil?: true
@@ -1798,8 +1770,7 @@ module ContextDev
                 optional :pdf, -> { ContextDev::BatchSubmitParams::Input::Crawl::Data::HTML::Options::Pdf }
 
                 # @!attribute settle_animations
-                #   Wait briefly for CSS and transition animations to settle before extraction, on
-                #   pages that render in a browser.
+                #   Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @return [Boolean, nil]
                 optional :settle_animations, ContextDev::Internal::Type::Boolean, api_name: :settleAnimations
@@ -1825,24 +1796,23 @@ module ContextDev
                 #
                 #   Options for HTML output.
                 #
-                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::HTML::Options::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
+                #   @param country [Symbol, ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::HTML::Options::Country] Fetch from this country (ISO 3166-1 alpha-2).
                 #
                 #   @param exclude_selectors [Array<String>, nil] Remove elements matching these CSS selectors. Applied after `includeSelectors`,
                 #
-                #   @param include_selectors [Array<String>, nil] Keep only the subtrees matching these CSS selectors. Filtered pages are always f
+                #   @param include_selectors [Array<String>, nil] Keep only elements matching these CSS selectors. Filtered pages ignore `maxAgeMs
                 #
-                #   @param max_age_ms [Integer, nil] Return a cached result if a prior scrape for the same parameters exists and is y
+                #   @param max_age_ms [Integer, nil] Maximum cache age in milliseconds. Defaults to 3 days (259200000 ms). Maximum: 1
                 #
                 #   @param pdf [ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::HTML::Options::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
                 #
-                #   @param settle_animations [Boolean] Wait briefly for CSS and transition animations to settle before extraction, on p
+                #   @param settle_animations [Boolean] Wait for CSS animations to finish before extracting, on browser-rendered pages.
                 #
                 #   @param use_main_content_only [Boolean] Return the main content without navigation or footers.
                 #
                 #   @param wait_for_ms [Integer] How long to wait after initial page load, in milliseconds. `0` waits 500 ms.
 
-                # 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).
                 #
                 # @see ContextDev::Models::BatchSubmitParams::Input::Crawl::Data::HTML::Options#country
                 module Country
@@ -2067,17 +2037,13 @@ module ContextDev
                   optional :end_, Integer, api_name: :end
 
                   # @!attribute ocr
-                  #   When true, OCR the selected PDF pages that have no usable text layer (scans),
-                  #   replacing each recovered page's text with the OCR result while pages with a real
-                  #   text layer keep it. Billed at 1 credit per page OCR actually recovered, on top
-                  #   of the base request cost. When false, no OCR runs.
+                  #   Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
                   #   @return [Boolean, nil]
                   optional :ocr, ContextDev::Internal::Type::Boolean
 
                   # @!attribute should_parse
-                  #   When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
-                  #   a 400 PDF_SKIPPED is returned.
+                  #   Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @return [Boolean, nil]
                   optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
@@ -2098,9 +2064,9 @@ module ContextDev
                   #
                   #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
                   #
-                  #   @param ocr [Boolean] When true, OCR the selected PDF pages that have no usable text layer (scans), re
+                  #   @param ocr [Boolean] Read scanned PDF pages with OCR; preserve pages that already have text.
                   #
-                  #   @param should_parse [Boolean] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+                  #   @param should_parse [Boolean] Parse PDF URLs. When false, PDFs fail with `PDF_SKIPPED`.
                   #
                   #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
                 end
@@ -2118,6 +2084,8 @@ module ContextDev
 
       class Webhook < ContextDev::Internal::Type::BaseModel
         # @!attribute url
+        #   Public HTTP(S) URL that receives batch completion, failure, or cancellation
+        #   events.
         #
         #   @return [String]
         required :url, String
@@ -2129,10 +2097,13 @@ module ContextDev
         optional :retry_, -> { ContextDev::RetryConfig }, api_name: :retry
 
         # @!method initialize(url:, retry_: nil)
-        #   Completion webhook settings. Cannot be combined with webhookUrl. Omitting retry
-        #   preserves legacy delivery; retry: {} opts into durable retries.
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::BatchSubmitParams::Webhook} for more details.
         #
-        #   @param url [String]
+        #   Where to send the batch's final-status event. Omit `retry` for one attempt; `{}`
+        #   uses the default retry schedule.
+        #
+        #   @param url [String] Public HTTP(S) URL that receives batch completion, failure, or cancellation even
         #
         #   @param retry_ [ContextDev::Models::RetryConfig] Webhook retry settings. Use {} for the default schedule.
       end