context.dev 2.4.0 → 2.6.0

data/lib/context_dev/models/monitor_update_params.rb

@@ -38,6 +38,7 @@ module ContextDev
 
       # @!attribute tags
       #   User-defined tags for grouping and filtering monitors and their changes.
+      #   Duplicates are removed.
       #
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -68,7 +69,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.
       #
@@ -85,7 +86,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::MonitorUpdateParams::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
+        # Detect meaning-level changes to page content, ignoring cosmetic or instruction-irrelevant differences. Which changes are meaningful is judged against the page or extract target's `instructions` (and an extract target's `schema`, when provided).
         variant :semantic, -> { ContextDev::MonitorUpdateParams::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -113,9 +114,10 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
-          #   paraphrase-only differences. Which changes are meaningful is judged against the
-          #   extract target's `instructions` (and `schema`, when provided).
+          #   Detect meaning-level changes to page content, ignoring cosmetic or
+          #   instruction-irrelevant differences. Which changes are meaningful is judged
+          #   against the page or extract target's `instructions` (and an extract target's
+          #   `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -197,7 +199,7 @@ module ContextDev
 
         discriminator :type
 
-        # Watch a single web page.
+        # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
         variant :page, -> { ContextDev::MonitorUpdateParams::Target::Page }
 
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
@@ -217,17 +219,30 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute instructions
+          #   Plain-language goal describing which page changes matter. When provided without
+          #   change_detection, semantic detection is inferred.
+          #
+          #   @return [String, nil]
+          optional :instructions, String
+
           # @!attribute normalize_whitespace
           #   Normalize whitespace before comparing or analyzing text.
           #
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-          #   Watch a single web page.
+          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorUpdateParams::Target::Page} for more details.
+          #
+          #   Watch a single web page. Exact detection reports visible-text diffs; semantic
+          #   detection judges confirmed stable diffs against `instructions`.
           #
           #   @param url [String]
           #
+          #   @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.
           #
           #   @param type [Symbol, :page]
@@ -246,13 +261,13 @@ module ContextDev
           required :url, String
 
           # @!attribute exclude
-          #   URL path patterns to exclude.
+          #   URL path patterns to exclude (max 50).
           #
           #   @return [Array<String>, nil]
           optional :exclude, ContextDev::Internal::Type::ArrayOf[String]
 
           # @!attribute include
-          #   URL path patterns to include.
+          #   URL path patterns to include (max 50).
           #
           #   @return [Array<String>, nil]
           optional :include, ContextDev::Internal::Type::ArrayOf[String]
@@ -272,9 +287,9 @@ module ContextDev
           #
           #   @param url [String] Sitemap URL to monitor.
           #
-          #   @param exclude [Array<String>] URL path patterns to exclude.
+          #   @param exclude [Array<String>] URL path patterns to exclude (max 50).
           #
-          #   @param include [Array<String>] URL path patterns to include.
+          #   @param include [Array<String>] URL path patterns to include (max 50).
           #
           #   @param max_urls [Integer] Maximum number of sitemap URLs to track (capped at 10,000).
           #

data/lib/context_dev/models/monitor_update_response.rb

@@ -94,6 +94,7 @@ module ContextDev
 
       # @!attribute tags
       #   User-defined tags for grouping and filtering monitors and their changes.
+      #   Duplicates are removed.
       #
       #   @return [Array<String>, nil]
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -146,7 +147,7 @@ module ContextDev
       #
       #   @param next_run_at [Time, nil] When the next scheduled run is due.
       #
-      #   @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 webhook [ContextDev::Models::MonitorUpdateResponse::Webhook, nil]
       #
@@ -163,7 +164,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::Models::MonitorUpdateResponse::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
+        # Detect meaning-level changes to page content, ignoring cosmetic or instruction-irrelevant differences. Which changes are meaningful is judged against the page or extract target's `instructions` (and an extract target's `schema`, when provided).
         variant :semantic, -> { ContextDev::Models::MonitorUpdateResponse::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -191,9 +192,10 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
-          #   paraphrase-only differences. Which changes are meaningful is judged against the
-          #   extract target's `instructions` (and `schema`, when provided).
+          #   Detect meaning-level changes to page content, ignoring cosmetic or
+          #   instruction-irrelevant differences. Which changes are meaningful is judged
+          #   against the page or extract target's `instructions` (and an extract target's
+          #   `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -299,7 +301,7 @@ module ContextDev
 
         discriminator :type
 
-        # Watch a single web page.
+        # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
         variant :page, -> { ContextDev::Models::MonitorUpdateResponse::Target::Page }
 
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
@@ -319,17 +321,30 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute instructions
+          #   Plain-language goal describing which page changes matter. When provided without
+          #   change_detection, semantic detection is inferred.
+          #
+          #   @return [String, nil]
+          optional :instructions, String
+
           # @!attribute normalize_whitespace
           #   Normalize whitespace before comparing or analyzing text.
           #
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-          #   Watch a single web page.
+          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorUpdateResponse::Target::Page} for more details.
+          #
+          #   Watch a single web page. Exact detection reports visible-text diffs; semantic
+          #   detection judges confirmed stable diffs against `instructions`.
           #
           #   @param url [String]
           #
+          #   @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.
           #
           #   @param type [Symbol, :page]
@@ -348,13 +363,13 @@ module ContextDev
           required :url, String
 
           # @!attribute exclude
-          #   URL path patterns to exclude.
+          #   URL path patterns to exclude (max 50).
           #
           #   @return [Array<String>, nil]
           optional :exclude, ContextDev::Internal::Type::ArrayOf[String]
 
           # @!attribute include
-          #   URL path patterns to include.
+          #   URL path patterns to include (max 50).
           #
           #   @return [Array<String>, nil]
           optional :include, ContextDev::Internal::Type::ArrayOf[String]
@@ -374,9 +389,9 @@ module ContextDev
           #
           #   @param url [String] Sitemap URL to monitor.
           #
-          #   @param exclude [Array<String>] URL path patterns to exclude.
+          #   @param exclude [Array<String>] URL path patterns to exclude (max 50).
           #
-          #   @param include [Array<String>] URL path patterns to include.
+          #   @param include [Array<String>] URL path patterns to include (max 50).
           #
           #   @param max_urls [Integer] Maximum number of sitemap URLs to track (capped at 10,000).
           #

data/lib/context_dev/models/parse_handle_params.rb

@@ -12,9 +12,15 @@ module ContextDev
       #   @return [Pathname, StringIO, IO, String, ContextDev::FilePart]
       required :body, ContextDev::Internal::Type::FileInput
 
+      # @!attribute client
+      #   Optional client identifier used for usage attribution.
+      #
+      #   @return [String, nil]
+      optional :client, String
+
       # @!attribute extension
-      #   Optional file extension hint. Case-insensitive; a leading dot is accepted (e.g.
-      #   ".pdf").
+      #   Optional file extension hint, such as pdf, docx, xlsx, pptx, html, json, csv,
+      #   md, py, rtf, jpg, png, or txt.
       #
       #   @return [Symbol, ContextDev::Models::ParseHandleParams::Extension, nil]
       optional :extension, enum: -> { ContextDev::ParseHandleParams::Extension }
@@ -22,30 +28,26 @@ module ContextDev
       # @!attribute include_images
       #   Include image references in Markdown output
       #
-      #   @return [Boolean, nil]
-      optional :include_images, ContextDev::Internal::Type::Boolean
+      #   @return [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeImages, nil]
+      optional :include_images, union: -> { ContextDev::ParseHandleParams::IncludeImages }
 
       # @!attribute include_links
       #   Preserve hyperlinks in Markdown output
       #
-      #   @return [Boolean, nil]
-      optional :include_links, ContextDev::Internal::Type::Boolean
+      #   @return [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeLinks, nil]
+      optional :include_links, union: -> { ContextDev::ParseHandleParams::IncludeLinks }
 
       # @!attribute ocr
-      #   Gates all OCR. When true, PDFs get embedded-image OCR (recognized text inserted
-      #   at each image's position in page reading order, preserving the text layer;
-      #   pdf.start/pdf.end limit the page range), scanned PDFs with no text layer get
-      #   full-document OCR, and raster images get their visible text transcribed. When
-      #   false, no OCR runs: scanned PDFs may yield no content and images return only
-      #   format/dimension metadata. Calls where OCR actually runs cost 5 credits instead
-      #   of 1.
+      #   When true for PDF inputs, detect and OCR images embedded in the selected pages,
+      #   inserting recognized text at each image's position in page reading order while
+      #   preserving the PDF text layer. pdf.start/pdf.end limit the inclusive page range.
+      #   When false, all OCR is disabled, including the automatic scanned-PDF fallback.
       #
-      #   @return [Boolean, nil]
-      optional :ocr, ContextDev::Internal::Type::Boolean
+      #   @return [Boolean, Symbol, ContextDev::Models::ParseHandleParams::Ocr, nil]
+      optional :ocr, union: -> { ContextDev::ParseHandleParams::Ocr }
 
       # @!attribute pdf
-      #   PDF page-range controls. Use start/end to limit parsing (and OCR when ocr=true)
-      #   to an inclusive 1-based page range.
+      #   PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
       #
       #   @return [ContextDev::Models::ParseHandleParams::Pdf, nil]
       optional :pdf, -> { ContextDev::ParseHandleParams::Pdf }
@@ -53,39 +55,62 @@ module ContextDev
       # @!attribute shorten_base64_images
       #   Shorten base64-encoded image data in the Markdown output
       #
-      #   @return [Boolean, nil]
-      optional :shorten_base64_images, ContextDev::Internal::Type::Boolean
+      #   @return [Boolean, Symbol, ContextDev::Models::ParseHandleParams::ShortenBase64Images, nil]
+      optional :shorten_base64_images, union: -> { ContextDev::ParseHandleParams::ShortenBase64Images }
+
+      # @!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 use_main_content_only
       #   Extract only the main content from HTML-like inputs
       #
-      #   @return [Boolean, nil]
-      optional :use_main_content_only, ContextDev::Internal::Type::Boolean
+      #   @return [Boolean, Symbol, ContextDev::Models::ParseHandleParams::UseMainContentOnly, nil]
+      optional :use_main_content_only, union: -> { ContextDev::ParseHandleParams::UseMainContentOnly }
 
-      # @!method initialize(body:, extension: nil, include_images: nil, include_links: nil, ocr: nil, pdf: nil, shorten_base64_images: nil, use_main_content_only: 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::ParseHandleParams::Zdr, nil]
+      optional :zdr, enum: -> { ContextDev::ParseHandleParams::Zdr }
+
+      # @!method initialize(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: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::ParseHandleParams} for more details.
       #
       #   @param body [Pathname, StringIO, IO, String, ContextDev::FilePart]
       #
-      #   @param extension [Symbol, ContextDev::Models::ParseHandleParams::Extension] Optional file extension hint. Case-insensitive; a leading dot is accepted (e.g.
+      #   @param client [String] Optional client identifier used for usage attribution.
+      #
+      #   @param extension [Symbol, ContextDev::Models::ParseHandleParams::Extension] Optional file extension hint, such as pdf, docx, xlsx, pptx, html, json, csv, md
+      #
+      #   @param include_images [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeImages] Include image references in Markdown output
+      #
+      #   @param include_links [Boolean, Symbol, ContextDev::Models::ParseHandleParams::IncludeLinks] Preserve hyperlinks in Markdown output
       #
-      #   @param include_images [Boolean] Include image references in Markdown output
+      #   @param ocr [Boolean, Symbol, ContextDev::Models::ParseHandleParams::Ocr] When true for PDF inputs, detect and OCR images embedded in the selected pages,
       #
-      #   @param include_links [Boolean] Preserve hyperlinks in Markdown output
+      #   @param pdf [ContextDev::Models::ParseHandleParams::Pdf] PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
       #
-      #   @param ocr [Boolean] Gates all OCR. When true, PDFs get embedded-image OCR (recognized text inserted
+      #   @param shorten_base64_images [Boolean, Symbol, ContextDev::Models::ParseHandleParams::ShortenBase64Images] Shorten base64-encoded image data in the Markdown output
       #
-      #   @param pdf [ContextDev::Models::ParseHandleParams::Pdf] PDF page-range controls. Use start/end to limit parsing (and OCR when ocr=true)
+      #   @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
       #
-      #   @param shorten_base64_images [Boolean] Shorten base64-encoded image data in the Markdown output
+      #   @param use_main_content_only [Boolean, Symbol, ContextDev::Models::ParseHandleParams::UseMainContentOnly] Extract only the main content from HTML-like inputs
       #
-      #   @param use_main_content_only [Boolean] Extract only the main content from HTML-like inputs
+      #   @param zdr [Symbol, ContextDev::Models::ParseHandleParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
-      # Optional file extension hint. Case-insensitive; a leading dot is accepted (e.g.
-      # ".pdf").
+      # Optional file extension hint, such as pdf, docx, xlsx, pptx, html, json, csv,
+      # md, py, rtf, jpg, png, or txt.
       module Extension
         extend ContextDev::Internal::Type::Enum
 
@@ -164,6 +189,84 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
+      # Include image references in Markdown output
+      module IncludeImages
+        extend ContextDev::Internal::Type::Union
+
+        variant ContextDev::Internal::Type::Boolean
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::IncludeImages::TRUE }
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::IncludeImages::FALSE }
+
+        # @!method self.variants
+        #   @return [Array(Boolean, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(T::Boolean, ContextDev::ParseHandleParams::IncludeImages::TaggedSymbol) }
+        end
+
+        # @!group
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!endgroup
+      end
+
+      # Preserve hyperlinks in Markdown output
+      module IncludeLinks
+        extend ContextDev::Internal::Type::Union
+
+        variant ContextDev::Internal::Type::Boolean
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::IncludeLinks::TRUE }
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::IncludeLinks::FALSE }
+
+        # @!method self.variants
+        #   @return [Array(Boolean, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(T::Boolean, ContextDev::ParseHandleParams::IncludeLinks::TaggedSymbol) }
+        end
+
+        # @!group
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!endgroup
+      end
+
+      # When true for PDF inputs, detect and OCR images embedded in the selected pages,
+      # inserting recognized text at each image's position in page reading order while
+      # preserving the PDF text layer. pdf.start/pdf.end limit the inclusive page range.
+      # When false, all OCR is disabled, including the automatic scanned-PDF fallback.
+      module Ocr
+        extend ContextDev::Internal::Type::Union
+
+        variant ContextDev::Internal::Type::Boolean
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::Ocr::TRUE }
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::Ocr::FALSE }
+
+        # @!method self.variants
+        #   @return [Array(Boolean, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::TaggedSymbol) }
+        end
+
+        # @!group
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!endgroup
+      end
+
       class Pdf < ContextDev::Internal::Type::BaseModel
         # @!attribute end_
         #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
@@ -182,13 +285,76 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::ParseHandleParams::Pdf} for more details.
         #
-        #   PDF page-range controls. Use start/end to limit parsing (and OCR when ocr=true)
-        #   to an inclusive 1-based page range.
+        #   PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
         #
         #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
         #
         #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
       end
+
+      # Shorten base64-encoded image data in the Markdown output
+      module ShortenBase64Images
+        extend ContextDev::Internal::Type::Union
+
+        variant ContextDev::Internal::Type::Boolean
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::ShortenBase64Images::TRUE }
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::ShortenBase64Images::FALSE }
+
+        # @!method self.variants
+        #   @return [Array(Boolean, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(T::Boolean, ContextDev::ParseHandleParams::ShortenBase64Images::TaggedSymbol) }
+        end
+
+        # @!group
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!endgroup
+      end
+
+      # Extract only the main content from HTML-like inputs
+      module UseMainContentOnly
+        extend ContextDev::Internal::Type::Union
+
+        variant ContextDev::Internal::Type::Boolean
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::UseMainContentOnly::TRUE }
+
+        variant const: -> { ContextDev::Models::ParseHandleParams::UseMainContentOnly::FALSE }
+
+        # @!method self.variants
+        #   @return [Array(Boolean, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(T::Boolean, ContextDev::ParseHandleParams::UseMainContentOnly::TaggedSymbol) }
+        end
+
+        # @!group
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!endgroup
+      end
+
+      # 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/utility_prefetch_params.rb

@@ -19,6 +19,12 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::UtilityPrefetchParams::Type]
       required :type, enum: -> { ContextDev::UtilityPrefetchParams::Type }
 
+      # @!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_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
@@ -27,7 +33,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer, api_name: :timeoutMS
 
-      # @!method initialize(identifier:, type:, timeout_ms: nil, request_options: {})
+      # @!method initialize(identifier:, type:, tags: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
@@ -35,6 +41,8 @@ module ContextDev
       #
       #   @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}]

data/lib/context_dev/models/web_extract_competitors_params.rb

@@ -20,6 +20,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :num_competitors, Integer
 
+      # @!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
@@ -28,7 +36,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(domain:, num_competitors: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(domain:, num_competitors: nil, tags: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebExtractCompetitorsParams} for more details.
       #
@@ -36,6 +44,8 @@ module ContextDev
       #
       #   @param num_competitors [Integer] Exact number of direct competitors to return. Defaults to 5.
       #
+      #   @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}]

data/lib/context_dev/models/web_extract_fonts_params.rb

@@ -24,13 +24,21 @@ module ContextDev
       optional :domain, String
 
       # @!attribute max_age_ms
-      #   Maximum age in milliseconds for cached data before the API performs a hard
+      #   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.
       #
       #   @return [Integer, nil]
-      optional :max_age_ms, Integer
+      optional :max_age_ms, Integer, nil?: true
+
+      # @!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
@@ -40,7 +48,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(direct_url: nil, domain: nil, max_age_ms: nil, tags: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebExtractFontsParams} for more details.
       #
@@ -48,7 +56,9 @@ module ContextDev
       #
       #   @param domain [String] Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The domai
       #
-      #   @param max_age_ms [Integer] Maximum age in milliseconds for cached data before the API performs a hard refre
+      #   @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 timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #