context.dev 2.0.0 → 2.2.0

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_params.rb

@@ -29,8 +29,8 @@ module ContextDev
       optional :q, String
 
       # @!attribute search_by
-      #   Comma-separated fields to search with `q`. Defaults to all of them. Note `query`
-      #   only exists on semantic monitors.
+      #   Comma-separated fields to search with `q`. Defaults to all of them. Note
+      #   `instructions` only exists on extract monitors.
       #
       #   @return [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>, nil]
       optional :search_by,
@@ -82,7 +82,7 @@ module ContextDev
       #
       #   @param q [String] Free-text search term, matched against the fields named in `search_by`.
       #
-      #   @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>] Comma-separated fields to search with `q`. Defaults to all of them. Note `query`
+      #   @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>] Comma-separated fields to search with `q`. Defaults to all of them. Note `instru
       #
       #   @param search_type [Symbol, ContextDev::Models::MonitorListParams::SearchType] `prefix` for as-you-type prefix matching (default), `exact` for full-token match
       #
@@ -111,7 +111,7 @@ module ContextDev
 
         NAME = :name
         URL = :url
-        QUERY = :query
+        INSTRUCTIONS = :instructions
         TAGS = :tags
 
         # @!method self.values

data/lib/context_dev/models/monitor_list_response.rb

@@ -82,6 +82,15 @@ module ContextDev
         #   @return [Time]
         required :updated_at, Time
 
+        # @!attribute baseline
+        #   Current baseline: the last observed value the monitor compares new snapshots
+        #   against. Its shape follows `target.type` (page/sitemap/extract). Only populated
+        #   on GET /monitors/{monitor_id}; null until the first baseline run completes (and
+        #   after a target or change_detection update, which resets the baseline).
+        #
+        #   @return [ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline, nil]
+        optional :baseline, union: -> { ContextDev::Models::MonitorListResponse::Data::Baseline }, nil?: true
+
         # @!attribute last_change_at
         #
         #   @return [Time, nil]
@@ -115,7 +124,7 @@ module ContextDev
         #   @return [ContextDev::Models::MonitorListResponse::Data::Webhook, nil]
         optional :webhook, -> { ContextDev::Models::MonitorListResponse::Data::Webhook }, nil?: true
 
-        # @!method initialize(id:, change_detection:, created_at:, mode:, name:, schedule:, status:, target:, updated_at:, last_change_at: nil, last_error: nil, last_run_at: nil, next_run_at: nil, tags: nil, webhook: nil)
+        # @!method initialize(id:, change_detection:, created_at:, mode:, name:, schedule:, status:, target:, updated_at:, baseline: nil, last_change_at: nil, last_error: nil, last_run_at: nil, next_run_at: nil, tags: nil, webhook: nil)
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorListResponse::Data} for more details.
         #
@@ -140,6 +149,8 @@ module ContextDev
         #
         #   @param updated_at [Time]
         #
+        #   @param baseline [ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline, nil] Current baseline: the last observed value the monitor compares new snapshots aga
+        #
         #   @param last_change_at [Time, nil]
         #
         #   @param last_error [ContextDev::Models::MonitorListResponse::Data::LastError, nil] Error from the most recent failed run; null when the last run succeeded.
@@ -163,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 that match a natural language query.
+          # 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
@@ -180,11 +191,6 @@ module ContextDev
           end
 
           class Semantic < ContextDev::Internal::Type::BaseModel
-            # @!attribute query
-            #
-            #   @return [String]
-            required :query, String
-
             # @!attribute type
             #
             #   @return [Symbol, :semantic]
@@ -195,10 +201,11 @@ module ContextDev
             #   @return [Float, nil]
             optional :confidence_threshold, Float
 
-            # @!method initialize(query:, confidence_threshold: nil, type: :semantic)
-            #   Detect meaning-level changes that match a natural language query.
+            # @!method initialize(confidence_threshold: nil, type: :semantic)
+            #   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 query [String]
             #   @param confidence_threshold [Float]
             #   @param type [Symbol, :semantic]
           end
@@ -306,10 +313,10 @@ module ContextDev
           # Watch a single web page.
           variant :page, -> { ContextDev::Models::MonitorListResponse::Data::Target::Page }
 
-          # 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. A new URL set must be observed on two consecutive runs before a change is reported, suppressing one-run crawl flaps.
+          # 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 a site's extracted structured data.
+          # 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
@@ -372,8 +379,9 @@ module ContextDev
             # @!method initialize(url:, exclude: nil, include: nil, max_urls: nil, type: :sitemap)
             #   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. A new URL set must be observed on two
-            #   consecutive runs before a change is reported, suppressing one-run crawl flaps.
+            #   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.
             #
             #   @param url [String] Sitemap URL to monitor.
             #
@@ -387,6 +395,13 @@ module ContextDev
           end
 
           class Extract < ContextDev::Internal::Type::BaseModel
+            # @!attribute instructions
+            #   Natural-language instructions guiding which pages and facts to track and which
+            #   changes to report.
+            #
+            #   @return [String]
+            required :instructions, String
+
             # @!attribute type
             #
             #   @return [Symbol, :extract]
@@ -403,12 +418,6 @@ module ContextDev
             #   @return [Boolean, nil]
             optional :follow_subdomains, ContextDev::Internal::Type::Boolean
 
-            # @!attribute instructions
-            #   Optional natural-language instructions guiding what to extract.
-            #
-            #   @return [String, nil]
-            optional :instructions, String
-
             # @!attribute max_depth
             #   Optional maximum link depth from the starting URL (0 = only the starting page).
             #
@@ -416,36 +425,46 @@ module ContextDev
             optional :max_depth, Integer
 
             # @!attribute max_pages
-            #   Maximum number of pages to analyze during extraction.
+            #   Maximum number of pages to track.
             #
             #   @return [Integer, nil]
             optional :max_pages, Integer
 
             # @!attribute schema
-            #   JSON Schema describing the structured data to extract and watch for changes. 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]
 
-            # @!method initialize(url:, follow_subdomains: nil, instructions: nil, max_depth: nil, max_pages: nil, schema: nil, type: :extract)
+            # @!method initialize(instructions:, url:, follow_subdomains: nil, max_depth: nil, max_pages: nil, schema: nil, type: :extract)
             #   Some parameter documentations has been truncated, see
             #   {ContextDev::Models::MonitorListResponse::Data::Target::Extract} for more
             #   details.
             #
-            #   Watch a site's extracted structured data.
+            #   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.
+            #
+            #   @param instructions [String] Natural-language instructions guiding which pages and facts to track and which c
             #
             #   @param url [String] Root URL to extract structured data from.
             #
             #   @param follow_subdomains [Boolean]
             #
-            #   @param instructions [String] Optional natural-language instructions guiding what to extract.
-            #
             #   @param max_depth [Integer] Optional maximum link depth from the starting URL (0 = only the starting page).
             #
-            #   @param max_pages [Integer] Maximum number of pages to analyze during extraction.
+            #   @param max_pages [Integer] Maximum number of pages to track.
             #
-            #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the structured data to extract and watch for changes. If
+            #   @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
@@ -454,6 +473,116 @@ module ContextDev
           #   @return [Array(ContextDev::Models::MonitorListResponse::Data::Target::Page, ContextDev::Models::MonitorListResponse::Data::Target::Sitemap, ContextDev::Models::MonitorListResponse::Data::Target::Extract)]
         end
 
+        # Current baseline: the last observed value the monitor compares new snapshots
+        # against. Its shape follows `target.type` (page/sitemap/extract). Only populated
+        # on GET /monitors/{monitor_id}; null until the first baseline run completes (and
+        # after a target or change_detection update, which resets the baseline).
+        #
+        # @see ContextDev::Models::MonitorListResponse::Data#baseline
+        module Baseline
+          extend ContextDev::Internal::Type::Union
+
+          # Current baseline of a `page` monitor: the visible page text as last observed.
+          variant -> { ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline }
+
+          # Current baseline of a `sitemap` monitor: the normalized URL set as last observed.
+          variant -> { ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline }
+
+          # Current baseline of an `extract` monitor: the pages it tracks and the structured data as last extracted.
+          variant -> { ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline }
+
+          class MonitorsPageBaseline < ContextDev::Internal::Type::BaseModel
+            # @!attribute captured_at
+            #   When this baseline was last captured or replaced.
+            #
+            #   @return [Time]
+            required :captured_at, Time
+
+            # @!attribute text
+            #   The page's visible text as last observed.
+            #
+            #   @return [String]
+            required :text, String
+
+            # @!method initialize(captured_at:, text:)
+            #   Current baseline of a `page` monitor: the visible page text as last observed.
+            #
+            #   @param captured_at [Time] When this baseline was last captured or replaced.
+            #
+            #   @param text [String] The page's visible text as last observed.
+          end
+
+          class MonitorsSitemapBaseline < ContextDev::Internal::Type::BaseModel
+            # @!attribute captured_at
+            #   When this baseline was last captured or replaced.
+            #
+            #   @return [Time]
+            required :captured_at, Time
+
+            # @!attribute url_count
+            #   Number of URLs in the baseline.
+            #
+            #   @return [Integer]
+            required :url_count, Integer
+
+            # @!attribute urls
+            #   The sitemap URLs as last observed (sorted, normalized).
+            #
+            #   @return [Array<String>]
+            required :urls, ContextDev::Internal::Type::ArrayOf[String]
+
+            # @!method initialize(captured_at:, url_count:, urls:)
+            #   Current baseline of a `sitemap` monitor: the normalized URL set as last
+            #   observed.
+            #
+            #   @param captured_at [Time] When this baseline was last captured or replaced.
+            #
+            #   @param url_count [Integer] Number of URLs in the baseline.
+            #
+            #   @param urls [Array<String>] The sitemap URLs as last observed (sorted, normalized).
+          end
+
+          class MonitorsExtractBaseline < ContextDev::Internal::Type::BaseModel
+            # @!attribute captured_at
+            #   When this baseline was last captured or replaced.
+            #
+            #   @return [Time]
+            required :captured_at, Time
+
+            # @!attribute data
+            #   The extracted structured data, matching the monitor's extraction schema (same
+            #   shape as the /web/extract endpoint's `data`). Refreshed when the monitor
+            #   re-discovers its page set (at most about once a day); `null` when no extraction
+            #   has been captured yet.
+            #
+            #   @return [Object]
+            required :data, ContextDev::Internal::Type::Unknown
+
+            # @!attribute urls_analyzed
+            #   The page URLs the monitor tracks and analyzes for changes.
+            #
+            #   @return [Array<String>]
+            required :urls_analyzed, ContextDev::Internal::Type::ArrayOf[String]
+
+            # @!method initialize(captured_at:, data:, urls_analyzed:)
+            #   Some parameter documentations has been truncated, see
+            #   {ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline}
+            #   for more details.
+            #
+            #   Current baseline of an `extract` monitor: the pages it tracks and the structured
+            #   data as last extracted.
+            #
+            #   @param captured_at [Time] When this baseline was last captured or replaced.
+            #
+            #   @param data [Object] The extracted structured data, matching the monitor's extraction schema (same sh
+            #
+            #   @param urls_analyzed [Array<String>] The page URLs the monitor tracks and analyzes for changes.
+          end
+
+          # @!method self.variants
+          #   @return [Array(ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline)]
+        end
+
         # @see ContextDev::Models::MonitorListResponse::Data#last_error
         class LastError < ContextDev::Internal::Type::BaseModel
           # @!attribute code

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_change_response.rb

@@ -112,11 +112,6 @@ module ContextDev
       #   @return [Array<String>, nil]
       optional :matched_urls, ContextDev::Internal::Type::ArrayOf[String]
 
-      # @!attribute query
-      #
-      #   @return [String, nil]
-      optional :query, String
-
       # @!attribute removed_url_count
       #
       #   @return [Integer, nil]
@@ -134,7 +129,7 @@ module ContextDev
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(id:, change_detection_type:, detected_at:, mode:, monitor_id:, run_id:, summary:, target_type:, title:, url:, added_url_count: nil, added_urls: nil, after_text_excerpt: nil, before_text_excerpt: nil, confidence: nil, diff: nil, evidence: nil, importance: nil, matched_url_count: nil, matched_urls: nil, query: nil, removed_url_count: nil, removed_urls: nil, tags: nil)
+      # @!method initialize(id:, change_detection_type:, detected_at:, mode:, monitor_id:, run_id:, summary:, target_type:, title:, url:, added_url_count: nil, added_urls: nil, after_text_excerpt: nil, before_text_excerpt: nil, confidence: nil, diff: nil, evidence: nil, importance: nil, matched_url_count: nil, matched_urls: nil, removed_url_count: nil, removed_urls: nil, tags: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::MonitorRetrieveChangeResponse} for more details.
       #
@@ -184,8 +179,6 @@ module ContextDev
       #
       #   @param matched_urls [Array<String>] At most 500 URLs are included; the corresponding count field is always exact.
       #
-      #   @param query [String]
-      #
       #   @param removed_url_count [Integer]
       #
       #   @param removed_urls [Array<String>] At most 500 URLs are included; the corresponding count field is always exact.