context.dev 2.0.0 → 2.2.0

data/rbi/context_dev/models/monitor_list_response.rbi

@@ -114,6 +114,19 @@ module ContextDev
         sig { returns(Time) }
         attr_accessor :updated_at
 
+        # Current baseline: the last observed value the monitor compares new snapshots
+        # against. Its shape follows `target.type` (page/sitemap/extract). Only populated
+        # on GET /monitors/{monitor_id}; null until the first baseline run completes (and
+        # after a target or change_detection update, which resets the baseline).
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::Models::MonitorListResponse::Data::Baseline::Variants
+            )
+          )
+        end
+        attr_accessor :baseline
+
         sig { returns(T.nilable(Time)) }
         attr_accessor :last_change_at
 
@@ -190,6 +203,14 @@ module ContextDev
                 ContextDev::Models::MonitorListResponse::Data::Target::Extract::OrHash
               ),
             updated_at: Time,
+            baseline:
+              T.nilable(
+                T.any(
+                  ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline::OrHash,
+                  ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline::OrHash,
+                  ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline::OrHash
+                )
+              ),
             last_change_at: T.nilable(Time),
             last_error:
               T.nilable(
@@ -226,6 +247,11 @@ module ContextDev
           # Discriminated union describing what the monitor watches.
           target:,
           updated_at:,
+          # Current baseline: the last observed value the monitor compares new snapshots
+          # against. Its shape follows `target.type` (page/sitemap/extract). Only populated
+          # on GET /monitors/{monitor_id}; null until the first baseline run completes (and
+          # after a target or change_detection update, which resets the baseline).
+          baseline: nil,
           last_change_at: nil,
           # Error from the most recent failed run; null when the last run succeeded.
           last_error: nil,
@@ -254,6 +280,10 @@ module ContextDev
               target:
                 ContextDev::Models::MonitorListResponse::Data::Target::Variants,
               updated_at: Time,
+              baseline:
+                T.nilable(
+                  ContextDev::Models::MonitorListResponse::Data::Baseline::Variants
+                ),
               last_change_at: T.nilable(Time),
               last_error:
                 T.nilable(
@@ -316,9 +346,6 @@ module ContextDev
                 )
               end
 
-            sig { returns(String) }
-            attr_accessor :query
-
             sig { returns(Symbol) }
             attr_accessor :type
 
@@ -328,21 +355,19 @@ module ContextDev
             sig { params(confidence_threshold: Float).void }
             attr_writer :confidence_threshold
 
-            # Detect meaning-level changes that match a natural language query.
+            # 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).
             sig do
-              params(
-                query: String,
-                confidence_threshold: Float,
-                type: Symbol
-              ).returns(T.attached_class)
+              params(confidence_threshold: Float, type: Symbol).returns(
+                T.attached_class
+              )
             end
-            def self.new(query:, confidence_threshold: nil, type: :semantic)
+            def self.new(confidence_threshold: nil, type: :semantic)
             end
 
             sig do
-              override.returns(
-                { query: String, type: Symbol, confidence_threshold: Float }
-              )
+              override.returns({ type: Symbol, confidence_threshold: Float })
             end
             def to_hash
             end
@@ -664,8 +689,9 @@ module ContextDev
 
             # Watch a sitemap for URL additions and removals. Crawled URLs are normalized
             # (lowercased host, no trailing slash/fragment) and scoped to the monitored site
-            # and its subdomains before comparison. A new URL set must be observed on two
-            # consecutive runs before a change is reported, suppressing one-run crawl flaps.
+            # and its subdomains before comparison. On a detected difference the sitemap is
+            # re-fetched within the same run and only URLs both observations agree on are
+            # reported, suppressing transient crawl flaps.
             sig do
               params(
                 url: String,
@@ -712,6 +738,11 @@ module ContextDev
                 )
               end
 
+            # Natural-language instructions guiding which pages and facts to track and which
+            # changes to report.
+            sig { returns(String) }
+            attr_accessor :instructions
+
             sig { returns(Symbol) }
             attr_accessor :type
 
@@ -725,13 +756,6 @@ module ContextDev
             sig { params(follow_subdomains: T::Boolean).void }
             attr_writer :follow_subdomains
 
-            # Optional natural-language instructions guiding what to extract.
-            sig { returns(T.nilable(String)) }
-            attr_reader :instructions
-
-            sig { params(instructions: String).void }
-            attr_writer :instructions
-
             # Optional maximum link depth from the starting URL (0 = only the starting page).
             sig { returns(T.nilable(Integer)) }
             attr_reader :max_depth
@@ -739,27 +763,37 @@ module ContextDev
             sig { params(max_depth: Integer).void }
             attr_writer :max_depth
 
-            # Maximum number of pages to analyze during extraction.
+            # Maximum number of pages to track.
             sig { returns(T.nilable(Integer)) }
             attr_reader :max_pages
 
             sig { params(max_pages: Integer).void }
             attr_writer :max_pages
 
-            # JSON Schema describing the structured data to extract and watch for changes. If
-            # omitted, a default summary + key-points schema is used.
+            # JSON Schema describing the data you care about. It is used three ways: it guides
+            # which pages are selected for tracking, it gives the change judge extra context
+            # on which changes matter (alongside `instructions`), and it defines the shape of
+            # the baseline `data` snapshot on GET /monitors/{monitor_id} (refreshed at most
+            # about once a day). It is not a response format for changes: change events and
+            # webhook payloads always contain diffs, summaries, and evidence excerpts — never
+            # data in this schema's shape. If omitted, a default summary + key-points schema
+            # is used.
             sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
             attr_reader :schema
 
             sig { params(schema: T::Hash[Symbol, T.anything]).void }
             attr_writer :schema
 
-            # Watch a site's extracted structured data.
+            # Watch the monitor-relevant pages of a site for meaningful changes. A crawl
+            # guided by `schema`/`instructions` selects up to `max_pages` relevant pages to
+            # track; each run re-checks exactly those pages, and confirmed content changes are
+            # judged for relevance against the monitor's `instructions` (and `schema`, when
+            # provided). The tracked page set is refreshed by a periodic re-discovery crawl.
             sig do
               params(
+                instructions: String,
                 url: String,
                 follow_subdomains: T::Boolean,
-                instructions: String,
                 max_depth: Integer,
                 max_pages: Integer,
                 schema: T::Hash[Symbol, T.anything],
@@ -767,17 +801,24 @@ module ContextDev
               ).returns(T.attached_class)
             end
             def self.new(
+              # Natural-language instructions guiding which pages and facts to track and which
+              # changes to report.
+              instructions:,
               # Root URL to extract structured data from.
               url:,
               follow_subdomains: nil,
-              # Optional natural-language instructions guiding what to extract.
-              instructions: nil,
               # Optional maximum link depth from the starting URL (0 = only the starting page).
               max_depth: nil,
-              # Maximum number of pages to analyze during extraction.
+              # Maximum number of pages to track.
               max_pages: nil,
-              # JSON Schema describing the structured data to extract and watch for changes. If
-              # omitted, a default summary + key-points schema is used.
+              # JSON Schema describing the data you care about. It is used three ways: it guides
+              # which pages are selected for tracking, it gives the change judge extra context
+              # on which changes matter (alongside `instructions`), and it defines the shape of
+              # the baseline `data` snapshot on GET /monitors/{monitor_id} (refreshed at most
+              # about once a day). It is not a response format for changes: change events and
+              # webhook payloads always contain diffs, summaries, and evidence excerpts — never
+              # data in this schema's shape. If omitted, a default summary + key-points schema
+              # is used.
               schema: nil,
               type: :extract
             )
@@ -786,10 +827,10 @@ module ContextDev
             sig do
               override.returns(
                 {
+                  instructions: String,
                   type: Symbol,
                   url: String,
                   follow_subdomains: T::Boolean,
-                  instructions: String,
                   max_depth: Integer,
                   max_pages: Integer,
                   schema: T::Hash[Symbol, T.anything]
@@ -811,6 +852,179 @@ module ContextDev
           end
         end
 
+        # Current baseline: the last observed value the monitor compares new snapshots
+        # against. Its shape follows `target.type` (page/sitemap/extract). Only populated
+        # on GET /monitors/{monitor_id}; null until the first baseline run completes (and
+        # after a target or change_detection update, which resets the baseline).
+        module Baseline
+          extend ContextDev::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline,
+                ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline,
+                ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline
+              )
+            end
+
+          class MonitorsPageBaseline < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsPageBaseline,
+                  ContextDev::Internal::AnyHash
+                )
+              end
+
+            # When this baseline was last captured or replaced.
+            sig { returns(Time) }
+            attr_accessor :captured_at
+
+            # The page's visible text as last observed.
+            sig { returns(String) }
+            attr_accessor :text
+
+            # Current baseline of a `page` monitor: the visible page text as last observed.
+            sig do
+              params(captured_at: Time, text: String).returns(T.attached_class)
+            end
+            def self.new(
+              # When this baseline was last captured or replaced.
+              captured_at:,
+              # The page's visible text as last observed.
+              text:
+            )
+            end
+
+            sig { override.returns({ captured_at: Time, text: String }) }
+            def to_hash
+            end
+          end
+
+          class MonitorsSitemapBaseline < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsSitemapBaseline,
+                  ContextDev::Internal::AnyHash
+                )
+              end
+
+            # When this baseline was last captured or replaced.
+            sig { returns(Time) }
+            attr_accessor :captured_at
+
+            # Number of URLs in the baseline.
+            sig { returns(Integer) }
+            attr_accessor :url_count
+
+            # The sitemap URLs as last observed (sorted, normalized).
+            sig { returns(T::Array[String]) }
+            attr_accessor :urls
+
+            # Current baseline of a `sitemap` monitor: the normalized URL set as last
+            # observed.
+            sig do
+              params(
+                captured_at: Time,
+                url_count: Integer,
+                urls: T::Array[String]
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # When this baseline was last captured or replaced.
+              captured_at:,
+              # Number of URLs in the baseline.
+              url_count:,
+              # The sitemap URLs as last observed (sorted, normalized).
+              urls:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  captured_at: Time,
+                  url_count: Integer,
+                  urls: T::Array[String]
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+
+          class MonitorsExtractBaseline < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Models::MonitorListResponse::Data::Baseline::MonitorsExtractBaseline,
+                  ContextDev::Internal::AnyHash
+                )
+              end
+
+            # When this baseline was last captured or replaced.
+            sig { returns(Time) }
+            attr_accessor :captured_at
+
+            # The extracted structured data, matching the monitor's extraction schema (same
+            # shape as the /web/extract endpoint's `data`). Refreshed when the monitor
+            # re-discovers its page set (at most about once a day); `null` when no extraction
+            # has been captured yet.
+            sig { returns(T.anything) }
+            attr_accessor :data
+
+            # The page URLs the monitor tracks and analyzes for changes.
+            sig { returns(T::Array[String]) }
+            attr_accessor :urls_analyzed
+
+            # Current baseline of an `extract` monitor: the pages it tracks and the structured
+            # data as last extracted.
+            sig do
+              params(
+                captured_at: Time,
+                data: T.anything,
+                urls_analyzed: T::Array[String]
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # When this baseline was last captured or replaced.
+              captured_at:,
+              # The extracted structured data, matching the monitor's extraction schema (same
+              # shape as the /web/extract endpoint's `data`). Refreshed when the monitor
+              # re-discovers its page set (at most about once a day); `null` when no extraction
+              # has been captured yet.
+              data:,
+              # The page URLs the monitor tracks and analyzes for changes.
+              urls_analyzed:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  captured_at: Time,
+                  data: T.anything,
+                  urls_analyzed: T::Array[String]
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::MonitorListResponse::Data::Baseline::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
+
         class LastError < ContextDev::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/context_dev/models/monitor_list_runs_response.rbi

@@ -139,6 +139,26 @@ module ContextDev
         sig { returns(T.nilable(Time)) }
         attr_accessor :started_at
 
+        # The webhook delivery attempted for a change detected by this run. Omitted when
+        # no webhook was attempted, including historical runs created before delivery
+        # tracking was added.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery
+            )
+          )
+        end
+        attr_reader :webhook_delivery
+
+        sig do
+          params(
+            webhook_delivery:
+              ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::OrHash
+          ).void
+        end
+        attr_writer :webhook_delivery
+
         sig do
           params(
             id: String,
@@ -164,7 +184,9 @@ module ContextDev
               T.nilable(
                 ContextDev::Models::MonitorListRunsResponse::Data::SkipReason::OrSymbol
               ),
-            started_at: T.nilable(Time)
+            started_at: T.nilable(Time),
+            webhook_delivery:
+              ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -188,7 +210,11 @@ module ContextDev
           error: nil,
           # Why a skipped run never executed; null unless status is `skipped`.
           skip_reason: nil,
-          started_at: nil
+          started_at: nil,
+          # The webhook delivery attempted for a change detected by this run. Omitted when
+          # no webhook was attempted, including historical runs created before delivery
+          # tracking was added.
+          webhook_delivery: nil
         )
         end
 
@@ -218,7 +244,9 @@ module ContextDev
                 T.nilable(
                   ContextDev::Models::MonitorListRunsResponse::Data::SkipReason::TaggedSymbol
                 ),
-              started_at: T.nilable(Time)
+              started_at: T.nilable(Time),
+              webhook_delivery:
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery
             }
           )
         end
@@ -449,6 +477,179 @@ module ContextDev
           def self.values
           end
         end
+
+        class WebhookDelivery < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Time) }
+          attr_accessor :attempted_at
+
+          sig do
+            returns(
+              T.nilable(
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error
+              )
+            )
+          end
+          attr_reader :error
+
+          sig do
+            params(
+              error:
+                T.nilable(
+                  ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error::OrHash
+                )
+            ).void
+          end
+          attr_writer :error
+
+          # Identifier sent in the X-Context-Id header.
+          sig { returns(String) }
+          attr_accessor :event_id
+
+          # The endpoint's final HTTP response status, or null when no response was
+          # received.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :http_status
+
+          # Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+          # response; failed means no HTTP response was received; skipped_unsafe_url means
+          # the URL failed the public-endpoint safety check.
+          sig do
+            returns(
+              ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+            )
+          end
+          attr_accessor :status
+
+          # The webhook delivery attempted for a change detected by this run. Omitted when
+          # no webhook was attempted, including historical runs created before delivery
+          # tracking was added.
+          sig do
+            params(
+              attempted_at: Time,
+              error:
+                T.nilable(
+                  ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error::OrHash
+                ),
+              event_id: String,
+              http_status: T.nilable(Integer),
+              status:
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            attempted_at:,
+            error:,
+            # Identifier sent in the X-Context-Id header.
+            event_id:,
+            # The endpoint's final HTTP response status, or null when no response was
+            # received.
+            http_status:,
+            # Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+            # response; failed means no HTTP response was received; skipped_unsafe_url means
+            # the URL failed the public-endpoint safety check.
+            status:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                attempted_at: Time,
+                error:
+                  T.nilable(
+                    ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error
+                  ),
+                event_id: String,
+                http_status: T.nilable(Integer),
+                status:
+                  ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Error < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Error,
+                  ContextDev::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :code
+
+            sig { returns(String) }
+            attr_accessor :message
+
+            sig do
+              params(code: String, message: String).returns(T.attached_class)
+            end
+            def self.new(code:, message:)
+            end
+
+            sig { override.returns({ code: String, message: String }) }
+            def to_hash
+            end
+          end
+
+          # Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+          # response; failed means no HTTP response was received; skipped_unsafe_url means
+          # the URL failed the public-endpoint safety check.
+          module Status
+            extend ContextDev::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            DELIVERED =
+              T.let(
+                :delivered,
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+            REJECTED =
+              T.let(
+                :rejected,
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+            SKIPPED_UNSAFE_URL =
+              T.let(
+                :skipped_unsafe_url,
+                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
     end
   end

data/rbi/context_dev/models/monitor_retrieve_change_response.rbi

@@ -145,12 +145,6 @@ module ContextDev
       sig { params(matched_urls: T::Array[String]).void }
       attr_writer :matched_urls
 
-      sig { returns(T.nilable(String)) }
-      attr_reader :query
-
-      sig { params(query: String).void }
-      attr_writer :query
-
       sig { returns(T.nilable(Integer)) }
       attr_reader :removed_url_count
 
@@ -205,7 +199,6 @@ module ContextDev
             ContextDev::Models::MonitorRetrieveChangeResponse::Importance::OrSymbol,
           matched_url_count: Integer,
           matched_urls: T::Array[String],
-          query: String,
           removed_url_count: Integer,
           removed_urls: T::Array[String],
           tags: T::Array[String]
@@ -238,7 +231,6 @@ module ContextDev
         matched_url_count: nil,
         # At most 500 URLs are included; the corresponding count field is always exact.
         matched_urls: nil,
-        query: nil,
         removed_url_count: nil,
         # At most 500 URLs are included; the corresponding count field is always exact.
         removed_urls: nil,
@@ -277,7 +269,6 @@ module ContextDev
               ContextDev::Models::MonitorRetrieveChangeResponse::Importance::TaggedSymbol,
             matched_url_count: Integer,
             matched_urls: T::Array[String],
-            query: String,
             removed_url_count: Integer,
             removed_urls: T::Array[String],
             tags: T::Array[String]