context.dev 2.16.0 → 2.17.0

data/lib/context_dev/models/brand_retrieve_simplified_params.rb

@@ -15,9 +15,9 @@ module ContextDev
 
       # @!attribute max_age_ms
       #   Maximum age in milliseconds for cached brand data before the API performs a hard
-      #   refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
-      #   are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
-      #   year.
+      #   refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard
+      #   refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms)
+      #   are clamped to 1 year.
       #
       #   @return [Integer, nil]
       optional :max_age_ms, Integer, nil?: true
@@ -35,15 +35,15 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::BrandRetrieveSimplifiedParams::Theme, nil]
       optional :theme, enum: -> { ContextDev::BrandRetrieveSimplifiedParams::Theme }
 
-      # @!attribute timeout_ms
-      #   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).
+      # @!attribute timeout_opts
+      #   Optional request deadline and behavior on timeout. For GET requests, use
+      #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+      #   timeoutOpts object.
       #
-      #   @return [Integer, nil]
-      optional :timeout_ms, Integer
+      #   @return [ContextDev::Models::BrandRetrieveSimplifiedParams::TimeoutOpts, nil]
+      optional :timeout_opts, -> { ContextDev::BrandRetrieveSimplifiedParams::TimeoutOpts }
 
-      # @!method initialize(domain:, max_age_ms: nil, tags: nil, theme: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(domain:, max_age_ms: nil, tags: nil, theme: nil, timeout_opts: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveSimplifiedParams} for more details.
       #
@@ -55,7 +55,7 @@ module ContextDev
       #
       #   @param theme [Symbol, ContextDev::Models::BrandRetrieveSimplifiedParams::Theme] Optional theme preference used when selecting brand assets.
       #
-      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #   @param timeout_opts [ContextDev::Models::BrandRetrieveSimplifiedParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
@@ -69,6 +69,52 @@ module ContextDev
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        # @!attribute milliseconds
+        #   Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #
+        #   @return [Integer]
+        required :milliseconds, Integer
+
+        # @!attribute behavior
+        #   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.
+        #
+        #   @return [Symbol, ContextDev::Models::BrandRetrieveSimplifiedParams::TimeoutOpts::Behavior, nil]
+        optional :behavior, enum: -> { ContextDev::BrandRetrieveSimplifiedParams::TimeoutOpts::Behavior }
+
+        # @!method initialize(milliseconds:, behavior: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::BrandRetrieveSimplifiedParams::TimeoutOpts} for more
+        #   details.
+        #
+        #   Optional request deadline and behavior on timeout. For GET requests, use
+        #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        #   timeoutOpts object.
+        #
+        #   @param milliseconds [Integer] Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #
+        #   @param behavior [Symbol, ContextDev::Models::BrandRetrieveSimplifiedParams::TimeoutOpts::Behavior] What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+
+        # 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.
+        #
+        # @see ContextDev::Models::BrandRetrieveSimplifiedParams::TimeoutOpts#behavior
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          FAIL = :fail
+          RETURN_PARTIAL = :"return-partial"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end

data/lib/context_dev/models/brand_retrieve_simplified_response.rb

@@ -37,13 +37,20 @@ module ContextDev
       #   @return [ContextDev::Models::BrandRetrieveSimplifiedResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::BrandRetrieveSimplifiedResponse::KeyMetadata }
 
+      # @!attribute partial
+      #   True when the timeout ended processing and only completed brand data is
+      #   returned.
+      #
+      #   @return [Boolean, nil]
+      optional :partial, ContextDev::Internal::Type::Boolean
+
       # @!attribute status
       #   Status of the response, e.g., 'ok'
       #
       #   @return [String, nil]
       optional :status, String
 
-      # @!method initialize(cache_metadata:, request_id:, brand: nil, code: nil, key_metadata: nil, status: nil)
+      # @!method initialize(cache_metadata:, request_id:, brand: nil, code: nil, key_metadata: nil, partial: nil, status: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveSimplifiedResponse} for more details.
       #
@@ -57,6 +64,8 @@ module ContextDev
       #
       #   @param key_metadata [ContextDev::Models::BrandRetrieveSimplifiedResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
       #
+      #   @param partial [Boolean] True when the timeout ended processing and only completed brand data is returned
+      #
       #   @param status [String] Status of the response, e.g., 'ok'
 
       # @see ContextDev::Models::BrandRetrieveSimplifiedResponse#cache_metadata

data/lib/context_dev/models/industry_retrieve_naics_params.rb

@@ -35,15 +35,15 @@ module ContextDev
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
-      # @!attribute timeout_ms
-      #   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).
+      # @!attribute timeout_opts
+      #   Optional request deadline and behavior on timeout. For GET requests, use
+      #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+      #   timeoutOpts object.
       #
-      #   @return [Integer, nil]
-      optional :timeout_ms, Integer
+      #   @return [ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts, nil]
+      optional :timeout_opts, -> { ContextDev::IndustryRetrieveNaicsParams::TimeoutOpts }
 
-      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::IndustryRetrieveNaicsParams} for more details.
       #
@@ -55,9 +55,54 @@ module ContextDev
       #
       #   @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
       #
-      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #   @param timeout_opts [ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        # @!attribute milliseconds
+        #   Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #
+        #   @return [Integer]
+        required :milliseconds, Integer
+
+        # @!attribute behavior
+        #   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.
+        #
+        #   @return [Symbol, ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts::Behavior, nil]
+        optional :behavior, enum: -> { ContextDev::IndustryRetrieveNaicsParams::TimeoutOpts::Behavior }
+
+        # @!method initialize(milliseconds:, behavior: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts} for more details.
+        #
+        #   Optional request deadline and behavior on timeout. For GET requests, use
+        #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        #   timeoutOpts object.
+        #
+        #   @param milliseconds [Integer] Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #
+        #   @param behavior [Symbol, ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts::Behavior] What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+
+        # 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.
+        #
+        # @see ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts#behavior
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          FAIL = :fail
+          RETURN_PARTIAL = :"return-partial"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end

data/lib/context_dev/models/industry_retrieve_naics_response.rb

@@ -30,6 +30,13 @@ module ContextDev
       #   @return [ContextDev::Models::IndustryRetrieveNaicsResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::IndustryRetrieveNaicsResponse::KeyMetadata }
 
+      # @!attribute partial
+      #   True when the timeout ended processing and this response contains only usable
+      #   results completed so far. Unfinished results are omitted.
+      #
+      #   @return [Boolean, nil]
+      optional :partial, ContextDev::Internal::Type::Boolean
+
       # @!attribute status
       #   Status of the response, e.g., 'ok'
       #
@@ -42,7 +49,7 @@ module ContextDev
       #   @return [String, nil]
       optional :type, String
 
-      # @!method initialize(request_id:, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
+      # @!method initialize(request_id:, codes: nil, domain: nil, key_metadata: nil, partial: nil, status: nil, type: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::IndustryRetrieveNaicsResponse} for more details.
       #
@@ -54,6 +61,8 @@ module ContextDev
       #
       #   @param key_metadata [ContextDev::Models::IndustryRetrieveNaicsResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
       #
+      #   @param partial [Boolean] True when the timeout ended processing and this response contains only usable re
+      #
       #   @param status [String] Status of the response, e.g., 'ok'
       #
       #   @param type [String] Industry classification type, for naics api it will be `naics`

data/lib/context_dev/models/industry_retrieve_sic_params.rb

@@ -34,13 +34,13 @@ module ContextDev
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
-      # @!attribute timeout_ms
-      #   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).
+      # @!attribute timeout_opts
+      #   Optional request deadline and behavior on timeout. For GET requests, use
+      #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+      #   timeoutOpts object.
       #
-      #   @return [Integer, nil]
-      optional :timeout_ms, Integer
+      #   @return [ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts, nil]
+      optional :timeout_opts, -> { ContextDev::IndustryRetrieveSicParams::TimeoutOpts }
 
       # @!attribute type
       #   Which SIC dataset to classify against. `original_sic` uses the 1987 Standard
@@ -50,7 +50,7 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type, nil]
       optional :type, enum: -> { ContextDev::IndustryRetrieveSicParams::Type }
 
-      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_ms: nil, type: nil, request_options: {})
+      # @!method initialize(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, type: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::IndustryRetrieveSicParams} for more details.
       #
@@ -62,12 +62,57 @@ module ContextDev
       #
       #   @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
       #
-      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #   @param timeout_opts [ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
       #   @param type [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type] Which SIC dataset to classify against. `original_sic` uses the 1987 Standard Ind
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        # @!attribute milliseconds
+        #   Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #
+        #   @return [Integer]
+        required :milliseconds, Integer
+
+        # @!attribute behavior
+        #   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.
+        #
+        #   @return [Symbol, ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts::Behavior, nil]
+        optional :behavior, enum: -> { ContextDev::IndustryRetrieveSicParams::TimeoutOpts::Behavior }
+
+        # @!method initialize(milliseconds:, behavior: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts} for more details.
+        #
+        #   Optional request deadline and behavior on timeout. For GET requests, use
+        #   timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        #   timeoutOpts object.
+        #
+        #   @param milliseconds [Integer] Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        #
+        #   @param behavior [Symbol, ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts::Behavior] What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+
+        # 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.
+        #
+        # @see ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts#behavior
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          FAIL = :fail
+          RETURN_PARTIAL = :"return-partial"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # Which SIC dataset to classify against. `original_sic` uses the 1987 Standard
       # Industrial Classification system; `latest_sec` uses the current SIC list as
       # published by the SEC. Defaults to `original_sic`.

data/lib/context_dev/models/industry_retrieve_sic_response.rb

@@ -38,6 +38,13 @@ module ContextDev
       #   @return [ContextDev::Models::IndustryRetrieveSicResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::IndustryRetrieveSicResponse::KeyMetadata }
 
+      # @!attribute partial
+      #   True when the timeout ended processing and this response contains only usable
+      #   results completed so far. Unfinished results are omitted.
+      #
+      #   @return [Boolean, nil]
+      optional :partial, ContextDev::Internal::Type::Boolean
+
       # @!attribute status
       #   Status of the response, e.g., 'ok'
       #
@@ -50,7 +57,7 @@ module ContextDev
       #   @return [String, nil]
       optional :type, String
 
-      # @!method initialize(request_id:, classification: nil, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
+      # @!method initialize(request_id:, classification: nil, codes: nil, domain: nil, key_metadata: nil, partial: nil, status: nil, type: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::IndustryRetrieveSicResponse} for more details.
       #
@@ -64,6 +71,8 @@ module ContextDev
       #
       #   @param key_metadata [ContextDev::Models::IndustryRetrieveSicResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
       #
+      #   @param partial [Boolean] True when the timeout ended processing and this response contains only usable re
+      #
       #   @param status [String] Status of the response, e.g., 'ok'
       #
       #   @param type [String] Industry classification type, for sic api it will be `sic`

data/lib/context_dev/models/monitor_create_params.rb

@@ -97,6 +97,25 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute exclude_selectors
+          #   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.
+          #
+          #   @return [Array<String>, nil]
+          optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
+          # @!attribute include_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.
+          #
+          #   @return [Array<String>, nil]
+          optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
           # @!attribute instructions
           #   Plain-language goal describing which page changes matter. When provided without
           #   change_detection, semantic detection is inferred.
@@ -110,7 +129,7 @@ module ContextDev
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          # @!method initialize(url:, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::MonitorCreateParams::Target::Page} for more details.
           #
@@ -119,6 +138,10 @@ module ContextDev
           #
           #   @param url [String]
           #
+          #   @param exclude_selectors [Array<String>] CSS selectors for HTML regions to remove before text extraction. Applied after i
+          #
+          #   @param include_selectors [Array<String>] CSS selectors defining the HTML regions to monitor. Matching subtrees are combin
+          #
           #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
           #
           #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
@@ -371,7 +394,8 @@ module ContextDev
 
       class Webhook < ContextDev::Internal::Type::BaseModel
         # @!attribute url
-        #   Webhook URL events are delivered to.
+        #   Webhook URL events are delivered to. Slack incoming webhook URLs are
+        #   automatically formatted as Slack messages.
         #
         #   @return [String]
         required :url, String
@@ -396,7 +420,7 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorCreateParams::Webhook} for more details.
         #
-        #   @param url [String] Webhook URL events are delivered to.
+        #   @param url [String] Webhook URL events are delivered to. Slack incoming webhook URLs are automatical
         #
         #   @param events [Array<Symbol, ContextDev::Models::MonitorCreateParams::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
         #

data/lib/context_dev/models/monitor_create_response.rb

@@ -331,6 +331,25 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute exclude_selectors
+          #   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.
+          #
+          #   @return [Array<String>, nil]
+          optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
+          # @!attribute include_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.
+          #
+          #   @return [Array<String>, nil]
+          optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
           # @!attribute instructions
           #   Plain-language goal describing which page changes matter. When provided without
           #   change_detection, semantic detection is inferred.
@@ -344,7 +363,7 @@ module ContextDev
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          # @!method initialize(url:, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::MonitorCreateResponse::Target::Page} for more details.
           #
@@ -353,6 +372,10 @@ module ContextDev
           #
           #   @param url [String]
           #
+          #   @param exclude_selectors [Array<String>] CSS selectors for HTML regions to remove before text extraction. Applied after i
+          #
+          #   @param include_selectors [Array<String>] CSS selectors defining the HTML regions to monitor. Matching subtrees are combin
+          #
           #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
           #
           #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
@@ -618,7 +641,8 @@ module ContextDev
       # @see ContextDev::Models::MonitorCreateResponse#webhook
       class Webhook < ContextDev::Internal::Type::BaseModel
         # @!attribute url
-        #   Webhook URL events are delivered to.
+        #   Webhook URL events are delivered to. Slack incoming webhook URLs are
+        #   automatically formatted as Slack messages.
         #
         #   @return [String]
         required :url, String
@@ -641,7 +665,8 @@ module ContextDev
 
         response_only do
           # @!attribute secret
-          #   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;
@@ -655,13 +680,13 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorCreateResponse::Webhook} for more details.
         #
-        #   @param url [String] Webhook URL events are delivered to.
+        #   @param url [String] Webhook URL events are delivered to. Slack incoming webhook URLs are automatical
         #
         #   @param events [Array<Symbol, ContextDev::Models::MonitorCreateResponse::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
         #
         #   @param retry_ [ContextDev::Models::RetryConfig] Webhook retry settings. Use {} for the default schedule.
         #
-        #   @param secret [String] Signing secret used to verify webhook authenticity. Each delivery includes an `X
+        #   @param secret [String] Signing secret used to verify webhook authenticity. Omitted unless the API key h
 
         module Event
           extend ContextDev::Internal::Type::Enum

data/lib/context_dev/models/monitor_list_response.rb

@@ -344,6 +344,25 @@ module ContextDev
             #   @return [String]
             required :url, String
 
+            # @!attribute exclude_selectors
+            #   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.
+            #
+            #   @return [Array<String>, nil]
+            optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
+            # @!attribute include_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.
+            #
+            #   @return [Array<String>, nil]
+            optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
             # @!attribute instructions
             #   Plain-language goal describing which page changes matter. When provided without
             #   change_detection, semantic detection is inferred.
@@ -357,7 +376,7 @@ module ContextDev
             #   @return [Boolean, nil]
             optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-            # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+            # @!method initialize(url:, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
             #   Some parameter documentations has been truncated, see
             #   {ContextDev::Models::MonitorListResponse::Data::Target::Page} for more details.
             #
@@ -366,6 +385,10 @@ module ContextDev
             #
             #   @param url [String]
             #
+            #   @param exclude_selectors [Array<String>] CSS selectors for HTML regions to remove before text extraction. Applied after i
+            #
+            #   @param include_selectors [Array<String>] CSS selectors defining the HTML regions to monitor. Matching subtrees are combin
+            #
             #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
             #
             #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
@@ -632,7 +655,8 @@ module ContextDev
         # @see ContextDev::Models::MonitorListResponse::Data#webhook
         class Webhook < ContextDev::Internal::Type::BaseModel
           # @!attribute url
-          #   Webhook URL events are delivered to.
+          #   Webhook URL events are delivered to. Slack incoming webhook URLs are
+          #   automatically formatted as Slack messages.
           #
           #   @return [String]
           required :url, String
@@ -655,7 +679,8 @@ module ContextDev
 
           response_only do
             # @!attribute secret
-            #   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;
@@ -669,13 +694,13 @@ module ContextDev
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::MonitorListResponse::Data::Webhook} for more details.
           #
-          #   @param url [String] Webhook URL events are delivered to.
+          #   @param url [String] Webhook URL events are delivered to. Slack incoming webhook URLs are automatical
           #
           #   @param events [Array<Symbol, ContextDev::Models::MonitorListResponse::Data::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
           #
           #   @param retry_ [ContextDev::Models::RetryConfig] Webhook retry settings. Use {} for the default schedule.
           #
-          #   @param secret [String] Signing secret used to verify webhook authenticity. Each delivery includes an `X
+          #   @param secret [String] Signing secret used to verify webhook authenticity. Omitted unless the API key h
 
           module Event
             extend ContextDev::Internal::Type::Enum