context.dev 2.4.0 → 2.5.0

data/lib/context_dev/models/monitor_retrieve_change_response.rb

@@ -45,6 +45,7 @@ module ContextDev
 
       # @!attribute tags
       #   User-defined tags for grouping and filtering monitors and their changes.
+      #   Duplicates are removed.
       #
       #   @return [Array<String>]
       required :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -153,7 +154,7 @@ module ContextDev
       #
       #   @param summary [String]
       #
-      #   @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_type [Symbol, ContextDev::Models::MonitorRetrieveChangeResponse::TargetType]
       #

data/lib/context_dev/models/monitor_retrieve_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::MonitorRetrieveResponse::Webhook, nil]
       #
@@ -348,13 +349,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 +375,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_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.
       #
@@ -246,13 +247,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 +273,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]
       #
@@ -348,13 +349,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 +375,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
       #

data/lib/context_dev/models/web_extract_params.rb

@@ -77,6 +77,14 @@ module ContextDev
       #   @return [ContextDev::Models::WebExtractParams::Pdf, nil]
       optional :pdf, -> { ContextDev::WebExtractParams::Pdf }
 
+      # @!attribute settle_animations
+      #   When true, waits briefly for CSS and transition animations to settle before
+      #   extracting each crawled page. Defaults to false. This adds a bit of latency in
+      #   exchange for more stable output on animated pages.
+      #
+      #   @return [Boolean, nil]
+      optional :settle_animations, ContextDev::Internal::Type::Boolean, api_name: :settleAnimations
+
       # @!attribute stop_after_ms
       #   Soft time budget for the crawl in milliseconds. Min: 10000 (10s). Max: 110000
       #   (110s). Default: 80000 (80s).
@@ -84,6 +92,12 @@ module ContextDev
       #   @return [Integer, nil]
       optional :stop_after_ms, Integer, api_name: :stopAfterMs
 
+      # @!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
@@ -99,7 +113,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer, api_name: :waitForMs
 
-      # @!method initialize(schema:, url:, fact_check: nil, follow_subdomains: nil, include_frames: nil, instructions: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, stop_after_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(schema:, url:, fact_check: nil, follow_subdomains: nil, include_frames: nil, instructions: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, settle_animations: nil, stop_after_ms: nil, tags: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebExtractParams} for more details.
       #
@@ -123,8 +137,12 @@ module ContextDev
       #
       #   @param pdf [ContextDev::Models::WebExtractParams::Pdf]
       #
+      #   @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
+      #
       #   @param stop_after_ms [Integer] Soft time budget for the crawl in milliseconds. Min: 10000 (10s). Max: 110000 (1
       #
+      #   @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 wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load for each craw

data/lib/context_dev/models/web_extract_styleguide_params.rb

@@ -32,13 +32,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
@@ -48,7 +56,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(color_scheme: nil, direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(color_scheme: nil, 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::WebExtractStyleguideParams} for more details.
       #
@@ -58,7 +66,9 @@ module ContextDev
       #
       #   @param domain [String] Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
       #
-      #   @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
       #