context.dev 2.3.0 → 2.5.0

data/rbi/context_dev/models/parse_handle_params.rbi

@@ -14,126 +14,232 @@ module ContextDev
       sig { returns(ContextDev::Internal::FileInput) }
       attr_accessor :body
 
-      # Optional HTTP(S) source document URL used to resolve relative links and image
-      # references. Relative references remain relative when omitted.
+      # Optional client identifier used for usage attribution.
       sig { returns(T.nilable(String)) }
-      attr_reader :base_url
+      attr_reader :client
 
-      sig { params(base_url: String).void }
-      attr_writer :base_url
+      sig { params(client: String).void }
+      attr_writer :client
 
       # Optional file extension hint, such as pdf, docx, xlsx, pptx, html, json, csv,
       # md, py, rtf, jpg, png, or txt.
-      sig { returns(T.nilable(String)) }
+      sig do
+        returns(T.nilable(ContextDev::ParseHandleParams::Extension::OrSymbol))
+      end
       attr_reader :extension
 
-      sig { params(extension: String).void }
+      sig do
+        params(
+          extension: ContextDev::ParseHandleParams::Extension::OrSymbol
+        ).void
+      end
       attr_writer :extension
 
-      # Optional filename hint used to infer the extension when extension is omitted.
-      sig { returns(T.nilable(String)) }
-      attr_reader :filename
-
-      sig { params(filename: String).void }
-      attr_writer :filename
-
       # Include image references in Markdown output
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::IncludeImages::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :include_images
 
-      sig { params(include_images: T::Boolean).void }
+      sig do
+        params(
+          include_images:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::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::ParseHandleParams::IncludeLinks::OrSymbol
+            )
+          )
+        )
+      end
       attr_reader :include_links
 
-      sig { params(include_links: T::Boolean).void }
+      sig do
+        params(
+          include_links:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::IncludeLinks::OrSymbol
+            )
+        ).void
+      end
       attr_writer :include_links
 
       # 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. pdfStart/pdfEnd limit the inclusive page range.
-      # This is separate from automatic scanned-PDF OCR fallback.
-      sig { returns(T.nilable(T::Boolean)) }
+      # 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.
+      sig do
+        returns(
+          T.nilable(
+            T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::OrSymbol)
+          )
+        )
+      end
       attr_reader :ocr
 
-      sig { params(ocr: T::Boolean).void }
+      sig do
+        params(
+          ocr: T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::OrSymbol)
+        ).void
+      end
       attr_writer :ocr
 
-      # Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
-      # Must be greater than or equal to pdfStart when both are provided.
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :pdf_end
-
-      sig { params(pdf_end: Integer).void }
-      attr_writer :pdf_end
+      # PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
+      sig { returns(T.nilable(ContextDev::ParseHandleParams::Pdf)) }
+      attr_reader :pdf
 
-      # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :pdf_start
-
-      sig { params(pdf_start: Integer).void }
-      attr_writer :pdf_start
+      sig { params(pdf: ContextDev::ParseHandleParams::Pdf::OrHash).void }
+      attr_writer :pdf
 
       # 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::ParseHandleParams::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::ParseHandleParams::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
+
       # Extract only the main content from HTML-like inputs
-      sig { returns(T.nilable(T::Boolean)) }
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::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::ParseHandleParams::UseMainContentOnly::OrSymbol
+            )
+        ).void
+      end
       attr_writer :use_main_content_only
 
+      # 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 { returns(T.nilable(ContextDev::ParseHandleParams::Zdr::OrSymbol)) }
+      attr_reader :zdr
+
+      sig { params(zdr: ContextDev::ParseHandleParams::Zdr::OrSymbol).void }
+      attr_writer :zdr
+
       sig do
         params(
           body: ContextDev::Internal::FileInput,
-          base_url: String,
-          extension: String,
-          filename: String,
-          include_images: T::Boolean,
-          include_links: T::Boolean,
-          ocr: T::Boolean,
-          pdf_end: Integer,
-          pdf_start: Integer,
-          shorten_base64_images: T::Boolean,
-          use_main_content_only: T::Boolean,
+          client: String,
+          extension: ContextDev::ParseHandleParams::Extension::OrSymbol,
+          include_images:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::IncludeImages::OrSymbol
+            ),
+          include_links:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::IncludeLinks::OrSymbol
+            ),
+          ocr: T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::OrSymbol),
+          pdf: ContextDev::ParseHandleParams::Pdf::OrHash,
+          shorten_base64_images:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::ShortenBase64Images::OrSymbol
+            ),
+          tags: T::Array[String],
+          use_main_content_only:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::UseMainContentOnly::OrSymbol
+            ),
+          zdr: ContextDev::ParseHandleParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
         body:,
-        # Optional HTTP(S) source document URL used to resolve relative links and image
-        # references. Relative references remain relative when omitted.
-        base_url: nil,
+        # Optional client identifier used for usage attribution.
+        client: nil,
         # Optional file extension hint, such as pdf, docx, xlsx, pptx, html, json, csv,
         # md, py, rtf, jpg, png, or txt.
         extension: nil,
-        # Optional filename hint used to infer the extension when extension is omitted.
-        filename: nil,
         # Include image references in Markdown output
         include_images: nil,
         # Preserve hyperlinks in Markdown output
         include_links: nil,
         # 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. pdfStart/pdfEnd limit the inclusive page range.
-        # This is separate from automatic scanned-PDF OCR fallback.
+        # 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.
         ocr: nil,
-        # Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
-        # Must be greater than or equal to pdfStart when both are provided.
-        pdf_end: nil,
-        # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
-        pdf_start: nil,
+        # PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
+        pdf: 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,
         # Extract only the main content from HTML-like inputs
         use_main_content_only: 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
@@ -142,22 +248,446 @@ module ContextDev
         override.returns(
           {
             body: ContextDev::Internal::FileInput,
-            base_url: String,
-            extension: String,
-            filename: String,
-            include_images: T::Boolean,
-            include_links: T::Boolean,
-            ocr: T::Boolean,
-            pdf_end: Integer,
-            pdf_start: Integer,
-            shorten_base64_images: T::Boolean,
-            use_main_content_only: T::Boolean,
+            client: String,
+            extension: ContextDev::ParseHandleParams::Extension::OrSymbol,
+            include_images:
+              T.any(
+                T::Boolean,
+                ContextDev::ParseHandleParams::IncludeImages::OrSymbol
+              ),
+            include_links:
+              T.any(
+                T::Boolean,
+                ContextDev::ParseHandleParams::IncludeLinks::OrSymbol
+              ),
+            ocr:
+              T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::OrSymbol),
+            pdf: ContextDev::ParseHandleParams::Pdf,
+            shorten_base64_images:
+              T.any(
+                T::Boolean,
+                ContextDev::ParseHandleParams::ShortenBase64Images::OrSymbol
+              ),
+            tags: T::Array[String],
+            use_main_content_only:
+              T.any(
+                T::Boolean,
+                ContextDev::ParseHandleParams::UseMainContentOnly::OrSymbol
+              ),
+            zdr: ContextDev::ParseHandleParams::Zdr::OrSymbol,
             request_options: ContextDev::RequestOptions
           }
         )
       end
       def to_hash
       end
+
+      # 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
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::ParseHandleParams::Extension)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TXT =
+          T.let(:txt, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        TEXT =
+          T.let(:text, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        MD = T.let(:md, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        MARKDOWN =
+          T.let(
+            :markdown,
+            ContextDev::ParseHandleParams::Extension::TaggedSymbol
+          )
+        HTML =
+          T.let(:html, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        HTM =
+          T.let(:htm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XHTML =
+          T.let(:xhtml, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XML =
+          T.let(:xml, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        RSS =
+          T.let(:rss, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        ATOM =
+          T.let(:atom, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        CSV =
+          T.let(:csv, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        TSV =
+          T.let(:tsv, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        YAML =
+          T.let(:yaml, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        YML =
+          T.let(:yml, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PY = T.let(:py, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JAVA =
+          T.let(:java, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JS = T.let(:js, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JSX =
+          T.let(:jsx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        MJS =
+          T.let(:mjs, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        CJS =
+          T.let(:cjs, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JSON =
+          T.let(:json, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JSONL =
+          T.let(:jsonl, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        NDJSON =
+          T.let(:ndjson, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PHP =
+          T.let(:php, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        SH = T.let(:sh, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        BASH =
+          T.let(:bash, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        ZSH =
+          T.let(:zsh, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        FISH =
+          T.let(:fish, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        RB = T.let(:rb, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        TS = T.let(:ts, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        TSX =
+          T.let(:tsx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        RTF =
+          T.let(:rtf, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        SRT =
+          T.let(:srt, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        CSS =
+          T.let(:css, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        SCSS =
+          T.let(:scss, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        LESS =
+          T.let(:less, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        STYL =
+          T.let(:styl, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        SASS =
+          T.let(:sass, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        SVG =
+          T.let(:svg, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PDF =
+          T.let(:pdf, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        DOCX =
+          T.let(:docx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        DOC =
+          T.let(:doc, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XLSX =
+          T.let(:xlsx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XLSM =
+          T.let(:xlsm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XLSB =
+          T.let(:xlsb, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XLTX =
+          T.let(:xltx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XLTM =
+          T.let(:xltm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        XLS =
+          T.let(:xls, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PPTX =
+          T.let(:pptx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PPTM =
+          T.let(:pptm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PPSX =
+          T.let(:ppsx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PPSM =
+          T.let(:ppsm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        POTX =
+          T.let(:potx, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        POTM =
+          T.let(:potm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PPT =
+          T.let(:ppt, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PPS =
+          T.let(:pps, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        POT =
+          T.let(:pot, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JPG =
+          T.let(:jpg, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JPEG =
+          T.let(:jpeg, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        JPE =
+          T.let(:jpe, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PNG =
+          T.let(:png, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        GIF =
+          T.let(:gif, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        BMP =
+          T.let(:bmp, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        TIFF =
+          T.let(:tiff, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        TIF =
+          T.let(:tif, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        WEBP =
+          T.let(:webp, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PPM =
+          T.let(:ppm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PBM =
+          T.let(:pbm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PGM =
+          T.let(:pgm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+        PNM =
+          T.let(:pnm, ContextDev::ParseHandleParams::Extension::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::ParseHandleParams::Extension::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Include image references in Markdown output
+      module IncludeImages
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::IncludeImages::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::ParseHandleParams::IncludeImages::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::ParseHandleParams::IncludeImages)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::ParseHandleParams::IncludeImages::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::ParseHandleParams::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::ParseHandleParams::IncludeLinks::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::ParseHandleParams::IncludeLinks::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::ParseHandleParams::IncludeLinks)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::ParseHandleParams::IncludeLinks::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::ParseHandleParams::IncludeLinks::TaggedSymbol
+          )
+      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
+
+        Variants =
+          T.type_alias do
+            T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::TaggedSymbol)
+          end
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::ParseHandleParams::Ocr::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, ContextDev::ParseHandleParams::Ocr) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE = T.let(:true, ContextDev::ParseHandleParams::Ocr::TaggedSymbol)
+        FALSE = T.let(:false, ContextDev::ParseHandleParams::Ocr::TaggedSymbol)
+      end
+
+      class Pdf < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::ParseHandleParams::Pdf,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
+        # Must be greater than or equal to start when both are provided.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :end_
+
+        sig { params(end_: Integer).void }
+        attr_writer :end_
+
+        # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :start
+
+        sig { params(start: Integer).void }
+        attr_writer :start
+
+        # PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
+        sig { params(end_: Integer, start: Integer).returns(T.attached_class) }
+        def self.new(
+          # Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
+          # Must be greater than or equal to start when both are provided.
+          end_: nil,
+          # First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+          start: nil
+        )
+        end
+
+        sig { override.returns({ end_: Integer, start: Integer }) }
+        def to_hash
+        end
+      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::ParseHandleParams::ShortenBase64Images::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::ParseHandleParams::ShortenBase64Images::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::ParseHandleParams::ShortenBase64Images)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::ParseHandleParams::ShortenBase64Images::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::ParseHandleParams::ShortenBase64Images::TaggedSymbol
+          )
+      end
+
+      # Extract only the main content from HTML-like inputs
+      module UseMainContentOnly
+        extend ContextDev::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::UseMainContentOnly::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::ParseHandleParams::UseMainContentOnly::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::ParseHandleParams::UseMainContentOnly)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::ParseHandleParams::UseMainContentOnly::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::ParseHandleParams::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::ParseHandleParams::Zdr) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENABLED =
+          T.let(:enabled, ContextDev::ParseHandleParams::Zdr::TaggedSymbol)
+        DISABLED =
+          T.let(:disabled, ContextDev::ParseHandleParams::Zdr::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::ParseHandleParams::Zdr::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end