context.dev 2.21.0 → 2.22.0

data/lib/context_dev/models/monitor_list_response.rb

@@ -19,10 +19,32 @@ module ContextDev
       #   @return [String, nil]
       required :next_cursor, String, nil?: true
 
-      # @!method initialize(data:, has_more:, next_cursor:)
+      # @!attribute request_id
+      #   Unique ID of this request, also in `X-Request-Id`. Include it when contacting
+      #   support.
+      #
+      #   @return [String]
+      required :request_id, String
+
+      # @!attribute key_metadata
+      #   Credits this request used and your remaining balance.
+      #
+      #   @return [ContextDev::Models::MonitorListResponse::KeyMetadata, nil]
+      optional :key_metadata, -> { ContextDev::Models::MonitorListResponse::KeyMetadata }
+
+      # @!method initialize(data:, has_more:, next_cursor:, request_id:, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::MonitorListResponse} for more details.
+      #
       #   @param data [Array<ContextDev::Models::MonitorListResponse::Data>]
+      #
       #   @param has_more [Boolean]
+      #
       #   @param next_cursor [String, nil]
+      #
+      #   @param request_id [String] Unique ID of this request, also in `X-Request-Id`. Include it when contacting su
+      #
+      #   @param key_metadata [ContextDev::Models::MonitorListResponse::KeyMetadata] Credits this request used and your remaining balance.
 
       class Data < ContextDev::Internal::Type::BaseModel
         # @!attribute id
@@ -31,7 +53,8 @@ module ContextDev
         required :id, String
 
         # @!attribute change_detection
-        #   Discriminated union describing how changes are detected.
+        #   How changes are judged. Defaults to `semantic` for extract targets and page
+        #   targets with `instructions`, otherwise `exact`.
         #
         #   @return [ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Exact, ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic]
         required :change_detection, union: -> { ContextDev::Models::MonitorListResponse::Data::ChangeDetection }
@@ -42,8 +65,7 @@ module ContextDev
         required :created_at, Time
 
         # @!attribute mode
-        #   Top-level monitor category. Always `web` today; the concrete behavior is
-        #   described by `target` and `change_detection`.
+        #   Always `web`. Optional.
         #
         #   @return [Symbol, ContextDev::Models::MonitorListResponse::Data::Mode]
         required :mode, enum: -> { ContextDev::Models::MonitorListResponse::Data::Mode }
@@ -62,17 +84,14 @@ module ContextDev
         required :schedule, -> { ContextDev::Models::MonitorListResponse::Data::Schedule }
 
         # @!attribute status
-        #   Monitor lifecycle status. `failed` means the most recent run failed (see the
-        #   monitor's `last_error`); failed monitors keep running on schedule and flip back
-        #   to `active` on the next successful run. Monitors are auto-`paused` after
-        #   repeated consecutive failures or insufficient-credit skips; resume by PATCHing
-        #   status to `active`.
+        #   Current state. Failed monitors keep running; paused monitors must be resumed
+        #   with `status: "active"`.
         #
         #   @return [Symbol, ContextDev::Models::MonitorListResponse::Data::Status]
         required :status, enum: -> { ContextDev::Models::MonitorListResponse::Data::Status }
 
         # @!attribute target
-        #   Discriminated union describing what the monitor watches.
+        #   What to watch: a page, a sitemap, or data extracted from a site.
         #
         #   @return [ContextDev::Models::MonitorListResponse::Data::Target::Page, ContextDev::Models::MonitorListResponse::Data::Target::Sitemap, ContextDev::Models::MonitorListResponse::Data::Target::Extract]
         required :target, union: -> { ContextDev::Models::MonitorListResponse::Data::Target }
@@ -83,10 +102,8 @@ module ContextDev
         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).
+        #   Comparison baseline, included on Retrieve. Null until capture completes or after
+        #   target changes.
         #
         #   @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
@@ -108,19 +125,19 @@ module ContextDev
         optional :last_run_at, Time, nil?: true
 
         # @!attribute next_run_at
-        #   When the next scheduled run is due.
+        #   When the next scheduled run is due; null while paused.
         #
         #   @return [Time, nil]
         optional :next_run_at, Time, nil?: true
 
         # @!attribute tags
-        #   User-defined tags for grouping and filtering monitors and their changes.
-        #   Duplicates are removed.
+        #   Labels for filtering monitors, their changes, and their usage.
         #
         #   @return [Array<String>, nil]
         optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
         # @!attribute webhook
+        #   Webhook destination and delivery settings. Null means no webhook is configured.
         #
         #   @return [ContextDev::Models::MonitorListResponse::Data::Webhook, nil]
         optional :webhook, -> { ContextDev::Models::MonitorListResponse::Data::Webhook }, nil?: true
@@ -144,23 +161,23 @@ module ContextDev
         #
         #   @param id [String]
         #
-        #   @param change_detection [ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Exact, ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+        #   @param change_detection [ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Exact, ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic] How changes are judged. Defaults to `semantic` for extract targets and page targ
         #
         #   @param created_at [Time]
         #
-        #   @param mode [Symbol, ContextDev::Models::MonitorListResponse::Data::Mode] Top-level monitor category. Always `web` today; the concrete behavior is describ
+        #   @param mode [Symbol, ContextDev::Models::MonitorListResponse::Data::Mode] Always `web`. Optional.
         #
         #   @param name [String]
         #
         #   @param schedule [ContextDev::Models::MonitorListResponse::Data::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
         #
-        #   @param status [Symbol, ContextDev::Models::MonitorListResponse::Data::Status] Monitor lifecycle status. `failed` means the most recent run failed (see the mon
+        #   @param status [Symbol, ContextDev::Models::MonitorListResponse::Data::Status] Current state. Failed monitors keep running; paused monitors must be resumed wit
         #
-        #   @param target [ContextDev::Models::MonitorListResponse::Data::Target::Page, ContextDev::Models::MonitorListResponse::Data::Target::Sitemap, ContextDev::Models::MonitorListResponse::Data::Target::Extract] Discriminated union describing what the monitor watches.
+        #   @param target [ContextDev::Models::MonitorListResponse::Data::Target::Page, ContextDev::Models::MonitorListResponse::Data::Target::Sitemap, ContextDev::Models::MonitorListResponse::Data::Target::Extract] What to watch: a page, a sitemap, or data extracted from a site.
         #
         #   @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 baseline [ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline, ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline, nil] Comparison baseline, included on Retrieve. Null until capture completes or after
         #
         #   @param last_change_at [Time, nil]
         #
@@ -168,15 +185,16 @@ module ContextDev
         #
         #   @param last_run_at [Time, nil]
         #
-        #   @param next_run_at [Time, nil] When the next scheduled run is due.
+        #   @param next_run_at [Time, nil] When the next scheduled run is due; null while paused.
         #
-        #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
+        #   @param tags [Array<String>] Labels for filtering monitors, their changes, and their usage.
         #
-        #   @param webhook [ContextDev::Models::MonitorListResponse::Data::Webhook, nil]
+        #   @param webhook [ContextDev::Models::MonitorListResponse::Data::Webhook, nil] Webhook destination and delivery settings. Null means no webhook is configured.
         #
         #   @param webhook_failure [ContextDev::Models::MonitorListResponse::Data::WebhookFailure, nil] Present while webhook deliveries are failing consecutively; null when deliveries
 
-        # Discriminated union describing how changes are detected.
+        # How changes are judged. Defaults to `semantic` for extract targets and page
+        # targets with `instructions`, otherwise `exact`.
         #
         # @see ContextDev::Models::MonitorListResponse::Data#change_detection
         module ChangeDetection
@@ -187,11 +205,12 @@ 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 page content, ignoring cosmetic or instruction-irrelevant differences. Which changes are meaningful is judged against the page or extract target's `instructions` (and an extract target's `schema`, when provided).
+          # Detect meaningful content changes using the target’s instructions and optional schema.
           variant :semantic, -> { ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic }
 
           class Exact < ContextDev::Internal::Type::BaseModel
             # @!attribute type
+            #   Use `exact` to compare visible text or sitemap URLs.
             #
             #   @return [Symbol, :exact]
             required :type, const: :exact
@@ -200,36 +219,36 @@ module ContextDev
             #   Detect exact changes. For page targets, this means visible text diffs. For
             #   sitemap targets, this means URL additions and removals.
             #
-            #   @param type [Symbol, :exact]
+            #   @param type [Symbol, :exact] Use `exact` to compare visible text or sitemap URLs.
           end
 
           class Semantic < ContextDev::Internal::Type::BaseModel
             # @!attribute type
+            #   Use `semantic` to judge changes against the target instructions.
             #
             #   @return [Symbol, :semantic]
             required :type, const: :semantic
 
             # @!attribute confidence_threshold
+            #   Minimum confidence required to report a meaningful change, from 0 to 1.
             #
             #   @return [Float, nil]
             optional :confidence_threshold, Float
 
             # @!method initialize(confidence_threshold: nil, type: :semantic)
-            #   Detect meaning-level changes to page content, ignoring cosmetic or
-            #   instruction-irrelevant differences. Which changes are meaningful is judged
-            #   against the page or extract target's `instructions` (and an extract target's
-            #   `schema`, when provided).
+            #   Detect meaningful content changes using the target’s instructions and optional
+            #   schema.
             #
-            #   @param confidence_threshold [Float]
-            #   @param type [Symbol, :semantic]
+            #   @param confidence_threshold [Float] Minimum confidence required to report a meaningful change, from 0 to 1.
+            #
+            #   @param type [Symbol, :semantic] Use `semantic` to judge changes against the target instructions.
           end
 
           # @!method self.variants
           #   @return [Array(ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Exact, ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic)]
         end
 
-        # Top-level monitor category. Always `web` today; the concrete behavior is
-        # described by `target` and `change_detection`.
+        # Always `web`. Optional.
         #
         # @see ContextDev::Models::MonitorListResponse::Data#mode
         module Mode
@@ -252,11 +271,13 @@ module ContextDev
           required :frequency, Integer
 
           # @!attribute type
+          #   Use `interval` to run on a repeating schedule.
           #
           #   @return [Symbol, ContextDev::Models::MonitorListResponse::Data::Schedule::Type]
           required :type, enum: -> { ContextDev::Models::MonitorListResponse::Data::Schedule::Type }
 
           # @!attribute unit
+          #   Time unit used with `frequency` to set the run interval.
           #
           #   @return [Symbol, ContextDev::Models::MonitorListResponse::Data::Schedule::Unit]
           required :unit, enum: -> { ContextDev::Models::MonitorListResponse::Data::Schedule::Unit }
@@ -271,10 +292,12 @@ module ContextDev
           #
           #   @param frequency [Integer] Number of units between runs. The resulting interval (frequency × unit) must be
           #
-          #   @param type [Symbol, ContextDev::Models::MonitorListResponse::Data::Schedule::Type]
+          #   @param type [Symbol, ContextDev::Models::MonitorListResponse::Data::Schedule::Type] Use `interval` to run on a repeating schedule.
           #
-          #   @param unit [Symbol, ContextDev::Models::MonitorListResponse::Data::Schedule::Unit]
+          #   @param unit [Symbol, ContextDev::Models::MonitorListResponse::Data::Schedule::Unit] Time unit used with `frequency` to set the run interval.
 
+          # Use `interval` to run on a repeating schedule.
+          #
           # @see ContextDev::Models::MonitorListResponse::Data::Schedule#type
           module Type
             extend ContextDev::Internal::Type::Enum
@@ -285,6 +308,8 @@ module ContextDev
             #   @return [Array<Symbol>]
           end
 
+          # Time unit used with `frequency` to set the run interval.
+          #
           # @see ContextDev::Models::MonitorListResponse::Data::Schedule#unit
           module Unit
             extend ContextDev::Internal::Type::Enum
@@ -298,11 +323,8 @@ module ContextDev
           end
         end
 
-        # Monitor lifecycle status. `failed` means the most recent run failed (see the
-        # monitor's `last_error`); failed monitors keep running on schedule and flip back
-        # to `active` on the next successful run. Monitors are auto-`paused` after
-        # repeated consecutive failures or insufficient-credit skips; resume by PATCHing
-        # status to `active`.
+        # Current state. Failed monitors keep running; paused monitors must be resumed
+        # with `status: "active"`.
         #
         # @see ContextDev::Models::MonitorListResponse::Data#status
         module Status
@@ -316,7 +338,7 @@ module ContextDev
           #   @return [Array<Symbol>]
         end
 
-        # Discriminated union describing what the monitor watches.
+        # What to watch: a page, a sitemap, or data extracted from a site.
         #
         # @see ContextDev::Models::MonitorListResponse::Data#target
         module Target
@@ -327,38 +349,44 @@ module ContextDev
           # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
           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. 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.
+          # Watch a site’s URL inventory for confirmed additions and removals.
           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 for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
+          # Track relevant pages selected by `schema` and `instructions`; refresh the page set periodically.
           variant :extract, -> { ContextDev::Models::MonitorListResponse::Data::Target::Extract }
 
           class Page < ContextDev::Internal::Type::BaseModel
             # @!attribute type
+            #   Use `page` to watch one web page.
             #
             #   @return [Symbol, :page]
             required :type, const: :page
 
             # @!attribute url
+            #   Public HTTP(S) page URL to monitor.
             #
             #   @return [String]
             required :url, String
 
+            # @!attribute actions
+            #   Optional browser actions executed in array order after the page loads, before
+            #   content is captured, on every run. Requires a paid plan. Maximum: 5 actions.
+            #   Changes create a new baseline.
+            #
+            #   @return [Array<ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Wait, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Perform, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll>, nil]
+            optional :actions,
+                     -> { ContextDev::Internal::Type::ArrayOf[union: ContextDev::Models::MonitorListResponse::Data::Target::Page::Action] },
+                     nil?: true
+
             # @!attribute exclude_selectors
-            #   CSS selectors for HTML regions to remove before text extraction. Applied after
-            #   include_selectors; exclusion takes precedence when an element matches both. Omit
-            #   or pass an empty array to apply no explicit exclusions. Changing these selectors
-            #   creates a new baseline.
+            #   Remove matching regions after inclusions. Changes create a new baseline.
             #
             #   @return [Array<String>, nil]
             optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String]
 
             # @!attribute include_selectors
-            #   CSS selectors defining the HTML regions to monitor. Matching subtrees are
-            #   combined in document order before text extraction, instead of automatic
-            #   main-content selection. Omit or pass an empty array to use automatic
-            #   main-content extraction. If the filtered page has no usable text, the run fails
-            #   without replacing the baseline. Changing these selectors creates a new baseline.
+            #   Monitor these CSS-selected regions. Empty or omitted uses main content. Changes
+            #   create a new baseline.
             #
             #   @return [Array<String>, nil]
             optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String]
@@ -376,28 +404,195 @@ module ContextDev
             #   @return [Boolean, nil]
             optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-            # @!method initialize(url:, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
+            # @!method initialize(url:, actions: nil, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
             #   Some parameter documentations has been truncated, see
             #   {ContextDev::Models::MonitorListResponse::Data::Target::Page} for more details.
             #
             #   Watch a single web page. Exact detection reports visible-text diffs; semantic
             #   detection judges confirmed stable diffs against `instructions`.
             #
-            #   @param url [String]
+            #   @param url [String] Public HTTP(S) page URL to monitor.
+            #
+            #   @param actions [Array<ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Wait, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Perform, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll>, nil] Optional browser actions executed in array order after the page loads, before co
             #
-            #   @param exclude_selectors [Array<String>] CSS selectors for HTML regions to remove before text extraction. Applied after i
+            #   @param exclude_selectors [Array<String>] Remove matching regions after inclusions. Changes create a new baseline.
             #
-            #   @param include_selectors [Array<String>] CSS selectors defining the HTML regions to monitor. Matching subtrees are combin
+            #   @param include_selectors [Array<String>] Monitor these CSS-selected regions. Empty or omitted uses main content. Changes
             #
             #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
             #
             #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
             #
-            #   @param type [Symbol, :page]
+            #   @param type [Symbol, :page] Use `page` to watch one web page.
+
+            # Browser action discriminated by `do`. Each variant exposes only its applicable
+            # fields.
+            module Action
+              extend ContextDev::Internal::Type::Union
+
+              discriminator :do
+
+              # Pause for a fixed number of milliseconds before continuing to the next action.
+              variant :wait, -> { ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Wait }
+
+              # Resolve and perform one natural-language browser action.
+              variant :perform, -> { ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Perform }
+
+              # Scroll the page or a selected scrollable container, waiting adaptively for content and dimensions to settle after each iteration.
+              variant :scroll, -> { ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll }
+
+              class Wait < ContextDev::Internal::Type::BaseModel
+                # @!attribute do_
+                #   Use `wait` to pause for a fixed duration.
+                #
+                #   @return [Symbol, :wait]
+                required :do_, const: :wait, api_name: :do
+
+                # @!attribute time_ms
+                #   Time to pause in milliseconds before the next action.
+                #
+                #   @return [Integer]
+                required :time_ms, Integer, api_name: :timeMs
+
+                # @!method initialize(time_ms:, do_: :wait)
+                #   Pause for a fixed number of milliseconds before continuing to the next action.
+                #
+                #   @param time_ms [Integer] Time to pause in milliseconds before the next action.
+                #
+                #   @param do_ [Symbol, :wait] Use `wait` to pause for a fixed duration.
+              end
+
+              class Perform < ContextDev::Internal::Type::BaseModel
+                # @!attribute action
+                #   One browser instruction, such as clicking a button or entering text.
+                #
+                #   @return [String]
+                required :action, String
+
+                # @!attribute do_
+                #   Use `perform` for a plain-language browser instruction.
+                #
+                #   @return [Symbol, :perform]
+                required :do_, const: :perform, api_name: :do
+
+                # @!method initialize(action:, do_: :perform)
+                #   Resolve and perform one natural-language browser action.
+                #
+                #   @param action [String] One browser instruction, such as clicking a button or entering text.
+                #
+                #   @param do_ [Symbol, :perform] Use `perform` for a plain-language browser instruction.
+              end
+
+              class Scroll < ContextDev::Internal::Type::BaseModel
+                # @!attribute do_
+                #   Use `scroll` to move through the page or a container.
+                #
+                #   @return [Symbol, :scroll]
+                required :do_, const: :scroll, api_name: :do
+
+                # @!attribute amount
+                #   Pixels per scroll, one visible viewport, or the current scroll boundary.
+                #   Defaults to viewport.
+                #
+                #   @return [Integer, Symbol, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Amount, nil]
+                optional :amount,
+                         union: -> { ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Amount }
+
+                # @!attribute container
+                #   CSS selector for the first matching scroll container. Defaults to the page.
+                #
+                #   @return [String, nil]
+                optional :container, String
+
+                # @!attribute direction
+                #   Direction to scroll. Defaults to down.
+                #
+                #   @return [Symbol, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Direction, nil]
+                optional :direction,
+                         enum: -> { ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Direction }
+
+                # @!attribute max_scrolls
+                #   Maximum scroll iterations. Stops early when scrolling and scrollable extent stop
+                #   changing. Defaults to 1.
+                #
+                #   @return [Integer, nil]
+                optional :max_scrolls, Integer, api_name: :maxScrolls
+
+                # @!method initialize(amount: nil, container: nil, direction: nil, max_scrolls: nil, do_: :scroll)
+                #   Some parameter documentations has been truncated, see
+                #   {ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll}
+                #   for more details.
+                #
+                #   Scroll the page or a selected scrollable container, waiting adaptively for
+                #   content and dimensions to settle after each iteration.
+                #
+                #   @param amount [Integer, Symbol, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Amount] Pixels per scroll, one visible viewport, or the current scroll boundary. Default
+                #
+                #   @param container [String] CSS selector for the first matching scroll container. Defaults to the page.
+                #
+                #   @param direction [Symbol, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Direction] Direction to scroll. Defaults to down.
+                #
+                #   @param max_scrolls [Integer] Maximum scroll iterations. Stops early when scrolling and scrollable extent stop
+                #
+                #   @param do_ [Symbol, :scroll] Use `scroll` to move through the page or a container.
+
+                # Pixels per scroll, one visible viewport, or the current scroll boundary.
+                # Defaults to viewport.
+                #
+                # @see ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll#amount
+                module Amount
+                  extend ContextDev::Internal::Type::Union
+
+                  variant Integer
+
+                  variant const: -> { ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Amount::VIEWPORT }
+
+                  variant const: -> { ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Amount::MAX }
+
+                  # @!method self.variants
+                  #   @return [Array(Integer, Symbol)]
+
+                  define_sorbet_constant!(:Variants) do
+                    T.type_alias do
+                      T.any(
+                        Integer,
+                        ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll::Amount::TaggedSymbol
+                      )
+                    end
+                  end
+
+                  # @!group
+
+                  VIEWPORT = :viewport
+                  MAX = :max
+
+                  # @!endgroup
+                end
+
+                # Direction to scroll. Defaults to down.
+                #
+                # @see ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll#direction
+                module Direction
+                  extend ContextDev::Internal::Type::Enum
+
+                  UP = :up
+                  DOWN = :down
+                  LEFT = :left
+                  RIGHT = :right
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
+              # @!method self.variants
+              #   @return [Array(ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Wait, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Perform, ContextDev::Models::MonitorListResponse::Data::Target::Page::Action::Scroll)]
+            end
           end
 
           class Sitemap < ContextDev::Internal::Type::BaseModel
             # @!attribute type
+            #   Use `sitemap` to watch a site for added or removed URLs.
             #
             #   @return [Symbol, :sitemap]
             required :type, const: :sitemap
@@ -427,11 +622,7 @@ module ContextDev
             optional :max_urls, Integer
 
             # @!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. 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.
+            #   Watch a site’s URL inventory for confirmed additions and removals.
             #
             #   @param url [String] Sitemap URL to monitor.
             #
@@ -441,7 +632,7 @@ module ContextDev
             #
             #   @param max_urls [Integer] Maximum number of sitemap URLs to track (capped at 10,000).
             #
-            #   @param type [Symbol, :sitemap]
+            #   @param type [Symbol, :sitemap] Use `sitemap` to watch a site for added or removed URLs.
           end
 
           class Extract < ContextDev::Internal::Type::BaseModel
@@ -453,6 +644,7 @@ module ContextDev
             required :instructions, String
 
             # @!attribute type
+            #   Use `extract` to watch structured data across selected pages.
             #
             #   @return [Symbol, :extract]
             required :type, const: :extract
@@ -464,6 +656,7 @@ module ContextDev
             required :url, String
 
             # @!attribute follow_subdomains
+            #   Allow page discovery on subdomains of the target site.
             #
             #   @return [Boolean, nil]
             optional :follow_subdomains, ContextDev::Internal::Type::Boolean
@@ -481,14 +674,8 @@ module ContextDev
             optional :max_pages, Integer
 
             # @!attribute schema
-            #   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.
+            #   JSON Schema for page selection and the baseline snapshot. Changes return diffs
+            #   and evidence.
             #
             #   @return [Hash{Symbol=>Object}, nil]
             optional :schema, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
@@ -498,35 +685,30 @@ module ContextDev
             #   {ContextDev::Models::MonitorListResponse::Data::Target::Extract} for more
             #   details.
             #
-            #   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.
+            #   Track relevant pages selected by `schema` and `instructions`; refresh the page
+            #   set periodically.
             #
             #   @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 follow_subdomains [Boolean] Allow page discovery on subdomains of the target site.
             #
             #   @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 track.
             #
-            #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It is used three ways: it guides
+            #   @param schema [Hash{Symbol=>Object}] JSON Schema for page selection and the baseline snapshot. Changes return diffs a
             #
-            #   @param type [Symbol, :extract]
+            #   @param type [Symbol, :extract] Use `extract` to watch structured data across selected pages.
           end
 
           # @!method self.variants
           #   @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).
+        # Comparison baseline, included on Retrieve. Null until capture completes or after
+        # target changes.
         #
         # @see ContextDev::Models::MonitorListResponse::Data#baseline
         module Baseline
@@ -600,10 +782,8 @@ module ContextDev
             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.
+            #   Latest structured snapshot matching the extraction schema, refreshed at most
+            #   daily; `null` before capture.
             #
             #   @return [Object]
             required :data, ContextDev::Internal::Type::Unknown
@@ -624,7 +804,7 @@ module ContextDev
             #
             #   @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 data [Object] Latest structured snapshot matching the extraction schema, refreshed at most dai
             #
             #   @param urls_analyzed [Array<String>] The page URLs the monitor tracks and analyzes for changes.
           end
@@ -655,17 +835,15 @@ module ContextDev
         # @see ContextDev::Models::MonitorListResponse::Data#webhook
         class Webhook < ContextDev::Internal::Type::BaseModel
           # @!attribute url
-          #   Webhook URL events are delivered to. Slack incoming webhook URLs are
-          #   automatically formatted as Slack messages.
+          #   Public HTTP(S) URL that receives events. Slack and GovSlack URLs get formatted
+          #   messages.
           #
           #   @return [String]
           required :url, String
 
           # @!attribute events
-          #   Events delivered to this endpoint. `change.detected` fires only when a run
-          #   detects a change; `run.completed` fires on every completed run — including runs
-          #   that detected no change — and embeds the change when one was detected. Defaults
-          #   to `["change.detected"]` when omitted.
+          #   Events to deliver. Defaults to `change.detected`; `run.completed` also includes
+          #   unchanged runs.
           #
           #   @return [Array<Symbol, ContextDev::Models::MonitorListResponse::Data::Webhook::Event>, nil]
           optional :events,
@@ -679,12 +857,8 @@ module ContextDev
 
           response_only do
             # @!attribute secret
-            #   Signing secret used to verify webhook authenticity. Omitted unless the API key
-            #   has monitors:write permission or full access. Each delivery includes an
-            #   `X-Context-Signature: t=<unix>,v1=<hmac>` header, where the HMAC is SHA-256 over
-            #   `"{t}.{rawRequestBody}"` keyed by this secret. Recompute it with a constant-time
-            #   compare and reject stale timestamps to prevent replay. Generated by the API;
-            #   cannot be set by clients.
+            #   API-generated signing secret. Visible only with full access or `monitors:write`
+            #   permission.
             #
             #   @return [String, nil]
             optional :secret, String
@@ -694,13 +868,15 @@ module ContextDev
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::MonitorListResponse::Data::Webhook} for more details.
           #
-          #   @param url [String] Webhook URL events are delivered to. Slack incoming webhook URLs are automatical
+          #   Webhook destination and delivery settings. Null means no webhook is configured.
           #
-          #   @param events [Array<Symbol, ContextDev::Models::MonitorListResponse::Data::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
+          #   @param url [String] Public HTTP(S) URL that receives events. Slack and GovSlack URLs get formatted m
+          #
+          #   @param events [Array<Symbol, ContextDev::Models::MonitorListResponse::Data::Webhook::Event>] Events to deliver. Defaults to `change.detected`; `run.completed` also includes
           #
           #   @param retry_ [ContextDev::Models::RetryConfig] Webhook retry settings. Use {} for the default schedule.
           #
-          #   @param secret [String] Signing secret used to verify webhook authenticity. Omitted unless the API key h
+          #   @param secret [String] API-generated signing secret. Visible only with full access or `monitors:write`
 
           module Event
             extend ContextDev::Internal::Type::Enum
@@ -775,6 +951,28 @@ module ContextDev
           end
         end
       end
+
+      # @see ContextDev::Models::MonitorListResponse#key_metadata
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_consumed
+        #   Credits charged for this request.
+        #
+        #   @return [Integer]
+        required :credits_consumed, Integer
+
+        # @!attribute credits_remaining
+        #   Credits remaining for your organization.
+        #
+        #   @return [Integer]
+        required :credits_remaining, Integer
+
+        # @!method initialize(credits_consumed:, credits_remaining:)
+        #   Credits this request used and your remaining balance.
+        #
+        #   @param credits_consumed [Integer] Credits charged for this request.
+        #
+        #   @param credits_remaining [Integer] Credits remaining for your organization.
+      end
     end
   end
 end