context.dev 2.21.0 → 2.22.0

data/rbi/context_dev/models/monitor_list_account_changes_response.rbi

@@ -24,6 +24,29 @@ module ContextDev
       sig { returns(T.nilable(String)) }
       attr_accessor :next_cursor
 
+      # Unique ID of this request, also in `X-Request-Id`. Include it when contacting
+      # support.
+      sig { returns(String) }
+      attr_accessor :request_id
+
+      # Credits this request used and your remaining balance.
+      sig do
+        returns(
+          T.nilable(
+            ContextDev::Models::MonitorListAccountChangesResponse::KeyMetadata
+          )
+        )
+      end
+      attr_reader :key_metadata
+
+      sig do
+        params(
+          key_metadata:
+            ContextDev::Models::MonitorListAccountChangesResponse::KeyMetadata::OrHash
+        ).void
+      end
+      attr_writer :key_metadata
+
       sig do
         params(
           data:
@@ -31,10 +54,22 @@ module ContextDev
               ContextDev::Models::MonitorListAccountChangesResponse::Data::OrHash
             ],
           has_more: T::Boolean,
-          next_cursor: T.nilable(String)
+          next_cursor: T.nilable(String),
+          request_id: String,
+          key_metadata:
+            ContextDev::Models::MonitorListAccountChangesResponse::KeyMetadata::OrHash
         ).returns(T.attached_class)
       end
-      def self.new(data:, has_more:, next_cursor:)
+      def self.new(
+        data:,
+        has_more:,
+        next_cursor:,
+        # Unique ID of this request, also in `X-Request-Id`. Include it when contacting
+        # support.
+        request_id:,
+        # Credits this request used and your remaining balance.
+        key_metadata: nil
+      )
       end
 
       sig do
@@ -45,7 +80,10 @@ module ContextDev
                 ContextDev::Models::MonitorListAccountChangesResponse::Data
               ],
             has_more: T::Boolean,
-            next_cursor: T.nilable(String)
+            next_cursor: T.nilable(String),
+            request_id: String,
+            key_metadata:
+              ContextDev::Models::MonitorListAccountChangesResponse::KeyMetadata
           }
         )
       end
@@ -74,8 +112,7 @@ module ContextDev
         sig { returns(Time) }
         attr_accessor :detected_at
 
-        # Top-level monitor category. Always `web` today; the concrete behavior is
-        # described by `target` and `change_detection`.
+        # Always `web`. Optional.
         sig do
           returns(
             ContextDev::Models::MonitorListAccountChangesResponse::Data::Mode::TaggedSymbol
@@ -86,9 +123,17 @@ module ContextDev
         sig { returns(String) }
         attr_accessor :monitor_id
 
+        # The run that detected this change.
+        sig { returns(String) }
+        attr_accessor :run_id
+
         sig { returns(String) }
         attr_accessor :summary
 
+        # Labels for filtering monitors, their changes, and their usage.
+        sig { returns(T::Array[String]) }
+        attr_accessor :tags
+
         sig do
           returns(
             ContextDev::Models::MonitorListAccountChangesResponse::Data::TargetType::TaggedSymbol
@@ -108,12 +153,59 @@ module ContextDev
         sig { params(added_url_count: Integer).void }
         attr_writer :added_url_count
 
+        # At most 500 URLs are included; the corresponding count field is always exact.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :added_urls
+
+        sig { params(added_urls: T::Array[String]).void }
+        attr_writer :added_urls
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :after_text_excerpt
+
+        sig { params(after_text_excerpt: String).void }
+        attr_writer :after_text_excerpt
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :before_text_excerpt
+
+        sig { params(before_text_excerpt: String).void }
+        attr_writer :before_text_excerpt
+
         sig { returns(T.nilable(Float)) }
         attr_reader :confidence
 
         sig { params(confidence: Float).void }
         attr_writer :confidence
 
+        # Text diff between the previous and current page baseline (page targets).
+        sig { returns(T.nilable(String)) }
+        attr_reader :diff
+
+        sig { params(diff: String).void }
+        attr_writer :diff
+
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                ContextDev::Models::MonitorListAccountChangesResponse::Data::Evidence
+              ]
+            )
+          )
+        end
+        attr_reader :evidence
+
+        sig do
+          params(
+            evidence:
+              T::Array[
+                ContextDev::Models::MonitorListAccountChangesResponse::Data::Evidence::OrHash
+              ]
+          ).void
+        end
+        attr_writer :evidence
+
         sig do
           returns(
             T.nilable(
@@ -137,25 +229,27 @@ module ContextDev
         sig { params(matched_url_count: Integer).void }
         attr_writer :matched_url_count
 
+        # At most 500 URLs are included; the corresponding count field is always exact.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :matched_urls
+
+        sig { params(matched_urls: T::Array[String]).void }
+        attr_writer :matched_urls
+
         sig { returns(T.nilable(Integer)) }
         attr_reader :removed_url_count
 
         sig { params(removed_url_count: Integer).void }
         attr_writer :removed_url_count
 
-        # User-defined tags for grouping and filtering monitors and their changes.
-        # Duplicates are removed.
+        # At most 500 URLs are included; the corresponding count field is always exact.
         sig { returns(T.nilable(T::Array[String])) }
-        attr_reader :tags
+        attr_reader :removed_urls
 
-        sig { params(tags: T::Array[String]).void }
-        attr_writer :tags
+        sig { params(removed_urls: T::Array[String]).void }
+        attr_writer :removed_urls
 
-        # A lightweight change summary. `mode` is the constant `web`; `target_type` and
-        # `change_detection_type` describe the change, and which optional fields are
-        # present depends on them (e.g. sitemap changes include
-        # `added_url_count`/`removed_url_count`; semantic changes include
-        # `confidence`/`importance`).
+        # Detected change, including applicable diffs, URLs, and supporting evidence.
         sig do
           params(
             id: String,
@@ -165,40 +259,62 @@ module ContextDev
             mode:
               ContextDev::Models::MonitorListAccountChangesResponse::Data::Mode::OrSymbol,
             monitor_id: String,
+            run_id: String,
             summary: String,
+            tags: T::Array[String],
             target_type:
               ContextDev::Models::MonitorListAccountChangesResponse::Data::TargetType::OrSymbol,
             title: String,
             url: String,
             added_url_count: Integer,
+            added_urls: T::Array[String],
+            after_text_excerpt: String,
+            before_text_excerpt: String,
             confidence: Float,
+            diff: String,
+            evidence:
+              T::Array[
+                ContextDev::Models::MonitorListAccountChangesResponse::Data::Evidence::OrHash
+              ],
             importance:
               ContextDev::Models::MonitorListAccountChangesResponse::Data::Importance::OrSymbol,
             matched_url_count: Integer,
+            matched_urls: T::Array[String],
             removed_url_count: Integer,
-            tags: T::Array[String]
+            removed_urls: T::Array[String]
           ).returns(T.attached_class)
         end
         def self.new(
           id:,
           change_detection_type:,
           detected_at:,
-          # Top-level monitor category. Always `web` today; the concrete behavior is
-          # described by `target` and `change_detection`.
+          # Always `web`. Optional.
           mode:,
           monitor_id:,
+          # The run that detected this change.
+          run_id:,
           summary:,
+          # Labels for filtering monitors, their changes, and their usage.
+          tags:,
           target_type:,
           title:,
           url:,
           added_url_count: nil,
+          # At most 500 URLs are included; the corresponding count field is always exact.
+          added_urls: nil,
+          after_text_excerpt: nil,
+          before_text_excerpt: nil,
           confidence: nil,
+          # Text diff between the previous and current page baseline (page targets).
+          diff: nil,
+          evidence: nil,
           importance: nil,
           matched_url_count: nil,
+          # At most 500 URLs are included; the corresponding count field is always exact.
+          matched_urls: nil,
           removed_url_count: nil,
-          # User-defined tags for grouping and filtering monitors and their changes.
-          # Duplicates are removed.
-          tags: nil
+          # At most 500 URLs are included; the corresponding count field is always exact.
+          removed_urls: nil
         )
         end
 
@@ -212,18 +328,29 @@ module ContextDev
               mode:
                 ContextDev::Models::MonitorListAccountChangesResponse::Data::Mode::TaggedSymbol,
               monitor_id: String,
+              run_id: String,
               summary: String,
+              tags: T::Array[String],
               target_type:
                 ContextDev::Models::MonitorListAccountChangesResponse::Data::TargetType::TaggedSymbol,
               title: String,
               url: String,
               added_url_count: Integer,
+              added_urls: T::Array[String],
+              after_text_excerpt: String,
+              before_text_excerpt: String,
               confidence: Float,
+              diff: String,
+              evidence:
+                T::Array[
+                  ContextDev::Models::MonitorListAccountChangesResponse::Data::Evidence
+                ],
               importance:
                 ContextDev::Models::MonitorListAccountChangesResponse::Data::Importance::TaggedSymbol,
               matched_url_count: Integer,
+              matched_urls: T::Array[String],
               removed_url_count: Integer,
-              tags: T::Array[String]
+              removed_urls: T::Array[String]
             }
           )
         end
@@ -264,8 +391,7 @@ module ContextDev
           end
         end
 
-        # Top-level monitor category. Always `web` today; the concrete behavior is
-        # described by `target` and `change_detection`.
+        # Always `web`. Optional.
         module Mode
           extend ContextDev::Internal::Type::Enum
 
@@ -334,6 +460,52 @@ module ContextDev
           end
         end
 
+        class Evidence < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::MonitorListAccountChangesResponse::Data::Evidence,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Snapshot of the content after the change.
+          sig { returns(String) }
+          attr_accessor :after
+
+          # Snapshot of the content before the change.
+          sig { returns(String) }
+          attr_accessor :before
+
+          # Optional URL the evidence relates to. Absent for whole-target diffs.
+          sig { returns(T.nilable(String)) }
+          attr_reader :url
+
+          sig { params(url: String).void }
+          attr_writer :url
+
+          sig do
+            params(after: String, before: String, url: String).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # Snapshot of the content after the change.
+            after:,
+            # Snapshot of the content before the change.
+            before:,
+            # Optional URL the evidence relates to. Absent for whole-target diffs.
+            url: nil
+          )
+          end
+
+          sig do
+            override.returns({ after: String, before: String, url: String })
+          end
+          def to_hash
+          end
+        end
+
         module Importance
           extend ContextDev::Internal::Type::Enum
 
@@ -373,6 +545,46 @@ module ContextDev
           end
         end
       end
+
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::MonitorListAccountChangesResponse::KeyMetadata,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Credits charged for this request.
+        sig { returns(Integer) }
+        attr_accessor :credits_consumed
+
+        # Credits remaining for your organization.
+        sig { returns(Integer) }
+        attr_accessor :credits_remaining
+
+        # Credits this request used and your remaining balance.
+        sig do
+          params(credits_consumed: Integer, credits_remaining: Integer).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Credits charged for this request.
+          credits_consumed:,
+          # Credits remaining for your organization.
+          credits_remaining:
+        )
+        end
+
+        sig do
+          override.returns(
+            { credits_consumed: Integer, credits_remaining: Integer }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/monitor_list_account_runs_response.rbi

@@ -24,6 +24,29 @@ module ContextDev
       sig { returns(T.nilable(String)) }
       attr_accessor :next_cursor
 
+      # Unique ID of this request, also in `X-Request-Id`. Include it when contacting
+      # support.
+      sig { returns(String) }
+      attr_accessor :request_id
+
+      # Credits this request used and your remaining balance.
+      sig do
+        returns(
+          T.nilable(
+            ContextDev::Models::MonitorListAccountRunsResponse::KeyMetadata
+          )
+        )
+      end
+      attr_reader :key_metadata
+
+      sig do
+        params(
+          key_metadata:
+            ContextDev::Models::MonitorListAccountRunsResponse::KeyMetadata::OrHash
+        ).void
+      end
+      attr_writer :key_metadata
+
       sig do
         params(
           data:
@@ -31,10 +54,22 @@ module ContextDev
               ContextDev::Models::MonitorListAccountRunsResponse::Data::OrHash
             ],
           has_more: T::Boolean,
-          next_cursor: T.nilable(String)
+          next_cursor: T.nilable(String),
+          request_id: String,
+          key_metadata:
+            ContextDev::Models::MonitorListAccountRunsResponse::KeyMetadata::OrHash
         ).returns(T.attached_class)
       end
-      def self.new(data:, has_more:, next_cursor:)
+      def self.new(
+        data:,
+        has_more:,
+        next_cursor:,
+        # Unique ID of this request, also in `X-Request-Id`. Include it when contacting
+        # support.
+        request_id:,
+        # Credits this request used and your remaining balance.
+        key_metadata: nil
+      )
       end
 
       sig do
@@ -45,7 +80,10 @@ module ContextDev
                 ContextDev::Models::MonitorListAccountRunsResponse::Data
               ],
             has_more: T::Boolean,
-            next_cursor: T.nilable(String)
+            next_cursor: T.nilable(String),
+            request_id: String,
+            key_metadata:
+              ContextDev::Models::MonitorListAccountRunsResponse::KeyMetadata
           }
         )
       end
@@ -86,7 +124,7 @@ module ContextDev
         sig { returns(String) }
         attr_accessor :monitor_id
 
-        # The first run after monitor creation is a baseline run.
+        # A baseline run follows creation or a target or detection change.
         sig do
           returns(
             ContextDev::Models::MonitorListAccountRunsResponse::Data::RunType::TaggedSymbol
@@ -161,9 +199,7 @@ module ContextDev
         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.
+        # Deprecated. Use `webhook_deliveries` for all attempts.
         sig { returns(T.nilable(ContextDev::WebhookDelivery)) }
         attr_reader :webhook_delivery
 
@@ -220,7 +256,7 @@ module ContextDev
           # Credits charged for this run (0 for skipped/failed runs).
           credits_charged:,
           monitor_id:,
-          # The first run after monitor creation is a baseline run.
+          # A baseline run follows creation or a target or detection change.
           run_type:,
           # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
           # (insufficient credits, monitor paused, or superseded by a concurrent run).
@@ -236,9 +272,7 @@ module ContextDev
           # 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.
+          # Deprecated. Use `webhook_deliveries` for all attempts.
           webhook_delivery: nil,
           # Webhook delivery IDs for this run.
           webhook_delivery_ids: nil
@@ -315,7 +349,7 @@ module ContextDev
           end
         end
 
-        # The first run after monitor creation is a baseline run.
+        # A baseline run follows creation or a target or detection change.
         module RunType
           extend ContextDev::Internal::Type::Enum
 
@@ -506,6 +540,46 @@ module ContextDev
           end
         end
       end
+
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::MonitorListAccountRunsResponse::KeyMetadata,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Credits charged for this request.
+        sig { returns(Integer) }
+        attr_accessor :credits_consumed
+
+        # Credits remaining for your organization.
+        sig { returns(Integer) }
+        attr_accessor :credits_remaining
+
+        # Credits this request used and your remaining balance.
+        sig do
+          params(credits_consumed: Integer, credits_remaining: Integer).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Credits charged for this request.
+          credits_consumed:,
+          # Credits remaining for your organization.
+          credits_remaining:
+        )
+        end
+
+        sig do
+          override.returns(
+            { credits_consumed: Integer, credits_remaining: Integer }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/monitor_list_changes_params.rbi

@@ -14,6 +14,7 @@ module ContextDev
           )
         end
 
+      # ID of the monitor.
       sig { returns(String) }
       attr_accessor :monitor_id
 
@@ -64,6 +65,7 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
+        # ID of the monitor.
         monitor_id:,
         # Opaque pagination cursor from a previous response.
         cursor: nil,