context.dev 2.5.0 → 2.7.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
@@ -149,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,
@@ -160,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,
@@ -202,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:,
@@ -248,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,
@@ -330,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
@@ -590,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
@@ -597,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
@@ -615,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

data/rbi/context_dev/models/monitor_list_response.rbi

@@ -391,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
@@ -654,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
@@ -661,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
@@ -679,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

data/rbi/context_dev/models/monitor_retrieve_response.rbi

@@ -338,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
@@ -598,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
@@ -605,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
@@ -623,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

data/rbi/context_dev/models/monitor_update_params.rbi

@@ -233,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
@@ -431,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
@@ -438,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
@@ -456,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

data/rbi/context_dev/models/monitor_update_response.rbi

@@ -330,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
@@ -590,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
@@ -597,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
@@ -615,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

data/rbi/context_dev/models/page_error_count.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class PageErrorCount < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(ContextDev::PageErrorCount, ContextDev::Internal::AnyHash)
+        end
+
+      # Error code for these failures.
+      sig { returns(String) }
+      attr_accessor :code
+
+      # Pages that failed with this code.
+      sig { returns(Integer) }
+      attr_accessor :count
+
+      # Page failures sharing one error code.
+      sig { params(code: String, count: Integer).returns(T.attached_class) }
+      def self.new(
+        # Error code for these failures.
+        code:,
+        # Pages that failed with this code.
+        count:
+      )
+      end
+
+      sig { override.returns({ code: String, count: Integer }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/context_dev/models/web_screenshot_params.rbi

@@ -27,9 +27,8 @@ module ContextDev
       end
       attr_writer :color_scheme
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       sig do
         returns(T.nilable(ContextDev::WebScreenshotParams::Country::OrSymbol))
       end
@@ -201,9 +200,8 @@ module ContextDev
         # Optional parameter to choose the site's visual theme in the screenshot. Use
         # 'light' or 'dark' when the site offers both appearances.
         color_scheme: nil,
-        # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-        # residential proxy exit location. Must be one of Context.dev's supported
-        # countries. When provided, Context.dev fetches the target page from that country.
+        # Fetch the target page through a residential proxy in this country (ISO 3166-1
+        # alpha-2).
         country: nil,
         # A specific URL to screenshot directly, bypassing domain resolution (e.g.,
         # 'https://example.com/pricing'). When provided, the screenshot is taken of this
@@ -322,9 +320,8 @@ module ContextDev
         end
       end
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum
 

data/rbi/context_dev/models/web_web_crawl_md_params.rbi

@@ -15,9 +15,8 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       sig do
         returns(T.nilable(ContextDev::WebWebCrawlMdParams::Country::OrSymbol))
       end
@@ -213,9 +212,8 @@ module ContextDev
       def self.new(
         # The starting URL for the crawl (must include http:// or https:// protocol)
         url:,
-        # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-        # residential proxy exit location. Must be one of Context.dev's supported
-        # countries. When provided, Context.dev fetches the target page from that country.
+        # Fetch the target page through a residential proxy in this country (ISO 3166-1
+        # alpha-2).
         country: nil,
         # CSS selectors to remove before each crawled page is converted to Markdown.
         # Applied after includeSelectors. Exclusion takes precedence: an element matching
@@ -313,9 +311,8 @@ module ContextDev
       def to_hash
       end
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum
 

data/rbi/context_dev/models/web_web_scrape_html_params.rbi

@@ -35,9 +35,8 @@ module ContextDev
       end
       attr_accessor :actions
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       sig do
         returns(
           T.nilable(ContextDev::WebWebScrapeHTMLParams::Country::OrSymbol)
@@ -246,9 +245,8 @@ module ContextDev
         # content is captured. Requires a paid plan. Send a JSON array in the query
         # parameter. Maximum: 5 actions.
         actions: nil,
-        # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-        # residential proxy exit location. Must be one of Context.dev's supported
-        # countries. When provided, Context.dev fetches the target page from that country.
+        # Fetch the target page through a residential proxy in this country (ISO 3166-1
+        # alpha-2).
         country: nil,
         # CSS selectors to remove from the result. Applied after includeSelectors.
         # Exclusion takes precedence: an element matching both is removed. Examples:
@@ -417,9 +415,8 @@ module ContextDev
         end
       end
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum