context.dev 2.8.0 → 2.10.0

data/rbi/context_dev/models/parse_handle_params.rbi

@@ -36,71 +36,28 @@ module ContextDev
       attr_writer :extension
 
       # Include image references in Markdown output
-      sig do
-        returns(
-          T.nilable(
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::IncludeImages::OrSymbol
-            )
-          )
-        )
-      end
+      sig { returns(T.nilable(T::Boolean)) }
       attr_reader :include_images
 
-      sig do
-        params(
-          include_images:
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::IncludeImages::OrSymbol
-            )
-        ).void
-      end
+      sig { params(include_images: T::Boolean).void }
       attr_writer :include_images
 
       # Preserve hyperlinks in Markdown output
-      sig do
-        returns(
-          T.nilable(
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::IncludeLinks::OrSymbol
-            )
-          )
-        )
-      end
+      sig { returns(T.nilable(T::Boolean)) }
       attr_reader :include_links
 
-      sig do
-        params(
-          include_links:
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::IncludeLinks::OrSymbol
-            )
-        ).void
-      end
+      sig { params(include_links: T::Boolean).void }
       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. 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
+      # When true for PDF inputs, OCR the selected pages that have no usable text layer
+      # (scans), replacing each recovered page's text with the OCR result while pages
+      # with a real text layer keep it. pdf.start/pdf.end limit the inclusive page
+      # range. Billed at 1 credit per page OCR actually recovered, on top of the base
+      # request cost. When false, no OCR runs.
+      sig { returns(T.nilable(T::Boolean)) }
       attr_reader :ocr
 
-      sig do
-        params(
-          ocr: T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::OrSymbol)
-        ).void
-      end
+      sig { params(ocr: T::Boolean).void }
       attr_writer :ocr
 
       # PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
@@ -111,27 +68,10 @@ module ContextDev
       attr_writer :pdf
 
       # Shorten base64-encoded image data in the Markdown output
-      sig do
-        returns(
-          T.nilable(
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::ShortenBase64Images::OrSymbol
-            )
-          )
-        )
-      end
+      sig { returns(T.nilable(T::Boolean)) }
       attr_reader :shorten_base64_images
 
-      sig do
-        params(
-          shorten_base64_images:
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::ShortenBase64Images::OrSymbol
-            )
-        ).void
-      end
+      sig { params(shorten_base64_images: T::Boolean).void }
       attr_writer :shorten_base64_images
 
       # Optional comma-separated caller-defined tags for tracking this request. Tags are
@@ -144,27 +84,10 @@ module ContextDev
       attr_writer :tags
 
       # Extract only the main content from HTML-like inputs
-      sig do
-        returns(
-          T.nilable(
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::UseMainContentOnly::OrSymbol
-            )
-          )
-        )
-      end
+      sig { returns(T.nilable(T::Boolean)) }
       attr_reader :use_main_content_only
 
-      sig do
-        params(
-          use_main_content_only:
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::UseMainContentOnly::OrSymbol
-            )
-        ).void
-      end
+      sig { params(use_main_content_only: T::Boolean).void }
       attr_writer :use_main_content_only
 
       # Set to enabled to bypass shared caches and omit request and response content
@@ -182,29 +105,13 @@ module ContextDev
           body: ContextDev::Internal::FileInput,
           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),
+          include_images: T::Boolean,
+          include_links: T::Boolean,
+          ocr: T::Boolean,
           pdf: ContextDev::ParseHandleParams::Pdf::OrHash,
-          shorten_base64_images:
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::ShortenBase64Images::OrSymbol
-            ),
+          shorten_base64_images: T::Boolean,
           tags: T::Array[String],
-          use_main_content_only:
-            T.any(
-              T::Boolean,
-              ContextDev::ParseHandleParams::UseMainContentOnly::OrSymbol
-            ),
+          use_main_content_only: T::Boolean,
           zdr: ContextDev::ParseHandleParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -220,10 +127,11 @@ module ContextDev
         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. pdf.start/pdf.end limit the inclusive page range.
-        # When false, all OCR is disabled, including the automatic scanned-PDF fallback.
+        # When true for PDF inputs, OCR the selected pages that have no usable text layer
+        # (scans), replacing each recovered page's text with the OCR result while pages
+        # with a real text layer keep it. pdf.start/pdf.end limit the inclusive page
+        # range. Billed at 1 credit per page OCR actually recovered, on top of the base
+        # request cost. When false, no OCR runs.
         ocr: nil,
         # PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5}.
         pdf: nil,
@@ -250,30 +158,13 @@ module ContextDev
             body: ContextDev::Internal::FileInput,
             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),
+            include_images: T::Boolean,
+            include_links: T::Boolean,
+            ocr: T::Boolean,
             pdf: ContextDev::ParseHandleParams::Pdf,
-            shorten_base64_images:
-              T.any(
-                T::Boolean,
-                ContextDev::ParseHandleParams::ShortenBase64Images::OrSymbol
-              ),
+            shorten_base64_images: T::Boolean,
             tags: T::Array[String],
-            use_main_content_only:
-              T.any(
-                T::Boolean,
-                ContextDev::ParseHandleParams::UseMainContentOnly::OrSymbol
-              ),
+            use_main_content_only: T::Boolean,
             zdr: ContextDev::ParseHandleParams::Zdr::OrSymbol,
             request_options: ContextDev::RequestOptions
           }
@@ -440,110 +331,6 @@ module ContextDev
         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
@@ -584,86 +371,6 @@ module ContextDev
         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