context.dev 2.4.0 → 2.6.0

data/rbi/context_dev/models/monitor_create_response.rbi

@@ -25,6 +25,12 @@ module ContextDev
       sig { returns(Time) }
       attr_accessor :created_at
 
+      # The baseline run queued by this create call, or null if it could not be queued
+      # immediately (in which case the baseline runs on the next scheduled tick). Poll
+      # GET /monitors/{monitor_id}/runs/{run_id}.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :initial_run_id
+
       # Top-level monitor category. Always `web` today; the concrete behavior is
       # described by `target` and `change_detection`.
       sig do
@@ -107,6 +113,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
 
@@ -148,8 +155,8 @@ module ContextDev
       end
       attr_writer :webhook_failure
 
-      # A web monitor. `mode` is the constant `web`; behavior is described by `target`
-      # (page/sitemap/extract) and `change_detection` (exact/semantic).
+      # A newly created monitor plus `initial_run_id`, the id of the baseline run queued
+      # at creation.
       sig do
         params(
           id: String,
@@ -159,6 +166,7 @@ module ContextDev
               ContextDev::Models::MonitorCreateResponse::ChangeDetection::Semantic::OrHash
             ),
           created_at: Time,
+          initial_run_id: T.nilable(String),
           mode: ContextDev::Models::MonitorCreateResponse::Mode::OrSymbol,
           name: String,
           schedule: ContextDev::Models::MonitorCreateResponse::Schedule::OrHash,
@@ -201,6 +209,10 @@ module ContextDev
         # Discriminated union describing how changes are detected.
         change_detection:,
         created_at:,
+        # The baseline run queued by this create call, or null if it could not be queued
+        # immediately (in which case the baseline runs on the next scheduled tick). Poll
+        # GET /monitors/{monitor_id}/runs/{run_id}.
+        initial_run_id:,
         # Top-level monitor category. Always `web` today; the concrete behavior is
         # described by `target` and `change_detection`.
         mode:,
@@ -230,6 +242,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
@@ -246,6 +259,7 @@ module ContextDev
             change_detection:
               ContextDev::Models::MonitorCreateResponse::ChangeDetection::Variants,
             created_at: Time,
+            initial_run_id: T.nilable(String),
             mode: ContextDev::Models::MonitorCreateResponse::Mode::TaggedSymbol,
             name: String,
             schedule: ContextDev::Models::MonitorCreateResponse::Schedule,
@@ -328,9 +342,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 +603,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 +618,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 +641,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 +669,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 +707,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_get_credit_usage_params.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class MonitorGetCreditUsageParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::MonitorGetCreditUsageParams,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Only include items at or after this ISO 8601 timestamp.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :since
+
+      sig { params(since: Time).void }
+      attr_writer :since
+
+      # Only include items before this ISO 8601 timestamp.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :until_
+
+      sig { params(until_: Time).void }
+      attr_writer :until_
+
+      sig do
+        params(
+          since: Time,
+          until_: Time,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Only include items at or after this ISO 8601 timestamp.
+        since: nil,
+        # Only include items before this ISO 8601 timestamp.
+        until_: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            since: Time,
+            until_: Time,
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/context_dev/models/monitor_get_credit_usage_response.rbi

@@ -0,0 +1,111 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class MonitorGetCreditUsageResponse < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::Models::MonitorGetCreditUsageResponse,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      sig do
+        returns(
+          T::Array[ContextDev::Models::MonitorGetCreditUsageResponse::Data]
+        )
+      end
+      attr_accessor :data
+
+      # Sum of credits across all monitors in the window.
+      sig { returns(Integer) }
+      attr_accessor :total_credits
+
+      sig do
+        params(
+          data:
+            T::Array[
+              ContextDev::Models::MonitorGetCreditUsageResponse::Data::OrHash
+            ],
+          total_credits: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        data:,
+        # Sum of credits across all monitors in the window.
+        total_credits:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            data:
+              T::Array[ContextDev::Models::MonitorGetCreditUsageResponse::Data],
+            total_credits: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::MonitorGetCreditUsageResponse::Data,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Credits charged to this monitor over the window.
+        sig { returns(Integer) }
+        attr_accessor :credits
+
+        sig { returns(String) }
+        attr_accessor :monitor_id
+
+        # Monitor name (falls back to the id when the monitor was deleted).
+        sig { returns(String) }
+        attr_accessor :name
+
+        # Number of billed runs over the window.
+        sig { returns(Integer) }
+        attr_accessor :runs
+
+        sig do
+          params(
+            credits: Integer,
+            monitor_id: String,
+            name: String,
+            runs: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Credits charged to this monitor over the window.
+          credits:,
+          monitor_id:,
+          # Monitor name (falls back to the id when the monitor was deleted).
+          name:,
+          # Number of billed runs over the window.
+          runs:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              credits: Integer,
+              monitor_id: String,
+              name: String,
+              runs: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models/monitor_get_limits_params.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class MonitorGetLimitsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::MonitorGetLimitsParams,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      sig do
+        params(request_options: ContextDev::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: ContextDev::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/context_dev/models/monitor_get_limits_response.rbi

@@ -0,0 +1,105 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class MonitorGetLimitsResponse < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::Models::MonitorGetLimitsResponse,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Maximum number of monitors allowed for the account. Defaults to the plan
+      # allowance unless a custom limit is set for the organization.
+      sig { returns(Integer) }
+      attr_accessor :monitors_limit
+
+      # Number of monitors the account currently has.
+      sig { returns(Integer) }
+      attr_accessor :monitors_used
+
+      # The plan tier the limit was resolved from.
+      sig do
+        returns(
+          ContextDev::Models::MonitorGetLimitsResponse::Plan::TaggedSymbol
+        )
+      end
+      attr_accessor :plan
+
+      sig do
+        params(
+          monitors_limit: Integer,
+          monitors_used: Integer,
+          plan: ContextDev::Models::MonitorGetLimitsResponse::Plan::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Maximum number of monitors allowed for the account. Defaults to the plan
+        # allowance unless a custom limit is set for the organization.
+        monitors_limit:,
+        # Number of monitors the account currently has.
+        monitors_used:,
+        # The plan tier the limit was resolved from.
+        plan:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            monitors_limit: Integer,
+            monitors_used: Integer,
+            plan:
+              ContextDev::Models::MonitorGetLimitsResponse::Plan::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The plan tier the limit was resolved from.
+      module Plan
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::Models::MonitorGetLimitsResponse::Plan)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        FREE =
+          T.let(
+            :free,
+            ContextDev::Models::MonitorGetLimitsResponse::Plan::TaggedSymbol
+          )
+        STARTER =
+          T.let(
+            :starter,
+            ContextDev::Models::MonitorGetLimitsResponse::Plan::TaggedSymbol
+          )
+        PRO =
+          T.let(
+            :pro,
+            ContextDev::Models::MonitorGetLimitsResponse::Plan::TaggedSymbol
+          )
+        SCALE =
+          T.let(
+            :scale,
+            ContextDev::Models::MonitorGetLimitsResponse::Plan::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::Models::MonitorGetLimitsResponse::Plan::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models/monitor_list_account_changes_params.rbi

@@ -14,6 +14,7 @@ module ContextDev
           )
         end
 
+      # Filter by change detection type.
       sig do
         returns(
           T.nilable(
@@ -31,24 +32,28 @@ 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
 
       sig { params(limit: Integer).void }
       attr_writer :limit
 
+      # Filter changes to a single monitor.
       sig { returns(T.nilable(String)) }
       attr_reader :monitor_id
 
       sig { params(monitor_id: String).void }
       attr_writer :monitor_id
 
+      # Only include items at or after this ISO 8601 timestamp.
       sig { returns(T.nilable(Time)) }
       attr_reader :since
 
@@ -62,6 +67,7 @@ module ContextDev
       sig { params(tag: String).void }
       attr_writer :tag
 
+      # Filter by target type.
       sig do
         returns(
           T.nilable(
@@ -79,6 +85,7 @@ module ContextDev
       end
       attr_writer :target_type
 
+      # Only include items before this ISO 8601 timestamp.
       sig { returns(T.nilable(Time)) }
       attr_reader :until_
 
@@ -101,14 +108,21 @@ module ContextDev
         ).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,
+        # Filter changes to a single monitor.
         monitor_id: nil,
+        # Only include items at or after this ISO 8601 timestamp.
         since: nil,
         # Filter to items that have this tag.
         tag: nil,
+        # Filter by target type.
         target_type: nil,
+        # Only include items before this ISO 8601 timestamp.
         until_: nil,
         request_options: {}
       )
@@ -134,6 +148,7 @@ module ContextDev
       def to_hash
       end
 
+      # Filter by change detection type.
       module ChangeDetectionType
         extend ContextDev::Internal::Type::Enum
 
@@ -168,6 +183,7 @@ module ContextDev
         end
       end
 
+      # Filter by target type.
       module TargetType
         extend ContextDev::Internal::Type::Enum
 

data/rbi/context_dev/models/monitor_list_account_changes_response.rbi

@@ -144,6 +144,7 @@ module ContextDev
         attr_writer :removed_url_count
 
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :tags
 
@@ -196,6 +197,7 @@ module ContextDev
           matched_url_count: nil,
           removed_url_count: nil,
           # User-defined tags for grouping and filtering monitors and their changes.
+          # Duplicates are removed.
           tags: nil
         )
         end

data/rbi/context_dev/models/monitor_list_account_runs_params.rbi

@@ -14,20 +14,21 @@ module ContextDev
           )
         end
 
+      # 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::MonitorListAccountRunsParams::Status::OrSymbol)
@@ -51,10 +52,11 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
+        # 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: {}
       )
@@ -73,8 +75,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_list_changes_params.rbi

@@ -17,18 +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
 
+      # Only include items at or after this ISO 8601 timestamp.
       sig { returns(T.nilable(Time)) }
       attr_reader :since
 
@@ -42,6 +45,7 @@ module ContextDev
       sig { params(tag: String).void }
       attr_writer :tag
 
+      # Only include items before this ISO 8601 timestamp.
       sig { returns(T.nilable(Time)) }
       attr_reader :until_
 
@@ -61,11 +65,15 @@ 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,
+        # Only include items at or after this ISO 8601 timestamp.
         since: nil,
         # Filter to items that have this tag.
         tag: nil,
+        # Only include items before this ISO 8601 timestamp.
         until_: nil,
         request_options: {}
       )

data/rbi/context_dev/models/monitor_list_changes_response.rbi

@@ -140,6 +140,7 @@ module ContextDev
         attr_writer :removed_url_count
 
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :tags
 
@@ -192,6 +193,7 @@ module ContextDev
           matched_url_count: nil,
           removed_url_count: nil,
           # User-defined tags for grouping and filtering monitors and their changes.
+          # Duplicates are removed.
           tags: nil
         )
         end