context.dev 2.5.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
@@ -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/web_web_scrape_html_response.rbi

@@ -52,6 +52,36 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # One verified outcome per requested browser action, in request order.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied
+            ]
+          )
+        )
+      end
+      attr_reader :actions_applied
+
+      sig do
+        params(
+          actions_applied:
+            T::Array[
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::OrHash
+            ]
+        ).void
+      end
+      attr_writer :actions_applied
+
+      # True when an action was applied but the returned content could not be refreshed
+      # afterward.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :actions_html_stale
+
+      sig { params(actions_html_stale: T::Boolean).void }
+      attr_writer :actions_html_stale
+
       # Metadata about the API key used for the request. Included in every response
       # whenever a valid API key is provided, even when the response status is not 200.
       sig do
@@ -78,6 +108,11 @@ module ContextDev
             ContextDev::Models::WebWebScrapeHTMLResponse::Success::OrBoolean,
           type: ContextDev::Models::WebWebScrapeHTMLResponse::Type::OrSymbol,
           url: String,
+          actions_applied:
+            T::Array[
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::OrHash
+            ],
+          actions_html_stale: T::Boolean,
           key_metadata:
             ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata::OrHash
         ).returns(T.attached_class)
@@ -98,6 +133,11 @@ module ContextDev
         type:,
         # The URL that was scraped
         url:,
+        # One verified outcome per requested browser action, in request order.
+        actions_applied: nil,
+        # True when an action was applied but the returned content could not be refreshed
+        # afterward.
+        actions_html_stale: nil,
         # Metadata about the API key used for the request. Included in every response
         # whenever a valid API key is provided, even when the response status is not 200.
         key_metadata: nil
@@ -114,6 +154,11 @@ module ContextDev
             type:
               ContextDev::Models::WebWebScrapeHTMLResponse::Type::TaggedSymbol,
             url: String,
+            actions_applied:
+              T::Array[
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied
+              ],
+            actions_html_stale: T::Boolean,
             key_metadata:
               ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata
           }
@@ -705,6 +750,143 @@ module ContextDev
         end
       end
 
+      class ActionsApplied < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :instruction
+
+        # Applied means the requested page state was visibly verified. Failed means it was
+        # not verified. Skipped means it was not attempted.
+        sig do
+          returns(
+            ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Visible page evidence used to verify an applied action.
+        sig { returns(T.nilable(String)) }
+        attr_reader :completion_evidence
+
+        sig { params(completion_evidence: String).void }
+        attr_writer :completion_evidence
+
+        sig { returns(T.nilable(Float)) }
+        attr_reader :duration_ms
+
+        sig { params(duration_ms: Float).void }
+        attr_writer :duration_ms
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :error
+
+        sig { params(error: String).void }
+        attr_writer :error
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :method_
+
+        sig { params(method_: String).void }
+        attr_writer :method_
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :target_description
+
+        sig { params(target_description: String).void }
+        attr_writer :target_description
+
+        sig do
+          params(
+            instruction: String,
+            status:
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::OrSymbol,
+            completion_evidence: String,
+            duration_ms: Float,
+            error: String,
+            method_: String,
+            target_description: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          instruction:,
+          # Applied means the requested page state was visibly verified. Failed means it was
+          # not verified. Skipped means it was not attempted.
+          status:,
+          # Visible page evidence used to verify an applied action.
+          completion_evidence: nil,
+          duration_ms: nil,
+          error: nil,
+          method_: nil,
+          target_description: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              instruction: String,
+              status:
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol,
+              completion_evidence: String,
+              duration_ms: Float,
+              error: String,
+              method_: String,
+              target_description: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Applied means the requested page state was visibly verified. Failed means it was
+        # not verified. Skipped means it was not attempted.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          APPLIED =
+            T.let(
+              :applied,
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+            )
+          SKIPPED =
+            T.let(
+              :skipped,
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do