context.dev 2.1.0 → 2.3.0

data/rbi/context_dev/models/monitor_create_response.rbi

@@ -128,6 +128,26 @@ 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::MonitorCreateResponse::WebhookFailure)
+        )
+      end
+      attr_reader :webhook_failure
+
+      sig do
+        params(
+          webhook_failure:
+            T.nilable(
+              ContextDev::Models::MonitorCreateResponse::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
@@ -169,6 +189,10 @@ module ContextDev
           webhook:
             T.nilable(
               ContextDev::Models::MonitorCreateResponse::Webhook::OrHash
+            ),
+          webhook_failure:
+            T.nilable(
+              ContextDev::Models::MonitorCreateResponse::WebhookFailure::OrHash
             )
         ).returns(T.attached_class)
       end
@@ -207,7 +231,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
 
@@ -236,7 +264,11 @@ module ContextDev
             next_run_at: T.nilable(Time),
             tags: T::Array[String],
             webhook:
-              T.nilable(ContextDev::Models::MonitorCreateResponse::Webhook)
+              T.nilable(ContextDev::Models::MonitorCreateResponse::Webhook),
+            webhook_failure:
+              T.nilable(
+                ContextDev::Models::MonitorCreateResponse::WebhookFailure
+              )
           }
         )
       end
@@ -296,9 +328,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 +740,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 +757,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 +781,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
           )
@@ -983,10 +1025,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::MonitorCreateResponse::Webhook::Event::TaggedSymbol
+              ]
+            )
+          )
+        end
+        attr_reader :events
+
+        sig do
+          params(
+            events:
+              T::Array[
+                ContextDev::Models::MonitorCreateResponse::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
@@ -998,10 +1065,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::MonitorCreateResponse::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
@@ -1011,9 +1092,166 @@ module ContextDev
         )
         end
 
-        sig { override.returns({ url: String, secret: String }) }
+        sig do
+          override.returns(
+            {
+              url: String,
+              events:
+                T::Array[
+                  ContextDev::Models::MonitorCreateResponse::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::MonitorCreateResponse::Webhook::Event
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          CHANGE_DETECTED =
+            T.let(
+              :"change.detected",
+              ContextDev::Models::MonitorCreateResponse::Webhook::Event::TaggedSymbol
+            )
+          RUN_COMPLETED =
+            T.let(
+              :"run.completed",
+              ContextDev::Models::MonitorCreateResponse::Webhook::Event::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::MonitorCreateResponse::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::MonitorCreateResponse::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::MonitorCreateResponse::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::MonitorCreateResponse::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::MonitorCreateResponse::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::MonitorCreateResponse::WebhookFailure::LastStatus
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          REJECTED =
+            T.let(
+              :rejected,
+              ContextDev::Models::MonitorCreateResponse::WebhookFailure::LastStatus::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              ContextDev::Models::MonitorCreateResponse::WebhookFailure::LastStatus::TaggedSymbol
+            )
+          SKIPPED_UNSAFE_URL =
+            T.let(
+              :skipped_unsafe_url,
+              ContextDev::Models::MonitorCreateResponse::WebhookFailure::LastStatus::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::MonitorCreateResponse::WebhookFailure::LastStatus::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/context_dev/models/monitor_list_account_runs_response.rbi

@@ -148,6 +148,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,
@@ -173,7 +197,9 @@ module ContextDev
               T.nilable(
                 ContextDev::Models::MonitorListAccountRunsResponse::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(
@@ -197,7 +223,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
 
@@ -227,7 +261,9 @@ module ContextDev
                 T.nilable(
                   ContextDev::Models::MonitorListAccountRunsResponse::Data::SkipReason::TaggedSymbol
                 ),
-              started_at: T.nilable(Time)
+              started_at: T.nilable(Time),
+              webhook_deliveries: T::Array[ContextDev::WebhookDelivery],
+              webhook_delivery: ContextDev::WebhookDelivery
             }
           )
         end