context.dev 2.17.1 → 2.18.0

data/lib/context_dev/resources/industry.rb

@@ -8,7 +8,7 @@ module ContextDev
       #
       # Classify any brand into 2022 NAICS industry codes from its domain or name.
       #
-      # @overload retrieve_naics(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, request_options: {})
+      # @overload retrieve_naics(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #
       # @param input [String] Brand domain or title to retrieve NAICS code for. If a valid domain is provided,
       #
@@ -20,6 +20,8 @@ module ContextDev
       #
       # @param timeout_opts [ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
+      # @param zdr [Symbol, ContextDev::Models::IndustryRetrieveNaicsParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::IndustryRetrieveNaicsResponse]
@@ -48,7 +50,7 @@ module ContextDev
       # domain or name. Choose between the original SIC system (`original_sic`) or the
       # latest SIC list maintained by the SEC (`latest_sec`).
       #
-      # @overload retrieve_sic(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, type: nil, request_options: {})
+      # @overload retrieve_sic(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, type: nil, zdr: nil, request_options: {})
       #
       # @param input [String] Brand domain or title to retrieve SIC code for. If a valid domain is provided, i
       #
@@ -62,6 +64,8 @@ module ContextDev
       #
       # @param type [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type] Which SIC dataset to classify against. `original_sic` uses the 1987 Standard Ind
       #
+      # @param zdr [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::IndustryRetrieveSicResponse]

data/lib/context_dev/resources/people.rb

@@ -11,7 +11,7 @@ module ContextDev
       # plans. Successful requests cost 20 credits. Disposable and free email addresses
       # (like gmail.com, yahoo.com) will throw a 422 error.
       #
-      # @overload enrich(company: nil, education: nil, email: nil, location: nil, name: nil, social_urls: nil, tags: nil, timeout_opts: nil, request_options: {})
+      # @overload enrich(company: nil, education: nil, email: nil, location: nil, name: nil, social_urls: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #
       # @param company [ContextDev::Models::PersonEnrichParams::Company]
       #
@@ -29,6 +29,8 @@ module ContextDev
       #
       # @param timeout_opts [ContextDev::Models::PersonEnrichParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
+      # @param zdr [Symbol, ContextDev::Models::PersonEnrichParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::PersonEnrichResponse]

data/lib/context_dev/resources/web.rb

@@ -12,7 +12,7 @@ module ContextDev
       # 30 seconds and ultra to 50 seconds; timeoutOpts.milliseconds can shorten either
       # deadline.
       #
-      # @overload answers(task:, json_format: nil, mode: nil, tags: nil, timeout_opts: nil, request_options: {})
+      # @overload answers(task:, json_format: nil, mode: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #
       # @param task [String] What to research and answer, in plain language. Naming a domain in the task (for
       #
@@ -24,6 +24,8 @@ module ContextDev
       #
       # @param timeout_opts [ContextDev::Models::WebAnswersParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
+      # @param zdr [Symbol, ContextDev::Models::WebAnswersParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebAnswersResponse]
@@ -46,7 +48,7 @@ module ContextDev
       # Crawl a website, use the provided JSON Schema and instructions to prioritize
       # relevant internal links, and extract structured data from the selected pages.
       #
-      # @overload extract(schema:, url:, actions: nil, fact_check: nil, follow_subdomains: nil, include_frames: nil, instructions: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, settle_animations: nil, stop_after_ms: nil, tags: nil, timeout_opts: nil, wait_for_ms: nil, request_options: {})
+      # @overload extract(schema:, url:, actions: nil, fact_check: nil, follow_subdomains: nil, include_frames: nil, instructions: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, settle_animations: nil, stop_after_ms: nil, tags: nil, timeout_opts: nil, wait_for_ms: nil, zdr: nil, request_options: {})
       #
       # @param schema [Hash{Symbol=>Object}] JSON Schema for the returned data object. Image fields such as `image_urls` or `
       #
@@ -80,6 +82,8 @@ module ContextDev
       #
       # @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load for each craw
       #
+      # @param zdr [Symbol, ContextDev::Models::WebExtractParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebExtractResponse]
@@ -102,7 +106,7 @@ module ContextDev
       # Analyze a company's landing page and web search evidence to return direct
       # competitors for the same product or market.
       #
-      # @overload extract_competitors(domain:, num_competitors: nil, tags: nil, timeout_opts: nil, request_options: {})
+      # @overload extract_competitors(domain:, num_competitors: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #
       # @param domain [String] Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
       #
@@ -112,6 +116,8 @@ module ContextDev
       #
       # @param timeout_opts [ContextDev::Models::WebExtractCompetitorsParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
+      # @param zdr [Symbol, ContextDev::Models::WebExtractCompetitorsParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebExtractCompetitorsResponse]
@@ -174,7 +180,7 @@ module ContextDev
       # Extract a comprehensive design system from a website including colors,
       # typography, spacing, shadows, and UI components.
       #
-      # @overload extract_styleguide(color_scheme: nil, direct_url: nil, domain: nil, max_age_ms: nil, tags: nil, timeout_opts: nil, request_options: {})
+      # @overload extract_styleguide(color_scheme: nil, direct_url: nil, domain: nil, max_age_ms: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #
       # @param color_scheme [Symbol, ContextDev::Models::WebExtractStyleguideParams::ColorScheme] Optional browser color scheme to emulate for websites that respond to prefers-co
       #
@@ -188,6 +194,8 @@ module ContextDev
       #
       # @param timeout_opts [ContextDev::Models::WebExtractStyleguideParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
+      # @param zdr [Symbol, ContextDev::Models::WebExtractStyleguideParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebExtractStyleguideResponse]
@@ -279,7 +287,7 @@ module ContextDev
       #
       # Search the web and optionally scrape each result to Markdown in one round-trip.
       #
-      # @overload search(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, request_options: {})
+      # @overload search(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: {})
       #
       # @param query [String] Search query. Accepts natural language as well as Google-style search operators
       #
@@ -301,6 +309,8 @@ module ContextDev
       #
       # @param timeout_opts [ContextDev::Models::WebSearchParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
+      # @param zdr [Symbol, ContextDev::Models::WebSearchParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebSearchResponse]
@@ -431,14 +441,18 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebWebScrapeHTMLParams} for more details.
       #
-      # Scrapes the given URL and returns the raw HTML content of the page. The base
-      # request costs 1 credit; requests with browser actions cost 2 credits. A request
-      # that hits its timeoutOpts.milliseconds deadline fails with 408 and is not
-      # billed, unless timeoutOpts.behavior=return-partial is set — then the page as
-      # rendered so far is returned with `finalDOMState: "still-loading"` and billed at
-      # the base cost of 1 credit.
+      # Scrapes the given URL and returns the HTML content of the page. Optional
+      # extractRules return deterministic structured data in extracted using CSS
+      # selectors, attributes, lists, and nested rules, without an LLM or additional
+      # credits. Rules run on the returned HTML after selector and main-content
+      # filtering. Send extractRules as a JSON-encoded query parameter. The base request
+      # costs 1 credit; requests with browser actions cost 2 credits. A request that
+      # hits its timeoutOpts.milliseconds deadline fails with 408 and is not billed,
+      # unless timeoutOpts.behavior=return-partial is set — then the page as rendered so
+      # far is returned with `finalDOMState: "still-loading"` and billed at the base
+      # cost of 1 credit.
       #
-      # @overload web_scrape_html(url:, actions: nil, country: nil, exclude_selectors: nil, headers: nil, include_frames: nil, include_selectors: nil, max_age_ms: nil, pdf: nil, settle_animations: nil, tags: nil, timeout_opts: nil, use_main_content_only: nil, wait_for_ms: nil, zdr: nil, request_options: {})
+      # @overload web_scrape_html(url:, actions: nil, country: nil, exclude_selectors: nil, extract_rules: nil, headers: nil, include_frames: nil, include_selectors: nil, max_age_ms: nil, pdf: nil, settle_animations: nil, tags: nil, timeout_opts: nil, use_main_content_only: nil, wait_for_ms: nil, zdr: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
@@ -448,6 +462,8 @@ module ContextDev
       #
       # @param exclude_selectors [Array<String>, nil] CSS selectors to remove from the result. Applied after includeSelectors. Exclusi
       #
+      # @param extract_rules [Hash{Symbol=>String, ContextDev::Models::WebWebScrapeHTMLParams::ExtractRule::UnionMember1}] Optional CSS extraction rules applied to the returned HTML after selector and ma
+      #
       # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
       #
       # @param include_frames [Boolean] When true, iframes are rendered inline into the returned HTML.
@@ -483,6 +499,7 @@ module ContextDev
           path: "web/scrape/html",
           query: query.transform_keys(
             exclude_selectors: "excludeSelectors",
+            extract_rules: "extractRules",
             include_frames: "includeFrames",
             include_selectors: "includeSelectors",
             max_age_ms: "maxAgeMs",
@@ -505,7 +522,7 @@ module ContextDev
       # enrichment is enabled, the entire call costs 5 credits, including requests that
       # also use actions.
       #
-      # @overload web_scrape_images(url:, actions: nil, dedupe: nil, enrichment: nil, headers: nil, max_age_ms: nil, tags: nil, timeout_opts: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_images(url:, actions: nil, dedupe: nil, enrichment: nil, headers: nil, max_age_ms: nil, tags: nil, timeout_opts: nil, wait_for_ms: nil, zdr: nil, request_options: {})
       #
       # @param url [String] Page URL to inspect. Must include http:// or https://.
       #
@@ -525,6 +542,8 @@ module ContextDev
       #
       # @param wait_for_ms [Integer, nil] Optional browser wait time in milliseconds after initial page load before collec
       #
+      # @param zdr [Symbol, ContextDev::Models::WebWebScrapeImagesParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebWebScrapeImagesResponse]
@@ -649,6 +668,70 @@ module ContextDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebWebScrapeScreenshotParams} for more details.
+      #
+      # Capture the given HTTP or HTTPS URL with configurable viewport, full-page
+      # capture, wait time, popup handling, theme, scroll offset, cache age, country,
+      # and request timeout. Defaults to a 1920x1080 viewport, a 3-second wait, and a
+      # cache age of 1 day. With timeoutOpts.behavior=return-partial, a screenshot of
+      # the page rendered so far may be returned; inspect finalDOMState to identify an
+      # incomplete render. Successful requests cost 1 credit; errors are not billed.
+      #
+      # @overload web_scrape_screenshot(url:, clear_popups: nil, color_scheme: nil, country: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, scroll_offset: nil, tags: nil, timeout_opts: nil, viewport: nil, wait_for_ms: nil, zdr: nil, request_options: {})
+      #
+      # @param url [String]
+      #
+      # @param clear_popups [Boolean] Optional parameter for comprehensive popup cleanup. If 'true', the browser dismi
+      #
+      # @param color_scheme [Symbol, ContextDev::Models::WebWebScrapeScreenshotParams::ColorScheme] Optional parameter to choose the site's visual theme in the screenshot. Use 'lig
+      #
+      # @param country [Symbol, ContextDev::Models::WebWebScrapeScreenshotParams::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
+      #
+      # @param full_screenshot [Symbol, ContextDev::Models::WebWebScrapeScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
+      #
+      # @param handle_cookie_popup [Boolean] Optional parameter to control cookie/consent popup handling. If 'true', we dismi
+      #
+      # @param max_age_ms [Integer, nil] Return a cached screenshot if a prior screenshot for the same parameters exists
+      #
+      # @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 timeout_opts [ContextDev::Models::WebWebScrapeScreenshotParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      #
+      # @param viewport [ContextDev::Models::WebWebScrapeScreenshotParams::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::WebWebScrapeScreenshotParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::WebWebScrapeScreenshotResponse]
+      #
+      # @see ContextDev::Models::WebWebScrapeScreenshotParams
+      def web_scrape_screenshot(params)
+        parsed, options = ContextDev::WebWebScrapeScreenshotParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "web/scrape/screenshot",
+          query: query.transform_keys(
+            clear_popups: "clearPopups",
+            color_scheme: "colorScheme",
+            full_screenshot: "fullScreenshot",
+            handle_cookie_popup: "handleCookiePopup",
+            max_age_ms: "maxAgeMs",
+            scroll_offset: "scrollOffset",
+            timeout_opts: "timeoutOpts",
+            wait_for_ms: "waitForMs"
+          ),
+          model: ContextDev::Models::WebWebScrapeScreenshotResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebWebScrapeSitemapParams} for more details.
       #

data/lib/context_dev/version.rb

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

data/lib/context_dev.rb

@@ -157,6 +157,8 @@ require_relative "context_dev/models/web_web_scrape_images_params"
 require_relative "context_dev/models/web_web_scrape_images_response"
 require_relative "context_dev/models/web_web_scrape_md_params"
 require_relative "context_dev/models/web_web_scrape_md_response"
+require_relative "context_dev/models/web_web_scrape_screenshot_params"
+require_relative "context_dev/models/web_web_scrape_screenshot_response"
 require_relative "context_dev/models/web_web_scrape_sitemap_params"
 require_relative "context_dev/models/web_web_scrape_sitemap_response"
 require_relative "context_dev/models"

data/rbi/context_dev/models/ai_extract_product_params.rbi

@@ -49,12 +49,28 @@ module ContextDev
       end
       attr_writer :timeout_opts
 
+      # 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.
+      sig do
+        returns(T.nilable(ContextDev::AIExtractProductParams::Zdr::OrSymbol))
+      end
+      attr_reader :zdr
+
+      sig do
+        params(zdr: ContextDev::AIExtractProductParams::Zdr::OrSymbol).void
+      end
+      attr_writer :zdr
+
       sig do
         params(
           url: String,
           max_age_ms: Integer,
           tags: T::Array[String],
           timeout_opts: ContextDev::AIExtractProductParams::TimeoutOpts::OrHash,
+          zdr: ContextDev::AIExtractProductParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -71,6 +87,12 @@ module ContextDev
         # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
         # timeoutOpts object.
         timeout_opts: nil,
+        # 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.
+        zdr: nil,
         request_options: {}
       )
       end
@@ -82,6 +104,7 @@ module ContextDev
             max_age_ms: Integer,
             tags: T::Array[String],
             timeout_opts: ContextDev::AIExtractProductParams::TimeoutOpts,
+            zdr: ContextDev::AIExtractProductParams::Zdr::OrSymbol,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -194,6 +217,37 @@ module ContextDev
           end
         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.
+      module Zdr
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::AIExtractProductParams::Zdr)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENABLED =
+          T.let(:enabled, ContextDev::AIExtractProductParams::Zdr::TaggedSymbol)
+        DISABLED =
+          T.let(
+            :disabled,
+            ContextDev::AIExtractProductParams::Zdr::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::AIExtractProductParams::Zdr::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/ai_extract_product_response.rbi

@@ -432,6 +432,30 @@ module ContextDev
         sig { returns(T.nilable(String)) }
         attr_accessor :url
 
+        # Product variations, such as different colors or sizes, with their attributes and
+        # images. Empty if none are found. May not include every variation offered by the
+        # store.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                ContextDev::Models::AIExtractProductResponse::Product::Variant
+              ]
+            )
+          )
+        end
+        attr_reader :variants
+
+        sig do
+          params(
+            variants:
+              T::Array[
+                ContextDev::Models::AIExtractProductResponse::Product::Variant::OrHash
+              ]
+          ).void
+        end
+        attr_writer :variants
+
         # The extracted product data, or null if not a product page
         sig do
           params(
@@ -460,7 +484,11 @@ module ContextDev
                 ContextDev::Models::AIExtractProductResponse::Product::PricingModel::OrSymbol
               ),
             regular_price: T.nilable(Float),
-            url: T.nilable(String)
+            url: T.nilable(String),
+            variants:
+              T::Array[
+                ContextDev::Models::AIExtractProductResponse::Product::Variant::OrHash
+              ]
           ).returns(T.attached_class)
         end
         def self.new(
@@ -497,7 +525,11 @@ module ContextDev
           # Original or regular price before a displayed discount
           regular_price: nil,
           # URL to the product page
-          url: nil
+          url: nil,
+          # Product variations, such as different colors or sizes, with their attributes and
+          # images. Empty if none are found. May not include every variation offered by the
+          # store.
+          variants: nil
         )
         end
 
@@ -529,7 +561,11 @@ module ContextDev
                   ContextDev::Models::AIExtractProductResponse::Product::PricingModel::TaggedSymbol
                 ),
               regular_price: T.nilable(Float),
-              url: T.nilable(String)
+              url: T.nilable(String),
+              variants:
+                T::Array[
+                  ContextDev::Models::AIExtractProductResponse::Product::Variant
+                ]
             }
           )
         end
@@ -690,6 +726,65 @@ module ContextDev
           def self.values
           end
         end
+
+        class Variant < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::AIExtractProductResponse::Product::Variant,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Explicit variant attributes such as color, size, material, pattern and
+          # properties declared by page.
+          sig { returns(T::Hash[Symbol, String]) }
+          attr_accessor :attributes
+
+          # Original source image URLs explicitly attached to this variant.
+          sig { returns(T::Array[String]) }
+          attr_accessor :images
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :sku
+
+          # Variant or offer URL when provided by the source. May be shared by variants.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          sig do
+            params(
+              attributes: T::Hash[Symbol, String],
+              images: T::Array[String],
+              sku: T.nilable(String),
+              url: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Explicit variant attributes such as color, size, material, pattern and
+            # properties declared by page.
+            attributes:,
+            # Original source image URLs explicitly attached to this variant.
+            images:,
+            sku:,
+            # Variant or offer URL when provided by the source. May be shared by variants.
+            url:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                attributes: T::Hash[Symbol, String],
+                images: T::Array[String],
+                sku: T.nilable(String),
+                url: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
       end
     end
   end

data/rbi/context_dev/models/ai_extract_products_response.rbi

@@ -360,6 +360,30 @@ module ContextDev
         sig { returns(T.nilable(String)) }
         attr_accessor :url
 
+        # Product variations, such as different colors or sizes, with their attributes and
+        # images. Empty if none are found. May not include every variation offered by the
+        # store.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                ContextDev::Models::AIExtractProductsResponse::Product::Variant
+              ]
+            )
+          )
+        end
+        attr_reader :variants
+
+        sig do
+          params(
+            variants:
+              T::Array[
+                ContextDev::Models::AIExtractProductsResponse::Product::Variant::OrHash
+              ]
+          ).void
+        end
+        attr_writer :variants
+
         sig do
           params(
             description: String,
@@ -387,7 +411,11 @@ module ContextDev
                 ContextDev::Models::AIExtractProductsResponse::Product::PricingModel::OrSymbol
               ),
             regular_price: T.nilable(Float),
-            url: T.nilable(String)
+            url: T.nilable(String),
+            variants:
+              T::Array[
+                ContextDev::Models::AIExtractProductsResponse::Product::Variant::OrHash
+              ]
           ).returns(T.attached_class)
         end
         def self.new(
@@ -424,7 +452,11 @@ module ContextDev
           # Original or regular price before a displayed discount
           regular_price: nil,
           # URL to the product page
-          url: nil
+          url: nil,
+          # Product variations, such as different colors or sizes, with their attributes and
+          # images. Empty if none are found. May not include every variation offered by the
+          # store.
+          variants: nil
         )
         end
 
@@ -456,7 +488,11 @@ module ContextDev
                   ContextDev::Models::AIExtractProductsResponse::Product::PricingModel::TaggedSymbol
                 ),
               regular_price: T.nilable(Float),
-              url: T.nilable(String)
+              url: T.nilable(String),
+              variants:
+                T::Array[
+                  ContextDev::Models::AIExtractProductsResponse::Product::Variant
+                ]
             }
           )
         end
@@ -617,6 +653,65 @@ module ContextDev
           def self.values
           end
         end
+
+        class Variant < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::AIExtractProductsResponse::Product::Variant,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Explicit variant attributes such as color, size, material, pattern and
+          # properties declared by page.
+          sig { returns(T::Hash[Symbol, String]) }
+          attr_accessor :attributes
+
+          # Original source image URLs explicitly attached to this variant.
+          sig { returns(T::Array[String]) }
+          attr_accessor :images
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :sku
+
+          # Variant or offer URL when provided by the source. May be shared by variants.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          sig do
+            params(
+              attributes: T::Hash[Symbol, String],
+              images: T::Array[String],
+              sku: T.nilable(String),
+              url: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Explicit variant attributes such as color, size, material, pattern and
+            # properties declared by page.
+            attributes:,
+            # Original source image URLs explicitly attached to this variant.
+            images:,
+            sku:,
+            # Variant or offer URL when provided by the source. May be shared by variants.
+            url:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                attributes: T::Hash[Symbol, String],
+                images: T::Array[String],
+                sku: T.nilable(String),
+                url: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
       end
     end
   end