context.dev 2.1.0 → 2.2.0

data/lib/context_dev/models/monitor_update_response.rb

@@ -153,7 +153,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::Models::MonitorUpdateResponse::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+        # 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).
         variant :semantic, -> { ContextDev::Models::MonitorUpdateResponse::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -181,9 +181,9 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to the extracted data, ignoring cosmetic or
-          #   paraphrase-only differences. What is watched is determined by the extract
-          #   target's `schema` and `instructions`.
+          #   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).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -295,7 +295,7 @@ 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. 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.
         variant :sitemap, -> { ContextDev::Models::MonitorUpdateResponse::Target::Sitemap }
 
-        # 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 against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+        # 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.
         variant :extract, -> { ContextDev::Models::MonitorUpdateResponse::Target::Extract }
 
         class Page < ContextDev::Internal::Type::BaseModel
@@ -410,9 +410,14 @@ module ContextDev
           optional :max_pages, Integer
 
           # @!attribute schema
-          #   JSON Schema describing the data you care about. It guides which pages are
-          #   selected for tracking and gives the change judge context on what matters. 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.
           #
           #   @return [Hash{Symbol=>Object}, nil]
           optional :schema, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
@@ -424,8 +429,8 @@ module ContextDev
           #   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 against the monitor's instructions. The tracked page set is refreshed by
-          #   a periodic re-discovery crawl.
+          #   judged for relevance against the monitor's `instructions` (and `schema`, when
+          #   provided). The tracked page set is refreshed by a periodic re-discovery crawl.
           #
           #   @param instructions [String] Natural-language instructions guiding which pages and facts to track and which c
           #
@@ -437,7 +442,7 @@ module ContextDev
           #
           #   @param max_pages [Integer] Maximum number of pages to track.
           #
-          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It guides which pages are select
+          #   @param schema [Hash{Symbol=>Object}] JSON Schema describing the data you care about. It is used three ways: it guides
           #
           #   @param type [Symbol, :extract]
         end

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "2.1.0"
+  VERSION = "2.2.0"
 end

data/rbi/context_dev/models/monitor_create_params.rbi

@@ -195,9 +195,9 @@ module ContextDev
           sig { params(confidence_threshold: Float).void }
           attr_writer :confidence_threshold
 
-          # Detect meaning-level changes to the extracted data, ignoring cosmetic or
-          # paraphrase-only differences. What is watched is determined by the extract
-          # target's `schema` and `instructions`.
+          # 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(confidence_threshold: Float, type: Symbol).returns(
               T.attached_class
@@ -522,9 +522,14 @@ module ContextDev
           sig { params(max_pages: Integer).void }
           attr_writer :max_pages
 
-          # JSON Schema describing the data you care about. It guides which pages are
-          # selected for tracking and gives the change judge context on what matters. 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
 
@@ -534,8 +539,8 @@ module ContextDev
           # 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 against the monitor's instructions. The tracked page set is refreshed by
-          # a periodic re-discovery crawl.
+          # 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,
@@ -558,9 +563,14 @@ module ContextDev
             max_depth: nil,
             # Maximum number of pages to track.
             max_pages: nil,
-            # JSON Schema describing the data you care about. It guides which pages are
-            # selected for tracking and gives the change judge context on what matters. 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
           )

data/rbi/context_dev/models/monitor_create_response.rbi

@@ -296,9 +296,9 @@ module ContextDev
           sig { params(confidence_threshold: Float).void }
           attr_writer :confidence_threshold
 
-          # Detect meaning-level changes to the extracted data, ignoring cosmetic or
-          # paraphrase-only differences. What is watched is determined by the extract
-          # target's `schema` and `instructions`.
+          # 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(confidence_threshold: Float, type: Symbol).returns(
               T.attached_class
@@ -708,9 +708,14 @@ module ContextDev
           sig { params(max_pages: Integer).void }
           attr_writer :max_pages
 
-          # JSON Schema describing the data you care about. It guides which pages are
-          # selected for tracking and gives the change judge context on what matters. 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
 
@@ -720,8 +725,8 @@ module ContextDev
           # 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 against the monitor's instructions. The tracked page set is refreshed by
-          # a periodic re-discovery crawl.
+          # 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,
@@ -744,9 +749,14 @@ module ContextDev
             max_depth: nil,
             # Maximum number of pages to track.
             max_pages: nil,
-            # JSON Schema describing the data you care about. It guides which pages are
-            # selected for tracking and gives the change judge context on what matters. 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
           )

data/rbi/context_dev/models/monitor_list_account_runs_response.rbi

@@ -148,6 +148,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::MonitorListAccountRunsResponse::Data::WebhookDelivery
+            )
+          )
+        end
+        attr_reader :webhook_delivery
+
+        sig do
+          params(
+            webhook_delivery:
+              ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::OrHash
+          ).void
+        end
+        attr_writer :webhook_delivery
+
         sig do
           params(
             id: String,
@@ -173,7 +193,9 @@ module ContextDev
               T.nilable(
                 ContextDev::Models::MonitorListAccountRunsResponse::Data::SkipReason::OrSymbol
               ),
-            started_at: T.nilable(Time)
+            started_at: T.nilable(Time),
+            webhook_delivery:
+              ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -197,7 +219,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
 
@@ -227,7 +253,9 @@ module ContextDev
                 T.nilable(
                   ContextDev::Models::MonitorListAccountRunsResponse::Data::SkipReason::TaggedSymbol
                 ),
-              started_at: T.nilable(Time)
+              started_at: T.nilable(Time),
+              webhook_delivery:
+                ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery
             }
           )
         end
@@ -458,6 +486,179 @@ module ContextDev
           def self.values
           end
         end
+
+        class WebhookDelivery < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Time) }
+          attr_accessor :attempted_at
+
+          sig do
+            returns(
+              T.nilable(
+                ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Error
+              )
+            )
+          end
+          attr_reader :error
+
+          sig do
+            params(
+              error:
+                T.nilable(
+                  ContextDev::Models::MonitorListAccountRunsResponse::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::MonitorListAccountRunsResponse::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::MonitorListAccountRunsResponse::Data::WebhookDelivery::Error::OrHash
+                ),
+              event_id: String,
+              http_status: T.nilable(Integer),
+              status:
+                ContextDev::Models::MonitorListAccountRunsResponse::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::MonitorListAccountRunsResponse::Data::WebhookDelivery::Error
+                  ),
+                event_id: String,
+                http_status: T.nilable(Integer),
+                status:
+                  ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Error < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Models::MonitorListAccountRunsResponse::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::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            DELIVERED =
+              T.let(
+                :delivered,
+                ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+            REJECTED =
+              T.let(
+                :rejected,
+                ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+            SKIPPED_UNSAFE_URL =
+              T.let(
+                :skipped_unsafe_url,
+                ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::MonitorListAccountRunsResponse::Data::WebhookDelivery::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
     end
   end

data/rbi/context_dev/models/monitor_list_response.rbi

@@ -355,9 +355,9 @@ module ContextDev
             sig { params(confidence_threshold: Float).void }
             attr_writer :confidence_threshold
 
-            # Detect meaning-level changes to the extracted data, ignoring cosmetic or
-            # paraphrase-only differences. What is watched is determined by the extract
-            # target's `schema` and `instructions`.
+            # 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(confidence_threshold: Float, type: Symbol).returns(
                 T.attached_class
@@ -770,9 +770,14 @@ module ContextDev
             sig { params(max_pages: Integer).void }
             attr_writer :max_pages
 
-            # JSON Schema describing the data you care about. It guides which pages are
-            # selected for tracking and gives the change judge context on what matters. 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
 
@@ -782,8 +787,8 @@ module ContextDev
             # 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 against the monitor's instructions. The tracked page set is refreshed by
-            # a periodic re-discovery crawl.
+            # 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,
@@ -806,9 +811,14 @@ module ContextDev
               max_depth: nil,
               # Maximum number of pages to track.
               max_pages: nil,
-              # JSON Schema describing the data you care about. It guides which pages are
-              # selected for tracking and gives the change judge context on what matters. 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
             )