context.dev 1.8.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 968dddadfbf1199743ee57bc82a47fd2d7b882da416170b13f41bf0574828d5d
-  data.tar.gz: 5e35c5601c635fdc8182a81e5738418f4e4d879231cbaea89b1722ba5f28db00
+  metadata.gz: dd5277f504c21625472d556d7a4151a793e14e4721d603c2304b93fad9668631
+  data.tar.gz: 0c4141a438cd3acee423b2edf10563e58f95bf48ed107c0d4db14871e6f1dd52
 SHA512:
-  metadata.gz: 9ffe4d5dde7376e41afd9607af63fcecd7ab97d8abf26a2adceef1a30594ec54dd10356c731c54dd97ebad44e00eb2d24132ebe27c25a95acfd8a568578557a9
-  data.tar.gz: 2fc80f2bc42e75a0dc03f4c3692f45e6eadce167280695690d69bc408c87eb9504fb557cd661c33041bff9c59876a6f47bbd8ba360b092ab762e70221b79e3ff
+  metadata.gz: 17e11b02edc7b645b530ac42a76635525745050130a62b8cce21e07b11b583638df5063e242f14fd89467b198a79c0df344a3667eecedcaa5cce185cd5d9a28a
+  data.tar.gz: 6839a627ea33e8e1d2f95c260167ed208f327d90d362f771ed609d3986434b3d89b8ddf30d05a5f90b7b6e7fbecff282ba1a0d550dd9ad5bfa8738f7e86383ae

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.10.0 (2026-05-01)
+
+Full Changelog: [v1.9.0...v1.10.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.9.0...v1.10.0)
+
+### Features
+
+* **api:** api update ([c74cbf3](https://github.com/context-dot-dev/context-ruby-sdk/commit/c74cbf354e15c2b56680b4248ed69462a1a84d23))
+* **api:** api update ([cc57672](https://github.com/context-dot-dev/context-ruby-sdk/commit/cc576729ce6c522ee578e7dc5f99122463014515))
+* support setting headers via env ([e625fee](https://github.com/context-dot-dev/context-ruby-sdk/commit/e625fee97a6d4f6ab25f69447b33521cac6a896c))
+
+## 1.9.0 (2026-04-25)
+
+Full Changelog: [v1.8.0...v1.9.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.8.0...v1.9.0)
+
+### Features
+
+* **api:** manual updates ([e1f12de](https://github.com/context-dot-dev/context-ruby-sdk/commit/e1f12de44bcadd047b5746fdddcd828a29107e1e))
+
 ## 1.8.0 (2026-04-24)
 
 Full Changelog: [v1.7.0...v1.8.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.7.0...v1.8.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.8.0"
+gem "context.dev", "~> 1.10.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/client.rb

@@ -70,6 +70,19 @@ module ContextDev
         raise ArgumentError.new("api_key is required, and can be set via environ: \"CONTEXT_DEV_API_KEY\"")
       end
 
+      headers = {}
+      custom_headers_env = ENV["CONTEXT_DEV_CUSTOM_HEADERS"]
+      unless custom_headers_env.nil?
+        parsed = {}
+        custom_headers_env.split("\n").each do |line|
+          colon = line.index(":")
+          unless colon.nil?
+            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
+          end
+        end
+        headers = parsed.merge(headers)
+      end
+
       @api_key = api_key.to_s
 
       super(
@@ -77,7 +90,8 @@ module ContextDev
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        headers: headers
       )
 
       @web = ContextDev::Resources::Web.new(client: self)

data/lib/context_dev/models/ai_extract_product_params.rb

@@ -13,6 +13,14 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!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 7 days (604800000 ms) when
+      #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer, api_name: :maxAgeMs
+
       # @!attribute timeout_ms
       #   Optional timeout in milliseconds for the request. Maximum allowed value is
       #   300000ms (5 minutes).
@@ -20,12 +28,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer, api_name: :timeoutMS
 
-      # @!method initialize(url:, timeout_ms: nil, request_options: {})
+      # @!method initialize(url:, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::AIExtractProductParams} for more details.
       #
       #   @param url [String] The product page URL to extract product data from.
       #
+      #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+      #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]

data/lib/context_dev/models/ai_extract_products_params.rb

@@ -30,6 +30,14 @@ module ContextDev
           #   @return [String]
           required :domain, String
 
+          # @!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 7 days (604800000 ms) when
+          #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          #
+          #   @return [Integer, nil]
+          optional :max_age_ms, Integer, api_name: :maxAgeMs
+
           # @!attribute max_products
           #   Maximum number of products to extract.
           #
@@ -43,12 +51,14 @@ module ContextDev
           #   @return [Integer, nil]
           optional :timeout_ms, Integer, api_name: :timeoutMS
 
-          # @!method initialize(domain:, max_products: nil, timeout_ms: nil)
+          # @!method initialize(domain:, max_age_ms: nil, max_products: nil, timeout_ms: nil)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::AIExtractProductsParams::Body::ByDomain} for more details.
           #
           #   @param domain [String] The domain name to analyze.
           #
+          #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+          #
           #   @param max_products [Integer] Maximum number of products to extract.
           #
           #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
@@ -62,6 +72,14 @@ module ContextDev
           #   @return [String]
           required :direct_url, String, api_name: :directUrl
 
+          # @!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 7 days (604800000 ms) when
+          #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          #
+          #   @return [Integer, nil]
+          optional :max_age_ms, Integer, api_name: :maxAgeMs
+
           # @!attribute max_products
           #   Maximum number of products to extract.
           #
@@ -75,13 +93,15 @@ module ContextDev
           #   @return [Integer, nil]
           optional :timeout_ms, Integer, api_name: :timeoutMS
 
-          # @!method initialize(direct_url:, max_products: nil, timeout_ms: nil)
+          # @!method initialize(direct_url:, max_age_ms: nil, max_products: nil, timeout_ms: nil)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::AIExtractProductsParams::Body::ByDirectURL} for more
           #   details.
           #
           #   @param direct_url [String] A specific URL to use directly as the starting point for extraction without doma
           #
+          #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+          #
           #   @param max_products [Integer] Maximum number of products to extract.
           #
           #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000

data/lib/context_dev/models/industry_retrieve_sic_params.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Industry#retrieve_sic
+    class IndustryRetrieveSicParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute input
+      #   Brand domain or title to retrieve SIC code for. If a valid domain is provided,
+      #   it will be used for classification, otherwise, we will search for the brand
+      #   using the provided title.
+      #
+      #   @return [String]
+      required :input, String
+
+      # @!attribute max_results
+      #   Maximum number of SIC codes to return. Must be between 1 and 10. Defaults to 5.
+      #
+      #   @return [Integer, nil]
+      optional :max_results, Integer
+
+      # @!attribute min_results
+      #   Minimum number of SIC codes to return. Must be at least 1. Defaults to 1.
+      #
+      #   @return [Integer, nil]
+      optional :min_results, Integer
+
+      # @!attribute timeout_ms
+      #   Optional timeout in milliseconds for the request. If the request takes longer
+      #   than this value, it will be aborted with a 408 status code. Maximum allowed
+      #   value is 300000ms (5 minutes).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
+      # @!attribute type
+      #   Which SIC dataset to classify against. `original_sic` uses the 1987 Standard
+      #   Industrial Classification system; `latest_sec` uses the current SIC list as
+      #   published by the SEC. Defaults to `original_sic`.
+      #
+      #   @return [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type, nil]
+      optional :type, enum: -> { ContextDev::IndustryRetrieveSicParams::Type }
+
+      # @!method initialize(input:, max_results: nil, min_results: nil, timeout_ms: nil, type: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::IndustryRetrieveSicParams} for more details.
+      #
+      #   @param input [String] Brand domain or title to retrieve SIC code for. If a valid domain is provided, i
+      #
+      #   @param max_results [Integer] Maximum number of SIC codes to return. Must be between 1 and 10. Defaults to 5.
+      #
+      #   @param min_results [Integer] Minimum number of SIC codes to return. Must be at least 1. Defaults to 1.
+      #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param type [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type] Which SIC dataset to classify against. `original_sic` uses the 1987 Standard Ind
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Which SIC dataset to classify against. `original_sic` uses the 1987 Standard
+      # Industrial Classification system; `latest_sec` uses the current SIC list as
+      # published by the SEC. Defaults to `original_sic`.
+      module Type
+        extend ContextDev::Internal::Type::Enum
+
+        ORIGINAL_SIC = :original_sic
+        LATEST_SEC = :latest_sec
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/context_dev/models/industry_retrieve_sic_response.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Industry#retrieve_sic
+    class IndustryRetrieveSicResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute classification
+      #   Echoes back which SIC dataset was used to classify the brand.
+      #
+      #   @return [Symbol, ContextDev::Models::IndustryRetrieveSicResponse::Classification, nil]
+      optional :classification, enum: -> { ContextDev::Models::IndustryRetrieveSicResponse::Classification }
+
+      # @!attribute codes
+      #   Array of SIC codes with confidence scores. Extra fields depend on the requested
+      #   classification: `original_sic` results include `majorGroup` and
+      #   `majorGroupName`; `latest_sec` results include `office`.
+      #
+      #   @return [Array<ContextDev::Models::IndustryRetrieveSicResponse::Code>, nil]
+      optional :codes,
+               -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::IndustryRetrieveSicResponse::Code] }
+
+      # @!attribute domain
+      #   Domain found for the brand
+      #
+      #   @return [String, nil]
+      optional :domain, String
+
+      # @!attribute status
+      #   Status of the response, e.g., 'ok'
+      #
+      #   @return [String, nil]
+      optional :status, String
+
+      # @!attribute type
+      #   Industry classification type, for sic api it will be `sic`
+      #
+      #   @return [String, nil]
+      optional :type, String
+
+      # @!method initialize(classification: nil, codes: nil, domain: nil, status: nil, type: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::IndustryRetrieveSicResponse} for more details.
+      #
+      #   @param classification [Symbol, ContextDev::Models::IndustryRetrieveSicResponse::Classification] Echoes back which SIC dataset was used to classify the brand.
+      #
+      #   @param codes [Array<ContextDev::Models::IndustryRetrieveSicResponse::Code>] Array of SIC codes with confidence scores. Extra fields depend on the requested
+      #
+      #   @param domain [String] Domain found for the brand
+      #
+      #   @param status [String] Status of the response, e.g., 'ok'
+      #
+      #   @param type [String] Industry classification type, for sic api it will be `sic`
+
+      # Echoes back which SIC dataset was used to classify the brand.
+      #
+      # @see ContextDev::Models::IndustryRetrieveSicResponse#classification
+      module Classification
+        extend ContextDev::Internal::Type::Enum
+
+        ORIGINAL_SIC = :original_sic
+        LATEST_SEC = :latest_sec
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class Code < ContextDev::Internal::Type::BaseModel
+        # @!attribute code
+        #   SIC code (4-digit).
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!attribute confidence
+        #   Confidence level for how well this SIC code matches the company description.
+        #
+        #   @return [Symbol, ContextDev::Models::IndustryRetrieveSicResponse::Code::Confidence]
+        required :confidence, enum: -> { ContextDev::Models::IndustryRetrieveSicResponse::Code::Confidence }
+
+        # @!attribute name
+        #   SIC industry title.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute major_group
+        #   2-digit major group identifier (the leading two digits of the code). Only
+        #   present when `classification` is `original_sic`.
+        #
+        #   @return [String, nil]
+        optional :major_group, String, api_name: :majorGroup
+
+        # @!attribute major_group_name
+        #   Description of the 2-digit major group. Only present when `classification` is
+        #   `original_sic`.
+        #
+        #   @return [String, nil]
+        optional :major_group_name, String, api_name: :majorGroupName
+
+        # @!attribute office
+        #   SEC review office responsible for filings under this code. Only present when
+        #   `classification` is `latest_sec`.
+        #
+        #   @return [String, nil]
+        optional :office, String
+
+        # @!method initialize(code:, confidence:, name:, major_group: nil, major_group_name: nil, office: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::IndustryRetrieveSicResponse::Code} for more details.
+        #
+        #   @param code [String] SIC code (4-digit).
+        #
+        #   @param confidence [Symbol, ContextDev::Models::IndustryRetrieveSicResponse::Code::Confidence] Confidence level for how well this SIC code matches the company description.
+        #
+        #   @param name [String] SIC industry title.
+        #
+        #   @param major_group [String] 2-digit major group identifier (the leading two digits of the code). Only presen
+        #
+        #   @param major_group_name [String] Description of the 2-digit major group. Only present when `classification` is `o
+        #
+        #   @param office [String] SEC review office responsible for filings under this code. Only present when `cl
+
+        # Confidence level for how well this SIC code matches the company description.
+        #
+        # @see ContextDev::Models::IndustryRetrieveSicResponse::Code#confidence
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          HIGH = :high
+          MEDIUM = :medium
+          LOW = :low
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/context_dev/models.rb

@@ -61,6 +61,8 @@ module ContextDev
 
   IndustryRetrieveNaicsParams = ContextDev::Models::IndustryRetrieveNaicsParams
 
+  IndustryRetrieveSicParams = ContextDev::Models::IndustryRetrieveSicParams
+
   UtilityPrefetchByEmailParams = ContextDev::Models::UtilityPrefetchByEmailParams
 
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams

data/lib/context_dev/resources/ai.rb

@@ -39,14 +39,15 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::AIExtractProductParams} for more details.
       #
-      # Beta feature: Given a single URL, determines if it is a product detail page,
-      # classifies the platform/product type, and extracts the product information.
-      # Supports Amazon, TikTok Shop, Etsy, and generic ecommerce sites.
+      # Given a single URL, determines if it is a product page and extracts the product
+      # information.
       #
-      # @overload extract_product(url:, timeout_ms: nil, request_options: {})
+      # @overload extract_product(url:, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #
       # @param url [String] The product page URL to extract product data from.
       #
+      # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+      #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -65,9 +66,9 @@ module ContextDev
         )
       end
 
-      # Beta feature: Extract product information from a brand's website. We will
-      # analyze the website and return a list of products with details such as name,
-      # description, image, pricing, features, and more.
+      # Extract product information from a brand's website. We will analyze the website
+      # and return a list of products with details such as name, description, image,
+      # pricing, features, and more.
       #
       # @overload extract_products(body:, request_options: {})
       #

data/lib/context_dev/resources/industry.rb

@@ -39,6 +39,46 @@ module ContextDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::IndustryRetrieveSicParams} for more details.
+      #
+      # Classify any brand into Standard Industrial Classification (SIC) codes from its
+      # 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, timeout_ms: nil, type: nil, request_options: {})
+      #
+      # @param input [String] Brand domain or title to retrieve SIC code for. If a valid domain is provided, i
+      #
+      # @param max_results [Integer] Maximum number of SIC codes to return. Must be between 1 and 10. Defaults to 5.
+      #
+      # @param min_results [Integer] Minimum number of SIC codes to return. Must be at least 1. Defaults to 1.
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param type [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type] Which SIC dataset to classify against. `original_sic` uses the 1987 Standard Ind
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::IndustryRetrieveSicResponse]
+      #
+      # @see ContextDev::Models::IndustryRetrieveSicParams
+      def retrieve_sic(params)
+        parsed, options = ContextDev::IndustryRetrieveSicParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "web/sic",
+          query: query.transform_keys(
+            max_results: "maxResults",
+            min_results: "minResults",
+            timeout_ms: "timeoutMS"
+          ),
+          model: ContextDev::Models::IndustryRetrieveSicResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [ContextDev::Client]

data/lib/context_dev/resources/utility.rb

@@ -7,9 +7,7 @@ module ContextDev
       # {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
       # Signal that you may fetch brand data for a particular domain soon to improve
-      # latency. This endpoint does not charge credits and is available for paid
-      # customers to optimize future requests. [You must be on a paid plan to use this
-      # endpoint]
+      # latency.
       #
       # @overload prefetch(domain:, timeout_ms: nil, request_options: {})
       #
@@ -39,9 +37,7 @@ module ContextDev
       # Signal that you may fetch brand data for a particular domain soon to improve
       # latency. This endpoint accepts an email address, extracts the domain from it,
       # validates that it's not a disposable or free email provider, and queues the
-      # domain for prefetching. This endpoint does not charge credits and is available
-      # for paid customers to optimize future requests. [You must be on a paid plan to
-      # use this endpoint]
+      # domain for prefetching.
       #
       # @overload prefetch_by_email(email:, timeout_ms: nil, request_options: {})
       #

data/lib/context_dev/version.rb

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

data/lib/context_dev.rb

@@ -74,6 +74,8 @@ require_relative "context_dev/models/brand_retrieve_simplified_params"
 require_relative "context_dev/models/brand_retrieve_simplified_response"
 require_relative "context_dev/models/industry_retrieve_naics_params"
 require_relative "context_dev/models/industry_retrieve_naics_response"
+require_relative "context_dev/models/industry_retrieve_sic_params"
+require_relative "context_dev/models/industry_retrieve_sic_response"
 require_relative "context_dev/models/utility_prefetch_by_email_params"
 require_relative "context_dev/models/utility_prefetch_by_email_response"
 require_relative "context_dev/models/utility_prefetch_params"

data/rbi/context_dev/models/ai_extract_product_params.rbi

@@ -18,6 +18,15 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # Return a cached result if a prior scrape for the same parameters exists and is
+      # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+      # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :max_age_ms
+
+      sig { params(max_age_ms: Integer).void }
+      attr_writer :max_age_ms
+
       # Optional timeout in milliseconds for the request. Maximum allowed value is
       # 300000ms (5 minutes).
       sig { returns(T.nilable(Integer)) }
@@ -29,6 +38,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          max_age_ms: Integer,
           timeout_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -36,6 +46,10 @@ module ContextDev
       def self.new(
         # The product page URL to extract product data from.
         url:,
+        # Return a cached result if a prior scrape for the same parameters exists and is
+        # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+        # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+        max_age_ms: nil,
         # Optional timeout in milliseconds for the request. Maximum allowed value is
         # 300000ms (5 minutes).
         timeout_ms: nil,
@@ -47,6 +61,7 @@ module ContextDev
         override.returns(
           {
             url: String,
+            max_age_ms: Integer,
             timeout_ms: Integer,
             request_options: ContextDev::RequestOptions
           }

data/rbi/context_dev/models/ai_extract_products_params.rbi

@@ -76,6 +76,15 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :domain
 
+          # Return a cached result if a prior scrape for the same parameters exists and is
+          # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+          # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :max_age_ms
+
+          sig { params(max_age_ms: Integer).void }
+          attr_writer :max_age_ms
+
           # Maximum number of products to extract.
           sig { returns(T.nilable(Integer)) }
           attr_reader :max_products
@@ -94,6 +103,7 @@ module ContextDev
           sig do
             params(
               domain: String,
+              max_age_ms: Integer,
               max_products: Integer,
               timeout_ms: Integer
             ).returns(T.attached_class)
@@ -101,6 +111,10 @@ module ContextDev
           def self.new(
             # The domain name to analyze.
             domain:,
+            # Return a cached result if a prior scrape for the same parameters exists and is
+            # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+            # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+            max_age_ms: nil,
             # Maximum number of products to extract.
             max_products: nil,
             # Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -111,7 +125,12 @@ module ContextDev
 
           sig do
             override.returns(
-              { domain: String, max_products: Integer, timeout_ms: Integer }
+              {
+                domain: String,
+                max_age_ms: Integer,
+                max_products: Integer,
+                timeout_ms: Integer
+              }
             )
           end
           def to_hash
@@ -132,6 +151,15 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :direct_url
 
+          # Return a cached result if a prior scrape for the same parameters exists and is
+          # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+          # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :max_age_ms
+
+          sig { params(max_age_ms: Integer).void }
+          attr_writer :max_age_ms
+
           # Maximum number of products to extract.
           sig { returns(T.nilable(Integer)) }
           attr_reader :max_products
@@ -150,6 +178,7 @@ module ContextDev
           sig do
             params(
               direct_url: String,
+              max_age_ms: Integer,
               max_products: Integer,
               timeout_ms: Integer
             ).returns(T.attached_class)
@@ -158,6 +187,10 @@ module ContextDev
             # A specific URL to use directly as the starting point for extraction without
             # domain resolution.
             direct_url:,
+            # Return a cached result if a prior scrape for the same parameters exists and is
+            # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+            # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+            max_age_ms: nil,
             # Maximum number of products to extract.
             max_products: nil,
             # Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -168,7 +201,12 @@ module ContextDev
 
           sig do
             override.returns(
-              { direct_url: String, max_products: Integer, timeout_ms: Integer }
+              {
+                direct_url: String,
+                max_age_ms: Integer,
+                max_products: Integer,
+                timeout_ms: Integer
+              }
             )
           end
           def to_hash