context.dev 2.15.0 → 2.17.0

data/rbi/context_dev/models/monitor_retrieve_response.rbi

@@ -599,6 +599,27 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
+          # CSS selectors for HTML regions to remove before text extraction. Applied after
+          # include_selectors; exclusion takes precedence when an element matches both. Omit
+          # or pass an empty array to apply no explicit exclusions. Changing these selectors
+          # creates a new baseline.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :exclude_selectors
+
+          sig { params(exclude_selectors: T::Array[String]).void }
+          attr_writer :exclude_selectors
+
+          # CSS selectors defining the HTML regions to monitor. Matching subtrees are
+          # combined in document order before text extraction, instead of automatic
+          # main-content selection. Omit or pass an empty array to use automatic
+          # main-content extraction. If the filtered page has no usable text, the run fails
+          # without replacing the baseline. Changing these selectors creates a new baseline.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :include_selectors
+
+          sig { params(include_selectors: T::Array[String]).void }
+          attr_writer :include_selectors
+
           # Plain-language goal describing which page changes matter. When provided without
           # change_detection, semantic detection is inferred.
           sig { returns(T.nilable(String)) }
@@ -619,6 +640,8 @@ module ContextDev
           sig do
             params(
               url: String,
+              exclude_selectors: T::Array[String],
+              include_selectors: T::Array[String],
               instructions: String,
               normalize_whitespace: T::Boolean,
               type: Symbol
@@ -626,6 +649,17 @@ module ContextDev
           end
           def self.new(
             url:,
+            # CSS selectors for HTML regions to remove before text extraction. Applied after
+            # include_selectors; exclusion takes precedence when an element matches both. Omit
+            # or pass an empty array to apply no explicit exclusions. Changing these selectors
+            # creates a new baseline.
+            exclude_selectors: nil,
+            # CSS selectors defining the HTML regions to monitor. Matching subtrees are
+            # combined in document order before text extraction, instead of automatic
+            # main-content selection. Omit or pass an empty array to use automatic
+            # main-content extraction. If the filtered page has no usable text, the run fails
+            # without replacing the baseline. Changing these selectors creates a new baseline.
+            include_selectors: nil,
             # Plain-language goal describing which page changes matter. When provided without
             # change_detection, semantic detection is inferred.
             instructions: nil,
@@ -640,6 +674,8 @@ module ContextDev
               {
                 type: Symbol,
                 url: String,
+                exclude_selectors: T::Array[String],
+                include_selectors: T::Array[String],
                 instructions: String,
                 normalize_whitespace: T::Boolean
               }
@@ -1054,7 +1090,8 @@ module ContextDev
             )
           end
 
-        # Webhook URL events are delivered to.
+        # Webhook URL events are delivered to. Slack incoming webhook URLs are
+        # automatically formatted as Slack messages.
         sig { returns(String) }
         attr_accessor :url
 
@@ -1090,7 +1127,8 @@ module ContextDev
         sig { params(retry_: ContextDev::RetryConfig::OrHash).void }
         attr_writer :retry_
 
-        # Signing secret used to verify webhook authenticity. Each delivery includes an
+        # Signing secret used to verify webhook authenticity. Omitted unless the API key
+        # has monitors:write permission or full access. 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
         # compare and reject stale timestamps to prevent replay. Generated by the API;
@@ -1113,7 +1151,8 @@ module ContextDev
           ).returns(T.attached_class)
         end
         def self.new(
-          # Webhook URL events are delivered to.
+          # Webhook URL events are delivered to. Slack incoming webhook URLs are
+          # automatically formatted as Slack messages.
           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
@@ -1122,7 +1161,8 @@ module ContextDev
           events: nil,
           # Webhook retry settings. Use {} for the default schedule.
           retry_: nil,
-          # Signing secret used to verify webhook authenticity. Each delivery includes an
+          # Signing secret used to verify webhook authenticity. Omitted unless the API key
+          # has monitors:write permission or full access. 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
           # compare and reject stale timestamps to prevent replay. Generated by the API;

data/rbi/context_dev/models/monitor_update_params.rbi

@@ -432,6 +432,27 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
+          # CSS selectors for HTML regions to remove before text extraction. Applied after
+          # include_selectors; exclusion takes precedence when an element matches both. Omit
+          # or pass an empty array to apply no explicit exclusions. Changing these selectors
+          # creates a new baseline.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :exclude_selectors
+
+          sig { params(exclude_selectors: T::Array[String]).void }
+          attr_writer :exclude_selectors
+
+          # CSS selectors defining the HTML regions to monitor. Matching subtrees are
+          # combined in document order before text extraction, instead of automatic
+          # main-content selection. Omit or pass an empty array to use automatic
+          # main-content extraction. If the filtered page has no usable text, the run fails
+          # without replacing the baseline. Changing these selectors creates a new baseline.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :include_selectors
+
+          sig { params(include_selectors: T::Array[String]).void }
+          attr_writer :include_selectors
+
           # Plain-language goal describing which page changes matter. When provided without
           # change_detection, semantic detection is inferred.
           sig { returns(T.nilable(String)) }
@@ -452,6 +473,8 @@ module ContextDev
           sig do
             params(
               url: String,
+              exclude_selectors: T::Array[String],
+              include_selectors: T::Array[String],
               instructions: String,
               normalize_whitespace: T::Boolean,
               type: Symbol
@@ -459,6 +482,17 @@ module ContextDev
           end
           def self.new(
             url:,
+            # CSS selectors for HTML regions to remove before text extraction. Applied after
+            # include_selectors; exclusion takes precedence when an element matches both. Omit
+            # or pass an empty array to apply no explicit exclusions. Changing these selectors
+            # creates a new baseline.
+            exclude_selectors: nil,
+            # CSS selectors defining the HTML regions to monitor. Matching subtrees are
+            # combined in document order before text extraction, instead of automatic
+            # main-content selection. Omit or pass an empty array to use automatic
+            # main-content extraction. If the filtered page has no usable text, the run fails
+            # without replacing the baseline. Changing these selectors creates a new baseline.
+            include_selectors: nil,
             # Plain-language goal describing which page changes matter. When provided without
             # change_detection, semantic detection is inferred.
             instructions: nil,
@@ -473,6 +507,8 @@ module ContextDev
               {
                 type: Symbol,
                 url: String,
+                exclude_selectors: T::Array[String],
+                include_selectors: T::Array[String],
                 instructions: String,
                 normalize_whitespace: T::Boolean
               }
@@ -691,7 +727,8 @@ module ContextDev
             )
           end
 
-        # Webhook URL events are delivered to.
+        # Webhook URL events are delivered to. Slack incoming webhook URLs are
+        # automatically formatted as Slack messages.
         sig { returns(String) }
         attr_accessor :url
 
@@ -739,7 +776,8 @@ module ContextDev
           ).returns(T.attached_class)
         end
         def self.new(
-          # Webhook URL events are delivered to.
+          # Webhook URL events are delivered to. Slack incoming webhook URLs are
+          # automatically formatted as Slack messages.
           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

data/rbi/context_dev/models/monitor_update_response.rbi

@@ -591,6 +591,27 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :url
 
+          # CSS selectors for HTML regions to remove before text extraction. Applied after
+          # include_selectors; exclusion takes precedence when an element matches both. Omit
+          # or pass an empty array to apply no explicit exclusions. Changing these selectors
+          # creates a new baseline.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :exclude_selectors
+
+          sig { params(exclude_selectors: T::Array[String]).void }
+          attr_writer :exclude_selectors
+
+          # CSS selectors defining the HTML regions to monitor. Matching subtrees are
+          # combined in document order before text extraction, instead of automatic
+          # main-content selection. Omit or pass an empty array to use automatic
+          # main-content extraction. If the filtered page has no usable text, the run fails
+          # without replacing the baseline. Changing these selectors creates a new baseline.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :include_selectors
+
+          sig { params(include_selectors: T::Array[String]).void }
+          attr_writer :include_selectors
+
           # Plain-language goal describing which page changes matter. When provided without
           # change_detection, semantic detection is inferred.
           sig { returns(T.nilable(String)) }
@@ -611,6 +632,8 @@ module ContextDev
           sig do
             params(
               url: String,
+              exclude_selectors: T::Array[String],
+              include_selectors: T::Array[String],
               instructions: String,
               normalize_whitespace: T::Boolean,
               type: Symbol
@@ -618,6 +641,17 @@ module ContextDev
           end
           def self.new(
             url:,
+            # CSS selectors for HTML regions to remove before text extraction. Applied after
+            # include_selectors; exclusion takes precedence when an element matches both. Omit
+            # or pass an empty array to apply no explicit exclusions. Changing these selectors
+            # creates a new baseline.
+            exclude_selectors: nil,
+            # CSS selectors defining the HTML regions to monitor. Matching subtrees are
+            # combined in document order before text extraction, instead of automatic
+            # main-content selection. Omit or pass an empty array to use automatic
+            # main-content extraction. If the filtered page has no usable text, the run fails
+            # without replacing the baseline. Changing these selectors creates a new baseline.
+            include_selectors: nil,
             # Plain-language goal describing which page changes matter. When provided without
             # change_detection, semantic detection is inferred.
             instructions: nil,
@@ -632,6 +666,8 @@ module ContextDev
               {
                 type: Symbol,
                 url: String,
+                exclude_selectors: T::Array[String],
+                include_selectors: T::Array[String],
                 instructions: String,
                 normalize_whitespace: T::Boolean
               }
@@ -1046,7 +1082,8 @@ module ContextDev
             )
           end
 
-        # Webhook URL events are delivered to.
+        # Webhook URL events are delivered to. Slack incoming webhook URLs are
+        # automatically formatted as Slack messages.
         sig { returns(String) }
         attr_accessor :url
 
@@ -1082,7 +1119,8 @@ module ContextDev
         sig { params(retry_: ContextDev::RetryConfig::OrHash).void }
         attr_writer :retry_
 
-        # Signing secret used to verify webhook authenticity. Each delivery includes an
+        # Signing secret used to verify webhook authenticity. Omitted unless the API key
+        # has monitors:write permission or full access. 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
         # compare and reject stale timestamps to prevent replay. Generated by the API;
@@ -1105,7 +1143,8 @@ module ContextDev
           ).returns(T.attached_class)
         end
         def self.new(
-          # Webhook URL events are delivered to.
+          # Webhook URL events are delivered to. Slack incoming webhook URLs are
+          # automatically formatted as Slack messages.
           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
@@ -1114,7 +1153,8 @@ module ContextDev
           events: nil,
           # Webhook retry settings. Use {} for the default schedule.
           retry_: nil,
-          # Signing secret used to verify webhook authenticity. Each delivery includes an
+          # Signing secret used to verify webhook authenticity. Omitted unless the API key
+          # has monitors:write permission or full access. 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
           # compare and reject stale timestamps to prevent replay. Generated by the API;

data/rbi/context_dev/models/news_search_response.rbi

@@ -33,6 +33,11 @@ module ContextDev
       sig { returns(T.nilable(String)) }
       attr_accessor :next_cursor
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(T.nilable(ContextDev::Models::NewsSearchResponse::KeyMetadata))
@@ -53,6 +58,7 @@ module ContextDev
           has_more: T::Boolean,
           meta: ContextDev::Models::NewsSearchResponse::Meta::OrHash,
           next_cursor: T.nilable(String),
+          request_id: String,
           key_metadata:
             ContextDev::Models::NewsSearchResponse::KeyMetadata::OrHash
         ).returns(T.attached_class)
@@ -67,6 +73,9 @@ module ContextDev
         # Pass as cursor in the next request to fetch the following page. Null when there
         # are no more results.
         next_cursor:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil
       )
@@ -79,6 +88,7 @@ module ContextDev
             has_more: T::Boolean,
             meta: ContextDev::Models::NewsSearchResponse::Meta,
             next_cursor: T.nilable(String),
+            request_id: String,
             key_metadata: ContextDev::Models::NewsSearchResponse::KeyMetadata
           }
         )

data/rbi/context_dev/models/parse_handle_response.rbi

@@ -15,6 +15,11 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :markdown
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Indicates success
       sig do
         returns(ContextDev::Models::ParseHandleResponse::Success::TaggedBoolean)
@@ -44,6 +49,7 @@ module ContextDev
       sig do
         params(
           markdown: String,
+          request_id: String,
           success: ContextDev::Models::ParseHandleResponse::Success::OrBoolean,
           type: ContextDev::Models::ParseHandleResponse::Type::OrSymbol,
           key_metadata:
@@ -53,6 +59,9 @@ module ContextDev
       def self.new(
         # Input bytes converted to GitHub Flavored Markdown
         markdown:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Indicates success
         success:,
         # Detected content type used for parsing
@@ -66,6 +75,7 @@ module ContextDev
         override.returns(
           {
             markdown: String,
+            request_id: String,
             success:
               ContextDev::Models::ParseHandleResponse::Success::TaggedBoolean,
             type: ContextDev::Models::ParseHandleResponse::Type::TaggedSymbol,

data/rbi/context_dev/models/person_enrich_params.rbi

@@ -64,14 +64,18 @@ module ContextDev
       sig { params(tags: T::Array[String]).void }
       attr_writer :tags
 
-      # Optional timeout in milliseconds for the request. If the request takes longer
-      # than this value, it will be aborted with a 408 status code. Maximum allowed
-      # value is 300000ms (5 minutes).
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :timeout_ms
+      # Optional request deadline and behavior on timeout. For GET requests, use
+      # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+      # timeoutOpts object.
+      sig { returns(T.nilable(ContextDev::PersonEnrichParams::TimeoutOpts)) }
+      attr_reader :timeout_opts
 
-      sig { params(timeout_ms: Integer).void }
-      attr_writer :timeout_ms
+      sig do
+        params(
+          timeout_opts: ContextDev::PersonEnrichParams::TimeoutOpts::OrHash
+        ).void
+      end
+      attr_writer :timeout_opts
 
       sig do
         params(
@@ -83,7 +87,7 @@ module ContextDev
           name: ContextDev::PersonEnrichParams::Name::OrHash,
           social_urls: T::Array[String],
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::PersonEnrichParams::TimeoutOpts::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -96,10 +100,10 @@ module ContextDev
         social_urls: nil,
         # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         request_options: {}
       )
       end
@@ -114,7 +118,7 @@ module ContextDev
             name: ContextDev::PersonEnrichParams::Name,
             social_urls: T::Array[String],
             tags: T::Array[String],
-            timeout_ms: Integer,
+            timeout_opts: ContextDev::PersonEnrichParams::TimeoutOpts,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -327,6 +331,112 @@ module ContextDev
         def to_hash
         end
       end
+
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::PersonEnrichParams::TimeoutOpts,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        sig { returns(Integer) }
+        attr_accessor :milliseconds
+
+        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        # credits. "return-partial" returns usable results collected so far; if none are
+        # available, the request still fails without charging credits. Partial results are
+        # not cached as complete results.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+            )
+          )
+        end
+        attr_reader :behavior
+
+        sig do
+          params(
+            behavior:
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+          ).void
+        end
+        attr_writer :behavior
+
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        sig do
+          params(
+            milliseconds: Integer,
+            behavior:
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+          milliseconds:,
+          # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+          # credits. "return-partial" returns usable results collected so far; if none are
+          # available, the request still fails without charging credits. Partial results are
+          # not cached as complete results.
+          behavior: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              milliseconds: Integer,
+              behavior:
+                ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        # credits. "return-partial" returns usable results collected so far; if none are
+        # available, the request still fails without charging credits. Partial results are
+        # not cached as complete results.
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::PersonEnrichParams::TimeoutOpts::Behavior
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          FAIL =
+            T.let(
+              :fail,
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::TaggedSymbol
+            )
+          RETURN_PARTIAL =
+            T.let(
+              :"return-partial",
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/person_enrich_response.rbi

@@ -15,6 +15,11 @@ module ContextDev
       sig { returns(ContextDev::Models::PersonEnrichResponse::Match::Variants) }
       attr_accessor :match
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(
@@ -31,6 +36,14 @@ module ContextDev
       end
       attr_writer :key_metadata
 
+      # True when the timeout ended processing and this response contains the usable
+      # data completed so far. Unfinished fields are omitted.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :partial
+
+      sig { params(partial: T::Boolean).void }
+      attr_writer :partial
+
       sig do
         params(
           match:
@@ -38,15 +51,23 @@ module ContextDev
               ContextDev::Models::PersonEnrichResponse::Match::Candidate::OrHash,
               ContextDev::Models::PersonEnrichResponse::Match::NotFound::OrHash
             ),
+          request_id: String,
           key_metadata:
-            ContextDev::Models::PersonEnrichResponse::KeyMetadata::OrHash
+            ContextDev::Models::PersonEnrichResponse::KeyMetadata::OrHash,
+          partial: T::Boolean
         ).returns(T.attached_class)
       end
       def self.new(
         # The highest-scoring person candidate.
         match:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Credit usage, included whenever a valid API key is provided.
-        key_metadata: nil
+        key_metadata: nil,
+        # True when the timeout ended processing and this response contains the usable
+        # data completed so far. Unfinished fields are omitted.
+        partial: nil
       )
       end
 
@@ -54,7 +75,9 @@ module ContextDev
         override.returns(
           {
             match: ContextDev::Models::PersonEnrichResponse::Match::Variants,
-            key_metadata: ContextDev::Models::PersonEnrichResponse::KeyMetadata
+            request_id: String,
+            key_metadata: ContextDev::Models::PersonEnrichResponse::KeyMetadata,
+            partial: T::Boolean
           }
         )
       end