context.dev 2.4.0 → 2.6.0

data/rbi/context_dev/models/monitor_list_params.rbi

@@ -11,6 +11,7 @@ module ContextDev
           T.any(ContextDev::MonitorListParams, ContextDev::Internal::AnyHash)
         end
 
+      # Filter by change detection type.
       sig do
         returns(
           T.nilable(
@@ -28,12 +29,14 @@ module ContextDev
       end
       attr_writer :change_detection_type
 
+      # Opaque pagination cursor from a previous response.
       sig { returns(T.nilable(String)) }
       attr_reader :cursor
 
       sig { params(cursor: String).void }
       attr_writer :cursor
 
+      # Maximum number of items to return per page (1-100). Defaults to 25.
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
 
@@ -54,14 +57,7 @@ module ContextDev
           T.nilable(T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol])
         )
       end
-      attr_reader :search_by
-
-      sig do
-        params(
-          search_by: T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol]
-        ).void
-      end
-      attr_writer :search_by
+      attr_accessor :search_by
 
       # `prefix` for as-you-type prefix matching (default), `exact` for full-token
       # matching.
@@ -77,11 +73,7 @@ module ContextDev
       end
       attr_writer :search_type
 
-      # 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.
       sig do
         returns(T.nilable(ContextDev::MonitorListParams::Status::OrSymbol))
       end
@@ -101,11 +93,9 @@ module ContextDev
 
       # Comma-separated list of tags to filter by (matches monitors having any of them).
       sig { returns(T.nilable(T::Array[String])) }
-      attr_reader :tags
-
-      sig { params(tags: T::Array[String]).void }
-      attr_writer :tags
+      attr_accessor :tags
 
+      # Filter by target type.
       sig do
         returns(T.nilable(ContextDev::MonitorListParams::TargetType::OrSymbol))
       end
@@ -126,18 +116,23 @@ module ContextDev
           limit: Integer,
           q: String,
           search_by:
-            T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol],
+            T.nilable(
+              T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol]
+            ),
           search_type: ContextDev::MonitorListParams::SearchType::OrSymbol,
           status: ContextDev::MonitorListParams::Status::OrSymbol,
           tag: String,
-          tags: T::Array[String],
+          tags: T.nilable(T::Array[String]),
           target_type: ContextDev::MonitorListParams::TargetType::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # Filter by change detection type.
         change_detection_type: nil,
+        # Opaque pagination cursor from a previous response.
         cursor: nil,
+        # Maximum number of items to return per page (1-100). Defaults to 25.
         limit: nil,
         # Free-text search term, matched against the fields named in `search_by`.
         q: nil,
@@ -147,16 +142,13 @@ module ContextDev
         # `prefix` for as-you-type prefix matching (default), `exact` for full-token
         # matching.
         search_type: nil,
-        # 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.
         status: nil,
         # Filter to items that have this tag.
         tag: nil,
         # Comma-separated list of tags to filter by (matches monitors having any of them).
         tags: nil,
+        # Filter by target type.
         target_type: nil,
         request_options: {}
       )
@@ -171,11 +163,13 @@ module ContextDev
             limit: Integer,
             q: String,
             search_by:
-              T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol],
+              T.nilable(
+                T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol]
+              ),
             search_type: ContextDev::MonitorListParams::SearchType::OrSymbol,
             status: ContextDev::MonitorListParams::Status::OrSymbol,
             tag: String,
-            tags: T::Array[String],
+            tags: T.nilable(T::Array[String]),
             target_type: ContextDev::MonitorListParams::TargetType::OrSymbol,
             request_options: ContextDev::RequestOptions
           }
@@ -184,6 +178,7 @@ module ContextDev
       def to_hash
       end
 
+      # Filter by change detection type.
       module ChangeDetectionType
         extend ContextDev::Internal::Type::Enum
 
@@ -272,11 +267,7 @@ 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`.
+      # Filter monitors by lifecycle status.
       module Status
         extend ContextDev::Internal::Type::Enum
 
@@ -300,6 +291,7 @@ module ContextDev
         end
       end
 
+      # Filter by target type.
       module TargetType
         extend ContextDev::Internal::Type::Enum
 

data/rbi/context_dev/models/monitor_list_response.rbi

@@ -156,6 +156,7 @@ module ContextDev
         attr_accessor :next_run_at
 
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :tags
 
@@ -285,6 +286,7 @@ module ContextDev
           # When the next scheduled run is due.
           next_run_at: nil,
           # User-defined tags for grouping and filtering monitors and their changes.
+          # Duplicates are removed.
           tags: nil,
           webhook: nil,
           # Present while webhook deliveries are failing consecutively; null when deliveries
@@ -389,9 +391,10 @@ module ContextDev
             sig { params(confidence_threshold: Float).void }
             attr_writer :confidence_threshold
 
-            # 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).
             sig do
               params(confidence_threshold: Float, type: Symbol).returns(
                 T.attached_class
@@ -652,6 +655,14 @@ module ContextDev
             sig { returns(String) }
             attr_accessor :url
 
+            # Plain-language goal describing which page changes matter. When provided without
+            # change_detection, semantic detection is inferred.
+            sig { returns(T.nilable(String)) }
+            attr_reader :instructions
+
+            sig { params(instructions: String).void }
+            attr_writer :instructions
+
             # Normalize whitespace before comparing or analyzing text.
             sig { returns(T.nilable(T::Boolean)) }
             attr_reader :normalize_whitespace
@@ -659,16 +670,21 @@ module ContextDev
             sig { params(normalize_whitespace: T::Boolean).void }
             attr_writer :normalize_whitespace
 
-            # Watch a single web page.
+            # Watch a single web page. Exact detection reports visible-text diffs; semantic
+            # detection judges confirmed stable diffs against `instructions`.
             sig do
               params(
                 url: String,
+                instructions: String,
                 normalize_whitespace: T::Boolean,
                 type: Symbol
               ).returns(T.attached_class)
             end
             def self.new(
               url:,
+              # Plain-language goal describing which page changes matter. When provided without
+              # change_detection, semantic detection is inferred.
+              instructions: nil,
               # Normalize whitespace before comparing or analyzing text.
               normalize_whitespace: nil,
               type: :page
@@ -677,7 +693,12 @@ module ContextDev
 
             sig do
               override.returns(
-                { type: Symbol, url: String, normalize_whitespace: T::Boolean }
+                {
+                  type: Symbol,
+                  url: String,
+                  instructions: String,
+                  normalize_whitespace: T::Boolean
+                }
               )
             end
             def to_hash
@@ -700,14 +721,14 @@ module ContextDev
             sig { returns(String) }
             attr_accessor :url
 
-            # URL path patterns to exclude.
+            # URL path patterns to exclude (max 50).
             sig { returns(T.nilable(T::Array[String])) }
             attr_reader :exclude
 
             sig { params(exclude: T::Array[String]).void }
             attr_writer :exclude
 
-            # URL path patterns to include.
+            # URL path patterns to include (max 50).
             sig { returns(T.nilable(T::Array[String])) }
             attr_reader :include
 
@@ -738,9 +759,9 @@ module ContextDev
             def self.new(
               # Sitemap URL to monitor.
               url:,
-              # URL path patterns to exclude.
+              # URL path patterns to exclude (max 50).
               exclude: nil,
-              # URL path patterns to include.
+              # URL path patterns to include (max 50).
               include: nil,
               # Maximum number of sitemap URLs to track (capped at 10,000).
               max_urls: nil,

data/rbi/context_dev/models/monitor_list_runs_params.rbi

@@ -17,20 +17,21 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :monitor_id
 
+      # Opaque pagination cursor from a previous response.
       sig { returns(T.nilable(String)) }
       attr_reader :cursor
 
       sig { params(cursor: String).void }
       attr_writer :cursor
 
+      # Maximum number of items to return per page (1-100). Defaults to 25.
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
 
       sig { params(limit: Integer).void }
       attr_writer :limit
 
-      # 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.
       sig do
         returns(T.nilable(ContextDev::MonitorListRunsParams::Status::OrSymbol))
       end
@@ -52,10 +53,11 @@ module ContextDev
       end
       def self.new(
         monitor_id:,
+        # Opaque pagination cursor from a previous response.
         cursor: nil,
+        # Maximum number of items to return per page (1-100). Defaults to 25.
         limit: nil,
-        # 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.
         status: nil,
         request_options: {}
       )
@@ -75,8 +77,7 @@ module ContextDev
       def to_hash
       end
 
-      # 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/rbi/context_dev/models/monitor_retrieve_change_response.rbi

@@ -44,6 +44,7 @@ module ContextDev
       attr_accessor :summary
 
       # User-defined tags for grouping and filtering monitors and their changes.
+      # Duplicates are removed.
       sig { returns(T::Array[String]) }
       attr_accessor :tags
 
@@ -213,6 +214,7 @@ module ContextDev
         run_id:,
         summary:,
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         tags:,
         target_type:,
         title:,

data/rbi/context_dev/models/monitor_retrieve_response.rbi

@@ -112,6 +112,7 @@ module ContextDev
       attr_accessor :next_run_at
 
       # User-defined tags for grouping and filtering monitors and their changes.
+      # Duplicates are removed.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -236,6 +237,7 @@ module ContextDev
         # When the next scheduled run is due.
         next_run_at: nil,
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         tags: nil,
         webhook: nil,
         # Present while webhook deliveries are failing consecutively; null when deliveries
@@ -336,9 +338,10 @@ module ContextDev
           sig { params(confidence_threshold: Float).void }
           attr_writer :confidence_threshold
 
-          # 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).
           sig do
             params(confidence_threshold: Float, type: Symbol).returns(
               T.attached_class
@@ -596,6 +599,14 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
+          # Plain-language goal describing which page changes matter. When provided without
+          # change_detection, semantic detection is inferred.
+          sig { returns(T.nilable(String)) }
+          attr_reader :instructions
+
+          sig { params(instructions: String).void }
+          attr_writer :instructions
+
           # Normalize whitespace before comparing or analyzing text.
           sig { returns(T.nilable(T::Boolean)) }
           attr_reader :normalize_whitespace
@@ -603,16 +614,21 @@ module ContextDev
           sig { params(normalize_whitespace: T::Boolean).void }
           attr_writer :normalize_whitespace
 
-          # Watch a single web page.
+          # Watch a single web page. Exact detection reports visible-text diffs; semantic
+          # detection judges confirmed stable diffs against `instructions`.
           sig do
             params(
               url: String,
+              instructions: String,
               normalize_whitespace: T::Boolean,
               type: Symbol
             ).returns(T.attached_class)
           end
           def self.new(
             url:,
+            # Plain-language goal describing which page changes matter. When provided without
+            # change_detection, semantic detection is inferred.
+            instructions: nil,
             # Normalize whitespace before comparing or analyzing text.
             normalize_whitespace: nil,
             type: :page
@@ -621,7 +637,12 @@ module ContextDev
 
           sig do
             override.returns(
-              { type: Symbol, url: String, normalize_whitespace: T::Boolean }
+              {
+                type: Symbol,
+                url: String,
+                instructions: String,
+                normalize_whitespace: T::Boolean
+              }
             )
           end
           def to_hash
@@ -644,14 +665,14 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
-          # URL path patterns to exclude.
+          # URL path patterns to exclude (max 50).
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :exclude
 
           sig { params(exclude: T::Array[String]).void }
           attr_writer :exclude
 
-          # URL path patterns to include.
+          # URL path patterns to include (max 50).
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :include
 
@@ -682,9 +703,9 @@ module ContextDev
           def self.new(
             # Sitemap URL to monitor.
             url:,
-            # URL path patterns to exclude.
+            # URL path patterns to exclude (max 50).
             exclude: nil,
-            # URL path patterns to include.
+            # URL path patterns to include (max 50).
             include: nil,
             # Maximum number of sitemap URLs to track (capped at 10,000).
             max_urls: nil,

data/rbi/context_dev/models/monitor_update_params.rbi

@@ -66,6 +66,7 @@ module ContextDev
       attr_writer :status
 
       # User-defined tags for grouping and filtering monitors and their changes.
+      # Duplicates are removed.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -142,6 +143,7 @@ module ContextDev
         schedule: nil,
         status: nil,
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         tags: nil,
         # Discriminated union describing what the monitor watches.
         target: nil,
@@ -231,9 +233,10 @@ module ContextDev
           sig { params(confidence_threshold: Float).void }
           attr_writer :confidence_threshold
 
-          # 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).
           sig do
             params(confidence_threshold: Float, type: Symbol).returns(
               T.attached_class
@@ -429,6 +432,14 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
+          # Plain-language goal describing which page changes matter. When provided without
+          # change_detection, semantic detection is inferred.
+          sig { returns(T.nilable(String)) }
+          attr_reader :instructions
+
+          sig { params(instructions: String).void }
+          attr_writer :instructions
+
           # Normalize whitespace before comparing or analyzing text.
           sig { returns(T.nilable(T::Boolean)) }
           attr_reader :normalize_whitespace
@@ -436,16 +447,21 @@ module ContextDev
           sig { params(normalize_whitespace: T::Boolean).void }
           attr_writer :normalize_whitespace
 
-          # Watch a single web page.
+          # Watch a single web page. Exact detection reports visible-text diffs; semantic
+          # detection judges confirmed stable diffs against `instructions`.
           sig do
             params(
               url: String,
+              instructions: String,
               normalize_whitespace: T::Boolean,
               type: Symbol
             ).returns(T.attached_class)
           end
           def self.new(
             url:,
+            # Plain-language goal describing which page changes matter. When provided without
+            # change_detection, semantic detection is inferred.
+            instructions: nil,
             # Normalize whitespace before comparing or analyzing text.
             normalize_whitespace: nil,
             type: :page
@@ -454,7 +470,12 @@ module ContextDev
 
           sig do
             override.returns(
-              { type: Symbol, url: String, normalize_whitespace: T::Boolean }
+              {
+                type: Symbol,
+                url: String,
+                instructions: String,
+                normalize_whitespace: T::Boolean
+              }
             )
           end
           def to_hash
@@ -477,14 +498,14 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
-          # URL path patterns to exclude.
+          # URL path patterns to exclude (max 50).
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :exclude
 
           sig { params(exclude: T::Array[String]).void }
           attr_writer :exclude
 
-          # URL path patterns to include.
+          # URL path patterns to include (max 50).
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :include
 
@@ -515,9 +536,9 @@ module ContextDev
           def self.new(
             # Sitemap URL to monitor.
             url:,
-            # URL path patterns to exclude.
+            # URL path patterns to exclude (max 50).
             exclude: nil,
-            # URL path patterns to include.
+            # URL path patterns to include (max 50).
             include: nil,
             # Maximum number of sitemap URLs to track (capped at 10,000).
             max_urls: nil,

data/rbi/context_dev/models/monitor_update_response.rbi

@@ -107,6 +107,7 @@ module ContextDev
       attr_accessor :next_run_at
 
       # User-defined tags for grouping and filtering monitors and their changes.
+      # Duplicates are removed.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -230,6 +231,7 @@ module ContextDev
         # When the next scheduled run is due.
         next_run_at: nil,
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         tags: nil,
         webhook: nil,
         # Present while webhook deliveries are failing consecutively; null when deliveries
@@ -328,9 +330,10 @@ module ContextDev
           sig { params(confidence_threshold: Float).void }
           attr_writer :confidence_threshold
 
-          # 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).
           sig do
             params(confidence_threshold: Float, type: Symbol).returns(
               T.attached_class
@@ -588,6 +591,14 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
+          # Plain-language goal describing which page changes matter. When provided without
+          # change_detection, semantic detection is inferred.
+          sig { returns(T.nilable(String)) }
+          attr_reader :instructions
+
+          sig { params(instructions: String).void }
+          attr_writer :instructions
+
           # Normalize whitespace before comparing or analyzing text.
           sig { returns(T.nilable(T::Boolean)) }
           attr_reader :normalize_whitespace
@@ -595,16 +606,21 @@ module ContextDev
           sig { params(normalize_whitespace: T::Boolean).void }
           attr_writer :normalize_whitespace
 
-          # Watch a single web page.
+          # Watch a single web page. Exact detection reports visible-text diffs; semantic
+          # detection judges confirmed stable diffs against `instructions`.
           sig do
             params(
               url: String,
+              instructions: String,
               normalize_whitespace: T::Boolean,
               type: Symbol
             ).returns(T.attached_class)
           end
           def self.new(
             url:,
+            # Plain-language goal describing which page changes matter. When provided without
+            # change_detection, semantic detection is inferred.
+            instructions: nil,
             # Normalize whitespace before comparing or analyzing text.
             normalize_whitespace: nil,
             type: :page
@@ -613,7 +629,12 @@ module ContextDev
 
           sig do
             override.returns(
-              { type: Symbol, url: String, normalize_whitespace: T::Boolean }
+              {
+                type: Symbol,
+                url: String,
+                instructions: String,
+                normalize_whitespace: T::Boolean
+              }
             )
           end
           def to_hash
@@ -636,14 +657,14 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
-          # URL path patterns to exclude.
+          # URL path patterns to exclude (max 50).
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :exclude
 
           sig { params(exclude: T::Array[String]).void }
           attr_writer :exclude
 
-          # URL path patterns to include.
+          # URL path patterns to include (max 50).
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :include
 
@@ -674,9 +695,9 @@ module ContextDev
           def self.new(
             # Sitemap URL to monitor.
             url:,
-            # URL path patterns to exclude.
+            # URL path patterns to exclude (max 50).
             exclude: nil,
-            # URL path patterns to include.
+            # URL path patterns to include (max 50).
             include: nil,
             # Maximum number of sitemap URLs to track (capped at 10,000).
             max_urls: nil,