context.dev 2.17.1 → 2.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18b47383d0fc922af7bc818a48819c4d702950b89c51f28b6e373b3b6468108b
-  data.tar.gz: e0f57cfa02d05a6b3d6b24956798e52fe21841280ac164b7c53d8980b246ec37
+  metadata.gz: 19bc4f2a046f36541d3290c8269b746a16049faa40b7b4d6927b7174abf7e9de
+  data.tar.gz: a7c8c5666908f100105f0327009e1e818e8c8dc2df8bc6456d6b68e2ac30316c
 SHA512:
-  metadata.gz: 50a79881ad62bece93534a540bd06b18e3618687b81c8f817d95929339769766d7260da3bdb7409be4d42957c5d57818dceafc07fa3495b510d8dfde70af014a
-  data.tar.gz: 6a22ac07b5bebf800443f990c556f1864a41872f5ca08381716702b1cd61a470d22da90a4350dc745e357a1c21959f13bc156d585984ae0b4d7d98124d34cc06
+  metadata.gz: b4276f10c86abd47c7c633387aec7307b5db99f8e4f3a48fea4212aad7065d3e842fd8371bf3915ad899f906348d0959d16de12e092c12763c8fe9d4c6031338
+  data.tar.gz: f9223e8de4932b02187fc5df5d2ade222843928c784ac4e7839ed693f0ed8cd7d50f1862f48ae83bc72d8b5486dc126e6e7a03d884f9fb6fe6ef8afbfaf6667b

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [2.19.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.18.0...v2.19.0) (2026-09-22)
+
+
+### Features
+
+* **billing:** charge for 404s and skip fraud accounting ([#1152](https://github.com/context-dot-dev/context-ruby-sdk/issues/1152)) ([d1fa73e](https://github.com/context-dot-dev/context-ruby-sdk/commit/d1fa73e0809ce7acb5668f413f40b902e539fe72))
+* **scrape:** add cache age support to byte downloads ([#1171](https://github.com/context-dot-dev/context-ruby-sdk/issues/1171)) ([9b2704f](https://github.com/context-dot-dev/context-ruby-sdk/commit/9b2704f21f51249319a1536a535b881769da0864))
+* **scrape:** add unified scrape API ([#1182](https://github.com/context-dot-dev/context-ruby-sdk/issues/1182)) ([f96de1a](https://github.com/context-dot-dev/context-ruby-sdk/commit/f96de1aceca6305f47851701708cba674ed5c30b))
+* **scrape:** align timeout options and public SDK methods ([#1207](https://github.com/context-dot-dev/context-ruby-sdk/issues/1207)) ([f1f8442](https://github.com/context-dot-dev/context-ruby-sdk/commit/f1f84420192e0b686f973187d2efdadd4a1509cd))
+* **scrape:** support country for image scraping ([#1172](https://github.com/context-dot-dev/context-ruby-sdk/issues/1172)) ([9b2704f](https://github.com/context-dot-dev/context-ruby-sdk/commit/9b2704f21f51249319a1536a535b881769da0864))
+* **scrape:** support custom screenshot headers ([#1169](https://github.com/context-dot-dev/context-ruby-sdk/issues/1169)) ([ea364f2](https://github.com/context-dot-dev/context-ruby-sdk/commit/ea364f242b9120982ee69006305a1929464d4dfe))
+* **scrape:** support waitForMs for byte downloads ([#1170](https://github.com/context-dot-dev/context-ruby-sdk/issues/1170)) ([267301b](https://github.com/context-dot-dev/context-ruby-sdk/commit/267301b3da971db51c63102242ed0dece4ba6630))
+
+
+### Bug Fixes
+
+* **scrape:** reuse legacy caches across all output formats ([#1197](https://github.com/context-dot-dev/context-ruby-sdk/issues/1197)) ([007ad3f](https://github.com/context-dot-dev/context-ruby-sdk/commit/007ad3f81ba753e74093d5ee05dfe8df2db06be9))
+
+## [2.18.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.17.1...v2.18.0) (2026-09-18)
+
+
+### Features
+
+* **api:** enable ZDR on remaining AI endpoints via OpenAI ([#1099](https://github.com/context-dot-dev/context-ruby-sdk/issues/1099)) ([36e5487](https://github.com/context-dot-dev/context-ruby-sdk/commit/36e548724224b3198e49d248735916f3af6d1b61))
+* **products:** extract ProductGroup variants with images ([#1124](https://github.com/context-dot-dev/context-ruby-sdk/issues/1124)) ([dd14116](https://github.com/context-dot-dev/context-ruby-sdk/commit/dd141167200666c0bbb658f9a83ffa8896411aae))
+* **scrape:** add CSS extraction rules to HTML scraping ([#1146](https://github.com/context-dot-dev/context-ruby-sdk/issues/1146)) ([4ed406d](https://github.com/context-dot-dev/context-ruby-sdk/commit/4ed406dfa5bf0dd2ad8e6652fb85ef9ebe37ff07))
+* **web:** add URL-based scrape screenshot endpoint ([#1150](https://github.com/context-dot-dev/context-ruby-sdk/issues/1150)) ([52c8043](https://github.com/context-dot-dev/context-ruby-sdk/commit/52c80435c9c767bdb6ff782c487ada1263d9f767))
+
+
+### Bug Fixes
+
+* **api:** lower partial scrape timeout minimum to five seconds ([#1118](https://github.com/context-dot-dev/context-ruby-sdk/issues/1118)) ([871982b](https://github.com/context-dot-dev/context-ruby-sdk/commit/871982bff814f9cb698fc59f1e07c2d87c5a6dad))
+
 ## [2.17.1](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.17.0...v2.17.1) (2026-09-15)
 
 

data/README.md

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

data/lib/context_dev/client.rb

@@ -24,9 +24,6 @@ module ContextDev
     # @return [ContextDev::Resources::Web]
     attr_reader :web
 
-    # @return [ContextDev::Resources::AI]
-    attr_reader :ai
-
     # @return [ContextDev::Resources::Brand]
     attr_reader :brand
 
@@ -125,7 +122,6 @@ module ContextDev
 
       @parse = ContextDev::Resources::Parse.new(client: self)
       @web = ContextDev::Resources::Web.new(client: self)
-      @ai = ContextDev::Resources::AI.new(client: self)
       @brand = ContextDev::Resources::Brand.new(client: self)
       @industry = ContextDev::Resources::Industry.new(client: self)
       @utility = ContextDev::Resources::Utility.new(client: self)

data/lib/context_dev/models/industry_retrieve_naics_params.rb

@@ -43,7 +43,17 @@ module ContextDev
       #   @return [ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts, nil]
       optional :timeout_opts, -> { ContextDev::IndustryRetrieveNaicsParams::TimeoutOpts }
 
-      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, request_options: {})
+      # @!attribute zdr
+      #   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.
+      #
+      #   @return [Symbol, ContextDev::Models::IndustryRetrieveNaicsParams::Zdr, nil]
+      optional :zdr, enum: -> { ContextDev::IndustryRetrieveNaicsParams::Zdr }
+
+      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::IndustryRetrieveNaicsParams} for more details.
       #
@@ -57,6 +67,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}]
 
       class TimeoutOpts < ContextDev::Internal::Type::BaseModel
@@ -103,6 +115,21 @@ module ContextDev
           #   @return [Array<Symbol>]
         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
+
+        ENABLED = :enabled
+        DISABLED = :disabled
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/context_dev/models/industry_retrieve_sic_params.rb

@@ -50,7 +50,17 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type, nil]
       optional :type, enum: -> { ContextDev::IndustryRetrieveSicParams::Type }
 
-      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, type: nil, request_options: {})
+      # @!attribute zdr
+      #   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.
+      #
+      #   @return [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Zdr, nil]
+      optional :zdr, enum: -> { ContextDev::IndustryRetrieveSicParams::Zdr }
+
+      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, type: nil, zdr: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::IndustryRetrieveSicParams} for more details.
       #
@@ -66,6 +76,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}]
 
       class TimeoutOpts < ContextDev::Internal::Type::BaseModel
@@ -125,6 +137,21 @@ module ContextDev
         # @!method self.values
         #   @return [Array<Symbol>]
       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
+
+        ENABLED = :enabled
+        DISABLED = :disabled
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/context_dev/models/monitor_retrieve_run_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Monitors#retrieve_run
+    class MonitorRetrieveRunParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute monitor_id
+      #
+      #   @return [String]
+      required :monitor_id, String
+
+      # @!attribute run_id
+      #
+      #   @return [String]
+      required :run_id, String
+
+      # @!method initialize(monitor_id:, run_id:, request_options: {})
+      #   @param monitor_id [String]
+      #   @param run_id [String]
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/context_dev/models/monitor_retrieve_run_response.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Monitors#retrieve_run
+    class MonitorRetrieveRunResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute baseline_created
+      #   True when this run established the monitor's initial baseline; baseline runs
+      #   perform no change detection.
+      #
+      #   @return [Boolean]
+      required :baseline_created, ContextDev::Internal::Type::Boolean
+
+      # @!attribute change_detected
+      #
+      #   @return [Boolean]
+      required :change_detected, ContextDev::Internal::Type::Boolean
+
+      # @!attribute change_detection_type
+      #
+      #   @return [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::ChangeDetectionType]
+      required :change_detection_type,
+               enum: -> { ContextDev::Models::MonitorRetrieveRunResponse::ChangeDetectionType }
+
+      # @!attribute credits_charged
+      #   Credits charged for this run (0 for skipped/failed runs).
+      #
+      #   @return [Integer]
+      required :credits_charged, Integer
+
+      # @!attribute monitor_id
+      #
+      #   @return [String]
+      required :monitor_id, String
+
+      # @!attribute run_type
+      #   The first run after monitor creation is a baseline run.
+      #
+      #   @return [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::RunType]
+      required :run_type, enum: -> { ContextDev::Models::MonitorRetrieveRunResponse::RunType }
+
+      # @!attribute status
+      #   Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
+      #   (insufficient credits, monitor paused, or superseded by a concurrent run).
+      #
+      #   @return [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::Status]
+      required :status, enum: -> { ContextDev::Models::MonitorRetrieveRunResponse::Status }
+
+      # @!attribute target_type
+      #
+      #   @return [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::TargetType]
+      required :target_type, enum: -> { ContextDev::Models::MonitorRetrieveRunResponse::TargetType }
+
+      # @!attribute change_id
+      #
+      #   @return [String, nil]
+      optional :change_id, String, nil?: true
+
+      # @!attribute completed_at
+      #
+      #   @return [Time, nil]
+      optional :completed_at, Time, nil?: true
+
+      # @!attribute error
+      #
+      #   @return [ContextDev::Models::MonitorRetrieveRunResponse::Error, nil]
+      optional :error, -> { ContextDev::Models::MonitorRetrieveRunResponse::Error }, nil?: true
+
+      # @!attribute skip_reason
+      #   Why a skipped run never executed; null unless status is `skipped`.
+      #
+      #   @return [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::SkipReason, nil]
+      optional :skip_reason, enum: -> { ContextDev::Models::MonitorRetrieveRunResponse::SkipReason }, nil?: true
+
+      # @!attribute started_at
+      #
+      #   @return [Time, nil]
+      optional :started_at, Time, nil?: true
+
+      # @!attribute webhook_deliveries
+      #   All webhook deliveries attempted by this run — one per subscribed event that
+      #   fired. Omitted when no webhook was attempted, including runs created before
+      #   event selection was added.
+      #
+      #   @return [Array<ContextDev::Models::WebhookDelivery>, nil]
+      optional :webhook_deliveries, -> { ContextDev::Internal::Type::ArrayOf[ContextDev::WebhookDelivery] }
+
+      # @!attribute webhook_delivery
+      #   @deprecated
+      #
+      #   Deprecated: use `webhook_deliveries`, which records every attempt now that a run
+      #   can deliver multiple events. Omitted when no webhook was attempted, including
+      #   historical runs created before delivery tracking was added.
+      #
+      #   @return [ContextDev::Models::WebhookDelivery, nil]
+      optional :webhook_delivery, -> { ContextDev::WebhookDelivery }
+
+      # @!attribute webhook_delivery_ids
+      #   Webhook delivery IDs for this run.
+      #
+      #   @return [Array<String>, nil]
+      optional :webhook_delivery_ids, ContextDev::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(id:, baseline_created:, change_detected:, change_detection_type:, credits_charged:, monitor_id:, run_type:, status:, target_type:, change_id: nil, completed_at: nil, error: nil, skip_reason: nil, started_at: nil, webhook_deliveries: nil, webhook_delivery: nil, webhook_delivery_ids: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::MonitorRetrieveRunResponse} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param baseline_created [Boolean] True when this run established the monitor's initial baseline; baseline runs per
+      #
+      #   @param change_detected [Boolean]
+      #
+      #   @param change_detection_type [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::ChangeDetectionType]
+      #
+      #   @param credits_charged [Integer] Credits charged for this run (0 for skipped/failed runs).
+      #
+      #   @param monitor_id [String]
+      #
+      #   @param run_type [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::RunType] The first run after monitor creation is a baseline run.
+      #
+      #   @param status [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      #
+      #   @param target_type [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::TargetType]
+      #
+      #   @param change_id [String, nil]
+      #
+      #   @param completed_at [Time, nil]
+      #
+      #   @param error [ContextDev::Models::MonitorRetrieveRunResponse::Error, nil]
+      #
+      #   @param skip_reason [Symbol, ContextDev::Models::MonitorRetrieveRunResponse::SkipReason, nil] Why a skipped run never executed; null unless status is `skipped`.
+      #
+      #   @param started_at [Time, nil]
+      #
+      #   @param webhook_deliveries [Array<ContextDev::Models::WebhookDelivery>] All webhook deliveries attempted by this run — one per subscribed event that fir
+      #
+      #   @param webhook_delivery [ContextDev::Models::WebhookDelivery] Deprecated: use `webhook_deliveries`, which records every attempt now that a run
+      #
+      #   @param webhook_delivery_ids [Array<String>] Webhook delivery IDs for this run.
+
+      # @see ContextDev::Models::MonitorRetrieveRunResponse#change_detection_type
+      module ChangeDetectionType
+        extend ContextDev::Internal::Type::Enum
+
+        EXACT = :exact
+        SEMANTIC = :semantic
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The first run after monitor creation is a baseline run.
+      #
+      # @see ContextDev::Models::MonitorRetrieveRunResponse#run_type
+      module RunType
+        extend ContextDev::Internal::Type::Enum
+
+        BASELINE = :baseline
+        SCHEDULED = :scheduled
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
+      # (insufficient credits, monitor paused, or superseded by a concurrent run).
+      #
+      # @see ContextDev::Models::MonitorRetrieveRunResponse#status
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        QUEUED = :queued
+        RUNNING = :running
+        COMPLETED = :completed
+        FAILED = :failed
+        SKIPPED = :skipped
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see ContextDev::Models::MonitorRetrieveRunResponse#target_type
+      module TargetType
+        extend ContextDev::Internal::Type::Enum
+
+        PAGE = :page
+        SITEMAP = :sitemap
+        EXTRACT = :extract
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see ContextDev::Models::MonitorRetrieveRunResponse#error
+      class Error < ContextDev::Internal::Type::BaseModel
+        # @!attribute code
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!attribute message
+        #
+        #   @return [String]
+        required :message, String
+
+        # @!method initialize(code:, message:)
+        #   @param code [String]
+        #   @param message [String]
+      end
+
+      # Why a skipped run never executed; null unless status is `skipped`.
+      #
+      # @see ContextDev::Models::MonitorRetrieveRunResponse#skip_reason
+      module SkipReason
+        extend ContextDev::Internal::Type::Enum
+
+        INSUFFICIENT_CREDITS = :insufficient_credits
+        MONITOR_PAUSED = :monitor_paused
+        SUPERSEDED = :superseded
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/context_dev/models/monitor_rotate_webhook_secret_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Monitors#rotate_webhook_secret
+    class MonitorRotateWebhookSecretParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute monitor_id
+      #
+      #   @return [String]
+      required :monitor_id, String
+
+      # @!method initialize(monitor_id:, request_options: {})
+      #   @param monitor_id [String]
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end