context.dev 2.15.0 → 2.17.0

data/lib/context_dev/models/monitor_retrieve_response.rb

@@ -321,6 +321,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.
@@ -334,7 +353,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::MonitorRetrieveResponse::Target::Page} for more details.
           #
@@ -343,6 +362,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.
@@ -608,7 +631,8 @@ module ContextDev
       # @see ContextDev::Models::MonitorRetrieveResponse#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
@@ -631,7 +655,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;
@@ -645,13 +670,13 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorRetrieveResponse::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::MonitorRetrieveResponse::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_update_params.rb

@@ -219,6 +219,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.
@@ -232,7 +251,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::MonitorUpdateParams::Target::Page} for more details.
           #
@@ -241,6 +260,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.
@@ -376,7 +399,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
@@ -403,7 +427,7 @@ module ContextDev
         #
         #   Set to null to remove the webhook.
         #
-        #   @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::MonitorUpdateParams::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
         #

data/lib/context_dev/models/monitor_update_response.rb

@@ -321,6 +321,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.
@@ -334,7 +353,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::MonitorUpdateResponse::Target::Page} for more details.
           #
@@ -343,6 +362,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.
@@ -608,7 +631,8 @@ module ContextDev
       # @see ContextDev::Models::MonitorUpdateResponse#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
@@ -631,7 +655,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;
@@ -645,13 +670,13 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorUpdateResponse::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::MonitorUpdateResponse::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/news_search_response.rb

@@ -29,13 +29,20 @@ module ContextDev
       #   @return [String, nil]
       required :next_cursor, String, nil?: true
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute key_metadata
       #   Credit usage, included whenever a valid API key is provided.
       #
       #   @return [ContextDev::Models::NewsSearchResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::NewsSearchResponse::KeyMetadata }
 
-      # @!method initialize(data:, has_more:, meta:, next_cursor:, key_metadata: nil)
+      # @!method initialize(data:, has_more:, meta:, next_cursor:, request_id:, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::NewsSearchResponse} for more details.
       #
@@ -47,6 +54,8 @@ module ContextDev
       #
       #   @param next_cursor [String, nil] Pass as cursor in the next request to fetch the following page. Null when there
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param key_metadata [ContextDev::Models::NewsSearchResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
 
       class Data < ContextDev::Internal::Type::BaseModel

data/lib/context_dev/models/parse_handle_response.rb

@@ -10,6 +10,13 @@ module ContextDev
       #   @return [String]
       required :markdown, String
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute success
       #   Indicates success
       #
@@ -28,9 +35,14 @@ module ContextDev
       #   @return [ContextDev::Models::ParseHandleResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::ParseHandleResponse::KeyMetadata }
 
-      # @!method initialize(markdown:, success:, type:, key_metadata: nil)
+      # @!method initialize(markdown:, request_id:, success:, type:, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::ParseHandleResponse} for more details.
+      #
       #   @param markdown [String] Input bytes converted to GitHub Flavored Markdown
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param success [Boolean, ContextDev::Models::ParseHandleResponse::Success] Indicates success
       #
       #   @param type [Symbol, ContextDev::Models::ParseHandleResponse::Type] Detected content type used for parsing

data/lib/context_dev/models/person_enrich_params.rb

@@ -43,15 +43,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, api_name: :timeoutMS
+      #   @return [ContextDev::Models::PersonEnrichParams::TimeoutOpts, nil]
+      optional :timeout_opts, -> { ContextDev::PersonEnrichParams::TimeoutOpts }, api_name: :timeoutOpts
 
-      # @!method initialize(company: nil, education: nil, email: nil, location: nil, name: nil, social_urls: nil, tags: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(company: nil, education: nil, email: nil, location: nil, name: nil, social_urls: nil, tags: nil, timeout_opts: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::PersonEnrichParams} for more details.
       #
@@ -69,7 +69,7 @@ module ContextDev
       #
       #   @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
       #
-      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #   @param timeout_opts [ContextDev::Models::PersonEnrichParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
@@ -171,6 +171,51 @@ module ContextDev
         #   @param first [String]
         #   @param last [String]
       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::PersonEnrichParams::TimeoutOpts::Behavior, nil]
+        optional :behavior, enum: -> { ContextDev::PersonEnrichParams::TimeoutOpts::Behavior }
+
+        # @!method initialize(milliseconds:, behavior: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::PersonEnrichParams::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::PersonEnrichParams::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::PersonEnrichParams::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/person_enrich_response.rb

@@ -10,16 +10,37 @@ module ContextDev
       #   @return [ContextDev::Models::PersonEnrichResponse::Match::Candidate, ContextDev::Models::PersonEnrichResponse::Match::NotFound]
       required :match, union: -> { ContextDev::Models::PersonEnrichResponse::Match }
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute key_metadata
       #   Credit usage, included whenever a valid API key is provided.
       #
       #   @return [ContextDev::Models::PersonEnrichResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::PersonEnrichResponse::KeyMetadata }
 
-      # @!method initialize(match:, key_metadata: nil)
+      # @!attribute partial
+      #   True when the timeout ended processing and this response contains the usable
+      #   data completed so far. Unfinished fields are omitted.
+      #
+      #   @return [Boolean, nil]
+      optional :partial, ContextDev::Internal::Type::Boolean
+
+      # @!method initialize(match:, request_id:, key_metadata: nil, partial: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::PersonEnrichResponse} for more details.
+      #
       #   @param match [ContextDev::Models::PersonEnrichResponse::Match::Candidate, ContextDev::Models::PersonEnrichResponse::Match::NotFound] The highest-scoring person candidate.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param key_metadata [ContextDev::Models::PersonEnrichResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
+      #
+      #   @param partial [Boolean] True when the timeout ended processing and this response contains the usable dat
 
       # The highest-scoring person candidate.
       #

data/lib/context_dev/models/utility_prefetch_params.rb

@@ -26,15 +26,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, api_name: :timeoutMS
+      #   @return [ContextDev::Models::UtilityPrefetchParams::TimeoutOpts, nil]
+      optional :timeout_opts, -> { ContextDev::UtilityPrefetchParams::TimeoutOpts }, api_name: :timeoutOpts
 
-      # @!method initialize(identifier:, type:, tags: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(identifier:, type:, tags: nil, timeout_opts: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
@@ -44,7 +44,7 @@ module ContextDev
       #
       #   @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
       #
-      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #   @param timeout_opts [ContextDev::Models::UtilityPrefetchParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
@@ -105,6 +105,46 @@ 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. This endpoint supports "fail": return 408
+        #   REQUEST_TIMEOUT without charging credits.
+        #
+        #   @return [Symbol, ContextDev::Models::UtilityPrefetchParams::TimeoutOpts::Behavior, nil]
+        optional :behavior, enum: -> { ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior }
+
+        # @!method initialize(milliseconds:, behavior: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::UtilityPrefetchParams::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::UtilityPrefetchParams::TimeoutOpts::Behavior] What to do at the deadline. This endpoint supports "fail": return 408 REQUEST_TI
+
+        # What to do at the deadline. This endpoint supports "fail": return 408
+        # REQUEST_TIMEOUT without charging credits.
+        #
+        # @see ContextDev::Models::UtilityPrefetchParams::TimeoutOpts#behavior
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          FAIL = :fail
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end

data/lib/context_dev/models/utility_prefetch_response.rb

@@ -4,6 +4,13 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Utility#prefetch
     class UtilityPrefetchResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute domain
       #   The domain that was queued for prefetching
       #
@@ -34,7 +41,12 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::UtilityPrefetchResponse::Type, nil]
       optional :type, enum: -> { ContextDev::Models::UtilityPrefetchResponse::Type }
 
-      # @!method initialize(domain: nil, key_metadata: nil, message: nil, status: nil, type: nil)
+      # @!method initialize(request_id:, domain: nil, key_metadata: nil, message: nil, status: nil, type: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::UtilityPrefetchResponse} for more details.
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param domain [String] The domain that was queued for prefetching
       #
       #   @param key_metadata [ContextDev::Models::UtilityPrefetchResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.

data/lib/context_dev/models/web_answers_params.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Web#answers
+    class WebAnswersParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute task
+      #   What to research and answer, in plain language. Naming a domain in the task (for
+      #   example "pricing on context.dev") makes the agent read that site before it
+      #   searches.
+      #
+      #   @return [String]
+      required :task, String
+
+      # @!attribute json_format
+      #   An example object with placeholder values (for example {"pricing_page_url": "",
+      #   "plans": [{"name": "", "price": 0}]}). Object keys and value types are
+      #   preserved; unknown values may be null. Empty arrays accept any JSON items.
+      #   Defaults to {"result": ""}. Maximum 8 levels, 500 values, and 16000 characters.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :json_format, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
+
+      # @!attribute mode
+      #   Research level: fast uses a smaller model and research budget for 10 credits;
+      #   ultra uses deeper reasoning and research for 100 credits. Defaults to ultra.
+      #   Only successful requests consume credits.
+      #
+      #   @return [Symbol, ContextDev::Models::WebAnswersParams::Mode, nil]
+      optional :mode, enum: -> { ContextDev::WebAnswersParams::Mode }
+
+      # @!attribute tags
+      #   Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      #
+      #   @return [Array<String>, nil]
+      optional :tags, ContextDev::Internal::Type::ArrayOf[String]
+
+      # @!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 [ContextDev::Models::WebAnswersParams::TimeoutOpts, nil]
+      optional :timeout_opts, -> { ContextDev::WebAnswersParams::TimeoutOpts }, api_name: :timeoutOpts
+
+      # @!method initialize(task:, json_format: nil, mode: nil, tags: nil, timeout_opts: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::WebAnswersParams} for more details.
+      #
+      #   @param task [String] What to research and answer, in plain language. Naming a domain in the task (for
+      #
+      #   @param json_format [Hash{Symbol=>Object}] An example object with placeholder values (for example {"pricing_page_url": "",
+      #
+      #   @param mode [Symbol, ContextDev::Models::WebAnswersParams::Mode] Research level: fast uses a smaller model and research budget for 10 credits; ul
+      #
+      #   @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      #
+      #   @param timeout_opts [ContextDev::Models::WebAnswersParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Research level: fast uses a smaller model and research budget for 10 credits;
+      # ultra uses deeper reasoning and research for 100 credits. Defaults to ultra.
+      # Only successful requests consume credits.
+      module Mode
+        extend ContextDev::Internal::Type::Enum
+
+        FAST = :fast
+        ULTRA = :ultra
+
+        # @!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::WebAnswersParams::TimeoutOpts::Behavior, nil]
+        optional :behavior, enum: -> { ContextDev::WebAnswersParams::TimeoutOpts::Behavior }
+
+        # @!method initialize(milliseconds:, behavior: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::WebAnswersParams::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::WebAnswersParams::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::WebAnswersParams::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