context.dev 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25638d74c398495cbef201fdc8903b11a2e392ca235856c22af7281dadb1fcc2
-  data.tar.gz: 1c0ca0f9323f6a4a16e050a9dcd80298e70d07db776b4d3876c8c3bb359d0b0f
+  metadata.gz: 71a15fd21461c08a07aee8a7a0b03646393d119834f5977c703fa504a3fef780
+  data.tar.gz: cb91bfce1cc1e42798249e1a08001bbdf881ef37c0c9832783d7e511e721bd58
 SHA512:
-  metadata.gz: 6e9ef0f156d49e0c907e8db8fcf8e5e2fe2986b83bbc92e84039664f7c6733ed719df0aa82a582af2a05046ee36a3c4e980ad6d6bd0bd64f3a887fa63237beb9
-  data.tar.gz: 25fd60ebb92056db2ba5efaf793396255ed1661a69b3ae94d1683634294d575f364e0135592e23e8ff23c57482adcce67b35a72895e8058630941c468c35247f
+  metadata.gz: 3720fb3277c71cf83c1b01867e7cfb956e4b0588e421c23b5ef36fb7c715c5d4a94678e3de49ec83ab268628b1fccfa3b1f526f6a08ba459c213292930ebbe41
+  data.tar.gz: 60494a702cba70b719ef8e83f4d410d3e4a59af67cb0d0e478b7061646ba87702605505d8c09c311b8dd8d2fdd8bd60caf684a17904229291fcc1e29b9696e02

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.2.0 (2026-07-10)
+
+Full Changelog: [v2.1.0...v2.2.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.1.0...v2.2.0)
+
+### Features
+
+* **api:** api update ([04e3709](https://github.com/context-dot-dev/context-ruby-sdk/commit/04e370916ae9679892d86fc297e3c935afa1e2c2))
+* **api:** api update ([59b7e62](https://github.com/context-dot-dev/context-ruby-sdk/commit/59b7e62e57eff7482db12fe2dd1a97298620b88f))
+
 ## 2.1.0 (2026-07-08)
 
 Full Changelog: [v2.0.0...v2.1.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.0.0...v2.1.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", "~> 2.1.0"
+gem "context.dev", "~> 2.2.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/monitor_create_params.rb

@@ -79,7 +79,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::MonitorCreateParams::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
         variant :semantic, -> { ContextDev::MonitorCreateParams::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -107,9 +107,9 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to the extracted data, ignoring cosmetic or
-          #   paraphrase-only differences. What is watched is determined by the extract
-          #   target's `schema` and `instructions`.
+          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
+          #   paraphrase-only differences. Which changes are meaningful is judged against the
+          #   extract target's `instructions` (and `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -187,7 +187,7 @@ module ContextDev
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
         variant :sitemap, -> { ContextDev::MonitorCreateParams::Target::Sitemap }
 
-        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
         variant :extract, -> { ContextDev::MonitorCreateParams::Target::Extract }
 
         class Page < ContextDev::Internal::Type::BaseModel
@@ -302,9 +302,14 @@ module ContextDev
           optional :max_pages, Integer
 
           # @!attribute schema
-          #   JSON Schema describing the data you care about. It guides which pages are
-          #   selected for tracking and gives the change judge context on what matters. If
-          #   omitted, a default summary + key-points schema is used.
+          #   JSON Schema describing the data you care about. It is used three ways: it guides
+          #   which pages are selected for tracking, it gives the change judge extra context
+          #   on which changes matter (alongside `instructions`), and it defines the shape of
+          #   the baseline `data` snapshot on GET /monitors/{monitor_id} (refreshed at most
+          #   about once a day). It is not a response format for changes: change events and
+          #   webhook payloads always contain diffs, summaries, and evidence excerpts — never
+          #   data in this schema's shape. If omitted, a default summary + key-points schema
+          #   is used.
           #
           #   @return [Hash{Symbol=>Object}, nil]
           optional :schema, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
@@ -316,8 +321,8 @@ module ContextDev
           #   Watch the monitor-relevant pages of a site for meaningful changes. A crawl
           #   guided by `schema`/`instructions` selects up to `max_pages` relevant pages to
           #   track; each run re-checks exactly those pages, and confirmed content changes are
-          #   judged against the monitor's instructions. The tracked page set is refreshed by
-          #   a periodic re-discovery crawl.
+          #   judged for relevance against the monitor's `instructions` (and `schema`, when
+          #   provided). The tracked page set is refreshed by a periodic re-discovery crawl.
           #
           #   @param instructions [String] Natural-language instructions guiding which pages and facts to track and which c
           #
@@ -329,7 +334,7 @@ module ContextDev
           #
           #   @param max_pages [Integer] Maximum number of pages to track.
           #
-          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It guides which pages are select
+          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It is used three ways: it guides
           #
           #   @param type [Symbol, :extract]
         end

data/lib/context_dev/models/monitor_create_response.rb

@@ -153,7 +153,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::Models::MonitorCreateResponse::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
         variant :semantic, -> { ContextDev::Models::MonitorCreateResponse::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -181,9 +181,9 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to the extracted data, ignoring cosmetic or
-          #   paraphrase-only differences. What is watched is determined by the extract
-          #   target's `schema` and `instructions`.
+          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
+          #   paraphrase-only differences. Which changes are meaningful is judged against the
+          #   extract target's `instructions` (and `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -295,7 +295,7 @@ module ContextDev
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
         variant :sitemap, -> { ContextDev::Models::MonitorCreateResponse::Target::Sitemap }
 
-        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
         variant :extract, -> { ContextDev::Models::MonitorCreateResponse::Target::Extract }
 
         class Page < ContextDev::Internal::Type::BaseModel
@@ -410,9 +410,14 @@ module ContextDev
           optional :max_pages, Integer
 
           # @!attribute schema
-          #   JSON Schema describing the data you care about. It guides which pages are
-          #   selected for tracking and gives the change judge context on what matters. If
-          #   omitted, a default summary + key-points schema is used.
+          #   JSON Schema describing the data you care about. It is used three ways: it guides
+          #   which pages are selected for tracking, it gives the change judge extra context
+          #   on which changes matter (alongside `instructions`), and it defines the shape of
+          #   the baseline `data` snapshot on GET /monitors/{monitor_id} (refreshed at most
+          #   about once a day). It is not a response format for changes: change events and
+          #   webhook payloads always contain diffs, summaries, and evidence excerpts — never
+          #   data in this schema's shape. If omitted, a default summary + key-points schema
+          #   is used.
           #
           #   @return [Hash{Symbol=>Object}, nil]
           optional :schema, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
@@ -424,8 +429,8 @@ module ContextDev
           #   Watch the monitor-relevant pages of a site for meaningful changes. A crawl
           #   guided by `schema`/`instructions` selects up to `max_pages` relevant pages to
           #   track; each run re-checks exactly those pages, and confirmed content changes are
-          #   judged against the monitor's instructions. The tracked page set is refreshed by
-          #   a periodic re-discovery crawl.
+          #   judged for relevance against the monitor's `instructions` (and `schema`, when
+          #   provided). The tracked page set is refreshed by a periodic re-discovery crawl.
           #
           #   @param instructions [String] Natural-language instructions guiding which pages and facts to track and which c
           #
@@ -437,7 +442,7 @@ module ContextDev
           #
           #   @param max_pages [Integer] Maximum number of pages to track.
           #
-          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It guides which pages are select
+          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It is used three ways: it guides
           #
           #   @param type [Symbol, :extract]
         end

data/lib/context_dev/models/monitor_list_account_runs_response.rb

@@ -106,7 +106,16 @@ module ContextDev
         #   @return [Time, nil]
         optional :started_at, Time, nil?: true
 
-        # @!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)
+        # @!attribute webhook_delivery
+        #   The webhook delivery attempted for a change detected by this run. Omitted when
+        #   no webhook was attempted, including historical runs created before delivery
+        #   tracking was added.
+        #
+        #   @return [ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery, nil]
+        optional :webhook_delivery,
+                 -> { ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery }
+
+        # @!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_delivery: nil)
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorListAccountRunsResponse::Data} for more details.
         #
@@ -137,6 +146,8 @@ module ContextDev
         #   @param skip_reason [Symbol, ContextDev::Models::MonitorListAccountRunsResponse::Data::SkipReason, nil] Why a skipped run never executed; null unless status is `skipped`.
         #
         #   @param started_at [Time, nil]
+        #
+        #   @param webhook_delivery [ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery] The webhook delivery attempted for a change detected by this run. Omitted when n
 
         # @see ContextDev::Models::MonitorListAccountRunsResponse::Data#change_detection_type
         module ChangeDetectionType
@@ -221,6 +232,96 @@ module ContextDev
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # @see ContextDev::Models::MonitorListAccountRunsResponse::Data#webhook_delivery
+        class WebhookDelivery < ContextDev::Internal::Type::BaseModel
+          # @!attribute attempted_at
+          #
+          #   @return [Time]
+          required :attempted_at, Time
+
+          # @!attribute error
+          #
+          #   @return [ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Error, nil]
+          required :error,
+                   -> { ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Error },
+                   nil?: true
+
+          # @!attribute event_id
+          #   Identifier sent in the X-Context-Id header.
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute http_status
+          #   The endpoint's final HTTP response status, or null when no response was
+          #   received.
+          #
+          #   @return [Integer, nil]
+          required :http_status, Integer, nil?: true
+
+          # @!attribute status
+          #   Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+          #   response; failed means no HTTP response was received; skipped_unsafe_url means
+          #   the URL failed the public-endpoint safety check.
+          #
+          #   @return [Symbol, ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status]
+          required :status,
+                   enum: -> { ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status }
+
+          # @!method initialize(attempted_at:, error:, event_id:, http_status:, status:)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery} for
+          #   more details.
+          #
+          #   The webhook delivery attempted for a change detected by this run. Omitted when
+          #   no webhook was attempted, including historical runs created before delivery
+          #   tracking was added.
+          #
+          #   @param attempted_at [Time]
+          #
+          #   @param error [ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Error, nil]
+          #
+          #   @param event_id [String] Identifier sent in the X-Context-Id header.
+          #
+          #   @param http_status [Integer, nil] The endpoint's final HTTP response status, or null when no response was received
+          #
+          #   @param status [Symbol, ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status] Delivery outcome. delivered means any 2xx response; rejected means a non-2xx res
+
+          # @see ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery#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
+
+          # Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+          # response; failed means no HTTP response was received; skipped_unsafe_url means
+          # the URL failed the public-endpoint safety check.
+          #
+          # @see ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery#status
+          module Status
+            extend ContextDev::Internal::Type::Enum
+
+            DELIVERED = :delivered
+            REJECTED = :rejected
+            FAILED = :failed
+            SKIPPED_UNSAFE_URL = :skipped_unsafe_url
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

data/lib/context_dev/models/monitor_list_response.rb

@@ -174,7 +174,7 @@ module ContextDev
           # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
           variant :exact, -> { ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Exact }
 
-          # Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+          # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
           variant :semantic, -> { ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic }
 
           class Exact < ContextDev::Internal::Type::BaseModel
@@ -202,9 +202,9 @@ module ContextDev
             optional :confidence_threshold, Float
 
             # @!method initialize(confidence_threshold: nil, type: :semantic)
-            #   Detect meaning-level changes to the extracted data, ignoring cosmetic or
-            #   paraphrase-only differences. What is watched is determined by the extract
-            #   target's `schema` and `instructions`.
+            #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
+            #   paraphrase-only differences. Which changes are meaningful is judged against the
+            #   extract target's `instructions` (and `schema`, when provided).
             #
             #   @param confidence_threshold [Float]
             #   @param type [Symbol, :semantic]
@@ -316,7 +316,7 @@ module ContextDev
           # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
           variant :sitemap, -> { ContextDev::Models::MonitorListResponse::Data::Target::Sitemap }
 
-          # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+          # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
           variant :extract, -> { ContextDev::Models::MonitorListResponse::Data::Target::Extract }
 
           class Page < ContextDev::Internal::Type::BaseModel
@@ -431,9 +431,14 @@ module ContextDev
             optional :max_pages, Integer
 
             # @!attribute schema
-            #   JSON Schema describing the data you care about. It guides which pages are
-            #   selected for tracking and gives the change judge context on what matters. If
-            #   omitted, a default summary + key-points schema is used.
+            #   JSON Schema describing the data you care about. It is used three ways: it guides
+            #   which pages are selected for tracking, it gives the change judge extra context
+            #   on which changes matter (alongside `instructions`), and it defines the shape of
+            #   the baseline `data` snapshot on GET /monitors/{monitor_id} (refreshed at most
+            #   about once a day). It is not a response format for changes: change events and
+            #   webhook payloads always contain diffs, summaries, and evidence excerpts — never
+            #   data in this schema's shape. If omitted, a default summary + key-points schema
+            #   is used.
             #
             #   @return [Hash{Symbol=>Object}, nil]
             optional :schema, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
@@ -446,8 +451,8 @@ module ContextDev
             #   Watch the monitor-relevant pages of a site for meaningful changes. A crawl
             #   guided by `schema`/`instructions` selects up to `max_pages` relevant pages to
             #   track; each run re-checks exactly those pages, and confirmed content changes are
-            #   judged against the monitor's instructions. The tracked page set is refreshed by
-            #   a periodic re-discovery crawl.
+            #   judged for relevance against the monitor's `instructions` (and `schema`, when
+            #   provided). The tracked page set is refreshed by a periodic re-discovery crawl.
             #
             #   @param instructions [String] Natural-language instructions guiding which pages and facts to track and which c
             #
@@ -459,7 +464,7 @@ module ContextDev
             #
             #   @param max_pages [Integer] Maximum number of pages to track.
             #
-            #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It guides which pages are select
+            #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It is used three ways: it guides
             #
             #   @param type [Symbol, :extract]
           end

data/lib/context_dev/models/monitor_list_runs_response.rb

@@ -106,7 +106,15 @@ module ContextDev
         #   @return [Time, nil]
         optional :started_at, Time, nil?: true
 
-        # @!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)
+        # @!attribute webhook_delivery
+        #   The webhook delivery attempted for a change detected by this run. Omitted when
+        #   no webhook was attempted, including historical runs created before delivery
+        #   tracking was added.
+        #
+        #   @return [ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery, nil]
+        optional :webhook_delivery, -> { ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery }
+
+        # @!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_delivery: nil)
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorListRunsResponse::Data} for more details.
         #
@@ -137,6 +145,8 @@ module ContextDev
         #   @param skip_reason [Symbol, ContextDev::Models::MonitorListRunsResponse::Data::SkipReason, nil] Why a skipped run never executed; null unless status is `skipped`.
         #
         #   @param started_at [Time, nil]
+        #
+        #   @param webhook_delivery [ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery] The webhook delivery attempted for a change detected by this run. Omitted when n
 
         # @see ContextDev::Models::MonitorListRunsResponse::Data#change_detection_type
         module ChangeDetectionType
@@ -221,6 +231,95 @@ module ContextDev
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # @see ContextDev::Models::MonitorListRunsResponse::Data#webhook_delivery
+        class WebhookDelivery < ContextDev::Internal::Type::BaseModel
+          # @!attribute attempted_at
+          #
+          #   @return [Time]
+          required :attempted_at, Time
+
+          # @!attribute error
+          #
+          #   @return [ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error, nil]
+          required :error,
+                   -> { ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error },
+                   nil?: true
+
+          # @!attribute event_id
+          #   Identifier sent in the X-Context-Id header.
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute http_status
+          #   The endpoint's final HTTP response status, or null when no response was
+          #   received.
+          #
+          #   @return [Integer, nil]
+          required :http_status, Integer, nil?: true
+
+          # @!attribute status
+          #   Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+          #   response; failed means no HTTP response was received; skipped_unsafe_url means
+          #   the URL failed the public-endpoint safety check.
+          #
+          #   @return [Symbol, ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status]
+          required :status, enum: -> { ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status }
+
+          # @!method initialize(attempted_at:, error:, event_id:, http_status:, status:)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery} for more
+          #   details.
+          #
+          #   The webhook delivery attempted for a change detected by this run. Omitted when
+          #   no webhook was attempted, including historical runs created before delivery
+          #   tracking was added.
+          #
+          #   @param attempted_at [Time]
+          #
+          #   @param error [ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error, nil]
+          #
+          #   @param event_id [String] Identifier sent in the X-Context-Id header.
+          #
+          #   @param http_status [Integer, nil] The endpoint's final HTTP response status, or null when no response was received
+          #
+          #   @param status [Symbol, ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status] Delivery outcome. delivered means any 2xx response; rejected means a non-2xx res
+
+          # @see ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery#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
+
+          # Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+          # response; failed means no HTTP response was received; skipped_unsafe_url means
+          # the URL failed the public-endpoint safety check.
+          #
+          # @see ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery#status
+          module Status
+            extend ContextDev::Internal::Type::Enum
+
+            DELIVERED = :delivered
+            REJECTED = :rejected
+            FAILED = :failed
+            SKIPPED_UNSAFE_URL = :skipped_unsafe_url
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

data/lib/context_dev/models/monitor_retrieve_response.rb

@@ -153,7 +153,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::Models::MonitorRetrieveResponse::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
         variant :semantic, -> { ContextDev::Models::MonitorRetrieveResponse::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -181,9 +181,9 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to the extracted data, ignoring cosmetic or
-          #   paraphrase-only differences. What is watched is determined by the extract
-          #   target's `schema` and `instructions`.
+          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
+          #   paraphrase-only differences. Which changes are meaningful is judged against the
+          #   extract target's `instructions` (and `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -295,7 +295,7 @@ module ContextDev
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
         variant :sitemap, -> { ContextDev::Models::MonitorRetrieveResponse::Target::Sitemap }
 
-        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
         variant :extract, -> { ContextDev::Models::MonitorRetrieveResponse::Target::Extract }
 
         class Page < ContextDev::Internal::Type::BaseModel
@@ -410,9 +410,14 @@ module ContextDev
           optional :max_pages, Integer
 
           # @!attribute schema
-          #   JSON Schema describing the data you care about. It guides which pages are
-          #   selected for tracking and gives the change judge context on what matters. If
-          #   omitted, a default summary + key-points schema is used.
+          #   JSON Schema describing the data you care about. It is used three ways: it guides
+          #   which pages are selected for tracking, it gives the change judge extra context
+          #   on which changes matter (alongside `instructions`), and it defines the shape of
+          #   the baseline `data` snapshot on GET /monitors/{monitor_id} (refreshed at most
+          #   about once a day). It is not a response format for changes: change events and
+          #   webhook payloads always contain diffs, summaries, and evidence excerpts — never
+          #   data in this schema's shape. If omitted, a default summary + key-points schema
+          #   is used.
           #
           #   @return [Hash{Symbol=>Object}, nil]
           optional :schema, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
@@ -424,8 +429,8 @@ module ContextDev
           #   Watch the monitor-relevant pages of a site for meaningful changes. A crawl
           #   guided by `schema`/`instructions` selects up to `max_pages` relevant pages to
           #   track; each run re-checks exactly those pages, and confirmed content changes are
-          #   judged against the monitor's instructions. The tracked page set is refreshed by
-          #   a periodic re-discovery crawl.
+          #   judged for relevance against the monitor's `instructions` (and `schema`, when
+          #   provided). The tracked page set is refreshed by a periodic re-discovery crawl.
           #
           #   @param instructions [String] Natural-language instructions guiding which pages and facts to track and which c
           #
@@ -437,7 +442,7 @@ module ContextDev
           #
           #   @param max_pages [Integer] Maximum number of pages to track.
           #
-          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It guides which pages are select
+          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It is used three ways: it guides
           #
           #   @param type [Symbol, :extract]
         end

data/lib/context_dev/models/monitor_update_params.rb

@@ -85,7 +85,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::MonitorUpdateParams::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
         variant :semantic, -> { ContextDev::MonitorUpdateParams::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -113,9 +113,9 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to the extracted data, ignoring cosmetic or
-          #   paraphrase-only differences. What is watched is determined by the extract
-          #   target's `schema` and `instructions`.
+          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
+          #   paraphrase-only differences. Which changes are meaningful is judged against the
+          #   extract target's `instructions` (and `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -203,7 +203,7 @@ module ContextDev
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
         variant :sitemap, -> { ContextDev::MonitorUpdateParams::Target::Sitemap }
 
-        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+        # Watch the monitor-relevant pages of a site for meaningful changes. A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
         variant :extract, -> { ContextDev::MonitorUpdateParams::Target::Extract }
 
         class Page < ContextDev::Internal::Type::BaseModel
@@ -318,9 +318,14 @@ module ContextDev
           optional :max_pages, Integer
 
           # @!attribute schema
-          #   JSON Schema describing the data you care about. It guides which pages are
-          #   selected for tracking and gives the change judge context on what matters. If
-          #   omitted, a default summary + key-points schema is used.
+          #   JSON Schema describing the data you care about. It is used three ways: it guides
+          #   which pages are selected for tracking, it gives the change judge extra context
+          #   on which changes matter (alongside `instructions`), and it defines the shape of
+          #   the baseline `data` snapshot on GET /monitors/{monitor_id} (refreshed at most
+          #   about once a day). It is not a response format for changes: change events and
+          #   webhook payloads always contain diffs, summaries, and evidence excerpts — never
+          #   data in this schema's shape. If omitted, a default summary + key-points schema
+          #   is used.
           #
           #   @return [Hash{Symbol=>Object}, nil]
           optional :schema, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
@@ -332,8 +337,8 @@ module ContextDev
           #   Watch the monitor-relevant pages of a site for meaningful changes. A crawl
           #   guided by `schema`/`instructions` selects up to `max_pages` relevant pages to
           #   track; each run re-checks exactly those pages, and confirmed content changes are
-          #   judged against the monitor's instructions. The tracked page set is refreshed by
-          #   a periodic re-discovery crawl.
+          #   judged for relevance against the monitor's `instructions` (and `schema`, when
+          #   provided). The tracked page set is refreshed by a periodic re-discovery crawl.
           #
           #   @param instructions [String] Natural-language instructions guiding which pages and facts to track and which c
           #
@@ -345,7 +350,7 @@ module ContextDev
           #
           #   @param max_pages [Integer] Maximum number of pages to track.
           #
-          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It guides which pages are select
+          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It is used three ways: it guides
           #
           #   @param type [Symbol, :extract]
         end