context.dev 2.18.0 → 2.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0f065997a3f6bc987b9ef1486e702f79002addef6662ceeed38107340ff8565
-  data.tar.gz: d22faf02bd6bdc0ad7ba496b99375be03a07eeb2a8753b93aef39ea8733bbd35
+  metadata.gz: 19bc4f2a046f36541d3290c8269b746a16049faa40b7b4d6927b7174abf7e9de
+  data.tar.gz: a7c8c5666908f100105f0327009e1e818e8c8dc2df8bc6456d6b68e2ac30316c
 SHA512:
-  metadata.gz: c626610bd4e3070c60ad4db6c0b0c0eb3f0f8ac0eb1bf10f61e4c5dc740f2f3c40ab829309ecaaf5fe4ed232c9d8683bab6872641ccca935ca3eff5a932b0dcc
-  data.tar.gz: 8089fb01f3a2ba6dfbab55db9fac2ae0ac3d0555f051f6ec7ae5edaf3d9990e80b17d9d9d3b0588d4fa5ada2a073e5aed03caf1faa907e9dcbe717b136a6c16e
+  metadata.gz: b4276f10c86abd47c7c633387aec7307b5db99f8e4f3a48fea4212aad7065d3e842fd8371bf3915ad899f906348d0959d16de12e092c12763c8fe9d4c6031338
+  data.tar.gz: f9223e8de4932b02187fc5df5d2ade222843928c784ac4e7839ed693f0ed8cd7d50f1862f48ae83bc72d8b5486dc126e6e7a03d884f9fb6fe6ef8afbfaf6667b

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # 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)
 
 

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.18.0"
+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/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