context.dev 2.22.0 → 2.23.0

data/rbi/context_dev/models/parse_handle_params.rbi

@@ -324,15 +324,15 @@ module ContextDev
             )
           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.
         sig { returns(T.nilable(Integer)) }
         attr_reader :end_
 
         sig { params(end_: Integer).void }
         attr_writer :end_
 
-        # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        # First 1-based PDF page to parse.
         sig { returns(T.nilable(Integer)) }
         attr_reader :start
 
@@ -342,10 +342,10 @@ module ContextDev
         # PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
         sig { params(end_: Integer, start: Integer).returns(T.attached_class) }
         def self.new(
-          # 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.
           end_: nil,
-          # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+          # First 1-based PDF page to parse.
           start: nil
         )
         end

data/rbi/context_dev/models/web_scrape_params.rbi

@@ -127,7 +127,7 @@ module ContextDev
       sig { params(tags: T::Array[String]).void }
       attr_writer :tags
 
-      # 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.
       sig { returns(T.nilable(ContextDev::WebScrapeParams::TimeoutOpts)) }
       attr_reader :timeout_opts
@@ -193,7 +193,7 @@ module ContextDev
         shared_params: nil,
         # Labels for tracking request usage. Not retained when zdr is enabled.
         tags: nil,
-        # 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.
         timeout_opts: nil,
         # `enabled` turns on zero data retention. Your organization must have ZDR enabled.
@@ -972,22 +972,22 @@ module ContextDev
             )
           end
 
-        # Use an AI model when the page has no structured product data.
+        # Drop visually duplicate product images, keeping the largest copy.
         sig { returns(T.nilable(T::Boolean)) }
-        attr_reader :use_ai_fallback
+        attr_reader :dedupe_images
 
-        sig { params(use_ai_fallback: T::Boolean).void }
-        attr_writer :use_ai_fallback
+        sig { params(dedupe_images: T::Boolean).void }
+        attr_writer :dedupe_images
 
         # Product options. Requires formats.product: true.
-        sig { params(use_ai_fallback: T::Boolean).returns(T.attached_class) }
+        sig { params(dedupe_images: T::Boolean).returns(T.attached_class) }
         def self.new(
-          # Use an AI model when the page has no structured product data.
-          use_ai_fallback: nil
+          # Drop visually duplicate product images, keeping the largest copy.
+          dedupe_images: nil
         )
         end
 
-        sig { override.returns({ use_ai_fallback: T::Boolean }) }
+        sig { override.returns({ dedupe_images: T::Boolean }) }
         def to_hash
         end
       end
@@ -2146,7 +2146,7 @@ module ContextDev
         end
         attr_writer :behavior
 
-        # 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.
         sig do
           params(

data/rbi/context_dev/models/web_scrape_response.rbi

@@ -351,7 +351,7 @@ module ContextDev
               )
             end
 
-          # Body as base64, after HTTP decompression. Up to 20 MiB decoded.
+          # Body as base64, after HTTP decompression. Up to 50 MiB decoded.
           sig { returns(String) }
           attr_accessor :base64
 
@@ -364,7 +364,7 @@ module ContextDev
             )
           end
           def self.new(
-            # Body as base64, after HTTP decompression. Up to 20 MiB decoded.
+            # Body as base64, after HTTP decompression. Up to 50 MiB decoded.
             base64:,
             content_type:
           )

data/rbi/context_dev/models/web_search_params.rbi

@@ -53,7 +53,7 @@ module ContextDev
       sig do
         params(
           highlights_options:
-            ContextDev::WebSearchParams::HighlightsOptions::OrHash
+            T.nilable(ContextDev::WebSearchParams::HighlightsOptions::OrHash)
         ).void
       end
       attr_writer :highlights_options
@@ -72,7 +72,8 @@ module ContextDev
 
       sig do
         params(
-          markdown_options: ContextDev::WebSearchParams::MarkdownOptions::OrHash
+          markdown_options:
+            T.nilable(ContextDev::WebSearchParams::MarkdownOptions::OrHash)
         ).void
       end
       attr_writer :markdown_options
@@ -124,10 +125,10 @@ module ContextDev
           exclude_domains: T::Array[String],
           freshness: ContextDev::WebSearchParams::Freshness::OrSymbol,
           highlights_options:
-            ContextDev::WebSearchParams::HighlightsOptions::OrHash,
+            T.nilable(ContextDev::WebSearchParams::HighlightsOptions::OrHash),
           include_domains: T::Array[String],
           markdown_options:
-            ContextDev::WebSearchParams::MarkdownOptions::OrHash,
+            T.nilable(ContextDev::WebSearchParams::MarkdownOptions::OrHash),
           num_results: Integer,
           query_fanout: T::Boolean,
           tags: T::Array[String],
@@ -178,9 +179,11 @@ module ContextDev
             country: ContextDev::WebSearchParams::Country::OrSymbol,
             exclude_domains: T::Array[String],
             freshness: ContextDev::WebSearchParams::Freshness::OrSymbol,
-            highlights_options: ContextDev::WebSearchParams::HighlightsOptions,
+            highlights_options:
+              T.nilable(ContextDev::WebSearchParams::HighlightsOptions),
             include_domains: T::Array[String],
-            markdown_options: ContextDev::WebSearchParams::MarkdownOptions,
+            markdown_options:
+              T.nilable(ContextDev::WebSearchParams::MarkdownOptions),
             num_results: Integer,
             query_fanout: T::Boolean,
             tags: T::Array[String],
@@ -576,12 +579,9 @@ module ContextDev
         # only highlights are requested. Explicit values override either default. Maximum:
         # 365 days. Set to 0 to force a fresh scrape.
         sig { returns(T.nilable(Integer)) }
-        attr_reader :max_age_ms
-
-        sig { params(max_age_ms: Integer).void }
-        attr_writer :max_age_ms
+        attr_accessor :max_age_ms
 
-        # 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.
         sig do
           returns(T.nilable(ContextDev::WebSearchParams::MarkdownOptions::Pdf))
         end
@@ -627,10 +627,7 @@ module ContextDev
         # Extra wait after page load before rendering, in ms (0–30000). Useful for
         # JS-heavy pages.
         sig { returns(T.nilable(Integer)) }
-        attr_reader :wait_for_ms
-
-        sig { params(wait_for_ms: Integer).void }
-        attr_writer :wait_for_ms
+        attr_accessor :wait_for_ms
 
         # Inline Markdown scraping for each result. Set `enabled: true` to activate.
         sig do
@@ -639,13 +636,13 @@ module ContextDev
             include_frames: T::Boolean,
             include_images: T::Boolean,
             include_links: T::Boolean,
-            max_age_ms: Integer,
+            max_age_ms: T.nilable(Integer),
             pdf: ContextDev::WebSearchParams::MarkdownOptions::Pdf::OrHash,
             shorten_base64_images: T::Boolean,
             timeout_opts:
               ContextDev::WebSearchParams::MarkdownOptions::TimeoutOpts::OrHash,
             use_main_content_only: T::Boolean,
-            wait_for_ms: Integer
+            wait_for_ms: T.nilable(Integer)
           ).returns(T.attached_class)
         end
         def self.new(
@@ -662,7 +659,7 @@ module ContextDev
           # only highlights are requested. Explicit values override either default. Maximum:
           # 365 days. Set to 0 to force a fresh scrape.
           max_age_ms: nil,
-          # 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.
           pdf: nil,
           # Truncate inline base64 image payloads to keep responses small.
           shorten_base64_images: nil,
@@ -683,13 +680,13 @@ module ContextDev
               include_frames: T::Boolean,
               include_images: T::Boolean,
               include_links: T::Boolean,
-              max_age_ms: Integer,
+              max_age_ms: T.nilable(Integer),
               pdf: ContextDev::WebSearchParams::MarkdownOptions::Pdf,
               shorten_base64_images: T::Boolean,
               timeout_opts:
                 ContextDev::WebSearchParams::MarkdownOptions::TimeoutOpts,
               use_main_content_only: T::Boolean,
-              wait_for_ms: Integer
+              wait_for_ms: T.nilable(Integer)
             }
           )
         end
@@ -720,14 +717,14 @@ module ContextDev
           sig { params(should_parse: T::Boolean).void }
           attr_writer :should_parse
 
-          # First PDF page to parse (1-based, inclusive). Defaults to page 1.
+          # First 1-based PDF page to parse.
           sig { returns(T.nilable(Integer)) }
           attr_reader :start
 
           sig { params(start: Integer).void }
           attr_writer :start
 
-          # 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.
           sig do
             params(
               end_: Integer,
@@ -741,7 +738,7 @@ module ContextDev
             end_: nil,
             # Parse PDF URLs. When false, PDF results are skipped with WEBSITE_ACCESS_ERROR.
             should_parse: nil,
-            # First PDF page to parse (1-based, inclusive). Defaults to page 1.
+            # First 1-based PDF page to parse.
             start: nil
           )
           end

data/rbi/context_dev/models/web_web_crawl_md_params.rbi

@@ -28,10 +28,7 @@ module ContextDev
 
       # Remove matching elements after inclusions. Exclusions take precedence.
       sig { returns(T.nilable(T::Array[String])) }
-      attr_reader :exclude_selectors
-
-      sig { params(exclude_selectors: T::Array[String]).void }
-      attr_writer :exclude_selectors
+      attr_accessor :exclude_selectors
 
       # When true, follow links on subdomains of the starting URL's domain (e.g.
       # docs.example.com when starting from example.com). www and apex are always
@@ -66,17 +63,11 @@ module ContextDev
 
       # Keep matching HTML subtrees before converting each page to Markdown.
       sig { returns(T.nilable(T::Array[String])) }
-      attr_reader :include_selectors
-
-      sig { params(include_selectors: T::Array[String]).void }
-      attr_writer :include_selectors
+      attr_accessor :include_selectors
 
       # Maximum cache age in milliseconds. Defaults to 1 day; `0` fetches fresh.
       sig { returns(T.nilable(Integer)) }
-      attr_reader :max_age_ms
-
-      sig { params(max_age_ms: Integer).void }
-      attr_writer :max_age_ms
+      attr_accessor :max_age_ms
 
       # Maximum link depth from the starting URL (0 = only the starting page)
       sig { returns(T.nilable(Integer)) }
@@ -160,10 +151,7 @@ module ContextDev
       # Browser wait time in milliseconds after initial page load for each crawled page.
       # Defaults to 3500 (3.5 seconds). Min: 0. Max: 30000 (30 seconds).
       sig { returns(T.nilable(Integer)) }
-      attr_reader :wait_for_ms
-
-      sig { params(wait_for_ms: Integer).void }
-      attr_writer :wait_for_ms
+      attr_accessor :wait_for_ms
 
       # `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless
       # your organization has ZDR.
@@ -177,13 +165,13 @@ module ContextDev
         params(
           url: String,
           country: ContextDev::WebWebCrawlMdParams::Country::OrSymbol,
-          exclude_selectors: T::Array[String],
+          exclude_selectors: T.nilable(T::Array[String]),
           follow_subdomains: T::Boolean,
           include_frames: T::Boolean,
           include_images: T::Boolean,
           include_links: T::Boolean,
-          include_selectors: T::Array[String],
-          max_age_ms: Integer,
+          include_selectors: T.nilable(T::Array[String]),
+          max_age_ms: T.nilable(Integer),
           max_depth: Integer,
           max_pages: Integer,
           pdf: ContextDev::WebWebCrawlMdParams::Pdf::OrHash,
@@ -194,7 +182,7 @@ module ContextDev
           timeout_opts: ContextDev::WebWebCrawlMdParams::TimeoutOpts::OrHash,
           url_regex: String,
           use_main_content_only: T::Boolean,
-          wait_for_ms: Integer,
+          wait_for_ms: T.nilable(Integer),
           zdr: ContextDev::WebWebCrawlMdParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -261,13 +249,13 @@ module ContextDev
           {
             url: String,
             country: ContextDev::WebWebCrawlMdParams::Country::OrSymbol,
-            exclude_selectors: T::Array[String],
+            exclude_selectors: T.nilable(T::Array[String]),
             follow_subdomains: T::Boolean,
             include_frames: T::Boolean,
             include_images: T::Boolean,
             include_links: T::Boolean,
-            include_selectors: T::Array[String],
-            max_age_ms: Integer,
+            include_selectors: T.nilable(T::Array[String]),
+            max_age_ms: T.nilable(Integer),
             max_depth: Integer,
             max_pages: Integer,
             pdf: ContextDev::WebWebCrawlMdParams::Pdf,
@@ -278,7 +266,7 @@ module ContextDev
             timeout_opts: ContextDev::WebWebCrawlMdParams::TimeoutOpts,
             url_regex: String,
             use_main_content_only: T::Boolean,
-            wait_for_ms: Integer,
+            wait_for_ms: T.nilable(Integer),
             zdr: ContextDev::WebWebCrawlMdParams::Zdr::OrSymbol,
             request_options: ContextDev::RequestOptions
           }
@@ -520,15 +508,15 @@ module ContextDev
             )
           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.
         sig { returns(T.nilable(Integer)) }
         attr_reader :end_
 
         sig { params(end_: Integer).void }
         attr_writer :end_
 
-        # Read scanned PDF pages with OCR; preserve pages that already contain text.
+        # Read scanned PDF pages with OCR; preserve pages that already have text.
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :ocr
 
@@ -543,7 +531,7 @@ module ContextDev
         sig { params(should_parse: T::Boolean).void }
         attr_writer :should_parse
 
-        # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        # First 1-based PDF page to parse.
         sig { returns(T.nilable(Integer)) }
         attr_reader :start
 
@@ -560,15 +548,15 @@ module ContextDev
           ).returns(T.attached_class)
         end
         def self.new(
-          # 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.
           end_: nil,
-          # Read scanned PDF pages with OCR; preserve pages that already contain text.
+          # Read scanned PDF pages with OCR; preserve pages that already have text.
           ocr: nil,
           # When true, PDF pages are fetched and parsed. When false, PDF pages are skipped
           # entirely (not included in results and not counted as failures).
           should_parse: nil,
-          # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+          # First 1-based PDF page to parse.
           start: nil
         )
         end

data/rbi/context_dev/resources/batch.rbi

@@ -27,7 +27,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(ContextDev::Models::BatchListResponse)
       end
@@ -44,7 +44,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: {}
       )

data/rbi/context_dev/resources/web.rbi

@@ -200,7 +200,7 @@ module ContextDev
         shared_params: nil,
         # Labels for tracking request usage. Not retained when zdr is enabled.
         tags: nil,
-        # 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.
         timeout_opts: nil,
         # `enabled` turns on zero data retention. Your organization must have ZDR enabled.
@@ -313,10 +313,10 @@ module ContextDev
           exclude_domains: T::Array[String],
           freshness: ContextDev::WebSearchParams::Freshness::OrSymbol,
           highlights_options:
-            ContextDev::WebSearchParams::HighlightsOptions::OrHash,
+            T.nilable(ContextDev::WebSearchParams::HighlightsOptions::OrHash),
           include_domains: T::Array[String],
           markdown_options:
-            ContextDev::WebSearchParams::MarkdownOptions::OrHash,
+            T.nilable(ContextDev::WebSearchParams::MarkdownOptions::OrHash),
           num_results: Integer,
           query_fanout: T::Boolean,
           tags: T::Array[String],
@@ -366,13 +366,13 @@ module ContextDev
         params(
           url: String,
           country: ContextDev::WebWebCrawlMdParams::Country::OrSymbol,
-          exclude_selectors: T::Array[String],
+          exclude_selectors: T.nilable(T::Array[String]),
           follow_subdomains: T::Boolean,
           include_frames: T::Boolean,
           include_images: T::Boolean,
           include_links: T::Boolean,
-          include_selectors: T::Array[String],
-          max_age_ms: Integer,
+          include_selectors: T.nilable(T::Array[String]),
+          max_age_ms: T.nilable(Integer),
           max_depth: Integer,
           max_pages: Integer,
           pdf: ContextDev::WebWebCrawlMdParams::Pdf::OrHash,
@@ -383,7 +383,7 @@ module ContextDev
           timeout_opts: ContextDev::WebWebCrawlMdParams::TimeoutOpts::OrHash,
           url_regex: String,
           use_main_content_only: T::Boolean,
-          wait_for_ms: Integer,
+          wait_for_ms: T.nilable(Integer),
           zdr: ContextDev::WebWebCrawlMdParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebCrawlMdResponse)

data/sig/context_dev/models/batch_list_params.rbs

@@ -7,7 +7,7 @@ module ContextDev
         q: String,
         search_type: ContextDev::Models::BatchListParams::search_type,
         status: ContextDev::Models::BatchListParams::status,
-        tags: String
+        tags: ContextDev::Models::BatchListParams::tags
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -39,9 +39,11 @@ module ContextDev
         ContextDev::Models::BatchListParams::status
       ) -> ContextDev::Models::BatchListParams::status
 
-      attr_reader tags: String?
+      attr_reader tags: ContextDev::Models::BatchListParams::tags?
 
-      def tags=: (String) -> String
+      def tags=: (
+        ContextDev::Models::BatchListParams::tags
+      ) -> ContextDev::Models::BatchListParams::tags
 
       def initialize: (
         ?cursor: String,
@@ -49,7 +51,7 @@ module ContextDev
         ?q: String,
         ?search_type: ContextDev::Models::BatchListParams::search_type,
         ?status: ContextDev::Models::BatchListParams::status,
-        ?tags: String,
+        ?tags: ContextDev::Models::BatchListParams::tags,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -59,7 +61,7 @@ module ContextDev
         q: String,
         search_type: ContextDev::Models::BatchListParams::search_type,
         status: ContextDev::Models::BatchListParams::status,
-        tags: String,
+        tags: ContextDev::Models::BatchListParams::tags,
         request_options: ContextDev::RequestOptions
       }
 
@@ -89,6 +91,16 @@ module ContextDev
 
         def self?.values: -> ::Array[ContextDev::Models::BatchListParams::status]
       end
+
+      type tags = String | ::Array[String]
+
+      module Tags
+        extend ContextDev::Internal::Type::Union
+
+        def self?.variants: -> ::Array[ContextDev::Models::BatchListParams::tags]
+
+        StringArray: ContextDev::Internal::Type::Converter
+      end
     end
   end
 end