context.dev 2.9.0 → 2.11.0

data/rbi/context_dev/models/parse_handle_params.rbi

@@ -36,51 +36,17 @@ 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, OCR the selected pages that have no usable text layer
@@ -88,20 +54,10 @@ module ContextDev
       # 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 do
-        returns(
-          T.nilable(
-            T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::OrSymbol)
-          )
-        )
-      end
+      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}.
@@ -112,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
@@ -145,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
@@ -183,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)
@@ -252,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
           }
@@ -442,111 +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, 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.
-      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
@@ -587,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

data/rbi/context_dev/models/person_enrich_response.rbi

@@ -139,6 +139,17 @@ module ContextDev
                 )
               end
 
+            # Whether the person's current role is known. `present` — current_role is
+            # populated. `none` — the work history explicitly shows every role has ended.
+            # `unknown` — our data sources could not confirm either way; treat a missing
+            # current_role as unverified rather than vacant.
+            sig do
+              returns(
+                ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus::TaggedSymbol
+              )
+            end
+            attr_accessor :current_role_status
+
             sig do
               returns(
                 T::Array[
@@ -178,6 +189,13 @@ module ContextDev
             sig { params(bio: String).void }
             attr_writer :bio
 
+            # When we last refreshed this profile from our data sources (ISO 8601).
+            sig { returns(T.nilable(String)) }
+            attr_reader :checked_at
+
+            sig { params(checked_at: String).void }
+            attr_writer :checked_at
+
             sig do
               returns(
                 T.nilable(
@@ -201,6 +219,14 @@ module ContextDev
             sig { params(email: String).void }
             attr_writer :email
 
+            # When the underlying profile data last changed in our data sources (ISO 8601).
+            # Omitted when unknown.
+            sig { returns(T.nilable(String)) }
+            attr_reader :last_updated
+
+            sig { params(last_updated: String).void }
+            attr_writer :last_updated
+
             sig do
               returns(
                 T.nilable(
@@ -237,6 +263,8 @@ module ContextDev
 
             sig do
               params(
+                current_role_status:
+                  ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus::OrSymbol,
                 education:
                   T::Array[
                     ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::Education::OrHash
@@ -250,9 +278,11 @@ module ContextDev
                 website_urls: T::Array[String],
                 avatar_url: String,
                 bio: String,
+                checked_at: String,
                 current_role:
                   ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRole::OrHash,
                 email: String,
+                last_updated: String,
                 location:
                   ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::Location::OrHash,
                 name:
@@ -260,6 +290,11 @@ module ContextDev
               ).returns(T.attached_class)
             end
             def self.new(
+              # Whether the person's current role is known. `present` — current_role is
+              # populated. `none` — the work history explicitly shows every role has ended.
+              # `unknown` — our data sources could not confirm either way; treat a missing
+              # current_role as unverified rather than vacant.
+              current_role_status:,
               education:,
               experience:,
               skills:,
@@ -267,8 +302,13 @@ module ContextDev
               website_urls:,
               avatar_url: nil,
               bio: nil,
+              # When we last refreshed this profile from our data sources (ISO 8601).
+              checked_at: nil,
               current_role: nil,
               email: nil,
+              # When the underlying profile data last changed in our data sources (ISO 8601).
+              # Omitted when unknown.
+              last_updated: nil,
               location: nil,
               name: nil
             )
@@ -277,6 +317,8 @@ module ContextDev
             sig do
               override.returns(
                 {
+                  current_role_status:
+                    ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus::TaggedSymbol,
                   education:
                     T::Array[
                       ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::Education
@@ -290,9 +332,11 @@ module ContextDev
                   website_urls: T::Array[String],
                   avatar_url: String,
                   bio: String,
+                  checked_at: String,
                   current_role:
                     ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRole,
                   email: String,
+                  last_updated: String,
                   location:
                     ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::Location,
                   name:
@@ -303,6 +347,49 @@ module ContextDev
             def to_hash
             end
 
+            # Whether the person's current role is known. `present` — current_role is
+            # populated. `none` — the work history explicitly shows every role has ended.
+            # `unknown` — our data sources could not confirm either way; treat a missing
+            # current_role as unverified rather than vacant.
+            module CurrentRoleStatus
+              extend ContextDev::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              PRESENT =
+                T.let(
+                  :present,
+                  ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus::TaggedSymbol
+                )
+              NONE =
+                T.let(
+                  :none,
+                  ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus::TaggedSymbol
+                )
+              UNKNOWN =
+                T.let(
+                  :unknown,
+                  ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    ContextDev::Models::PersonEnrichResponse::Match::Candidate::Person::CurrentRoleStatus::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
             class Education < ContextDev::Internal::Type::BaseModel
               OrHash =
                 T.type_alias do

data/rbi/context_dev/models/utility_prefetch_params.rbi

@@ -14,7 +14,7 @@ module ContextDev
           )
         end
 
-      # Identifier of the brand to prefetch. Provide exactly one of domain or email.
+      # Identifier of the target to prefetch. Provide exactly one of domain or email.
       sig do
         returns(
           T.any(
@@ -25,7 +25,8 @@ module ContextDev
       end
       attr_accessor :identifier
 
-      # What to prefetch. Currently only 'brand' is supported.
+      # What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the
+      # styleguide cache.
       sig { returns(ContextDev::UtilityPrefetchParams::Type::OrSymbol) }
       attr_accessor :type
 
@@ -59,9 +60,10 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
-        # Identifier of the brand to prefetch. Provide exactly one of domain or email.
+        # Identifier of the target to prefetch. Provide exactly one of domain or email.
         identifier:,
-        # What to prefetch. Currently only 'brand' is supported.
+        # What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the
+        # styleguide cache.
         type:,
         # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
         tags: nil,
@@ -91,7 +93,7 @@ module ContextDev
       def to_hash
       end
 
-      # Identifier of the brand to prefetch. Provide exactly one of domain or email.
+      # Identifier of the target to prefetch. Provide exactly one of domain or email.
       module Identifier
         extend ContextDev::Internal::Type::Union
 
@@ -112,14 +114,14 @@ module ContextDev
               )
             end
 
-          # Domain name to prefetch brand data for
+          # Domain name to prefetch data for
           sig { returns(String) }
           attr_accessor :domain
 
-          # Prefetch brand data by domain.
+          # Prefetch by domain.
           sig { params(domain: String).returns(T.attached_class) }
           def self.new(
-            # Domain name to prefetch brand data for
+            # Domain name to prefetch data for
             domain:
           )
           end
@@ -138,18 +140,18 @@ module ContextDev
               )
             end
 
-          # Email address to prefetch brand data for. The domain will be extracted from the
-          # email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email
-          # addresses are not allowed.
+          # Email address to prefetch data for. The domain will be extracted from the email.
+          # Free email providers (gmail.com, yahoo.com, etc.) and disposable email addresses
+          # are not allowed.
           sig { returns(String) }
           attr_accessor :email
 
-          # Prefetch brand data by email. The domain will be extracted and validated.
+          # Prefetch by email. The domain will be extracted and validated.
           sig { params(email: String).returns(T.attached_class) }
           def self.new(
-            # Email address to prefetch brand data for. The domain will be extracted from the
-            # email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email
-            # addresses are not allowed.
+            # Email address to prefetch data for. The domain will be extracted from the email.
+            # Free email providers (gmail.com, yahoo.com, etc.) and disposable email addresses
+            # are not allowed.
             email:
           )
           end
@@ -168,7 +170,8 @@ module ContextDev
         end
       end
 
-      # What to prefetch. Currently only 'brand' is supported.
+      # What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the
+      # styleguide cache.
       module Type
         extend ContextDev::Internal::Type::Enum
 
@@ -180,6 +183,11 @@ module ContextDev
 
         BRAND =
           T.let(:brand, ContextDev::UtilityPrefetchParams::Type::TaggedSymbol)
+        STYLEGUIDE =
+          T.let(
+            :styleguide,
+            ContextDev::UtilityPrefetchParams::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(