context.dev 2.4.0 → 2.5.0

data/rbi/context_dev/models/web_web_scrape_md_params.rbi

@@ -16,8 +16,26 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
-      # Two-letter ISO 3166-1 alpha-2 country code for the website request location.
-      # When provided, Context.dev fetches the target page from that country.
+      # Optional browser actions executed in array order after the page loads and before
+      # content is captured. Requires a paid plan. Send a JSON array in the query
+      # parameter. Maximum: 5 actions.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[
+              T.any(
+                ContextDev::WebWebScrapeMdParams::Action::Wait,
+                ContextDev::WebWebScrapeMdParams::Action::Perform
+              )
+            ]
+          )
+        )
+      end
+      attr_accessor :actions
+
+      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
+      # residential proxy exit location. Must be one of Context.dev's supported
+      # countries. When provided, Context.dev fetches the target page from that country.
       sig do
         returns(T.nilable(ContextDev::WebWebScrapeMdParams::Country::OrSymbol))
       end
@@ -34,10 +52,7 @@ module ContextDev
       # includeSelectors. Exclusion takes precedence: an element matching both is
       # removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
       sig { returns(T.nilable(T::Array[String])) }
-      attr_reader :exclude_selectors
-
-      sig { params(exclude_selectors: T::Array[String]).void }
-      attr_writer :exclude_selectors
+      attr_accessor :exclude_selectors
 
       # Optional outbound HTTP headers forwarded only to the target URL, sent as
       # deep-object query params such as headers[X-Custom]=value. When provided, caching
@@ -49,43 +64,88 @@ module ContextDev
       attr_writer :headers
 
       # When true, the contents of iframes are rendered to Markdown.
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeFrames::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :include_frames
 
-      sig { params(include_frames: T::Boolean).void }
+      sig do
+        params(
+          include_frames:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeFrames::OrSymbol
+            )
+        ).void
+      end
       attr_writer :include_frames
 
       # Include image references in Markdown output
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeImages::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :include_images
 
-      sig { params(include_images: T::Boolean).void }
+      sig do
+        params(
+          include_images:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeImages::OrSymbol
+            )
+        ).void
+      end
       attr_writer :include_images
 
       # Preserve hyperlinks in Markdown output
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeLinks::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :include_links
 
-      sig { params(include_links: T::Boolean).void }
+      sig do
+        params(
+          include_links:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeLinks::OrSymbol
+            )
+        ).void
+      end
       attr_writer :include_links
 
       # CSS selectors. When provided, only matching HTML subtrees (and their
       # descendants) are kept before conversion to Markdown. When omitted, the entire
       # document is kept. Examples: "article.main", "#content", "[role=main]".
       sig { returns(T.nilable(T::Array[String])) }
-      attr_reader :include_selectors
-
-      sig { params(include_selectors: T::Array[String]).void }
-      attr_writer :include_selectors
+      attr_accessor :include_selectors
 
       # Return a cached result if a prior scrape for the same parameters exists and is
       # younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
       # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
       sig { returns(T.nilable(Integer)) }
-      attr_reader :max_age_ms
-
-      sig { params(max_age_ms: Integer).void }
-      attr_writer :max_age_ms
+      attr_accessor :max_age_ms
 
       # PDF parsing controls. Use start/end to limit text extraction and embedded-image
       # detection/OCR to an inclusive 1-based page range.
@@ -98,19 +158,62 @@ module ContextDev
       # When true, waits briefly for CSS and transition animations to settle before
       # converting to Markdown. Defaults to false. This adds a bit of latency in
       # exchange for more stable output on animated pages.
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::SettleAnimations::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :settle_animations
 
-      sig { params(settle_animations: T::Boolean).void }
+      sig do
+        params(
+          settle_animations:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::SettleAnimations::OrSymbol
+            )
+        ).void
+      end
       attr_writer :settle_animations
 
       # Shorten base64-encoded image data in the Markdown output
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::ShortenBase64Images::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :shorten_base64_images
 
-      sig { params(shorten_base64_images: T::Boolean).void }
+      sig do
+        params(
+          shorten_base64_images:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::ShortenBase64Images::OrSymbol
+            )
+        ).void
+      end
       attr_writer :shorten_base64_images
 
+      # 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.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :tags
+
+      sig { params(tags: T::Array[String]).void }
+      attr_writer :tags
+
       # Optional timeout in milliseconds for the request. If the request takes longer
       # than this value, it will be aborted with a 408 status code. Maximum allowed
       # value is 300000ms (5 minutes).
@@ -122,37 +225,98 @@ module ContextDev
 
       # Extract only the main content of the page, excluding headers, footers, sidebars,
       # and navigation
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::UseMainContentOnly::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :use_main_content_only
 
-      sig { params(use_main_content_only: T::Boolean).void }
+      sig do
+        params(
+          use_main_content_only:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::UseMainContentOnly::OrSymbol
+            )
+        ).void
+      end
       attr_writer :use_main_content_only
 
       # Optional browser wait time in milliseconds after initial page load before
       # converting the page to Markdown. Min: 0. Max: 30000 (30 seconds).
       sig { returns(T.nilable(Integer)) }
-      attr_reader :wait_for_ms
+      attr_accessor :wait_for_ms
 
-      sig { params(wait_for_ms: Integer).void }
-      attr_writer :wait_for_ms
+      # 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.
+      sig do
+        returns(T.nilable(ContextDev::WebWebScrapeMdParams::Zdr::OrSymbol))
+      end
+      attr_reader :zdr
+
+      sig { params(zdr: ContextDev::WebWebScrapeMdParams::Zdr::OrSymbol).void }
+      attr_writer :zdr
 
       sig do
         params(
           url: String,
+          actions:
+            T.nilable(
+              T::Array[
+                T.any(
+                  ContextDev::WebWebScrapeMdParams::Action::Wait::OrHash,
+                  ContextDev::WebWebScrapeMdParams::Action::Perform::OrHash
+                )
+              ]
+            ),
           country: ContextDev::WebWebScrapeMdParams::Country::OrSymbol,
-          exclude_selectors: T::Array[String],
+          exclude_selectors: T.nilable(T::Array[String]),
           headers: T::Hash[Symbol, String],
-          include_frames: T::Boolean,
-          include_images: T::Boolean,
-          include_links: T::Boolean,
-          include_selectors: T::Array[String],
-          max_age_ms: Integer,
+          include_frames:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeFrames::OrSymbol
+            ),
+          include_images:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeImages::OrSymbol
+            ),
+          include_links:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeLinks::OrSymbol
+            ),
+          include_selectors: T.nilable(T::Array[String]),
+          max_age_ms: T.nilable(Integer),
           pdf: ContextDev::WebWebScrapeMdParams::Pdf::OrHash,
-          settle_animations: T::Boolean,
-          shorten_base64_images: T::Boolean,
+          settle_animations:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::SettleAnimations::OrSymbol
+            ),
+          shorten_base64_images:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::ShortenBase64Images::OrSymbol
+            ),
+          tags: T::Array[String],
           timeout_ms: Integer,
-          use_main_content_only: T::Boolean,
-          wait_for_ms: Integer,
+          use_main_content_only:
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::UseMainContentOnly::OrSymbol
+            ),
+          wait_for_ms: T.nilable(Integer),
+          zdr: ContextDev::WebWebScrapeMdParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -160,8 +324,13 @@ module ContextDev
         # Full URL to scrape into LLM usable Markdown (must include http:// or https://
         # protocol)
         url:,
-        # Two-letter ISO 3166-1 alpha-2 country code for the website request location.
-        # When provided, Context.dev fetches the target page from that country.
+        # Optional browser actions executed in array order after the page loads and before
+        # content is captured. Requires a paid plan. Send a JSON array in the query
+        # parameter. Maximum: 5 actions.
+        actions: nil,
+        # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
+        # residential proxy exit location. Must be one of Context.dev's supported
+        # countries. When provided, Context.dev fetches the target page from that country.
         country: nil,
         # CSS selectors to remove before conversion to Markdown. Applied after
         # includeSelectors. Exclusion takes precedence: an element matching both is
@@ -194,6 +363,10 @@ module ContextDev
         settle_animations: nil,
         # Shorten base64-encoded image data in the Markdown output
         shorten_base64_images: nil,
+        # 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.
+        tags: nil,
         # Optional timeout in milliseconds for the request. If the request takes longer
         # than this value, it will be aborted with a 408 status code. Maximum allowed
         # value is 300000ms (5 minutes).
@@ -204,6 +377,11 @@ module ContextDev
         # Optional browser wait time in milliseconds after initial page load before
         # converting the page to Markdown. Min: 0. Max: 30000 (30 seconds).
         wait_for_ms: nil,
+        # 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.
+        zdr: nil,
         request_options: {}
       )
       end
@@ -212,20 +390,55 @@ module ContextDev
         override.returns(
           {
             url: String,
+            actions:
+              T.nilable(
+                T::Array[
+                  T.any(
+                    ContextDev::WebWebScrapeMdParams::Action::Wait,
+                    ContextDev::WebWebScrapeMdParams::Action::Perform
+                  )
+                ]
+              ),
             country: ContextDev::WebWebScrapeMdParams::Country::OrSymbol,
-            exclude_selectors: T::Array[String],
+            exclude_selectors: T.nilable(T::Array[String]),
             headers: T::Hash[Symbol, String],
-            include_frames: T::Boolean,
-            include_images: T::Boolean,
-            include_links: T::Boolean,
-            include_selectors: T::Array[String],
-            max_age_ms: Integer,
+            include_frames:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::IncludeFrames::OrSymbol
+              ),
+            include_images:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::IncludeImages::OrSymbol
+              ),
+            include_links:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::IncludeLinks::OrSymbol
+              ),
+            include_selectors: T.nilable(T::Array[String]),
+            max_age_ms: T.nilable(Integer),
             pdf: ContextDev::WebWebScrapeMdParams::Pdf,
-            settle_animations: T::Boolean,
-            shorten_base64_images: T::Boolean,
+            settle_animations:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::SettleAnimations::OrSymbol
+              ),
+            shorten_base64_images:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::ShortenBase64Images::OrSymbol
+              ),
+            tags: T::Array[String],
             timeout_ms: Integer,
-            use_main_content_only: T::Boolean,
-            wait_for_ms: Integer,
+            use_main_content_only:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::UseMainContentOnly::OrSymbol
+              ),
+            wait_for_ms: T.nilable(Integer),
+            zdr: ContextDev::WebWebScrapeMdParams::Zdr::OrSymbol,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -233,8 +446,83 @@ module ContextDev
       def to_hash
       end
 
-      # Two-letter ISO 3166-1 alpha-2 country code for the website request location.
-      # When provided, Context.dev fetches the target page from that country.
+      # Browser action discriminated by `do`. Each variant exposes only its applicable
+      # fields.
+      module Action
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              ContextDev::WebWebScrapeMdParams::Action::Wait,
+              ContextDev::WebWebScrapeMdParams::Action::Perform
+            )
+          end
+
+        class Wait < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::WebWebScrapeMdParams::Action::Wait,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Symbol) }
+          attr_accessor :do_
+
+          sig { returns(Integer) }
+          attr_accessor :time_ms
+
+          # Pause for a fixed number of milliseconds before continuing to the next action.
+          sig do
+            params(time_ms: Integer, do_: Symbol).returns(T.attached_class)
+          end
+          def self.new(time_ms:, do_: :wait)
+          end
+
+          sig { override.returns({ do_: Symbol, time_ms: Integer }) }
+          def to_hash
+          end
+        end
+
+        class Perform < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::WebWebScrapeMdParams::Action::Perform,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :action
+
+          sig { returns(Symbol) }
+          attr_accessor :do_
+
+          # Resolve and perform one natural-language browser action.
+          sig { params(action: String, do_: Symbol).returns(T.attached_class) }
+          def self.new(action:, do_: :perform)
+          end
+
+          sig { override.returns({ action: String, do_: Symbol }) }
+          def to_hash
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::WebWebScrapeMdParams::Action::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
+
+      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
+      # residential proxy exit location. Must be one of Context.dev's supported
+      # countries. When provided, Context.dev fetches the target page from that country.
       module Country
         extend ContextDev::Internal::Type::Enum
 
@@ -458,6 +746,120 @@ module ContextDev
         end
       end
 
+      # When true, the contents of iframes are rendered to Markdown.
+      module IncludeFrames
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeFrames::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::WebWebScrapeMdParams::IncludeFrames::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebWebScrapeMdParams::IncludeFrames)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::WebWebScrapeMdParams::IncludeFrames::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::WebWebScrapeMdParams::IncludeFrames::TaggedSymbol
+          )
+      end
+
+      # Include image references in Markdown output
+      module IncludeImages
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeImages::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::WebWebScrapeMdParams::IncludeImages::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebWebScrapeMdParams::IncludeImages)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::WebWebScrapeMdParams::IncludeImages::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::WebWebScrapeMdParams::IncludeImages::TaggedSymbol
+          )
+      end
+
+      # Preserve hyperlinks in Markdown output
+      module IncludeLinks
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::IncludeLinks::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::WebWebScrapeMdParams::IncludeLinks::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebWebScrapeMdParams::IncludeLinks)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::WebWebScrapeMdParams::IncludeLinks::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::WebWebScrapeMdParams::IncludeLinks::TaggedSymbol
+          )
+      end
+
       class Pdf < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -478,18 +880,52 @@ module ContextDev
         # When true, detect and OCR images embedded in the selected PDF pages, inserting
         # recognized text at each image's position in page reading order while preserving
         # the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
-        sig { returns(T.nilable(T::Boolean)) }
+        sig do
+          returns(
+            T.nilable(
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::Ocr::OrSymbol
+              )
+            )
+          )
+        end
         attr_reader :ocr
 
-        sig { params(ocr: T::Boolean).void }
+        sig do
+          params(
+            ocr:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::Ocr::OrSymbol
+              )
+          ).void
+        end
         attr_writer :ocr
 
         # When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
         # a 400 WEBSITE_ACCESS_ERROR is returned.
-        sig { returns(T.nilable(T::Boolean)) }
+        sig do
+          returns(
+            T.nilable(
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::OrSymbol
+              )
+            )
+          )
+        end
         attr_reader :should_parse
 
-        sig { params(should_parse: T::Boolean).void }
+        sig do
+          params(
+            should_parse:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::OrSymbol
+              )
+          ).void
+        end
         attr_writer :should_parse
 
         # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
@@ -504,8 +940,16 @@ module ContextDev
         sig do
           params(
             end_: Integer,
-            ocr: T::Boolean,
-            should_parse: T::Boolean,
+            ocr:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::Ocr::OrSymbol
+              ),
+            should_parse:
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::OrSymbol
+              ),
             start: Integer
           ).returns(T.attached_class)
         end
@@ -529,14 +973,251 @@ module ContextDev
           override.returns(
             {
               end_: Integer,
-              ocr: T::Boolean,
-              should_parse: T::Boolean,
+              ocr:
+                T.any(
+                  T::Boolean,
+                  ContextDev::WebWebScrapeMdParams::Pdf::Ocr::OrSymbol
+                ),
+              should_parse:
+                T.any(
+                  T::Boolean,
+                  ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::OrSymbol
+                ),
               start: Integer
             }
           )
         end
         def to_hash
         end
+
+        # When true, detect and OCR images embedded in the selected PDF pages, inserting
+        # recognized text at each image's position in page reading order while preserving
+        # the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
+        module Ocr
+          extend ContextDev::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::Ocr::TaggedSymbol
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[ContextDev::WebWebScrapeMdParams::Pdf::Ocr::Variants]
+            )
+          end
+          def self.variants
+          end
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::WebWebScrapeMdParams::Pdf::Ocr)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TRUE =
+            T.let(
+              :true,
+              ContextDev::WebWebScrapeMdParams::Pdf::Ocr::TaggedSymbol
+            )
+          FALSE =
+            T.let(
+              :false,
+              ContextDev::WebWebScrapeMdParams::Pdf::Ocr::TaggedSymbol
+            )
+        end
+
+        # When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+        # a 400 WEBSITE_ACCESS_ERROR is returned.
+        module ShouldParse
+          extend ContextDev::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                T::Boolean,
+                ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::TaggedSymbol
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TRUE =
+            T.let(
+              :true,
+              ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::TaggedSymbol
+            )
+          FALSE =
+            T.let(
+              :false,
+              ContextDev::WebWebScrapeMdParams::Pdf::ShouldParse::TaggedSymbol
+            )
+        end
+      end
+
+      # When true, waits briefly for CSS and transition animations to settle before
+      # converting to Markdown. Defaults to false. This adds a bit of latency in
+      # exchange for more stable output on animated pages.
+      module SettleAnimations
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::SettleAnimations::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::WebWebScrapeMdParams::SettleAnimations::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebWebScrapeMdParams::SettleAnimations)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::WebWebScrapeMdParams::SettleAnimations::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::WebWebScrapeMdParams::SettleAnimations::TaggedSymbol
+          )
+      end
+
+      # Shorten base64-encoded image data in the Markdown output
+      module ShortenBase64Images
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::ShortenBase64Images::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::WebWebScrapeMdParams::ShortenBase64Images::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebWebScrapeMdParams::ShortenBase64Images)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::WebWebScrapeMdParams::ShortenBase64Images::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::WebWebScrapeMdParams::ShortenBase64Images::TaggedSymbol
+          )
+      end
+
+      # Extract only the main content of the page, excluding headers, footers, sidebars,
+      # and navigation
+      module UseMainContentOnly
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::WebWebScrapeMdParams::UseMainContentOnly::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::WebWebScrapeMdParams::UseMainContentOnly::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebWebScrapeMdParams::UseMainContentOnly)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::WebWebScrapeMdParams::UseMainContentOnly::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::WebWebScrapeMdParams::UseMainContentOnly::TaggedSymbol
+          )
+      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
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, ContextDev::WebWebScrapeMdParams::Zdr) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENABLED =
+          T.let(:enabled, ContextDev::WebWebScrapeMdParams::Zdr::TaggedSymbol)
+        DISABLED =
+          T.let(:disabled, ContextDev::WebWebScrapeMdParams::Zdr::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::WebWebScrapeMdParams::Zdr::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
       end
     end
   end