context.dev 2.22.0 → 2.23.0

data/lib/context_dev/models/web_scrape_params.rb

@@ -85,7 +85,7 @@ module ContextDev
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
       # @!attribute timeout_opts
-      #   Deadline for the whole request. Defaults to 60000 ms with `fail`. Fixed waits
+      #   Deadline for the whole request. Defaults to 90000 ms with `fail`. Fixed waits
       #   must end before it.
       #
       #   @return [ContextDev::Models::WebScrapeParams::TimeoutOpts, nil]
@@ -125,7 +125,7 @@ module ContextDev
       #
       #   @param tags [Array<String>] Labels for tracking request usage. Not retained when zdr is enabled.
       #
-      #   @param timeout_opts [ContextDev::Models::WebScrapeParams::TimeoutOpts] Deadline for the whole request. Defaults to 60000 ms with `fail`. Fixed waits mu
+      #   @param timeout_opts [ContextDev::Models::WebScrapeParams::TimeoutOpts] Deadline for the whole request. Defaults to 90000 ms with `fail`. Fixed waits mu
       #
       #   @param zdr [Symbol, ContextDev::Models::WebScrapeParams::Zdr] `enabled` turns on zero data retention. Your organization must have ZDR enabled.
       #
@@ -460,16 +460,16 @@ module ContextDev
       end
 
       class ProductParams < ContextDev::Internal::Type::BaseModel
-        # @!attribute use_ai_fallback
-        #   Use an AI model when the page has no structured product data.
+        # @!attribute dedupe_images
+        #   Drop visually duplicate product images, keeping the largest copy.
         #
         #   @return [Boolean, nil]
-        optional :use_ai_fallback, ContextDev::Internal::Type::Boolean, api_name: :useAIFallback
+        optional :dedupe_images, ContextDev::Internal::Type::Boolean, api_name: :dedupeImages
 
-        # @!method initialize(use_ai_fallback: nil)
+        # @!method initialize(dedupe_images: nil)
         #   Product options. Requires formats.product: true.
         #
-        #   @param use_ai_fallback [Boolean] Use an AI model when the page has no structured product data.
+        #   @param dedupe_images [Boolean] Drop visually duplicate product images, keeping the largest copy.
       end
 
       class ScreenshotParams < ContextDev::Internal::Type::BaseModel
@@ -1006,7 +1006,7 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::WebScrapeParams::TimeoutOpts} for more details.
         #
-        #   Deadline for the whole request. Defaults to 60000 ms with `fail`. Fixed waits
+        #   Deadline for the whole request. Defaults to 90000 ms with `fail`. Fixed waits
         #   must end before it.
         #
         #   @param milliseconds [Integer] Deadline in milliseconds.

data/lib/context_dev/models/web_scrape_response.rb

@@ -178,7 +178,7 @@ module ContextDev
         # @see ContextDev::Models::WebScrapeResponse::Bytes#data
         class Data < ContextDev::Internal::Type::BaseModel
           # @!attribute base64
-          #   Body as base64, after HTTP decompression. Up to 20 MiB decoded.
+          #   Body as base64, after HTTP decompression. Up to 50 MiB decoded.
           #
           #   @return [String]
           required :base64, String
@@ -189,7 +189,7 @@ module ContextDev
           required :content_type, String, api_name: :contentType
 
           # @!method initialize(base64:, content_type:)
-          #   @param base64 [String] Body as base64, after HTTP decompression. Up to 20 MiB decoded.
+          #   @param base64 [String] Body as base64, after HTTP decompression. Up to 50 MiB decoded.
           #
           #   @param content_type [String]
         end

data/lib/context_dev/models/web_search_params.rb

@@ -41,7 +41,8 @@ module ContextDev
       #   @return [ContextDev::Models::WebSearchParams::HighlightsOptions, nil]
       optional :highlights_options,
                -> { ContextDev::WebSearchParams::HighlightsOptions },
-               api_name: :highlightsOptions
+               api_name: :highlightsOptions,
+               nil?: true
 
       # @!attribute include_domains
       #   Allowlist — only return results from these domains. Up to 100 domains. Example:
@@ -56,7 +57,8 @@ module ContextDev
       #   @return [ContextDev::Models::WebSearchParams::MarkdownOptions, nil]
       optional :markdown_options,
                -> { ContextDev::WebSearchParams::MarkdownOptions },
-               api_name: :markdownOptions
+               api_name: :markdownOptions,
+               nil?: true
 
       # @!attribute num_results
       #   Number of results to request and return (10–100). Defaults to 10.
@@ -101,11 +103,11 @@ module ContextDev
       #
       #   @param freshness [Symbol, ContextDev::Models::WebSearchParams::Freshness] Restrict results to content published within this window.
       #
-      #   @param highlights_options [ContextDev::Models::WebSearchParams::HighlightsOptions] Passages from each result page that are relevant to the query. Pages are read wi
+      #   @param highlights_options [ContextDev::Models::WebSearchParams::HighlightsOptions, nil] 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 markdown_options [ContextDev::Models::WebSearchParams::MarkdownOptions, nil] 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.
       #
@@ -435,10 +437,10 @@ module ContextDev
         #   365 days. Set to 0 to force a fresh scrape.
         #
         #   @return [Integer, nil]
-        optional :max_age_ms, Integer, api_name: :maxAgeMs
+        optional :max_age_ms, Integer, api_name: :maxAgeMs, nil?: true
 
         # @!attribute pdf
-        #   PDF handling. Use start/end to bound text extraction and OCR to a page range.
+        #   PDF handling. `start`/`end` limit parsing to an inclusive, 1-based page range.
         #
         #   @return [ContextDev::Models::WebSearchParams::MarkdownOptions::Pdf, nil]
         optional :pdf, -> { ContextDev::WebSearchParams::MarkdownOptions::Pdf }
@@ -468,7 +470,7 @@ module ContextDev
         #   JS-heavy pages.
         #
         #   @return [Integer, nil]
-        optional :wait_for_ms, Integer, api_name: :waitForMs
+        optional :wait_for_ms, Integer, api_name: :waitForMs, nil?: true
 
         # @!method initialize(enabled: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_opts: nil, use_main_content_only: nil, wait_for_ms: nil)
         #   Some parameter documentations has been truncated, see
@@ -484,9 +486,9 @@ module ContextDev
         #
         #   @param include_links [Boolean] Keep hyperlinks in the Markdown.
         #
-        #   @param max_age_ms [Integer] Maximum cache age in milliseconds for result page content. Defaults to 180 days
+        #   @param max_age_ms [Integer, nil] 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 pdf [ContextDev::Models::WebSearchParams::MarkdownOptions::Pdf] PDF handling. `start`/`end` limit parsing to an inclusive, 1-based page range.
         #
         #   @param shorten_base64_images [Boolean] Truncate inline base64 image payloads to keep responses small.
         #
@@ -494,7 +496,7 @@ module ContextDev
         #
         #   @param use_main_content_only [Boolean] Strip nav, header, footer, and sidebar — keep only the primary article content.
         #
-        #   @param wait_for_ms [Integer] Extra wait after page load before rendering, in ms (0–30000). Useful for JS-heav
+        #   @param wait_for_ms [Integer, nil] Extra wait after page load before rendering, in ms (0–30000). Useful for JS-heav
 
         # @see ContextDev::Models::WebSearchParams::MarkdownOptions#pdf
         class Pdf < ContextDev::Internal::Type::BaseModel
@@ -512,7 +514,7 @@ module ContextDev
           optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
 
           # @!attribute start
-          #   First PDF page to parse (1-based, inclusive). Defaults to page 1.
+          #   First 1-based PDF page to parse.
           #
           #   @return [Integer, nil]
           optional :start, Integer
@@ -521,13 +523,13 @@ module ContextDev
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::WebSearchParams::MarkdownOptions::Pdf} for more details.
           #
-          #   PDF handling. Use start/end to bound text extraction and OCR to a page range.
+          #   PDF handling. `start`/`end` limit parsing to an inclusive, 1-based page range.
           #
           #   @param end_ [Integer] Last PDF page to parse (1-based, inclusive). Defaults to the final page. Must be
           #
           #   @param should_parse [Boolean] Parse PDF URLs. When false, PDF results are skipped with WEBSITE_ACCESS_ERROR.
           #
-          #   @param start [Integer] First PDF page to parse (1-based, inclusive). Defaults to page 1.
+          #   @param start [Integer] First 1-based PDF page to parse.
         end
 
         # @see ContextDev::Models::WebSearchParams::MarkdownOptions#timeout_opts

data/lib/context_dev/models/web_web_crawl_md_params.rb

@@ -23,7 +23,10 @@ module ContextDev
       #   Remove matching elements after inclusions. Exclusions take precedence.
       #
       #   @return [Array<String>, nil]
-      optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String], api_name: :excludeSelectors
+      optional :exclude_selectors,
+               ContextDev::Internal::Type::ArrayOf[String],
+               api_name: :excludeSelectors,
+               nil?: true
 
       # @!attribute follow_subdomains
       #   When true, follow links on subdomains of the starting URL's domain (e.g.
@@ -56,13 +59,16 @@ module ContextDev
       #   Keep matching HTML subtrees before converting each page to Markdown.
       #
       #   @return [Array<String>, nil]
-      optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String], api_name: :includeSelectors
+      optional :include_selectors,
+               ContextDev::Internal::Type::ArrayOf[String],
+               api_name: :includeSelectors,
+               nil?: true
 
       # @!attribute max_age_ms
       #   Maximum cache age in milliseconds. Defaults to 1 day; `0` fetches fresh.
       #
       #   @return [Integer, nil]
-      optional :max_age_ms, Integer, api_name: :maxAgeMs
+      optional :max_age_ms, Integer, api_name: :maxAgeMs, nil?: true
 
       # @!attribute max_depth
       #   Maximum link depth from the starting URL (0 = only the starting page)
@@ -134,7 +140,7 @@ module ContextDev
       #   Defaults to 3500 (3.5 seconds). Min: 0. Max: 30000 (30 seconds).
       #
       #   @return [Integer, nil]
-      optional :wait_for_ms, Integer, api_name: :waitForMs
+      optional :wait_for_ms, Integer, api_name: :waitForMs, nil?: true
 
       # @!attribute zdr
       #   `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless
@@ -151,7 +157,7 @@ module ContextDev
       #
       #   @param country [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country] Fetch from this country (ISO 3166-1 alpha-2).
       #
-      #   @param exclude_selectors [Array<String>] Remove matching elements after inclusions. Exclusions take precedence.
+      #   @param exclude_selectors [Array<String>, nil] Remove matching elements after inclusions. Exclusions take precedence.
       #
       #   @param follow_subdomains [Boolean] When true, follow links on subdomains of the starting URL's domain (e.g. docs.ex
       #
@@ -161,9 +167,9 @@ module ContextDev
       #
       #   @param include_links [Boolean] Preserve hyperlinks in the Markdown output
       #
-      #   @param include_selectors [Array<String>] Keep matching HTML subtrees before converting each page to Markdown.
+      #   @param include_selectors [Array<String>, nil] Keep matching HTML subtrees before converting each page to Markdown.
       #
-      #   @param max_age_ms [Integer] Maximum cache age in milliseconds. Defaults to 1 day; `0` fetches fresh.
+      #   @param max_age_ms [Integer, nil] Maximum cache age in milliseconds. Defaults to 1 day; `0` fetches fresh.
       #
       #   @param max_depth [Integer] Maximum link depth from the starting URL (0 = only the starting page)
       #
@@ -185,7 +191,7 @@ module ContextDev
       #
       #   @param use_main_content_only [Boolean] Extract only the main content, stripping headers, footers, sidebars, and navigat
       #
-      #   @param wait_for_ms [Integer] Browser wait time in milliseconds after initial page load for each crawled page.
+      #   @param wait_for_ms [Integer, nil] Browser wait time in milliseconds after initial page load for each crawled page.
       #
       #   @param zdr [Symbol, ContextDev::Models::WebWebCrawlMdParams::Zdr] `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless you
       #
@@ -406,14 +412,14 @@ module ContextDev
 
       class Pdf < ContextDev::Internal::Type::BaseModel
         # @!attribute end_
-        #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
-        #   Must be greater than or equal to start when both are provided.
+        #   Last PDF page to parse (1-based, inclusive). Defaults to the final page. Must
+        #   be >= start.
         #
         #   @return [Integer, nil]
         optional :end_, Integer, api_name: :end
 
         # @!attribute ocr
-        #   Read scanned PDF pages with OCR; preserve pages that already contain text.
+        #   Read scanned PDF pages with OCR; preserve pages that already have text.
         #
         #   @return [Boolean, nil]
         optional :ocr, ContextDev::Internal::Type::Boolean
@@ -426,7 +432,7 @@ module ContextDev
         optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
 
         # @!attribute start
-        #   First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        #   First 1-based PDF page to parse.
         #
         #   @return [Integer, nil]
         optional :start, Integer
@@ -437,13 +443,13 @@ module ContextDev
         #
         #   PDF handling. `start`/`end` limit parsing to an inclusive, 1-based page range.
         #
-        #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
+        #   @param end_ [Integer] Last PDF page to parse (1-based, inclusive). Defaults to the final page. Must be
         #
-        #   @param ocr [Boolean] Read scanned PDF pages with OCR; preserve pages that already contain text.
+        #   @param ocr [Boolean] Read scanned PDF pages with OCR; preserve pages that already have text.
         #
         #   @param should_parse [Boolean] When true, PDF pages are fetched and parsed. When false, PDF pages are skipped e
         #
-        #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        #   @param start [Integer] First 1-based PDF page to parse.
       end
 
       class TimeoutOpts < ContextDev::Internal::Type::BaseModel

data/lib/context_dev/resources/batch.rb

@@ -42,7 +42,7 @@ module ContextDev
       #
       # @param status [Symbol, ContextDev::Models::BatchListParams::Status] Filter by status.
       #
-      # @param tags [String] Comma-separated list of tags to filter by (matches batches having any of them).
+      # @param tags [String, Array<String>] Tags to filter by (matches batches having any of them). Pass repeated `tags` par
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/context_dev/resources/logs.rb

@@ -18,7 +18,7 @@ module ContextDev
       def retrieve(request_id, params = {})
         @client.request(
           method: :get,
-          path: ["logs/%1$s", request_id],
+          path: ["org/logs/%1$s", request_id],
           model: ContextDev::Models::LogRetrieveResponse,
           options: params[:request_options]
         )
@@ -64,7 +64,7 @@ module ContextDev
         query = ContextDev::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
-          path: "logs",
+          path: "org/logs",
           query: query,
           model: ContextDev::Models::LogListResponse,
           options: options

data/lib/context_dev/resources/web.rb

@@ -200,7 +200,7 @@ module ContextDev
       #
       # @param tags [Array<String>] Labels for tracking request usage. Not retained when zdr is enabled.
       #
-      # @param timeout_opts [ContextDev::Models::WebScrapeParams::TimeoutOpts] Deadline for the whole request. Defaults to 60000 ms with `fail`. Fixed waits mu
+      # @param timeout_opts [ContextDev::Models::WebScrapeParams::TimeoutOpts] Deadline for the whole request. Defaults to 90000 ms with `fail`. Fixed waits mu
       #
       # @param zdr [Symbol, ContextDev::Models::WebScrapeParams::Zdr] `enabled` turns on zero data retention. Your organization must have ZDR enabled.
       #
@@ -302,11 +302,11 @@ module ContextDev
       #
       # @param freshness [Symbol, ContextDev::Models::WebSearchParams::Freshness] Restrict results to content published within this window.
       #
-      # @param highlights_options [ContextDev::Models::WebSearchParams::HighlightsOptions] Passages from each result page that are relevant to the query. Pages are read wi
+      # @param highlights_options [ContextDev::Models::WebSearchParams::HighlightsOptions, nil] 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 markdown_options [ContextDev::Models::WebSearchParams::MarkdownOptions, nil] 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.
       #
@@ -346,7 +346,7 @@ module ContextDev
       #
       # @param country [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country] Fetch from this country (ISO 3166-1 alpha-2).
       #
-      # @param exclude_selectors [Array<String>] Remove matching elements after inclusions. Exclusions take precedence.
+      # @param exclude_selectors [Array<String>, nil] Remove matching elements after inclusions. Exclusions take precedence.
       #
       # @param follow_subdomains [Boolean] When true, follow links on subdomains of the starting URL's domain (e.g. docs.ex
       #
@@ -356,9 +356,9 @@ module ContextDev
       #
       # @param include_links [Boolean] Preserve hyperlinks in the Markdown output
       #
-      # @param include_selectors [Array<String>] Keep matching HTML subtrees before converting each page to Markdown.
+      # @param include_selectors [Array<String>, nil] Keep matching HTML subtrees before converting each page to Markdown.
       #
-      # @param max_age_ms [Integer] Maximum cache age in milliseconds. Defaults to 1 day; `0` fetches fresh.
+      # @param max_age_ms [Integer, nil] Maximum cache age in milliseconds. Defaults to 1 day; `0` fetches fresh.
       #
       # @param max_depth [Integer] Maximum link depth from the starting URL (0 = only the starting page)
       #
@@ -380,7 +380,7 @@ module ContextDev
       #
       # @param use_main_content_only [Boolean] Extract only the main content, stripping headers, footers, sidebars, and navigat
       #
-      # @param wait_for_ms [Integer] Browser wait time in milliseconds after initial page load for each crawled page.
+      # @param wait_for_ms [Integer, nil] Browser wait time in milliseconds after initial page load for each crawled page.
       #
       # @param zdr [Symbol, ContextDev::Models::WebWebCrawlMdParams::Zdr] `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless you
       #

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "2.22.0"
+  VERSION = "2.23.0"
 end

data/rbi/context_dev/models/batch_list_params.rbi

@@ -54,11 +54,12 @@ module ContextDev
       sig { params(status: ContextDev::BatchListParams::Status::OrSymbol).void }
       attr_writer :status
 
-      # Comma-separated list of tags to filter by (matches batches having any of them).
-      sig { returns(T.nilable(String)) }
+      # Tags to filter by (matches batches having any of them). Pass repeated `tags`
+      # params or one comma-separated list, e.g. `tags=docs,competitor`.
+      sig { returns(T.nilable(ContextDev::BatchListParams::Tags::Variants)) }
       attr_reader :tags
 
-      sig { params(tags: String).void }
+      sig { params(tags: ContextDev::BatchListParams::Tags::Variants).void }
       attr_writer :tags
 
       sig do
@@ -68,7 +69,7 @@ module ContextDev
           q: String,
           search_type: ContextDev::BatchListParams::SearchType::OrSymbol,
           status: ContextDev::BatchListParams::Status::OrSymbol,
-          tags: String,
+          tags: ContextDev::BatchListParams::Tags::Variants,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -85,7 +86,8 @@ module ContextDev
         search_type: nil,
         # Filter by status.
         status: nil,
-        # Comma-separated list of tags to filter by (matches batches having any of them).
+        # Tags to filter by (matches batches having any of them). Pass repeated `tags`
+        # params or one comma-separated list, e.g. `tags=docs,competitor`.
         tags: nil,
         request_options: {}
       )
@@ -99,7 +101,7 @@ module ContextDev
             q: String,
             search_type: ContextDev::BatchListParams::SearchType::OrSymbol,
             status: ContextDev::BatchListParams::Status::OrSymbol,
-            tags: String,
+            tags: ContextDev::BatchListParams::Tags::Variants,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -161,6 +163,28 @@ module ContextDev
         def self.values
         end
       end
+
+      # Tags to filter by (matches batches having any of them). Pass repeated `tags`
+      # params or one comma-separated list, e.g. `tags=docs,competitor`.
+      module Tags
+        extend ContextDev::Internal::Type::Union
+
+        Variants = T.type_alias { T.any(String, T::Array[String]) }
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::BatchListParams::Tags::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        StringArray =
+          T.let(
+            ContextDev::Internal::Type::ArrayOf[String],
+            ContextDev::Internal::Type::Converter
+          )
+      end
     end
   end
 end