context.dev 2.2.0 → 2.4.0

data/rbi/context_dev/models/monitor_list_runs_response.rbi

@@ -139,23 +139,27 @@ 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.
+        # 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
-          returns(
-            T.nilable(
-              ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery
-            )
-          )
+          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::Models::MonitorListRunsResponse::Data::WebhookDelivery::OrHash
-          ).void
+          params(webhook_delivery: ContextDev::WebhookDelivery::OrHash).void
         end
         attr_writer :webhook_delivery
 
@@ -185,8 +189,8 @@ module ContextDev
                 ContextDev::Models::MonitorListRunsResponse::Data::SkipReason::OrSymbol
               ),
             started_at: T.nilable(Time),
-            webhook_delivery:
-              ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery::OrHash
+            webhook_deliveries: T::Array[ContextDev::WebhookDelivery::OrHash],
+            webhook_delivery: ContextDev::WebhookDelivery::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -211,9 +215,13 @@ module ContextDev
           # Why a skipped run never executed; null unless status is `skipped`.
           skip_reason: 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.
+          # 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
@@ -245,8 +253,8 @@ module ContextDev
                   ContextDev::Models::MonitorListRunsResponse::Data::SkipReason::TaggedSymbol
                 ),
               started_at: T.nilable(Time),
-              webhook_delivery:
-                ContextDev::Models::MonitorListRunsResponse::Data::WebhookDelivery
+              webhook_deliveries: T::Array[ContextDev::WebhookDelivery],
+              webhook_delivery: ContextDev::WebhookDelivery
             }
           )
         end
@@ -477,179 +485,6 @@ 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

@@ -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

data/rbi/context_dev/models/monitor_retrieve_response.rbi

@@ -133,6 +133,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::MonitorRetrieveResponse::WebhookFailure)
+        )
+      end
+      attr_reader :webhook_failure
+
+      sig do
+        params(
+          webhook_failure:
+            T.nilable(
+              ContextDev::Models::MonitorRetrieveResponse::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
@@ -175,6 +195,10 @@ module ContextDev
           webhook:
             T.nilable(
               ContextDev::Models::MonitorRetrieveResponse::Webhook::OrHash
+            ),
+          webhook_failure:
+            T.nilable(
+              ContextDev::Models::MonitorRetrieveResponse::WebhookFailure::OrHash
             )
         ).returns(T.attached_class)
       end
@@ -213,7 +237,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
 
@@ -244,7 +272,11 @@ module ContextDev
             next_run_at: T.nilable(Time),
             tags: T::Array[String],
             webhook:
-              T.nilable(ContextDev::Models::MonitorRetrieveResponse::Webhook)
+              T.nilable(ContextDev::Models::MonitorRetrieveResponse::Webhook),
+            webhook_failure:
+              T.nilable(
+                ContextDev::Models::MonitorRetrieveResponse::WebhookFailure
+              )
           }
         )
       end
@@ -1001,10 +1033,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::MonitorRetrieveResponse::Webhook::Event::TaggedSymbol
+              ]
+            )
+          )
+        end
+        attr_reader :events
+
+        sig do
+          params(
+            events:
+              T::Array[
+                ContextDev::Models::MonitorRetrieveResponse::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
@@ -1016,10 +1073,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::MonitorRetrieveResponse::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
@@ -1029,9 +1100,166 @@ module ContextDev
         )
         end
 
-        sig { override.returns({ url: String, secret: String }) }
+        sig do
+          override.returns(
+            {
+              url: String,
+              events:
+                T::Array[
+                  ContextDev::Models::MonitorRetrieveResponse::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::MonitorRetrieveResponse::Webhook::Event
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          CHANGE_DETECTED =
+            T.let(
+              :"change.detected",
+              ContextDev::Models::MonitorRetrieveResponse::Webhook::Event::TaggedSymbol
+            )
+          RUN_COMPLETED =
+            T.let(
+              :"run.completed",
+              ContextDev::Models::MonitorRetrieveResponse::Webhook::Event::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::MonitorRetrieveResponse::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::MonitorRetrieveResponse::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::MonitorRetrieveResponse::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::MonitorRetrieveResponse::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::MonitorRetrieveResponse::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::MonitorRetrieveResponse::WebhookFailure::LastStatus
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          REJECTED =
+            T.let(
+              :rejected,
+              ContextDev::Models::MonitorRetrieveResponse::WebhookFailure::LastStatus::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              ContextDev::Models::MonitorRetrieveResponse::WebhookFailure::LastStatus::TaggedSymbol
+            )
+          SKIPPED_UNSAFE_URL =
+            T.let(
+              :skipped_unsafe_url,
+              ContextDev::Models::MonitorRetrieveResponse::WebhookFailure::LastStatus::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::MonitorRetrieveResponse::WebhookFailure::LastStatus::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end