context.dev 2.4.0 → 2.6.0

data/lib/context_dev/models/web_web_scrape_sitemap_params.rb

@@ -28,6 +28,21 @@ module ContextDev
       #   @return [Integer, nil]
       optional :max_links, Integer
 
+      # @!attribute sitemap_url
+      #   Optional explicit sitemap URL. When provided, exactly this sitemap is crawled
+      #   instead of discovering the domain's sitemaps.
+      #
+      #   @return [String, nil]
+      optional :sitemap_url, String
+
+      # @!attribute tags
+      #   Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #   recorded on the request's usage log and can be used to filter usage on the
+      #   dashboard usage page. Up to 20 tags, each 1-50 characters.
+      #
+      #   @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
@@ -43,7 +58,16 @@ module ContextDev
       #   @return [String, nil]
       optional :url_regex, String
 
-      # @!method initialize(domain:, headers: nil, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
+      # @!attribute zdr
+      #   Set to enabled to bypass shared caches and omit request and response content
+      #   from retained usage logs. Requires zero data retention to be enabled for your
+      #   organization (contact support@context.dev), otherwise the request fails with
+      #   ZDR_NOT_ENABLED. Successful ZDR responses include X-Context-ZDR: true.
+      #
+      #   @return [Symbol, ContextDev::Models::WebWebScrapeSitemapParams::Zdr, nil]
+      optional :zdr, enum: -> { ContextDev::WebWebScrapeSitemapParams::Zdr }
+
+      # @!method initialize(domain:, headers: nil, max_links: nil, sitemap_url: nil, tags: nil, timeout_ms: nil, url_regex: nil, zdr: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeSitemapParams} for more details.
       #
@@ -53,11 +77,31 @@ module ContextDev
       #
       #   @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
+      #   @param sitemap_url [String] Optional explicit sitemap URL. When provided, exactly this sitemap is crawled in
+      #
+      #   @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       #   @param url_regex [String] Optional RE2-compatible regex pattern. Only URLs matching this pattern are retur
       #
+      #   @param zdr [Symbol, ContextDev::Models::WebWebScrapeSitemapParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Set to enabled to bypass shared caches and omit request and response content
+      # from retained usage logs. Requires zero data retention to be enabled for your
+      # organization (contact support@context.dev), otherwise the request fails with
+      # ZDR_NOT_ENABLED. Successful ZDR responses include X-Context-ZDR: true.
+      module Zdr
+        extend ContextDev::Internal::Type::Enum
+
+        ENABLED = :enabled
+        DISABLED = :disabled
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/context_dev/models.rb

@@ -43,10 +43,24 @@ module ContextDev
 
   AIExtractProductsParams = ContextDev::Models::AIExtractProductsParams
 
+  BatchCancelParams = ContextDev::Models::BatchCancelParams
+
+  BatchGetResultsParams = ContextDev::Models::BatchGetResultsParams
+
+  BatchListParams = ContextDev::Models::BatchListParams
+
+  BatchRetrieveParams = ContextDev::Models::BatchRetrieveParams
+
+  BatchSubmitParams = ContextDev::Models::BatchSubmitParams
+
   BrandRetrieveParams = ContextDev::Models::BrandRetrieveParams
 
   BrandRetrieveSimplifiedParams = ContextDev::Models::BrandRetrieveSimplifiedParams
 
+  Error = ContextDev::Models::Error
+
+  ErrorCount = ContextDev::Models::ErrorCount
+
   IndustryRetrieveNaicsParams = ContextDev::Models::IndustryRetrieveNaicsParams
 
   IndustryRetrieveSicParams = ContextDev::Models::IndustryRetrieveSicParams
@@ -55,6 +69,10 @@ module ContextDev
 
   MonitorDeleteParams = ContextDev::Models::MonitorDeleteParams
 
+  MonitorGetCreditUsageParams = ContextDev::Models::MonitorGetCreditUsageParams
+
+  MonitorGetLimitsParams = ContextDev::Models::MonitorGetLimitsParams
+
   MonitorListAccountChangesParams = ContextDev::Models::MonitorListAccountChangesParams
 
   MonitorListAccountRunsParams = ContextDev::Models::MonitorListAccountRunsParams

data/lib/context_dev/resources/ai.rb

@@ -9,12 +9,14 @@ module ContextDev
       # Given a single URL, determines if it is a product page and extracts the product
       # information.
       #
-      # @overload extract_product(url:, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      # @overload extract_product(url:, max_age_ms: nil, tags: nil, timeout_ms: nil, request_options: {})
       #
       # @param url [String] The product page URL to extract product data from.
       #
       # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
       #
+      # @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 request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/context_dev/resources/batch.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Resources
+    class Batch
+      # Check progress and get download links when the batch finishes. Also returns the
+      # rejected-URL list and webhook signing secret from submission, so nothing is lost
+      # if the submit response was dropped.
+      #
+      # @overload retrieve(batch_id, request_options: {})
+      #
+      # @param batch_id [String] ID of the batch to retrieve or cancel.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::BatchRetrieveResponse]
+      #
+      # @see ContextDev::Models::BatchRetrieveParams
+      def retrieve(batch_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["batch/%1$s", batch_id],
+          model: ContextDev::Models::BatchRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::BatchListParams} for more details.
+      #
+      # List your batches from newest to oldest. Filter by status or continue with a
+      # cursor.
+      #
+      # @overload list(cursor: nil, limit: nil, q: nil, search_type: nil, status: nil, tags: nil, request_options: {})
+      #
+      # @param cursor [String] Cursor from the previous page.
+      #
+      # @param limit [Integer] Batches per page. Defaults to 25.
+      #
+      # @param q [String] Free-text search term, matched against the batch id, crawl source (start URL or
+      #
+      # @param search_type [Symbol, ContextDev::Models::BatchListParams::SearchType] `prefix` for as-you-type prefix matching (default), `exact` for full-token match
+      #
+      # @param status [Symbol, ContextDev::Models::BatchListParams::Status] Filter by status.
+      #
+      # @param tags [String] Comma-separated list of tags to filter by (matches batches having any of them).
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::BatchListResponse]
+      #
+      # @see ContextDev::Models::BatchListParams
+      def list(params = {})
+        parsed, options = ContextDev::BatchListParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "batch/list",
+          query: query,
+          model: ContextDev::Models::BatchListResponse,
+          options: options
+        )
+      end
+
+      # Stop a batch from starting new pages. In-progress pages finish, and unused
+      # credits are refunded.
+      #
+      # @overload cancel(batch_id, request_options: {})
+      #
+      # @param batch_id [String] ID of the batch to retrieve or cancel.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::BatchCancelResponse]
+      #
+      # @see ContextDev::Models::BatchCancelParams
+      def cancel(batch_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["batch/%1$s/cancel", batch_id],
+          model: ContextDev::Models::BatchCancelResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::BatchGetResultsParams} for more details.
+      #
+      # Page through the result records of a finished batch as JSON, in the same order
+      # as the downloadable result files. Use this instead of downloading and parsing
+      # the NDJSON files yourself.
+      #
+      # @overload get_results(batch_id, cursor: nil, limit: nil, request_options: {})
+      #
+      # @param batch_id [String] ID of the batch to retrieve or cancel.
+      #
+      # @param cursor [String] next_cursor from the previous page.
+      #
+      # @param limit [Integer] Records per page. Defaults to 25. A page can close early so its payload stays un
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::BatchGetResultsResponse]
+      #
+      # @see ContextDev::Models::BatchGetResultsParams
+      def get_results(batch_id, params = {})
+        parsed, options = ContextDev::BatchGetResultsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["batch/%1$s/results", batch_id],
+          query: query,
+          model: ContextDev::Models::BatchGetResultsResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::BatchSubmitParams} for more details.
+      #
+      # Retrieve and normalize a person profile from identifiers.
+      #
+      # @overload submit(identifiers:, tags: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param identifiers [ContextDev::Models::BatchSubmitParams::Identifiers] Known identifiers for the person. At least one identifier is required.
+      #
+      # @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 request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::BatchSubmitResponse]
+      #
+      # @see ContextDev::Models::BatchSubmitParams
+      def submit(params)
+        parsed, options = ContextDev::BatchSubmitParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "people/retrieve",
+          body: parsed,
+          model: ContextDev::Models::BatchSubmitResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [ContextDev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/context_dev/resources/brand.rb

@@ -36,11 +36,15 @@ module ContextDev
       # information: domain, title, colors, logos, and backdrops. Optimized for faster
       # responses and reduced data transfer.
       #
-      # @overload retrieve_simplified(domain:, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve_simplified(domain:, max_age_ms: nil, tags: nil, theme: nil, timeout_ms: nil, request_options: {})
       #
       # @param domain [String] Domain name to retrieve simplified brand data for
       #
-      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      # @param max_age_ms [Integer, nil] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
+      # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #
+      # @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
       #

data/lib/context_dev/resources/industry.rb

@@ -8,7 +8,7 @@ module ContextDev
       #
       # Classify any brand into 2022 NAICS industry codes from its domain or name.
       #
-      # @overload retrieve_naics(input:, max_results: nil, min_results: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve_naics(input:, max_results: nil, min_results: nil, tags: nil, timeout_ms: nil, request_options: {})
       #
       # @param input [String] Brand domain or title to retrieve NAICS code for. If a valid domain is provided,
       #
@@ -16,6 +16,8 @@ module ContextDev
       #
       # @param min_results [Integer] Minimum number of NAICS codes to return. Must be at least 1. Defaults to 1.
       #
+      # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -46,7 +48,7 @@ module ContextDev
       # domain or name. Choose between the original SIC system (`original_sic`) or the
       # latest SIC list maintained by the SEC (`latest_sec`).
       #
-      # @overload retrieve_sic(input:, max_results: nil, min_results: nil, timeout_ms: nil, type: nil, request_options: {})
+      # @overload retrieve_sic(input:, max_results: nil, min_results: nil, tags: nil, timeout_ms: nil, type: nil, request_options: {})
       #
       # @param input [String] Brand domain or title to retrieve SIC code for. If a valid domain is provided, i
       #
@@ -54,6 +56,8 @@ module ContextDev
       #
       # @param min_results [Integer] Minimum number of SIC codes to return. Must be at least 1. Defaults to 1.
       #
+      # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       # @param type [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type] Which SIC dataset to classify against. `original_sic` uses the 1987 Standard Ind

data/lib/context_dev/resources/monitors.rb

@@ -14,19 +14,19 @@ module ContextDev
       # detection combinations. The monitor runs immediately after creation to create
       # its initial baseline.
       #
-      # @overload create(change_detection:, name:, schedule:, target:, mode: nil, tags: nil, webhook: nil, request_options: {})
-      #
-      # @param change_detection [ContextDev::Models::MonitorCreateParams::ChangeDetection::Exact, ContextDev::Models::MonitorCreateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      # @overload create(name:, target:, change_detection: nil, mode: nil, schedule: nil, tags: nil, webhook: nil, request_options: {})
       #
       # @param name [String]
       #
-      # @param schedule [ContextDev::Models::MonitorCreateParams::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
-      #
       # @param target [ContextDev::Models::MonitorCreateParams::Target::Page, ContextDev::Models::MonitorCreateParams::Target::Sitemap, ContextDev::Models::MonitorCreateParams::Target::Extract] Discriminated union describing what the monitor watches.
       #
+      # @param change_detection [ContextDev::Models::MonitorCreateParams::ChangeDetection::Exact, ContextDev::Models::MonitorCreateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      #
       # @param mode [Symbol, ContextDev::Models::MonitorCreateParams::Mode] Top-level monitor category. Always `web` today; the concrete behavior is describ
       #
-      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      # @param schedule [ContextDev::Models::MonitorCreateParams::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
+      #
+      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
       #
       # @param webhook [ContextDev::Models::MonitorCreateParams::Webhook, nil]
       #
@@ -84,7 +84,7 @@ module ContextDev
       #
       # @param status [Symbol, ContextDev::Models::MonitorUpdateParams::Status]
       #
-      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
       #
       # @param target [ContextDev::Models::MonitorUpdateParams::Target::Page, ContextDev::Models::MonitorUpdateParams::Target::Sitemap, ContextDev::Models::MonitorUpdateParams::Target::Extract] Discriminated union describing what the monitor watches.
       #
@@ -115,25 +115,25 @@ module ContextDev
       #
       # @overload list(change_detection_type: nil, cursor: nil, limit: nil, q: nil, search_by: nil, search_type: nil, status: nil, tag: nil, tags: nil, target_type: nil, request_options: {})
       #
-      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListParams::ChangeDetectionType]
+      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListParams::ChangeDetectionType] Filter by change detection type.
       #
-      # @param cursor [String]
+      # @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      # @param limit [Integer]
+      # @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
       # @param q [String] Free-text search term, matched against the fields named in `search_by`.
       #
-      # @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>] Comma-separated fields to search with `q`. Defaults to all of them. Note `instru
+      # @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>, nil] Comma-separated fields to search with `q`. Defaults to all of them. Note `instru
       #
       # @param search_type [Symbol, ContextDev::Models::MonitorListParams::SearchType] `prefix` for as-you-type prefix matching (default), `exact` for full-token match
       #
-      # @param status [Symbol, ContextDev::Models::MonitorListParams::Status] Monitor lifecycle status. `failed` means the most recent run failed (see the mon
+      # @param status [Symbol, ContextDev::Models::MonitorListParams::Status] Filter monitors by lifecycle status.
       #
       # @param tag [String] Filter to items that have this tag.
       #
-      # @param tags [Array<String>] Comma-separated list of tags to filter by (matches monitors having any of them).
+      # @param tags [Array<String>, nil] Comma-separated list of tags to filter by (matches monitors having any of them).
       #
-      # @param target_type [Symbol, ContextDev::Models::MonitorListParams::TargetType]
+      # @param target_type [Symbol, ContextDev::Models::MonitorListParams::TargetType] Filter by target type.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -171,25 +171,69 @@ module ContextDev
         )
       end
 
+      # Returns credits charged per monitor over an optional [since, until] window,
+      # newest spenders first.
+      #
+      # @overload get_credit_usage(since: nil, until_: nil, request_options: {})
+      #
+      # @param since [Time] Only include items at or after this ISO 8601 timestamp.
+      #
+      # @param until_ [Time] Only include items before this ISO 8601 timestamp.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorGetCreditUsageResponse]
+      #
+      # @see ContextDev::Models::MonitorGetCreditUsageParams
+      def get_credit_usage(params = {})
+        parsed, options = ContextDev::MonitorGetCreditUsageParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "monitors/credit-usage",
+          query: query.transform_keys(until_: "until"),
+          model: ContextDev::Models::MonitorGetCreditUsageResponse,
+          options: options
+        )
+      end
+
+      # Returns how many monitors the account has and the maximum it allows.
+      #
+      # @overload get_limits(request_options: {})
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorGetLimitsResponse]
+      #
+      # @see ContextDev::Models::MonitorGetLimitsParams
+      def get_limits(params = {})
+        @client.request(
+          method: :get,
+          path: "monitors/limits",
+          model: ContextDev::Models::MonitorGetLimitsResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Returns an account-wide feed of detected changes across monitors.
       #
       # @overload list_account_changes(change_detection_type: nil, cursor: nil, limit: nil, monitor_id: nil, since: nil, tag: nil, target_type: nil, until_: nil, request_options: {})
       #
-      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::ChangeDetectionType]
+      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::ChangeDetectionType] Filter by change detection type.
       #
-      # @param cursor [String]
+      # @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      # @param limit [Integer]
+      # @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      # @param monitor_id [String]
+      # @param monitor_id [String] Filter changes to a single monitor.
       #
-      # @param since [Time]
+      # @param since [Time] Only include items at or after this ISO 8601 timestamp.
       #
       # @param tag [String] Filter to items that have this tag.
       #
-      # @param target_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::TargetType]
+      # @param target_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::TargetType] Filter by target type.
       #
-      # @param until_ [Time]
+      # @param until_ [Time] Only include items before this ISO 8601 timestamp.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -208,18 +252,15 @@ module ContextDev
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::MonitorListAccountRunsParams} for more details.
-      #
       # Returns an account-wide feed of monitor runs across all monitors.
       #
       # @overload list_account_runs(cursor: nil, limit: nil, status: nil, request_options: {})
       #
-      # @param cursor [String]
+      # @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      # @param limit [Integer]
+      # @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      # @param status [Symbol, ContextDev::Models::MonitorListAccountRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      # @param status [Symbol, ContextDev::Models::MonitorListAccountRunsParams::Status] Filter runs by lifecycle status.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -244,15 +285,15 @@ module ContextDev
       #
       # @param monitor_id [String]
       #
-      # @param cursor [String]
+      # @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      # @param limit [Integer]
+      # @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      # @param since [Time]
+      # @param since [Time] Only include items at or after this ISO 8601 timestamp.
       #
       # @param tag [String] Filter to items that have this tag.
       #
-      # @param until_ [Time]
+      # @param until_ [Time] Only include items before this ISO 8601 timestamp.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -271,20 +312,17 @@ module ContextDev
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::MonitorListRunsParams} for more details.
-      #
       # List monitor runs
       #
       # @overload list_runs(monitor_id, cursor: nil, limit: nil, status: nil, request_options: {})
       #
       # @param monitor_id [String]
       #
-      # @param cursor [String]
+      # @param cursor [String] Opaque pagination cursor from a previous response.
       #
-      # @param limit [Integer]
+      # @param limit [Integer] Maximum number of items to return per page (1-100). Defaults to 25.
       #
-      # @param status [Symbol, ContextDev::Models::MonitorListRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      # @param status [Symbol, ContextDev::Models::MonitorListRunsParams::Status] Filter runs by lifecycle status.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/context_dev/resources/parse.rb

@@ -7,27 +7,31 @@ module ContextDev
       # {ContextDev::Models::ParseHandleParams} for more details.
       #
       # Converts raw text, source code, web/data, PDF, Microsoft Office, and image bytes
-      # into LLM-usable Markdown. The base request costs 1 credit. When OCR runs
-      # (requires ocr=true), the entire call costs 5 credits; ocr=true requests where no
-      # OCR ends up running still cost 1 credit.
+      # into LLM-usable Markdown.
       #
-      # @overload handle(body:, extension: nil, include_images: nil, include_links: nil, ocr: nil, pdf: nil, shorten_base64_images: nil, use_main_content_only: nil, request_options: {})
+      # @overload handle(body:, client: nil, extension: nil, include_images: nil, include_links: nil, ocr: nil, pdf: nil, shorten_base64_images: nil, tags: nil, use_main_content_only: nil, zdr: nil, request_options: {})
       #
       # @param body [Pathname, StringIO, IO, String, ContextDev::FilePart] Body param
       #
-      # @param extension [Symbol, ContextDev::Models::ParseHandleParams::Extension] Query param: Optional file extension hint. Case-insensitive; a leading dot is ac
+      # @param client [String] Query param: Optional client identifier used for usage attribution.
       #
-      # @param include_images [Boolean] Query param: Include image references in Markdown output
+      # @param extension [Symbol, ContextDev::Models::ParseHandleParams::Extension] Query param: Optional file extension hint, such as pdf, docx, xlsx, pptx, html,
       #
-      # @param include_links [Boolean] Query param: Preserve hyperlinks in Markdown output
+      # @param include_images [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeImages] Query param: Include image references in Markdown output
       #
-      # @param ocr [Boolean] Query param: Gates all OCR. When true, PDFs get embedded-image OCR (recognized t
+      # @param include_links [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeLinks] Query param: Preserve hyperlinks in Markdown output
       #
-      # @param pdf [ContextDev::Models::ParseHandleParams::Pdf] Query param: PDF page-range controls. Use start/end to limit parsing (and OCR wh
+      # @param ocr [Boolean, Symbol, ContextDev::Models::ParseHandleParams::Ocr] Query param: When true for PDF inputs, detect and OCR images embedded in the sel
       #
-      # @param shorten_base64_images [Boolean] Query param: Shorten base64-encoded image data in the Markdown output
+      # @param pdf [ContextDev::Models::ParseHandleParams::Pdf] Query param: PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5
       #
-      # @param use_main_content_only [Boolean] Query param: Extract only the main content from HTML-like inputs
+      # @param shorten_base64_images [Boolean, Symbol, ContextDev::Models::ParseHandleParams::ShortenBase64Images] Query param: Shorten base64-encoded image data in the Markdown output
+      #
+      # @param tags [Array<String>] Query param: Optional comma-separated caller-defined tags for tracking this requ
+      #
+      # @param use_main_content_only [Boolean, Symbol, ContextDev::Models::ParseHandleParams::UseMainContentOnly] Query param: Extract only the main content from HTML-like inputs
+      #
+      # @param zdr [Symbol, ContextDev::Models::ParseHandleParams::Zdr] Query param: Set to enabled to bypass shared caches and omit request and respons
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/context_dev/resources/utility.rb

@@ -11,12 +11,14 @@ module ContextDev
       # one lookup key: a domain, or an email whose domain is extracted and validated
       # (free email providers and disposable email addresses are not allowed).
       #
-      # @overload prefetch(identifier:, type:, timeout_ms: nil, request_options: {})
+      # @overload prefetch(identifier:, type:, tags: nil, timeout_ms: nil, request_options: {})
       #
       # @param identifier [ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier, ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier] Identifier of the brand to prefetch. Provide exactly one of domain or email.
       #
       # @param type [Symbol, ContextDev::Models::UtilityPrefetchParams::Type] What to prefetch. Currently only 'brand' is supported.
       #
+      # @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 request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]