lumnisai 0.5.25 → 0.5.26

package/dist/index.cjs

@@ -1177,6 +1177,10 @@ class EnrichmentResource {
    * @param params.onlyVerifiedEmail - Only return verified emails (default: true)
    * @param params.enrichMobile - Include mobile enrichment, 10x cost (default: false)
    * @param params.onlyVerifiedMobile - Only return verified mobiles (default: false)
+   * @param params.deepWebFallback - For vendor-misses, discover contacts from the
+   *   organization's official public web pages. Findings come back in
+   *   `result.deepWebFindings` with source URLs + confidence tiers and never
+   *   overwrite `person.email`. Pass false to disable (default: true)
    * @returns Promise resolving to enrichment results
    *
    * @example
@@ -3550,6 +3554,10 @@ class ResponsesResource {
    * @param options.excludePreviouslyContacted - Exclude previously contacted people
    * @param options.excludeNames - Names to exclude from results
    * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
+   * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
+   * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+   * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+   * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
    * @returns Response with structured_response containing:
    *   - candidates: Validated and scored candidates
    *   - criteria: Generated/reused criteria definitions and classification
@@ -3560,8 +3568,11 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "deep_people_search"
     };
+    const params = {
+      deepValidationUseRelevanceReranker: options?.deepValidationUseRelevanceReranker ?? true,
+      deepValidationBackfillBelowCriteria: options?.deepValidationBackfillBelowCriteria ?? true
+    };
     if (options) {
-      const params = {};
       if (options.requestedCandidates !== void 0)
         params.requestedCandidates = options.requestedCandidates;
       if (options.dataSources)
@@ -3612,9 +3623,12 @@ class ResponsesResource {
         params.postsExtractAuthor = options.postsExtractAuthor;
       if (options.searchJobSignal !== void 0)
         params.searchJobSignal = options.searchJobSignal;
-      if (Object.keys(params).length > 0)
-        request.specializedAgentParams = params;
+      if (options.deepVerify !== void 0)
+        params.deepVerify = options.deepVerify;
+      if (options.deepSearchCriteriaModel)
+        params.deepSearchCriteriaModel = options.deepSearchCriteriaModel;
     }
+    request.specializedAgentParams = params;
     return this.create(request);
   }
   /**
@@ -3631,6 +3645,9 @@ class ResponsesResource {
    *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
    *   Example string: 'Must have 5+ years Python experience'
    *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+   * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+   * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+   * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
    * @returns Response with structured_response containing:
    *   - candidates: Scored candidates with validation results
    *   - criteria: Generated/reused criteria definitions and classification
@@ -3640,7 +3657,9 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "people_scoring",
       specializedAgentParams: {
-        candidateProfiles
+        candidateProfiles,
+        deepValidationUseRelevanceReranker: options?.deepValidationUseRelevanceReranker ?? true,
+        deepValidationBackfillBelowCriteria: options?.deepValidationBackfillBelowCriteria ?? true
       }
     };
     if (options) {
@@ -3656,6 +3675,8 @@ class ResponsesResource {
         request.specializedAgentParams.addCriterion = options.addCriterion;
       if (options.addAndRunCriterion)
         request.specializedAgentParams.addAndRunCriterion = options.addAndRunCriterion;
+      if (options.deepSearchCriteriaModel)
+        request.specializedAgentParams.deepSearchCriteriaModel = options.deepSearchCriteriaModel;
     }
     return this.create(request);
   }
@@ -3689,7 +3710,9 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "competitor_post_engagement"
     };
-    const params = {};
+    const params = {
+      deepValidationUseRelevanceReranker: options.deepValidationUseRelevanceReranker ?? true
+    };
     if (options.company)
       params.company = options.company;
     if (options.competitors)
@@ -3755,7 +3778,9 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "competitor_rep_engagement"
     };
-    const params = {};
+    const params = {
+      deepValidationUseRelevanceReranker: options.deepValidationUseRelevanceReranker ?? true
+    };
     if (options.company)
       params.company = options.company;
     if (options.competitors)

package/dist/index.d.cts

@@ -1342,12 +1342,20 @@ interface ModelOverrides {
     [key: string]: string;
 }
 type CriterionType = 'universal' | 'varying' | 'validation_only';
+/** SLM relevance reranker tier (deep_people_search / people_scoring output). */
+type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
 interface CriterionDefinition {
     criterionId: string;
     columnName: string;
     criterionText: string;
     criterionType: CriterionType;
     weight: number;
+    /** Set by the web-need classifier when deep verification runs (response output). */
+    requiresWebVerification?: boolean;
+    /** Whose fact must be verified: person, organization, or location (response output). */
+    verificationEntity?: 'person' | 'organization' | 'location';
+    /** Positive fact question used for web verification (response output). */
+    verificationQuestion?: string;
 }
 interface CriteriaClassification {
     universalCriteria: CriterionDefinition[];
@@ -1498,9 +1506,15 @@ interface ValidatedCandidate {
     name: string;
     /** LinkedIn profile URL */
     linkedinUrl?: string;
-    /** Current job title */
+    /**
+     * Current job title. When the reranker runs, may reflect the resolved primary
+     * operating role (`primaryTitle`); see `enrichedCurrentTitle` for the pre-rerank value.
+     */
     currentTitle?: string;
-    /** Current company */
+    /**
+     * Current company. When the reranker runs, may reflect the resolved primary
+     * employer (`primaryCompany`); see `enrichedCurrentCompany` for the pre-rerank value.
+     */
     currentCompany?: string;
     /** Location */
     location?: string;
@@ -1535,6 +1549,40 @@ interface ValidatedCandidate {
      * competitor_rep_engagement.
      */
     intentSignals?: IntentSignal[];
+    /**
+     * Holistic relevance score (0-100) from the SLM reranker (on by default).
+     * Ranking-only: absent only when `deepValidationUseRelevanceReranker` was false;
+     * does not change `overallScore` or routing.
+     */
+    relevanceScore?: number;
+    /** Coarse match tier paired with `relevanceScore`. */
+    relevanceTier?: RelevanceTier;
+    /** One-line reranker justification grounded in candidate data. */
+    relevanceReason?: string;
+    /**
+     * Primary current operating role from the reranker (main full-time job, not side/advisory).
+     * Also written to `currentTitle` when present.
+     */
+    primaryTitle?: string;
+    /**
+     * Employer of the primary current role. Also written to `currentCompany` when present.
+     */
+    primaryCompany?: string;
+    /** Pre-rerank `currentTitle` preserved when the reranker overwrites display fields. */
+    enrichedCurrentTitle?: string;
+    /** Pre-rerank `currentCompany` preserved when the reranker overwrites display fields. */
+    enrichedCurrentCompany?: string;
+    /**
+     * True when the candidate failed at least one universal or post_hard (must-have) criterion.
+     * Demoted candidates (`anyUniversalFailed` or `backfilled`) sort after passing ones regardless
+     * of relevance score.
+     */
+    anyUniversalFailed?: boolean;
+    /**
+     * True when promoted from excluded to meet the requested count despite failing hard
+     * criteria. Such candidates sort after passing ones; use to segregate or badge them.
+     */
+    backfilled?: boolean;
     /**
      * LinkedIn posts this candidate engaged with (reacted or commented).
      * One entry per post — if someone engaged with multiple competitor posts,
@@ -1826,6 +1874,39 @@ interface SpecializedAgentParams {
      * Used by deep_people_search when includeEngagementInScore is true.
      */
     engagementScoreWeight?: number;
+    /**
+     * Web verification of criteria a LinkedIn profile cannot establish (customer/vendor
+     * status, agency type, city stats, grants, etc.).
+     * - 'auto' (default): classifier forces only web-only criteria to real web verification
+     * - 'always': force every non-profile criterion to web verification
+     * - 'off': legacy behavior (may clear web-only criteria from profile data alone)
+     * Used by deep_people_search.
+     */
+    deepVerify?: 'off' | 'auto' | 'always';
+    /**
+     * If true, re-rank surfaced results with a cheap SLM relevance judge (holistic fit
+     * to the request). Ranking-only: never changes routing/inclusion; `overallScore` and
+     * `intentScore` are untouched. Adds `relevanceScore` / `relevanceTier` per candidate.
+     * @default true
+     * Used by deep_people_search, people_scoring, competitor_post_engagement, and
+     * competitor_rep_engagement.
+     */
+    deepValidationUseRelevanceReranker?: boolean;
+    /**
+     * When fewer candidates pass hard criteria than requested, pad the result list by
+     * promoting top-scoring excluded candidates (tagged `backfilled=true`). Set false for
+     * quality-over-count (return only passing candidates, even if fewer than requested).
+     * @default true
+     * Used by deep_people_search and people_scoring.
+     */
+    deepValidationBackfillBelowCriteria?: boolean;
+    /**
+     * Override the model used for criteria decomposition (e.g. 'openai:gpt-5.4').
+     * Defaults to the configured deep-search model. Only changes the criteria generator,
+     * not fast_filter/validation.
+     * Used by deep_people_search and people_scoring.
+     */
+    deepSearchCriteriaModel?: string;
     /**
      * Whether to extract post authors as candidates from posts search.
      * When true with directPostsExtractReactors=false and directPostsExtractCommenters=false,
@@ -3542,6 +3623,53 @@ interface ContactEnrichRequest {
     enrichMobile?: boolean;
     /** Only return/charge for records with verified mobile (default: false) */
     onlyVerifiedMobile?: boolean;
+    /**
+     * "Extra deep search", ON by default. Any prospect the data vendors leave
+     * without an acceptable WORK email is looked up on the organization's own
+     * official web pages (team/people directories, profiles, org charts). For
+     * LinkedIn-URL inputs the person's name + organization are resolved from the
+     * profile first. Results come back in `deepWebFindings` on that person's
+     * result - each with a source URL and a confidence tier - and NEVER overwrite
+     * the vendor `person.email`. Pass false to disable (it spends search + scrape
+     * + LLM + verification credits and adds latency). (default: true)
+     */
+    deepWebFallback?: boolean;
+}
+/**
+ * One contact found on the public web (deep-web fallback).
+ *
+ * Verification is a returned property, not a filter: findings carry their
+ * evidence (`sourceUrl`), how they were obtained (`derivation`), and a
+ * `confidence` tier so the caller decides what to trust. A `pattern_derived`
+ * value is an inference, never a vendor-grade match.
+ */
+interface ContactFinding {
+    channel: 'email' | 'phone';
+    value: string;
+    /** Official page the value came from */
+    sourceUrl: string;
+    /** directory|profile|org_chart|listing|press_release|other */
+    sourceType: string;
+    derivation: 'found_directly' | 'pattern_derived';
+    /**
+     * For email: the ZeroBounce status (valid/invalid/catch-all/unknown/
+     * unverified). For phone: direct|main_line.
+     */
+    verification: string;
+    /**
+     * confirmed: page confirms this person currently holds the role.
+     * contradicted: page names a DIFFERENT current holder (they moved).
+     * unconfirmed: pages don't establish the current role (not a stale signal -
+     * just unknown).
+     */
+    roleStatus: 'confirmed' | 'contradicted' | 'unconfirmed';
+    /**
+     * When roleStatus=contradicted, the person the official page names as the
+     * CURRENT holder of the role (i.e. who replaced this prospect).
+     */
+    currentRoleHolder?: string | null;
+    confidence: 'high' | 'medium' | 'low';
+    notes?: string | null;
 }
 /** Result for one person */
 interface ContactEnrichPersonResult {
@@ -3553,6 +3681,13 @@ interface ContactEnrichPersonResult {
     errorCode?: string | null;
     person?: Record<string, any> | null;
     company?: Record<string, any> | null;
+    /**
+     * Present only when deepWebFallback was requested AND the vendors left this
+     * person without an acceptable work email. Public-web findings with source
+     * URLs + confidence tiers; not billed as vendor matches, never merged into
+     * `person.email`.
+     */
+    deepWebFindings?: ContactFinding[] | null;
 }
 /** Response for bulk enrichment */
 interface ContactEnrichResponse {
@@ -3576,6 +3711,10 @@ declare class EnrichmentResource {
      * @param params.onlyVerifiedEmail - Only return verified emails (default: true)
      * @param params.enrichMobile - Include mobile enrichment, 10x cost (default: false)
      * @param params.onlyVerifiedMobile - Only return verified mobiles (default: false)
+     * @param params.deepWebFallback - For vendor-misses, discover contacts from the
+     *   organization's official public web pages. Findings come back in
+     *   `result.deepWebFindings` with source URLs + confidence tiers and never
+     *   overwrite `person.email`. Pass false to disable (default: true)
      * @returns Promise resolving to enrichment results
      *
      * @example
@@ -5772,6 +5911,10 @@ declare class ResponsesResource {
      * @param options.excludePreviouslyContacted - Exclude previously contacted people
      * @param options.excludeNames - Names to exclude from results
      * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
+     * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
+     * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+     * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+     * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
      * @returns Response with structured_response containing:
      *   - candidates: Validated and scored candidates
      *   - criteria: Generated/reused criteria definitions and classification
@@ -5808,6 +5951,10 @@ declare class ResponsesResource {
         engagementScoreWeight?: number;
         postsExtractAuthor?: boolean;
         searchJobSignal?: boolean | 'auto';
+        deepVerify?: 'off' | 'auto' | 'always';
+        deepValidationUseRelevanceReranker?: boolean;
+        deepValidationBackfillBelowCriteria?: boolean;
+        deepSearchCriteriaModel?: string;
     }): Promise<CreateResponseResponse>;
     /**
      * Score provided candidates against AI-generated or provided criteria
@@ -5823,6 +5970,9 @@ declare class ResponsesResource {
      *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
      *   Example string: 'Must have 5+ years Python experience'
      *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+     * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+     * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
      * @returns Response with structured_response containing:
      *   - candidates: Scored candidates with validation results
      *   - criteria: Generated/reused criteria definitions and classification
@@ -5839,6 +5989,9 @@ declare class ResponsesResource {
             weight?: number;
         };
         addAndRunCriterion?: string | AddAndRunCriterionRequest;
+        deepValidationUseRelevanceReranker?: boolean;
+        deepValidationBackfillBelowCriteria?: boolean;
+        deepSearchCriteriaModel?: string;
     }): Promise<CreateResponseResponse>;
     /**
      * Score people who reacted to or commented on competitor LinkedIn posts.
@@ -5906,6 +6059,8 @@ declare class ResponsesResource {
          * Hard max 100 — above that Crustdata returns thin profiles.
          */
         maxCommentsPerPost?: number;
+        /** SLM relevance reranker for surfaced candidates (ranking-only); @default true */
+        deepValidationUseRelevanceReranker?: boolean;
     }): Promise<CreateResponseResponse>;
     /**
      * Find a competitor's sales reps and surface the AUTHORS of the LinkedIn posts
@@ -5988,6 +6143,8 @@ declare class ResponsesResource {
          * @default false
          */
         thoroughEnrichment?: boolean;
+        /** SLM relevance reranker for surfaced candidates (ranking-only); @default true */
+        deepValidationUseRelevanceReranker?: boolean;
     }): Promise<CreateResponseResponse>;
 }
 
@@ -7488,4 +7645,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };
+export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };

package/dist/index.d.mts

@@ -1342,12 +1342,20 @@ interface ModelOverrides {
     [key: string]: string;
 }
 type CriterionType = 'universal' | 'varying' | 'validation_only';
+/** SLM relevance reranker tier (deep_people_search / people_scoring output). */
+type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
 interface CriterionDefinition {
     criterionId: string;
     columnName: string;
     criterionText: string;
     criterionType: CriterionType;
     weight: number;
+    /** Set by the web-need classifier when deep verification runs (response output). */
+    requiresWebVerification?: boolean;
+    /** Whose fact must be verified: person, organization, or location (response output). */
+    verificationEntity?: 'person' | 'organization' | 'location';
+    /** Positive fact question used for web verification (response output). */
+    verificationQuestion?: string;
 }
 interface CriteriaClassification {
     universalCriteria: CriterionDefinition[];
@@ -1498,9 +1506,15 @@ interface ValidatedCandidate {
     name: string;
     /** LinkedIn profile URL */
     linkedinUrl?: string;
-    /** Current job title */
+    /**
+     * Current job title. When the reranker runs, may reflect the resolved primary
+     * operating role (`primaryTitle`); see `enrichedCurrentTitle` for the pre-rerank value.
+     */
     currentTitle?: string;
-    /** Current company */
+    /**
+     * Current company. When the reranker runs, may reflect the resolved primary
+     * employer (`primaryCompany`); see `enrichedCurrentCompany` for the pre-rerank value.
+     */
     currentCompany?: string;
     /** Location */
     location?: string;
@@ -1535,6 +1549,40 @@ interface ValidatedCandidate {
      * competitor_rep_engagement.
      */
     intentSignals?: IntentSignal[];
+    /**
+     * Holistic relevance score (0-100) from the SLM reranker (on by default).
+     * Ranking-only: absent only when `deepValidationUseRelevanceReranker` was false;
+     * does not change `overallScore` or routing.
+     */
+    relevanceScore?: number;
+    /** Coarse match tier paired with `relevanceScore`. */
+    relevanceTier?: RelevanceTier;
+    /** One-line reranker justification grounded in candidate data. */
+    relevanceReason?: string;
+    /**
+     * Primary current operating role from the reranker (main full-time job, not side/advisory).
+     * Also written to `currentTitle` when present.
+     */
+    primaryTitle?: string;
+    /**
+     * Employer of the primary current role. Also written to `currentCompany` when present.
+     */
+    primaryCompany?: string;
+    /** Pre-rerank `currentTitle` preserved when the reranker overwrites display fields. */
+    enrichedCurrentTitle?: string;
+    /** Pre-rerank `currentCompany` preserved when the reranker overwrites display fields. */
+    enrichedCurrentCompany?: string;
+    /**
+     * True when the candidate failed at least one universal or post_hard (must-have) criterion.
+     * Demoted candidates (`anyUniversalFailed` or `backfilled`) sort after passing ones regardless
+     * of relevance score.
+     */
+    anyUniversalFailed?: boolean;
+    /**
+     * True when promoted from excluded to meet the requested count despite failing hard
+     * criteria. Such candidates sort after passing ones; use to segregate or badge them.
+     */
+    backfilled?: boolean;
     /**
      * LinkedIn posts this candidate engaged with (reacted or commented).
      * One entry per post — if someone engaged with multiple competitor posts,
@@ -1826,6 +1874,39 @@ interface SpecializedAgentParams {
      * Used by deep_people_search when includeEngagementInScore is true.
      */
     engagementScoreWeight?: number;
+    /**
+     * Web verification of criteria a LinkedIn profile cannot establish (customer/vendor
+     * status, agency type, city stats, grants, etc.).
+     * - 'auto' (default): classifier forces only web-only criteria to real web verification
+     * - 'always': force every non-profile criterion to web verification
+     * - 'off': legacy behavior (may clear web-only criteria from profile data alone)
+     * Used by deep_people_search.
+     */
+    deepVerify?: 'off' | 'auto' | 'always';
+    /**
+     * If true, re-rank surfaced results with a cheap SLM relevance judge (holistic fit
+     * to the request). Ranking-only: never changes routing/inclusion; `overallScore` and
+     * `intentScore` are untouched. Adds `relevanceScore` / `relevanceTier` per candidate.
+     * @default true
+     * Used by deep_people_search, people_scoring, competitor_post_engagement, and
+     * competitor_rep_engagement.
+     */
+    deepValidationUseRelevanceReranker?: boolean;
+    /**
+     * When fewer candidates pass hard criteria than requested, pad the result list by
+     * promoting top-scoring excluded candidates (tagged `backfilled=true`). Set false for
+     * quality-over-count (return only passing candidates, even if fewer than requested).
+     * @default true
+     * Used by deep_people_search and people_scoring.
+     */
+    deepValidationBackfillBelowCriteria?: boolean;
+    /**
+     * Override the model used for criteria decomposition (e.g. 'openai:gpt-5.4').
+     * Defaults to the configured deep-search model. Only changes the criteria generator,
+     * not fast_filter/validation.
+     * Used by deep_people_search and people_scoring.
+     */
+    deepSearchCriteriaModel?: string;
     /**
      * Whether to extract post authors as candidates from posts search.
      * When true with directPostsExtractReactors=false and directPostsExtractCommenters=false,
@@ -3542,6 +3623,53 @@ interface ContactEnrichRequest {
     enrichMobile?: boolean;
     /** Only return/charge for records with verified mobile (default: false) */
     onlyVerifiedMobile?: boolean;
+    /**
+     * "Extra deep search", ON by default. Any prospect the data vendors leave
+     * without an acceptable WORK email is looked up on the organization's own
+     * official web pages (team/people directories, profiles, org charts). For
+     * LinkedIn-URL inputs the person's name + organization are resolved from the
+     * profile first. Results come back in `deepWebFindings` on that person's
+     * result - each with a source URL and a confidence tier - and NEVER overwrite
+     * the vendor `person.email`. Pass false to disable (it spends search + scrape
+     * + LLM + verification credits and adds latency). (default: true)
+     */
+    deepWebFallback?: boolean;
+}
+/**
+ * One contact found on the public web (deep-web fallback).
+ *
+ * Verification is a returned property, not a filter: findings carry their
+ * evidence (`sourceUrl`), how they were obtained (`derivation`), and a
+ * `confidence` tier so the caller decides what to trust. A `pattern_derived`
+ * value is an inference, never a vendor-grade match.
+ */
+interface ContactFinding {
+    channel: 'email' | 'phone';
+    value: string;
+    /** Official page the value came from */
+    sourceUrl: string;
+    /** directory|profile|org_chart|listing|press_release|other */
+    sourceType: string;
+    derivation: 'found_directly' | 'pattern_derived';
+    /**
+     * For email: the ZeroBounce status (valid/invalid/catch-all/unknown/
+     * unverified). For phone: direct|main_line.
+     */
+    verification: string;
+    /**
+     * confirmed: page confirms this person currently holds the role.
+     * contradicted: page names a DIFFERENT current holder (they moved).
+     * unconfirmed: pages don't establish the current role (not a stale signal -
+     * just unknown).
+     */
+    roleStatus: 'confirmed' | 'contradicted' | 'unconfirmed';
+    /**
+     * When roleStatus=contradicted, the person the official page names as the
+     * CURRENT holder of the role (i.e. who replaced this prospect).
+     */
+    currentRoleHolder?: string | null;
+    confidence: 'high' | 'medium' | 'low';
+    notes?: string | null;
 }
 /** Result for one person */
 interface ContactEnrichPersonResult {
@@ -3553,6 +3681,13 @@ interface ContactEnrichPersonResult {
     errorCode?: string | null;
     person?: Record<string, any> | null;
     company?: Record<string, any> | null;
+    /**
+     * Present only when deepWebFallback was requested AND the vendors left this
+     * person without an acceptable work email. Public-web findings with source
+     * URLs + confidence tiers; not billed as vendor matches, never merged into
+     * `person.email`.
+     */
+    deepWebFindings?: ContactFinding[] | null;
 }
 /** Response for bulk enrichment */
 interface ContactEnrichResponse {
@@ -3576,6 +3711,10 @@ declare class EnrichmentResource {
      * @param params.onlyVerifiedEmail - Only return verified emails (default: true)
      * @param params.enrichMobile - Include mobile enrichment, 10x cost (default: false)
      * @param params.onlyVerifiedMobile - Only return verified mobiles (default: false)
+     * @param params.deepWebFallback - For vendor-misses, discover contacts from the
+     *   organization's official public web pages. Findings come back in
+     *   `result.deepWebFindings` with source URLs + confidence tiers and never
+     *   overwrite `person.email`. Pass false to disable (default: true)
      * @returns Promise resolving to enrichment results
      *
      * @example
@@ -5772,6 +5911,10 @@ declare class ResponsesResource {
      * @param options.excludePreviouslyContacted - Exclude previously contacted people
      * @param options.excludeNames - Names to exclude from results
      * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
+     * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
+     * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+     * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+     * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
      * @returns Response with structured_response containing:
      *   - candidates: Validated and scored candidates
      *   - criteria: Generated/reused criteria definitions and classification
@@ -5808,6 +5951,10 @@ declare class ResponsesResource {
         engagementScoreWeight?: number;
         postsExtractAuthor?: boolean;
         searchJobSignal?: boolean | 'auto';
+        deepVerify?: 'off' | 'auto' | 'always';
+        deepValidationUseRelevanceReranker?: boolean;
+        deepValidationBackfillBelowCriteria?: boolean;
+        deepSearchCriteriaModel?: string;
     }): Promise<CreateResponseResponse>;
     /**
      * Score provided candidates against AI-generated or provided criteria
@@ -5823,6 +5970,9 @@ declare class ResponsesResource {
      *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
      *   Example string: 'Must have 5+ years Python experience'
      *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+     * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+     * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
      * @returns Response with structured_response containing:
      *   - candidates: Scored candidates with validation results
      *   - criteria: Generated/reused criteria definitions and classification
@@ -5839,6 +5989,9 @@ declare class ResponsesResource {
             weight?: number;
         };
         addAndRunCriterion?: string | AddAndRunCriterionRequest;
+        deepValidationUseRelevanceReranker?: boolean;
+        deepValidationBackfillBelowCriteria?: boolean;
+        deepSearchCriteriaModel?: string;
     }): Promise<CreateResponseResponse>;
     /**
      * Score people who reacted to or commented on competitor LinkedIn posts.
@@ -5906,6 +6059,8 @@ declare class ResponsesResource {
          * Hard max 100 — above that Crustdata returns thin profiles.
          */
         maxCommentsPerPost?: number;
+        /** SLM relevance reranker for surfaced candidates (ranking-only); @default true */
+        deepValidationUseRelevanceReranker?: boolean;
     }): Promise<CreateResponseResponse>;
     /**
      * Find a competitor's sales reps and surface the AUTHORS of the LinkedIn posts
@@ -5988,6 +6143,8 @@ declare class ResponsesResource {
          * @default false
          */
         thoroughEnrichment?: boolean;
+        /** SLM relevance reranker for surfaced candidates (ranking-only); @default true */
+        deepValidationUseRelevanceReranker?: boolean;
     }): Promise<CreateResponseResponse>;
 }
 
@@ -7488,4 +7645,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };
+export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1342,12 +1342,20 @@ interface ModelOverrides {
     [key: string]: string;
 }
 type CriterionType = 'universal' | 'varying' | 'validation_only';
+/** SLM relevance reranker tier (deep_people_search / people_scoring output). */
+type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
 interface CriterionDefinition {
     criterionId: string;
     columnName: string;
     criterionText: string;
     criterionType: CriterionType;
     weight: number;
+    /** Set by the web-need classifier when deep verification runs (response output). */
+    requiresWebVerification?: boolean;
+    /** Whose fact must be verified: person, organization, or location (response output). */
+    verificationEntity?: 'person' | 'organization' | 'location';
+    /** Positive fact question used for web verification (response output). */
+    verificationQuestion?: string;
 }
 interface CriteriaClassification {
     universalCriteria: CriterionDefinition[];
@@ -1498,9 +1506,15 @@ interface ValidatedCandidate {
     name: string;
     /** LinkedIn profile URL */
     linkedinUrl?: string;
-    /** Current job title */
+    /**
+     * Current job title. When the reranker runs, may reflect the resolved primary
+     * operating role (`primaryTitle`); see `enrichedCurrentTitle` for the pre-rerank value.
+     */
     currentTitle?: string;
-    /** Current company */
+    /**
+     * Current company. When the reranker runs, may reflect the resolved primary
+     * employer (`primaryCompany`); see `enrichedCurrentCompany` for the pre-rerank value.
+     */
     currentCompany?: string;
     /** Location */
     location?: string;
@@ -1535,6 +1549,40 @@ interface ValidatedCandidate {
      * competitor_rep_engagement.
      */
     intentSignals?: IntentSignal[];
+    /**
+     * Holistic relevance score (0-100) from the SLM reranker (on by default).
+     * Ranking-only: absent only when `deepValidationUseRelevanceReranker` was false;
+     * does not change `overallScore` or routing.
+     */
+    relevanceScore?: number;
+    /** Coarse match tier paired with `relevanceScore`. */
+    relevanceTier?: RelevanceTier;
+    /** One-line reranker justification grounded in candidate data. */
+    relevanceReason?: string;
+    /**
+     * Primary current operating role from the reranker (main full-time job, not side/advisory).
+     * Also written to `currentTitle` when present.
+     */
+    primaryTitle?: string;
+    /**
+     * Employer of the primary current role. Also written to `currentCompany` when present.
+     */
+    primaryCompany?: string;
+    /** Pre-rerank `currentTitle` preserved when the reranker overwrites display fields. */
+    enrichedCurrentTitle?: string;
+    /** Pre-rerank `currentCompany` preserved when the reranker overwrites display fields. */
+    enrichedCurrentCompany?: string;
+    /**
+     * True when the candidate failed at least one universal or post_hard (must-have) criterion.
+     * Demoted candidates (`anyUniversalFailed` or `backfilled`) sort after passing ones regardless
+     * of relevance score.
+     */
+    anyUniversalFailed?: boolean;
+    /**
+     * True when promoted from excluded to meet the requested count despite failing hard
+     * criteria. Such candidates sort after passing ones; use to segregate or badge them.
+     */
+    backfilled?: boolean;
     /**
      * LinkedIn posts this candidate engaged with (reacted or commented).
      * One entry per post — if someone engaged with multiple competitor posts,
@@ -1826,6 +1874,39 @@ interface SpecializedAgentParams {
      * Used by deep_people_search when includeEngagementInScore is true.
      */
     engagementScoreWeight?: number;
+    /**
+     * Web verification of criteria a LinkedIn profile cannot establish (customer/vendor
+     * status, agency type, city stats, grants, etc.).
+     * - 'auto' (default): classifier forces only web-only criteria to real web verification
+     * - 'always': force every non-profile criterion to web verification
+     * - 'off': legacy behavior (may clear web-only criteria from profile data alone)
+     * Used by deep_people_search.
+     */
+    deepVerify?: 'off' | 'auto' | 'always';
+    /**
+     * If true, re-rank surfaced results with a cheap SLM relevance judge (holistic fit
+     * to the request). Ranking-only: never changes routing/inclusion; `overallScore` and
+     * `intentScore` are untouched. Adds `relevanceScore` / `relevanceTier` per candidate.
+     * @default true
+     * Used by deep_people_search, people_scoring, competitor_post_engagement, and
+     * competitor_rep_engagement.
+     */
+    deepValidationUseRelevanceReranker?: boolean;
+    /**
+     * When fewer candidates pass hard criteria than requested, pad the result list by
+     * promoting top-scoring excluded candidates (tagged `backfilled=true`). Set false for
+     * quality-over-count (return only passing candidates, even if fewer than requested).
+     * @default true
+     * Used by deep_people_search and people_scoring.
+     */
+    deepValidationBackfillBelowCriteria?: boolean;
+    /**
+     * Override the model used for criteria decomposition (e.g. 'openai:gpt-5.4').
+     * Defaults to the configured deep-search model. Only changes the criteria generator,
+     * not fast_filter/validation.
+     * Used by deep_people_search and people_scoring.
+     */
+    deepSearchCriteriaModel?: string;
     /**
      * Whether to extract post authors as candidates from posts search.
      * When true with directPostsExtractReactors=false and directPostsExtractCommenters=false,
@@ -3542,6 +3623,53 @@ interface ContactEnrichRequest {
     enrichMobile?: boolean;
     /** Only return/charge for records with verified mobile (default: false) */
     onlyVerifiedMobile?: boolean;
+    /**
+     * "Extra deep search", ON by default. Any prospect the data vendors leave
+     * without an acceptable WORK email is looked up on the organization's own
+     * official web pages (team/people directories, profiles, org charts). For
+     * LinkedIn-URL inputs the person's name + organization are resolved from the
+     * profile first. Results come back in `deepWebFindings` on that person's
+     * result - each with a source URL and a confidence tier - and NEVER overwrite
+     * the vendor `person.email`. Pass false to disable (it spends search + scrape
+     * + LLM + verification credits and adds latency). (default: true)
+     */
+    deepWebFallback?: boolean;
+}
+/**
+ * One contact found on the public web (deep-web fallback).
+ *
+ * Verification is a returned property, not a filter: findings carry their
+ * evidence (`sourceUrl`), how they were obtained (`derivation`), and a
+ * `confidence` tier so the caller decides what to trust. A `pattern_derived`
+ * value is an inference, never a vendor-grade match.
+ */
+interface ContactFinding {
+    channel: 'email' | 'phone';
+    value: string;
+    /** Official page the value came from */
+    sourceUrl: string;
+    /** directory|profile|org_chart|listing|press_release|other */
+    sourceType: string;
+    derivation: 'found_directly' | 'pattern_derived';
+    /**
+     * For email: the ZeroBounce status (valid/invalid/catch-all/unknown/
+     * unverified). For phone: direct|main_line.
+     */
+    verification: string;
+    /**
+     * confirmed: page confirms this person currently holds the role.
+     * contradicted: page names a DIFFERENT current holder (they moved).
+     * unconfirmed: pages don't establish the current role (not a stale signal -
+     * just unknown).
+     */
+    roleStatus: 'confirmed' | 'contradicted' | 'unconfirmed';
+    /**
+     * When roleStatus=contradicted, the person the official page names as the
+     * CURRENT holder of the role (i.e. who replaced this prospect).
+     */
+    currentRoleHolder?: string | null;
+    confidence: 'high' | 'medium' | 'low';
+    notes?: string | null;
 }
 /** Result for one person */
 interface ContactEnrichPersonResult {
@@ -3553,6 +3681,13 @@ interface ContactEnrichPersonResult {
     errorCode?: string | null;
     person?: Record<string, any> | null;
     company?: Record<string, any> | null;
+    /**
+     * Present only when deepWebFallback was requested AND the vendors left this
+     * person without an acceptable work email. Public-web findings with source
+     * URLs + confidence tiers; not billed as vendor matches, never merged into
+     * `person.email`.
+     */
+    deepWebFindings?: ContactFinding[] | null;
 }
 /** Response for bulk enrichment */
 interface ContactEnrichResponse {
@@ -3576,6 +3711,10 @@ declare class EnrichmentResource {
      * @param params.onlyVerifiedEmail - Only return verified emails (default: true)
      * @param params.enrichMobile - Include mobile enrichment, 10x cost (default: false)
      * @param params.onlyVerifiedMobile - Only return verified mobiles (default: false)
+     * @param params.deepWebFallback - For vendor-misses, discover contacts from the
+     *   organization's official public web pages. Findings come back in
+     *   `result.deepWebFindings` with source URLs + confidence tiers and never
+     *   overwrite `person.email`. Pass false to disable (default: true)
      * @returns Promise resolving to enrichment results
      *
      * @example
@@ -5772,6 +5911,10 @@ declare class ResponsesResource {
      * @param options.excludePreviouslyContacted - Exclude previously contacted people
      * @param options.excludeNames - Names to exclude from results
      * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
+     * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
+     * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+     * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+     * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
      * @returns Response with structured_response containing:
      *   - candidates: Validated and scored candidates
      *   - criteria: Generated/reused criteria definitions and classification
@@ -5808,6 +5951,10 @@ declare class ResponsesResource {
         engagementScoreWeight?: number;
         postsExtractAuthor?: boolean;
         searchJobSignal?: boolean | 'auto';
+        deepVerify?: 'off' | 'auto' | 'always';
+        deepValidationUseRelevanceReranker?: boolean;
+        deepValidationBackfillBelowCriteria?: boolean;
+        deepSearchCriteriaModel?: string;
     }): Promise<CreateResponseResponse>;
     /**
      * Score provided candidates against AI-generated or provided criteria
@@ -5823,6 +5970,9 @@ declare class ResponsesResource {
      *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
      *   Example string: 'Must have 5+ years Python experience'
      *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+     * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+     * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
      * @returns Response with structured_response containing:
      *   - candidates: Scored candidates with validation results
      *   - criteria: Generated/reused criteria definitions and classification
@@ -5839,6 +5989,9 @@ declare class ResponsesResource {
             weight?: number;
         };
         addAndRunCriterion?: string | AddAndRunCriterionRequest;
+        deepValidationUseRelevanceReranker?: boolean;
+        deepValidationBackfillBelowCriteria?: boolean;
+        deepSearchCriteriaModel?: string;
     }): Promise<CreateResponseResponse>;
     /**
      * Score people who reacted to or commented on competitor LinkedIn posts.
@@ -5906,6 +6059,8 @@ declare class ResponsesResource {
          * Hard max 100 — above that Crustdata returns thin profiles.
          */
         maxCommentsPerPost?: number;
+        /** SLM relevance reranker for surfaced candidates (ranking-only); @default true */
+        deepValidationUseRelevanceReranker?: boolean;
     }): Promise<CreateResponseResponse>;
     /**
      * Find a competitor's sales reps and surface the AUTHORS of the LinkedIn posts
@@ -5988,6 +6143,8 @@ declare class ResponsesResource {
          * @default false
          */
         thoroughEnrichment?: boolean;
+        /** SLM relevance reranker for surfaced candidates (ranking-only); @default true */
+        deepValidationUseRelevanceReranker?: boolean;
     }): Promise<CreateResponseResponse>;
 }
 
@@ -7488,4 +7645,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };
+export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };

package/dist/index.mjs

@@ -1171,6 +1171,10 @@ class EnrichmentResource {
    * @param params.onlyVerifiedEmail - Only return verified emails (default: true)
    * @param params.enrichMobile - Include mobile enrichment, 10x cost (default: false)
    * @param params.onlyVerifiedMobile - Only return verified mobiles (default: false)
+   * @param params.deepWebFallback - For vendor-misses, discover contacts from the
+   *   organization's official public web pages. Findings come back in
+   *   `result.deepWebFindings` with source URLs + confidence tiers and never
+   *   overwrite `person.email`. Pass false to disable (default: true)
    * @returns Promise resolving to enrichment results
    *
    * @example
@@ -3544,6 +3548,10 @@ class ResponsesResource {
    * @param options.excludePreviouslyContacted - Exclude previously contacted people
    * @param options.excludeNames - Names to exclude from results
    * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
+   * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
+   * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+   * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+   * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
    * @returns Response with structured_response containing:
    *   - candidates: Validated and scored candidates
    *   - criteria: Generated/reused criteria definitions and classification
@@ -3554,8 +3562,11 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "deep_people_search"
     };
+    const params = {
+      deepValidationUseRelevanceReranker: options?.deepValidationUseRelevanceReranker ?? true,
+      deepValidationBackfillBelowCriteria: options?.deepValidationBackfillBelowCriteria ?? true
+    };
     if (options) {
-      const params = {};
       if (options.requestedCandidates !== void 0)
         params.requestedCandidates = options.requestedCandidates;
       if (options.dataSources)
@@ -3606,9 +3617,12 @@ class ResponsesResource {
         params.postsExtractAuthor = options.postsExtractAuthor;
       if (options.searchJobSignal !== void 0)
         params.searchJobSignal = options.searchJobSignal;
-      if (Object.keys(params).length > 0)
-        request.specializedAgentParams = params;
+      if (options.deepVerify !== void 0)
+        params.deepVerify = options.deepVerify;
+      if (options.deepSearchCriteriaModel)
+        params.deepSearchCriteriaModel = options.deepSearchCriteriaModel;
     }
+    request.specializedAgentParams = params;
     return this.create(request);
   }
   /**
@@ -3625,6 +3639,9 @@ class ResponsesResource {
    *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
    *   Example string: 'Must have 5+ years Python experience'
    *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+   * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
+   * @param options.deepValidationBackfillBelowCriteria - Pad with criteria-failed candidates when under count; @default true
+   * @param options.deepSearchCriteriaModel - Override criteria decomposition model (e.g. 'openai:gpt-5.4')
    * @returns Response with structured_response containing:
    *   - candidates: Scored candidates with validation results
    *   - criteria: Generated/reused criteria definitions and classification
@@ -3634,7 +3651,9 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "people_scoring",
       specializedAgentParams: {
-        candidateProfiles
+        candidateProfiles,
+        deepValidationUseRelevanceReranker: options?.deepValidationUseRelevanceReranker ?? true,
+        deepValidationBackfillBelowCriteria: options?.deepValidationBackfillBelowCriteria ?? true
       }
     };
     if (options) {
@@ -3650,6 +3669,8 @@ class ResponsesResource {
         request.specializedAgentParams.addCriterion = options.addCriterion;
       if (options.addAndRunCriterion)
         request.specializedAgentParams.addAndRunCriterion = options.addAndRunCriterion;
+      if (options.deepSearchCriteriaModel)
+        request.specializedAgentParams.deepSearchCriteriaModel = options.deepSearchCriteriaModel;
     }
     return this.create(request);
   }
@@ -3683,7 +3704,9 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "competitor_post_engagement"
     };
-    const params = {};
+    const params = {
+      deepValidationUseRelevanceReranker: options.deepValidationUseRelevanceReranker ?? true
+    };
     if (options.company)
       params.company = options.company;
     if (options.competitors)
@@ -3749,7 +3772,9 @@ class ResponsesResource {
       messages: [{ role: "user", content: query }],
       specializedAgent: "competitor_rep_engagement"
     };
-    const params = {};
+    const params = {
+      deepValidationUseRelevanceReranker: options.deepValidationUseRelevanceReranker ?? true
+    };
     if (options.company)
       params.company = options.company;
     if (options.competitors)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lumnisai",
   "type": "module",
-  "version": "0.5.25",
+  "version": "0.5.26",
   "description": "Official Node.js SDK for the Lumnis AI API",
   "author": "Lumnis AI",
   "license": "MIT",