context.dev 2.1.0 → 2.3.0

data/rbi/context_dev/models/monitor_list_response.rbi

@@ -179,6 +179,28 @@ module ContextDev
         end
         attr_writer :webhook
 
+        # Present while webhook deliveries are failing consecutively; null when deliveries
+        # are healthy or no webhook is configured. Cleared on the next successful delivery
+        # and when the webhook URL changes.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::Models::MonitorListResponse::Data::WebhookFailure
+            )
+          )
+        end
+        attr_reader :webhook_failure
+
+        sig do
+          params(
+            webhook_failure:
+              T.nilable(
+                ContextDev::Models::MonitorListResponse::Data::WebhookFailure::OrHash
+              )
+          ).void
+        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).
         sig do
@@ -222,6 +244,10 @@ module ContextDev
             webhook:
               T.nilable(
                 ContextDev::Models::MonitorListResponse::Data::Webhook::OrHash
+              ),
+            webhook_failure:
+              T.nilable(
+                ContextDev::Models::MonitorListResponse::Data::WebhookFailure::OrHash
               )
           ).returns(T.attached_class)
         end
@@ -260,7 +286,11 @@ module ContextDev
           next_run_at: nil,
           # User-defined tags for grouping and filtering monitors and their changes.
           tags: nil,
-          webhook: nil
+          webhook: nil,
+          # Present while webhook deliveries are failing consecutively; null when deliveries
+          # are healthy or no webhook is configured. Cleared on the next successful delivery
+          # and when the webhook URL changes.
+          webhook_failure: nil
         )
         end
 
@@ -295,6 +325,10 @@ module ContextDev
               webhook:
                 T.nilable(
                   ContextDev::Models::MonitorListResponse::Data::Webhook
+                ),
+              webhook_failure:
+                T.nilable(
+                  ContextDev::Models::MonitorListResponse::Data::WebhookFailure
                 )
             }
           )
@@ -355,9 +389,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 +804,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 +821,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 +845,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
             )
@@ -1051,10 +1095,35 @@ module ContextDev
               )
             end
 
-          # Webhook URL called when a change is detected.
+          # Webhook URL events are delivered to.
           sig { returns(String) }
           attr_accessor :url
 
+          # Events delivered to this endpoint. `change.detected` fires only when a run
+          # detects a change; `run.completed` fires on every completed run — including runs
+          # that detected no change — and embeds the change when one was detected. Defaults
+          # to `["change.detected"]` when omitted.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  ContextDev::Models::MonitorListResponse::Data::Webhook::Event::TaggedSymbol
+                ]
+              )
+            )
+          end
+          attr_reader :events
+
+          sig do
+            params(
+              events:
+                T::Array[
+                  ContextDev::Models::MonitorListResponse::Data::Webhook::Event::OrSymbol
+                ]
+            ).void
+          end
+          attr_writer :events
+
           # Signing secret used to verify webhook authenticity. Each delivery includes an
           # `X-Context-Signature: t=<unix>,v1=<hmac>` header, where the HMAC is SHA-256 over
           # `"{t}.{rawRequestBody}"` keyed by this secret. Recompute it with a constant-time
@@ -1066,10 +1135,24 @@ module ContextDev
           sig { params(secret: String).void }
           attr_writer :secret
 
-          sig { params(url: String, secret: String).returns(T.attached_class) }
+          sig do
+            params(
+              url: String,
+              events:
+                T::Array[
+                  ContextDev::Models::MonitorListResponse::Data::Webhook::Event::OrSymbol
+                ],
+              secret: String
+            ).returns(T.attached_class)
+          end
           def self.new(
-            # Webhook URL called when a change is detected.
+            # Webhook URL events are delivered to.
             url:,
+            # Events delivered to this endpoint. `change.detected` fires only when a run
+            # detects a change; `run.completed` fires on every completed run — including runs
+            # that detected no change — and embeds the change when one was detected. Defaults
+            # to `["change.detected"]` when omitted.
+            events: nil,
             # Signing secret used to verify webhook authenticity. Each delivery includes an
             # `X-Context-Signature: t=<unix>,v1=<hmac>` header, where the HMAC is SHA-256 over
             # `"{t}.{rawRequestBody}"` keyed by this secret. Recompute it with a constant-time
@@ -1079,9 +1162,166 @@ module ContextDev
           )
           end
 
-          sig { override.returns({ url: String, secret: String }) }
+          sig do
+            override.returns(
+              {
+                url: String,
+                events:
+                  T::Array[
+                    ContextDev::Models::MonitorListResponse::Data::Webhook::Event::TaggedSymbol
+                  ],
+                secret: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module Event
+            extend ContextDev::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ContextDev::Models::MonitorListResponse::Data::Webhook::Event
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CHANGE_DETECTED =
+              T.let(
+                :"change.detected",
+                ContextDev::Models::MonitorListResponse::Data::Webhook::Event::TaggedSymbol
+              )
+            RUN_COMPLETED =
+              T.let(
+                :"run.completed",
+                ContextDev::Models::MonitorListResponse::Data::Webhook::Event::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::MonitorListResponse::Data::Webhook::Event::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        class WebhookFailure < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::MonitorListResponse::Data::WebhookFailure,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Number of consecutive delivery attempts that did not succeed.
+          sig { returns(Integer) }
+          attr_accessor :consecutive_failures
+
+          sig { returns(Time) }
+          attr_accessor :last_failed_at
+
+          # Human-readable description of the most recent failure.
+          sig { returns(String) }
+          attr_accessor :last_message
+
+          # Outcome of the most recent failed delivery. 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::MonitorListResponse::Data::WebhookFailure::LastStatus::TaggedSymbol
+            )
+          end
+          attr_accessor :last_status
+
+          # Present while webhook deliveries are failing consecutively; null when deliveries
+          # are healthy or no webhook is configured. Cleared on the next successful delivery
+          # and when the webhook URL changes.
+          sig do
+            params(
+              consecutive_failures: Integer,
+              last_failed_at: Time,
+              last_message: String,
+              last_status:
+                ContextDev::Models::MonitorListResponse::Data::WebhookFailure::LastStatus::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Number of consecutive delivery attempts that did not succeed.
+            consecutive_failures:,
+            last_failed_at:,
+            # Human-readable description of the most recent failure.
+            last_message:,
+            # Outcome of the most recent failed delivery. 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.
+            last_status:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                consecutive_failures: Integer,
+                last_failed_at: Time,
+                last_message: String,
+                last_status:
+                  ContextDev::Models::MonitorListResponse::Data::WebhookFailure::LastStatus::TaggedSymbol
+              }
+            )
+          end
           def to_hash
           end
+
+          # Outcome of the most recent failed delivery. 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 LastStatus
+            extend ContextDev::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ContextDev::Models::MonitorListResponse::Data::WebhookFailure::LastStatus
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            REJECTED =
+              T.let(
+                :rejected,
+                ContextDev::Models::MonitorListResponse::Data::WebhookFailure::LastStatus::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                ContextDev::Models::MonitorListResponse::Data::WebhookFailure::LastStatus::TaggedSymbol
+              )
+            SKIPPED_UNSAFE_URL =
+              T.let(
+                :skipped_unsafe_url,
+                ContextDev::Models::MonitorListResponse::Data::WebhookFailure::LastStatus::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::MonitorListResponse::Data::WebhookFailure::LastStatus::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
       end
     end

data/rbi/context_dev/models/monitor_list_runs_response.rbi

@@ -139,6 +139,30 @@ module ContextDev
         sig { returns(T.nilable(Time)) }
         attr_accessor :started_at
 
+        # All webhook deliveries attempted by this run — one per subscribed event that
+        # fired. Omitted when no webhook was attempted, including runs created before
+        # event selection was added.
+        sig { returns(T.nilable(T::Array[ContextDev::WebhookDelivery])) }
+        attr_reader :webhook_deliveries
+
+        sig do
+          params(
+            webhook_deliveries: T::Array[ContextDev::WebhookDelivery::OrHash]
+          ).void
+        end
+        attr_writer :webhook_deliveries
+
+        # Deprecated: use `webhook_deliveries`, which records every attempt now that a run
+        # can deliver multiple events. Omitted when no webhook was attempted, including
+        # historical runs created before delivery tracking was added.
+        sig { returns(T.nilable(ContextDev::WebhookDelivery)) }
+        attr_reader :webhook_delivery
+
+        sig do
+          params(webhook_delivery: ContextDev::WebhookDelivery::OrHash).void
+        end
+        attr_writer :webhook_delivery
+
         sig do
           params(
             id: String,
@@ -164,7 +188,9 @@ module ContextDev
               T.nilable(
                 ContextDev::Models::MonitorListRunsResponse::Data::SkipReason::OrSymbol
               ),
-            started_at: T.nilable(Time)
+            started_at: T.nilable(Time),
+            webhook_deliveries: T::Array[ContextDev::WebhookDelivery::OrHash],
+            webhook_delivery: ContextDev::WebhookDelivery::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -188,7 +214,15 @@ module ContextDev
           error: nil,
           # Why a skipped run never executed; null unless status is `skipped`.
           skip_reason: nil,
-          started_at: nil
+          started_at: nil,
+          # All webhook deliveries attempted by this run — one per subscribed event that
+          # fired. Omitted when no webhook was attempted, including runs created before
+          # event selection was added.
+          webhook_deliveries: nil,
+          # Deprecated: use `webhook_deliveries`, which records every attempt now that a run
+          # can deliver multiple events. Omitted when no webhook was attempted, including
+          # historical runs created before delivery tracking was added.
+          webhook_delivery: nil
         )
         end
 
@@ -218,7 +252,9 @@ module ContextDev
                 T.nilable(
                   ContextDev::Models::MonitorListRunsResponse::Data::SkipReason::TaggedSymbol
                 ),
-              started_at: T.nilable(Time)
+              started_at: T.nilable(Time),
+              webhook_deliveries: T::Array[ContextDev::WebhookDelivery],
+              webhook_delivery: ContextDev::WebhookDelivery
             }
           )
         end

data/rbi/context_dev/models/monitor_retrieve_change_response.rbi

@@ -43,6 +43,10 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :summary
 
+      # User-defined tags for grouping and filtering monitors and their changes.
+      sig { returns(T::Array[String]) }
+      attr_accessor :tags
+
       sig do
         returns(
           ContextDev::Models::MonitorRetrieveChangeResponse::TargetType::TaggedSymbol
@@ -158,18 +162,11 @@ module ContextDev
       sig { params(removed_urls: T::Array[String]).void }
       attr_writer :removed_urls
 
-      # User-defined tags for grouping and filtering monitors and their changes.
-      sig { returns(T.nilable(T::Array[String])) }
-      attr_reader :tags
-
-      sig { params(tags: T::Array[String]).void }
-      attr_writer :tags
-
       # A detected change. `mode` is the constant `web`; `target_type` and
       # `change_detection_type` describe the change, and which optional fields are
       # present depends on them (page: `diff` + excerpts; sitemap:
       # `added_urls`/`removed_urls`; semantic:
-      # `query`/`confidence`/`importance`/`evidence`/`matched_urls`).
+      # `confidence`/`importance`/`evidence`/`matched_urls`).
       sig do
         params(
           id: String,
@@ -181,6 +178,7 @@ module ContextDev
           monitor_id: String,
           run_id: String,
           summary: String,
+          tags: T::Array[String],
           target_type:
             ContextDev::Models::MonitorRetrieveChangeResponse::TargetType::OrSymbol,
           title: String,
@@ -200,8 +198,7 @@ module ContextDev
           matched_url_count: Integer,
           matched_urls: T::Array[String],
           removed_url_count: Integer,
-          removed_urls: T::Array[String],
-          tags: T::Array[String]
+          removed_urls: T::Array[String]
         ).returns(T.attached_class)
       end
       def self.new(
@@ -215,6 +212,8 @@ module ContextDev
         # The run that detected this change.
         run_id:,
         summary:,
+        # User-defined tags for grouping and filtering monitors and their changes.
+        tags:,
         target_type:,
         title:,
         url:,
@@ -233,9 +232,7 @@ module ContextDev
         matched_urls: nil,
         removed_url_count: nil,
         # At most 500 URLs are included; the corresponding count field is always exact.
-        removed_urls: nil,
-        # User-defined tags for grouping and filtering monitors and their changes.
-        tags: nil
+        removed_urls: nil
       )
       end
 
@@ -251,6 +248,7 @@ module ContextDev
             monitor_id: String,
             run_id: String,
             summary: String,
+            tags: T::Array[String],
             target_type:
               ContextDev::Models::MonitorRetrieveChangeResponse::TargetType::TaggedSymbol,
             title: String,
@@ -270,8 +268,7 @@ module ContextDev
             matched_url_count: Integer,
             matched_urls: T::Array[String],
             removed_url_count: Integer,
-            removed_urls: T::Array[String],
-            tags: T::Array[String]
+            removed_urls: T::Array[String]
           }
         )
       end