context.dev 2.4.0 → 2.6.0

data/lib/context_dev/models/monitor_get_limits_response.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Monitors#get_limits
+    class MonitorGetLimitsResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute monitors_limit
+      #   Maximum number of monitors allowed for the account. Defaults to the plan
+      #   allowance unless a custom limit is set for the organization.
+      #
+      #   @return [Integer]
+      required :monitors_limit, Integer
+
+      # @!attribute monitors_used
+      #   Number of monitors the account currently has.
+      #
+      #   @return [Integer]
+      required :monitors_used, Integer
+
+      # @!attribute plan
+      #   The plan tier the limit was resolved from.
+      #
+      #   @return [Symbol, ContextDev::Models::MonitorGetLimitsResponse::Plan]
+      required :plan, enum: -> { ContextDev::Models::MonitorGetLimitsResponse::Plan }
+
+      # @!method initialize(monitors_limit:, monitors_used:, plan:)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::MonitorGetLimitsResponse} for more details.
+      #
+      #   @param monitors_limit [Integer] Maximum number of monitors allowed for the account. Defaults to the plan allowan
+      #
+      #   @param monitors_used [Integer] Number of monitors the account currently has.
+      #
+      #   @param plan [Symbol, ContextDev::Models::MonitorGetLimitsResponse::Plan] The plan tier the limit was resolved from.
+
+      # The plan tier the limit was resolved from.
+      #
+      # @see ContextDev::Models::MonitorGetLimitsResponse#plan
+      module Plan
+        extend ContextDev::Internal::Type::Enum
+
+        FREE = :free
+        STARTER = :starter
+        PRO = :pro
+        SCALE = :scale
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/context_dev/models/monitor_list_account_changes_params.rb

@@ -8,27 +8,32 @@ module ContextDev
       include ContextDev::Internal::Type::RequestParameters
 
       # @!attribute change_detection_type
+      #   Filter by change detection type.
       #
       #   @return [Symbol, ContextDev::Models::MonitorListAccountChangesParams::ChangeDetectionType, nil]
       optional :change_detection_type,
                enum: -> { ContextDev::MonitorListAccountChangesParams::ChangeDetectionType }
 
       # @!attribute cursor
+      #   Opaque pagination cursor from a previous response.
       #
       #   @return [String, nil]
       optional :cursor, String
 
       # @!attribute limit
+      #   Maximum number of items to return per page (1-100). Defaults to 25.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
       # @!attribute monitor_id
+      #   Filter changes to a single monitor.
       #
       #   @return [String, nil]
       optional :monitor_id, String
 
       # @!attribute since
+      #   Only include items at or after this ISO 8601 timestamp.
       #
       #   @return [Time, nil]
       optional :since, Time
@@ -40,34 +45,37 @@ module ContextDev
       optional :tag, String
 
       # @!attribute target_type
+      #   Filter by target type.
       #
       #   @return [Symbol, ContextDev::Models::MonitorListAccountChangesParams::TargetType, nil]
       optional :target_type, enum: -> { ContextDev::MonitorListAccountChangesParams::TargetType }
 
       # @!attribute until_
+      #   Only include items before this ISO 8601 timestamp.
       #
       #   @return [Time, nil]
       optional :until_, Time
 
       # @!method initialize(change_detection_type: nil, cursor: nil, limit: nil, monitor_id: nil, since: nil, tag: nil, target_type: nil, until_: nil, request_options: {})
-      #   @param change_detection_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::ChangeDetectionType]
+      #   @param change_detection_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::ChangeDetectionType] Filter by change detection type.
       #
-      #   @param cursor [String]
+      #   @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      #   @param limit [Integer]
+      #   @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      #   @param monitor_id [String]
+      #   @param monitor_id [String] Filter changes to a single monitor.
       #
-      #   @param since [Time]
+      #   @param since [Time] Only include items at or after this ISO 8601 timestamp.
       #
       #   @param tag [String] Filter to items that have this tag.
       #
-      #   @param target_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::TargetType]
+      #   @param target_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::TargetType] Filter by target type.
       #
-      #   @param until_ [Time]
+      #   @param until_ [Time] Only include items before this ISO 8601 timestamp.
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
+      # Filter by change detection type.
       module ChangeDetectionType
         extend ContextDev::Internal::Type::Enum
 
@@ -78,6 +86,7 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
+      # Filter by target type.
       module TargetType
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/monitor_list_account_changes_response.rb

@@ -102,6 +102,7 @@ module ContextDev
 
         # @!attribute tags
         #   User-defined tags for grouping and filtering monitors and their changes.
+        #   Duplicates are removed.
         #
         #   @return [Array<String>, nil]
         optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -144,7 +145,7 @@ module ContextDev
         #
         #   @param removed_url_count [Integer]
         #
-        #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+        #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
 
         # @see ContextDev::Models::MonitorListAccountChangesResponse::Data#change_detection_type
         module ChangeDetectionType

data/lib/context_dev/models/monitor_list_account_runs_params.rb

@@ -8,36 +8,33 @@ module ContextDev
       include ContextDev::Internal::Type::RequestParameters
 
       # @!attribute cursor
+      #   Opaque pagination cursor from a previous response.
       #
       #   @return [String, nil]
       optional :cursor, String
 
       # @!attribute limit
+      #   Maximum number of items to return per page (1-100). Defaults to 25.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
       # @!attribute status
-      #   Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
-      #   (insufficient credits, monitor paused, or superseded by a concurrent run).
+      #   Filter runs by lifecycle status.
       #
       #   @return [Symbol, ContextDev::Models::MonitorListAccountRunsParams::Status, nil]
       optional :status, enum: -> { ContextDev::MonitorListAccountRunsParams::Status }
 
       # @!method initialize(cursor: nil, limit: nil, status: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {ContextDev::Models::MonitorListAccountRunsParams} for more details.
+      #   @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      #   @param cursor [String]
+      #   @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      #   @param limit [Integer]
-      #
-      #   @param status [Symbol, ContextDev::Models::MonitorListAccountRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      #   @param status [Symbol, ContextDev::Models::MonitorListAccountRunsParams::Status] Filter runs by lifecycle status.
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
-      # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
-      # (insufficient credits, monitor paused, or superseded by a concurrent run).
+      # Filter runs by lifecycle status.
       module Status
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/monitor_list_changes_params.rb

@@ -13,16 +13,19 @@ module ContextDev
       required :monitor_id, String
 
       # @!attribute cursor
+      #   Opaque pagination cursor from a previous response.
       #
       #   @return [String, nil]
       optional :cursor, String
 
       # @!attribute limit
+      #   Maximum number of items to return per page (1-100). Defaults to 25.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
       # @!attribute since
+      #   Only include items at or after this ISO 8601 timestamp.
       #
       #   @return [Time, nil]
       optional :since, Time
@@ -34,6 +37,7 @@ module ContextDev
       optional :tag, String
 
       # @!attribute until_
+      #   Only include items before this ISO 8601 timestamp.
       #
       #   @return [Time, nil]
       optional :until_, Time
@@ -41,15 +45,15 @@ module ContextDev
       # @!method initialize(monitor_id:, cursor: nil, limit: nil, since: nil, tag: nil, until_: nil, request_options: {})
       #   @param monitor_id [String]
       #
-      #   @param cursor [String]
+      #   @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      #   @param limit [Integer]
+      #   @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      #   @param since [Time]
+      #   @param since [Time] Only include items at or after this ISO 8601 timestamp.
       #
       #   @param tag [String] Filter to items that have this tag.
       #
-      #   @param until_ [Time]
+      #   @param until_ [Time] Only include items before this ISO 8601 timestamp.
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/context_dev/models/monitor_list_changes_response.rb

@@ -101,6 +101,7 @@ module ContextDev
 
         # @!attribute tags
         #   User-defined tags for grouping and filtering monitors and their changes.
+        #   Duplicates are removed.
         #
         #   @return [Array<String>, nil]
         optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -143,7 +144,7 @@ module ContextDev
         #
         #   @param removed_url_count [Integer]
         #
-        #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+        #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
 
         # @see ContextDev::Models::MonitorListChangesResponse::Data#change_detection_type
         module ChangeDetectionType

data/lib/context_dev/models/monitor_list_params.rb

@@ -8,16 +8,19 @@ module ContextDev
       include ContextDev::Internal::Type::RequestParameters
 
       # @!attribute change_detection_type
+      #   Filter by change detection type.
       #
       #   @return [Symbol, ContextDev::Models::MonitorListParams::ChangeDetectionType, nil]
       optional :change_detection_type, enum: -> { ContextDev::MonitorListParams::ChangeDetectionType }
 
       # @!attribute cursor
+      #   Opaque pagination cursor from a previous response.
       #
       #   @return [String, nil]
       optional :cursor, String
 
       # @!attribute limit
+      #   Maximum number of items to return per page (1-100). Defaults to 25.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
@@ -34,7 +37,8 @@ module ContextDev
       #
       #   @return [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>, nil]
       optional :search_by,
-               -> { ContextDev::Internal::Type::ArrayOf[enum: ContextDev::MonitorListParams::SearchBy] }
+               -> { ContextDev::Internal::Type::ArrayOf[enum: ContextDev::MonitorListParams::SearchBy] },
+               nil?: true
 
       # @!attribute search_type
       #   `prefix` for as-you-type prefix matching (default), `exact` for full-token
@@ -44,11 +48,7 @@ module ContextDev
       optional :search_type, enum: -> { ContextDev::MonitorListParams::SearchType }
 
       # @!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`.
+      #   Filter monitors by lifecycle status.
       #
       #   @return [Symbol, ContextDev::Models::MonitorListParams::Status, nil]
       optional :status, enum: -> { ContextDev::MonitorListParams::Status }
@@ -63,9 +63,10 @@ module ContextDev
       #   Comma-separated list of tags to filter by (matches monitors having any of them).
       #
       #   @return [Array<String>, nil]
-      optional :tags, ContextDev::Internal::Type::ArrayOf[String]
+      optional :tags, ContextDev::Internal::Type::ArrayOf[String], nil?: true
 
       # @!attribute target_type
+      #   Filter by target type.
       #
       #   @return [Symbol, ContextDev::Models::MonitorListParams::TargetType, nil]
       optional :target_type, enum: -> { ContextDev::MonitorListParams::TargetType }
@@ -74,28 +75,29 @@ module ContextDev
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::MonitorListParams} for more details.
       #
-      #   @param change_detection_type [Symbol, ContextDev::Models::MonitorListParams::ChangeDetectionType]
+      #   @param change_detection_type [Symbol, ContextDev::Models::MonitorListParams::ChangeDetectionType] Filter by change detection type.
       #
-      #   @param cursor [String]
+      #   @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      #   @param limit [Integer]
+      #   @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
       #   @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 `instru
+      #   @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>, nil] 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
       #
-      #   @param status [Symbol, ContextDev::Models::MonitorListParams::Status] Monitor lifecycle status. `failed` means the most recent run failed (see the mon
+      #   @param status [Symbol, ContextDev::Models::MonitorListParams::Status] Filter monitors by lifecycle status.
       #
       #   @param tag [String] Filter to items that have this tag.
       #
-      #   @param tags [Array<String>] Comma-separated list of tags to filter by (matches monitors having any of them).
+      #   @param tags [Array<String>, nil] Comma-separated list of tags to filter by (matches monitors having any of them).
       #
-      #   @param target_type [Symbol, ContextDev::Models::MonitorListParams::TargetType]
+      #   @param target_type [Symbol, ContextDev::Models::MonitorListParams::TargetType] Filter by target type.
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
+      # Filter by change detection type.
       module ChangeDetectionType
         extend ContextDev::Internal::Type::Enum
 
@@ -130,11 +132,7 @@ module ContextDev
         #   @return [Array<Symbol>]
       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`.
+      # Filter monitors by lifecycle status.
       module Status
         extend ContextDev::Internal::Type::Enum
 
@@ -146,6 +144,7 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
+      # Filter by target type.
       module TargetType
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/monitor_list_response.rb

@@ -115,6 +115,7 @@ module ContextDev
 
         # @!attribute tags
         #   User-defined tags for grouping and filtering monitors and their changes.
+        #   Duplicates are removed.
         #
         #   @return [Array<String>, nil]
         optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -169,7 +170,7 @@ module ContextDev
         #
         #   @param next_run_at [Time, nil] When the next scheduled run is due.
         #
-        #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+        #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
         #
         #   @param webhook [ContextDev::Models::MonitorListResponse::Data::Webhook, nil]
         #
@@ -186,7 +187,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 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).
+          # 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).
           variant :semantic, -> { ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic }
 
           class Exact < ContextDev::Internal::Type::BaseModel
@@ -214,9 +215,10 @@ module ContextDev
             optional :confidence_threshold, Float
 
             # @!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).
+            #   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).
             #
             #   @param confidence_threshold [Float]
             #   @param type [Symbol, :semantic]
@@ -322,7 +324,7 @@ module ContextDev
 
           discriminator :type
 
-          # Watch a single web page.
+          # 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.
@@ -342,17 +344,30 @@ module ContextDev
             #   @return [String]
             required :url, String
 
+            # @!attribute instructions
+            #   Plain-language goal describing which page changes matter. When provided without
+            #   change_detection, semantic detection is inferred.
+            #
+            #   @return [String, nil]
+            optional :instructions, String
+
             # @!attribute normalize_whitespace
             #   Normalize whitespace before comparing or analyzing text.
             #
             #   @return [Boolean, nil]
             optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-            # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-            #   Watch a single web page.
+            # @!method initialize(url:, 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 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]
@@ -371,13 +386,13 @@ module ContextDev
             required :url, String
 
             # @!attribute exclude
-            #   URL path patterns to exclude.
+            #   URL path patterns to exclude (max 50).
             #
             #   @return [Array<String>, nil]
             optional :exclude, ContextDev::Internal::Type::ArrayOf[String]
 
             # @!attribute include
-            #   URL path patterns to include.
+            #   URL path patterns to include (max 50).
             #
             #   @return [Array<String>, nil]
             optional :include, ContextDev::Internal::Type::ArrayOf[String]
@@ -397,9 +412,9 @@ module ContextDev
             #
             #   @param url [String] Sitemap URL to monitor.
             #
-            #   @param exclude [Array<String>] URL path patterns to exclude.
+            #   @param exclude [Array<String>] URL path patterns to exclude (max 50).
             #
-            #   @param include [Array<String>] URL path patterns to include.
+            #   @param include [Array<String>] URL path patterns to include (max 50).
             #
             #   @param max_urls [Integer] Maximum number of sitemap URLs to track (capped at 10,000).
             #

data/lib/context_dev/models/monitor_list_runs_params.rb

@@ -13,38 +13,35 @@ module ContextDev
       required :monitor_id, String
 
       # @!attribute cursor
+      #   Opaque pagination cursor from a previous response.
       #
       #   @return [String, nil]
       optional :cursor, String
 
       # @!attribute limit
+      #   Maximum number of items to return per page (1-100). Defaults to 25.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
       # @!attribute status
-      #   Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
-      #   (insufficient credits, monitor paused, or superseded by a concurrent run).
+      #   Filter runs by lifecycle status.
       #
       #   @return [Symbol, ContextDev::Models::MonitorListRunsParams::Status, nil]
       optional :status, enum: -> { ContextDev::MonitorListRunsParams::Status }
 
       # @!method initialize(monitor_id:, cursor: nil, limit: nil, status: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {ContextDev::Models::MonitorListRunsParams} for more details.
-      #
       #   @param monitor_id [String]
       #
-      #   @param cursor [String]
+      #   @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      #   @param limit [Integer]
+      #   @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      #   @param status [Symbol, ContextDev::Models::MonitorListRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      #   @param status [Symbol, ContextDev::Models::MonitorListRunsParams::Status] Filter runs by lifecycle status.
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
-      # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
-      # (insufficient credits, monitor paused, or superseded by a concurrent run).
+      # Filter runs by lifecycle status.
       module Status
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/monitor_retrieve_change_response.rb

@@ -45,6 +45,7 @@ module ContextDev
 
       # @!attribute tags
       #   User-defined tags for grouping and filtering monitors and their changes.
+      #   Duplicates are removed.
       #
       #   @return [Array<String>]
       required :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -153,7 +154,7 @@ module ContextDev
       #
       #   @param summary [String]
       #
-      #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
       #
       #   @param target_type [Symbol, ContextDev::Models::MonitorRetrieveChangeResponse::TargetType]
       #

data/lib/context_dev/models/monitor_retrieve_response.rb

@@ -94,6 +94,7 @@ module ContextDev
 
       # @!attribute tags
       #   User-defined tags for grouping and filtering monitors and their changes.
+      #   Duplicates are removed.
       #
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -146,7 +147,7 @@ module ContextDev
       #
       #   @param next_run_at [Time, nil] When the next scheduled run is due.
       #
-      #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      #   @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
       #
       #   @param webhook [ContextDev::Models::MonitorRetrieveResponse::Webhook, nil]
       #
@@ -163,7 +164,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 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).
+        # 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).
         variant :semantic, -> { ContextDev::Models::MonitorRetrieveResponse::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -191,9 +192,10 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!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).
+          #   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).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -299,7 +301,7 @@ module ContextDev
 
         discriminator :type
 
-        # Watch a single web page.
+        # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
         variant :page, -> { ContextDev::Models::MonitorRetrieveResponse::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.
@@ -319,17 +321,30 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute instructions
+          #   Plain-language goal describing which page changes matter. When provided without
+          #   change_detection, semantic detection is inferred.
+          #
+          #   @return [String, nil]
+          optional :instructions, String
+
           # @!attribute normalize_whitespace
           #   Normalize whitespace before comparing or analyzing text.
           #
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-          #   Watch a single web page.
+          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorRetrieveResponse::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 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]
@@ -348,13 +363,13 @@ module ContextDev
           required :url, String
 
           # @!attribute exclude
-          #   URL path patterns to exclude.
+          #   URL path patterns to exclude (max 50).
           #
           #   @return [Array<String>, nil]
           optional :exclude, ContextDev::Internal::Type::ArrayOf[String]
 
           # @!attribute include
-          #   URL path patterns to include.
+          #   URL path patterns to include (max 50).
           #
           #   @return [Array<String>, nil]
           optional :include, ContextDev::Internal::Type::ArrayOf[String]
@@ -374,9 +389,9 @@ module ContextDev
           #
           #   @param url [String] Sitemap URL to monitor.
           #
-          #   @param exclude [Array<String>] URL path patterns to exclude.
+          #   @param exclude [Array<String>] URL path patterns to exclude (max 50).
           #
-          #   @param include [Array<String>] URL path patterns to include.
+          #   @param include [Array<String>] URL path patterns to include (max 50).
           #
           #   @param max_urls [Integer] Maximum number of sitemap URLs to track (capped at 10,000).
           #