lumnisai 0.5.29 → 0.5.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -969,8 +969,9 @@ class CrmResource {
969
969
  * `crmRecordId`. Stale links (record deleted in the CRM) are detected
970
970
  * and re-created automatically.
971
971
  *
972
- * Works with or without a `campaign_prospects` row search-sourced
973
- * prospects are enriched from profile cache when needed.
972
+ * Pass `contact` to avoid re-deriving attributes the caller already has.
973
+ * Any omitted contact fields are gap-filled from campaign/profile data when
974
+ * available. `customFields` keys are provider-native property names.
974
975
  *
975
976
  * @example
976
977
  * ```typescript
@@ -978,6 +979,13 @@ class CrmResource {
978
979
  * userId: 'user@example.com',
979
980
  * provider: 'attio',
980
981
  * linkedinUrl: 'https://www.linkedin.com/in/jane-doe/',
982
+ * contact: {
983
+ * fullName: 'Jane Doe',
984
+ * email: 'jane@example.com',
985
+ * jobTitle: 'VP of Sales',
986
+ * company: 'Acme',
987
+ * },
988
+ * customFields: { lead_source: 'Lumnis' },
981
989
  * })
982
990
  * console.log(result.action, result.crmUrl)
983
991
  * ```
@@ -1884,7 +1892,8 @@ function convertCase(obj, converter) {
1884
1892
  return obj.map((v) => convertCase(v, converter));
1885
1893
  } else if (obj !== null && typeof obj === "object") {
1886
1894
  return Object.keys(obj).reduce((acc, key) => {
1887
- acc[converter(key)] = convertCase(obj[key], converter);
1895
+ const value = key === "customFields" || key === "custom_fields" ? obj[key] : convertCase(obj[key], converter);
1896
+ acc[converter(key)] = value;
1888
1897
  return acc;
1889
1898
  }, {});
1890
1899
  }
@@ -3417,8 +3426,8 @@ class ResponsesResource {
3417
3426
  throw new ValidationError("add_criterion requires criterion_text");
3418
3427
  }
3419
3428
  if (addAndRunCriterion !== void 0) {
3420
- if (!reuseCriteriaFrom && !hasCriteria)
3421
- throw new ValidationError("add_and_run_criterion requires existing criteria (reuse or direct criteria).");
3429
+ if (!reuseCriteriaFrom && !hasCriteria && specializedAgent !== "people_scoring")
3430
+ throw new ValidationError("add_and_run_criterion requires existing criteria outside people_scoring.");
3422
3431
  if (typeof addAndRunCriterion === "string") {
3423
3432
  if (!addAndRunCriterion.trim())
3424
3433
  throw new ValidationError("add_and_run_criterion must be a non-empty string");
@@ -3429,10 +3438,19 @@ class ResponsesResource {
3429
3438
  "suggestedColumnName",
3430
3439
  "suggested_column_name"
3431
3440
  );
3432
- if (!criterionText || typeof criterionText !== "string")
3441
+ const answerFormat = this._getParamValue(addAndRunCriterion, "answerFormat", "answer_format");
3442
+ const columnKind = this._getParamValue(addAndRunCriterion, "columnKind", "column_kind");
3443
+ const webVerify = this._getParamValue(addAndRunCriterion, "webVerify", "web_verify");
3444
+ if (!criterionText || typeof criterionText !== "string" || !criterionText.trim())
3433
3445
  throw new ValidationError("add_and_run_criterion object requires criterion_text");
3434
3446
  if (suggestedColumnName !== void 0 && typeof suggestedColumnName !== "string")
3435
3447
  throw new ValidationError("add_and_run_criterion suggested_column_name must be a string if provided");
3448
+ if (answerFormat !== void 0 && typeof answerFormat !== "string")
3449
+ throw new ValidationError("add_and_run_criterion answer_format must be a string if provided");
3450
+ if (columnKind !== void 0 && columnKind !== "extraction" && columnKind !== "verdict")
3451
+ throw new ValidationError("add_and_run_criterion column_kind must be extraction or verdict");
3452
+ if (webVerify !== void 0 && typeof webVerify !== "boolean")
3453
+ throw new ValidationError("add_and_run_criterion web_verify must be a boolean if provided");
3436
3454
  } else {
3437
3455
  throw new ValidationError("add_and_run_criterion must be a string or an object");
3438
3456
  }
@@ -3624,7 +3642,9 @@ class ResponsesResource {
3624
3642
  * @param options.runSingleCriterion - Run only a single criterion by ID
3625
3643
  * @param options.addCriterion - Add a new criterion to existing criteria
3626
3644
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
3627
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
3645
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
3646
+ * and optional suggestedColumnName. Deep search still requires an existing criteria set;
3647
+ * use peopleScoring to bootstrap a column on a plain candidate list.
3628
3648
  * Example string: 'Must have 5+ years Python experience'
3629
3649
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
3630
3650
  * @param options.excludeProfiles - LinkedIn URLs to exclude from results
@@ -3707,6 +3727,10 @@ class ResponsesResource {
3707
3727
  params.engagementScoreWeight = options.engagementScoreWeight;
3708
3728
  if (options.postsExtractAuthor !== void 0)
3709
3729
  params.postsExtractAuthor = options.postsExtractAuthor;
3730
+ if (options.postsExtractReactors !== void 0)
3731
+ params.postsExtractReactors = options.postsExtractReactors;
3732
+ if (options.postsExtractCommenters !== void 0)
3733
+ params.postsExtractCommenters = options.postsExtractCommenters;
3710
3734
  if (options.searchJobSignal !== void 0)
3711
3735
  params.searchJobSignal = options.searchJobSignal;
3712
3736
  if (options.deepVerify !== void 0)
@@ -3728,7 +3752,8 @@ class ResponsesResource {
3728
3752
  * @param options.runSingleCriterion - Run only a single criterion by ID
3729
3753
  * @param options.addCriterion - Add a new criterion to existing criteria
3730
3754
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
3731
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
3755
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
3756
+ * and optional suggestedColumnName. No existing criteria are required.
3732
3757
  * Example string: 'Must have 5+ years Python experience'
3733
3758
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
3734
3759
  * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -4711,7 +4736,8 @@ class Http {
4711
4736
  detail = JSON.parse(detail.raw);
4712
4737
  } catch {
4713
4738
  }
4714
- const errorMsg = detail?.error?.message || `Server error: ${response.status}`;
4739
+ const responseDetail = detail?.detail;
4740
+ const errorMsg = detail?.error?.message || detail?.message || (typeof responseDetail === "string" ? responseDetail : void 0) || (responseDetail !== void 0 ? JSON.stringify(responseDetail) : void 0) || `Server error: ${response.status}`;
4715
4741
  switch (response.status) {
4716
4742
  case 401:
4717
4743
  throw new AuthenticationError("Invalid or missing API key", { requestId, statusCode: 401, details: detail });
package/dist/index.d.cts CHANGED
@@ -1342,6 +1342,7 @@ interface ModelOverrides {
1342
1342
  [key: string]: string;
1343
1343
  }
1344
1344
  type CriterionType = 'universal' | 'varying' | 'validation_only';
1345
+ type ColumnKind = 'extraction' | 'verdict';
1345
1346
  /** SLM relevance reranker tier (deep_people_search / people_scoring output). */
1346
1347
  type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
1347
1348
  interface CriterionDefinition {
@@ -1350,6 +1351,12 @@ interface CriterionDefinition {
1350
1351
  criterionText: string;
1351
1352
  criterionType: CriterionType;
1352
1353
  weight: number;
1354
+ /** Expected answer shape for an extraction column. */
1355
+ answerFormat?: string;
1356
+ /** Whether this criterion extracts a value or produces a score-bearing verdict. */
1357
+ columnKind?: ColumnKind;
1358
+ /** Extraction columns are excluded from fit-score calculations. */
1359
+ scoringRelevance?: 'none';
1353
1360
  /** Set by the web-need classifier when deep verification runs (response output). */
1354
1361
  requiresWebVerification?: boolean;
1355
1362
  /** Whose fact must be verified: person, organization, or location (response output). */
@@ -1374,6 +1381,12 @@ interface AddCriterionRequest {
1374
1381
  interface AddAndRunCriterionRequest {
1375
1382
  criterionText: string;
1376
1383
  suggestedColumnName?: string;
1384
+ /** Expected answer shape, such as "Exactly one of: A, B, C". */
1385
+ answerFormat?: string;
1386
+ /** Extraction columns are score-neutral; verdict columns contribute to fit. */
1387
+ columnKind?: ColumnKind;
1388
+ /** Verify the answer with web retrieval. Defaults to true. */
1389
+ webVerify?: boolean;
1377
1390
  }
1378
1391
  interface CriteriaMetadata {
1379
1392
  version: number;
@@ -1439,6 +1452,10 @@ interface CriterionResult {
1439
1452
  score: number;
1440
1453
  /** Confidence in the evaluation (0.0-1.0) */
1441
1454
  confidence: number;
1455
+ /** Canonical cell value for extraction columns; null when no reliable answer was found. */
1456
+ extractedValue?: string | null;
1457
+ /** Risk that the result is unsupported or hallucinated. */
1458
+ hallucinationRisk?: 'low' | 'medium' | 'high';
1442
1459
  /** User-facing explanation of what was checked and found (min 2 sentences) */
1443
1460
  reasoning: string;
1444
1461
  /** Concrete evidence with sources */
@@ -1526,8 +1543,10 @@ interface ValidatedCandidate {
1526
1543
  overallConfidence: number;
1527
1544
  /** User-facing summary (3-5 sentences with highlights) */
1528
1545
  summary: string;
1529
- /** Results for each evaluated criterion */
1530
- criterionResults: CriterionResult[];
1546
+ /** Legacy criterion-results field returned by some scoring paths. */
1547
+ criterionResults?: CriterionResult[];
1548
+ /** Criterion results emitted by deep_people_search and people_scoring. */
1549
+ deepCriteria?: CriterionResult[];
1531
1550
  /** Warnings about criteria that couldn't be fully verified */
1532
1551
  criteriaQualityWarnings?: string[];
1533
1552
  /** Explanation of LinkedIn engagement relevance (if applicable) */
@@ -1672,9 +1691,16 @@ interface DeepPeopleSearchOutput {
1672
1691
  searchStats?: DeepSearchStats;
1673
1692
  /** Criteria metadata */
1674
1693
  criteria?: CriteriaMetadata;
1694
+ /** Definitions used by the scoring pipeline. */
1695
+ criteriaDefinitions?: CriterionDefinition[];
1696
+ /** Distinct canonical values for each extraction column. */
1697
+ columnValues?: Record<string, string[]>;
1675
1698
  }
1676
1699
  interface StructuredResponse extends Record<string, any> {
1677
1700
  criteria?: CriteriaMetadata;
1701
+ criteriaDefinitions?: CriterionDefinition[];
1702
+ /** Distinct canonical values for each extraction column. */
1703
+ columnValues?: Record<string, string[]>;
1678
1704
  /** Deep people search output (when using deep_people_search agent) */
1679
1705
  preview?: DeepSearchPreview;
1680
1706
  candidates?: ValidatedCandidate[];
@@ -1936,6 +1962,16 @@ interface SpecializedAgentParams {
1936
1962
  * Used by deep_people_search.
1937
1963
  */
1938
1964
  postsExtractAuthor?: boolean;
1965
+ /**
1966
+ * Whether to extract reactors from topic-based post search results.
1967
+ * Omitted lets the post-search agent decide per committed post.
1968
+ */
1969
+ postsExtractReactors?: boolean;
1970
+ /**
1971
+ * Whether to extract commenters from topic-based post search results.
1972
+ * Omitted lets the post-search agent decide per committed post.
1973
+ */
1974
+ postsExtractCommenters?: boolean;
1939
1975
  /**
1940
1976
  * Direct LinkedIn post URLs to extract candidates from.
1941
1977
  * System will extract authors, reactors, and commenters with full profile data.
@@ -3279,11 +3315,29 @@ interface CrmExclusionGrantListResponse {
3279
3315
  memberUserId: string;
3280
3316
  ownerUserIds: string[];
3281
3317
  }
3318
+ /**
3319
+ * Contact attributes to send with a prospect sync.
3320
+ *
3321
+ * Every field is optional. The server fills omitted values from its campaign
3322
+ * and profile data when available. Supply either `fullName` or
3323
+ * `firstName` + `lastName`; `fullName` takes precedence when both are set.
3324
+ */
3325
+ interface CrmContactInput {
3326
+ fullName?: string;
3327
+ firstName?: string;
3328
+ lastName?: string;
3329
+ email?: string;
3330
+ jobTitle?: string;
3331
+ company?: string;
3332
+ /** Accepted by the API but not mapped to a CRM field in v1. */
3333
+ location?: string;
3334
+ }
3282
3335
  /**
3283
3336
  * Push one Lumnis prospect to the connected CRM.
3284
3337
  *
3285
- * Prefer a `campaign_prospects` row owned by `userId` when present; otherwise
3286
- * the server enriches from profile cache / Fiber and creates the CRM record.
3338
+ * Caller-supplied contact attributes take precedence. The server gap-fills
3339
+ * omitted values from campaign/profile data and creates the CRM record when
3340
+ * no existing contact matches.
3287
3341
  * Provider-id/URN LinkedIn URLs are resolved to vanity before reconcile.
3288
3342
  */
3289
3343
  interface CrmSyncProspectRequest {
@@ -3292,6 +3346,13 @@ interface CrmSyncProspectRequest {
3292
3346
  provider: CrmProvider;
3293
3347
  /** Must contain `linkedin.com/in/`. */
3294
3348
  linkedinUrl: string;
3349
+ /** Optional contact details; omitted fields are gap-filled server-side. */
3350
+ contact?: CrmContactInput;
3351
+ /**
3352
+ * Provider-native CRM property/attribute names mapped to string values.
3353
+ * These are applied on create and fill empty fields on an existing record.
3354
+ */
3355
+ customFields?: Record<string, string>;
3295
3356
  }
3296
3357
  interface CrmSyncProspectResponse {
3297
3358
  /**
@@ -3362,8 +3423,9 @@ declare class CrmResource {
3362
3423
  * `crmRecordId`. Stale links (record deleted in the CRM) are detected
3363
3424
  * and re-created automatically.
3364
3425
  *
3365
- * Works with or without a `campaign_prospects` row search-sourced
3366
- * prospects are enriched from profile cache when needed.
3426
+ * Pass `contact` to avoid re-deriving attributes the caller already has.
3427
+ * Any omitted contact fields are gap-filled from campaign/profile data when
3428
+ * available. `customFields` keys are provider-native property names.
3367
3429
  *
3368
3430
  * @example
3369
3431
  * ```typescript
@@ -3371,6 +3433,13 @@ declare class CrmResource {
3371
3433
  * userId: 'user@example.com',
3372
3434
  * provider: 'attio',
3373
3435
  * linkedinUrl: 'https://www.linkedin.com/in/jane-doe/',
3436
+ * contact: {
3437
+ * fullName: 'Jane Doe',
3438
+ * email: 'jane@example.com',
3439
+ * jobTitle: 'VP of Sales',
3440
+ * company: 'Acme',
3441
+ * },
3442
+ * customFields: { lead_source: 'Lumnis' },
3374
3443
  * })
3375
3444
  * console.log(result.action, result.crmUrl)
3376
3445
  * ```
@@ -6039,7 +6108,9 @@ declare class ResponsesResource {
6039
6108
  * @param options.runSingleCriterion - Run only a single criterion by ID
6040
6109
  * @param options.addCriterion - Add a new criterion to existing criteria
6041
6110
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
6042
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
6111
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
6112
+ * and optional suggestedColumnName. Deep search still requires an existing criteria set;
6113
+ * use peopleScoring to bootstrap a column on a plain candidate list.
6043
6114
  * Example string: 'Must have 5+ years Python experience'
6044
6115
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
6045
6116
  * @param options.excludeProfiles - LinkedIn URLs to exclude from results
@@ -6091,6 +6162,8 @@ declare class ResponsesResource {
6091
6162
  postsEnableFiltering?: boolean;
6092
6163
  engagementScoreWeight?: number;
6093
6164
  postsExtractAuthor?: boolean;
6165
+ postsExtractReactors?: boolean;
6166
+ postsExtractCommenters?: boolean;
6094
6167
  searchJobSignal?: boolean | 'auto';
6095
6168
  deepVerify?: 'off' | 'auto' | 'always';
6096
6169
  deepValidationUseRelevanceReranker?: boolean;
@@ -6108,7 +6181,8 @@ declare class ResponsesResource {
6108
6181
  * @param options.runSingleCriterion - Run only a single criterion by ID
6109
6182
  * @param options.addCriterion - Add a new criterion to existing criteria
6110
6183
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
6111
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
6184
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
6185
+ * and optional suggestedColumnName. No existing criteria are required.
6112
6186
  * Example string: 'Must have 5+ years Python experience'
6113
6187
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
6114
6188
  * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -7786,4 +7860,4 @@ declare class ProgressTracker {
7786
7860
  */
7787
7861
  declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
7788
7862
 
7789
- 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 CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, 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 PauseProspectsRequest, type PauseProspectsResponse, 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, type ResumeProspectsRequest, 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 };
7863
+ 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 ColumnKind, 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 CrmContactInput, type CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, 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 PauseProspectsRequest, type PauseProspectsResponse, 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, type ResumeProspectsRequest, 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 CHANGED
@@ -1342,6 +1342,7 @@ interface ModelOverrides {
1342
1342
  [key: string]: string;
1343
1343
  }
1344
1344
  type CriterionType = 'universal' | 'varying' | 'validation_only';
1345
+ type ColumnKind = 'extraction' | 'verdict';
1345
1346
  /** SLM relevance reranker tier (deep_people_search / people_scoring output). */
1346
1347
  type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
1347
1348
  interface CriterionDefinition {
@@ -1350,6 +1351,12 @@ interface CriterionDefinition {
1350
1351
  criterionText: string;
1351
1352
  criterionType: CriterionType;
1352
1353
  weight: number;
1354
+ /** Expected answer shape for an extraction column. */
1355
+ answerFormat?: string;
1356
+ /** Whether this criterion extracts a value or produces a score-bearing verdict. */
1357
+ columnKind?: ColumnKind;
1358
+ /** Extraction columns are excluded from fit-score calculations. */
1359
+ scoringRelevance?: 'none';
1353
1360
  /** Set by the web-need classifier when deep verification runs (response output). */
1354
1361
  requiresWebVerification?: boolean;
1355
1362
  /** Whose fact must be verified: person, organization, or location (response output). */
@@ -1374,6 +1381,12 @@ interface AddCriterionRequest {
1374
1381
  interface AddAndRunCriterionRequest {
1375
1382
  criterionText: string;
1376
1383
  suggestedColumnName?: string;
1384
+ /** Expected answer shape, such as "Exactly one of: A, B, C". */
1385
+ answerFormat?: string;
1386
+ /** Extraction columns are score-neutral; verdict columns contribute to fit. */
1387
+ columnKind?: ColumnKind;
1388
+ /** Verify the answer with web retrieval. Defaults to true. */
1389
+ webVerify?: boolean;
1377
1390
  }
1378
1391
  interface CriteriaMetadata {
1379
1392
  version: number;
@@ -1439,6 +1452,10 @@ interface CriterionResult {
1439
1452
  score: number;
1440
1453
  /** Confidence in the evaluation (0.0-1.0) */
1441
1454
  confidence: number;
1455
+ /** Canonical cell value for extraction columns; null when no reliable answer was found. */
1456
+ extractedValue?: string | null;
1457
+ /** Risk that the result is unsupported or hallucinated. */
1458
+ hallucinationRisk?: 'low' | 'medium' | 'high';
1442
1459
  /** User-facing explanation of what was checked and found (min 2 sentences) */
1443
1460
  reasoning: string;
1444
1461
  /** Concrete evidence with sources */
@@ -1526,8 +1543,10 @@ interface ValidatedCandidate {
1526
1543
  overallConfidence: number;
1527
1544
  /** User-facing summary (3-5 sentences with highlights) */
1528
1545
  summary: string;
1529
- /** Results for each evaluated criterion */
1530
- criterionResults: CriterionResult[];
1546
+ /** Legacy criterion-results field returned by some scoring paths. */
1547
+ criterionResults?: CriterionResult[];
1548
+ /** Criterion results emitted by deep_people_search and people_scoring. */
1549
+ deepCriteria?: CriterionResult[];
1531
1550
  /** Warnings about criteria that couldn't be fully verified */
1532
1551
  criteriaQualityWarnings?: string[];
1533
1552
  /** Explanation of LinkedIn engagement relevance (if applicable) */
@@ -1672,9 +1691,16 @@ interface DeepPeopleSearchOutput {
1672
1691
  searchStats?: DeepSearchStats;
1673
1692
  /** Criteria metadata */
1674
1693
  criteria?: CriteriaMetadata;
1694
+ /** Definitions used by the scoring pipeline. */
1695
+ criteriaDefinitions?: CriterionDefinition[];
1696
+ /** Distinct canonical values for each extraction column. */
1697
+ columnValues?: Record<string, string[]>;
1675
1698
  }
1676
1699
  interface StructuredResponse extends Record<string, any> {
1677
1700
  criteria?: CriteriaMetadata;
1701
+ criteriaDefinitions?: CriterionDefinition[];
1702
+ /** Distinct canonical values for each extraction column. */
1703
+ columnValues?: Record<string, string[]>;
1678
1704
  /** Deep people search output (when using deep_people_search agent) */
1679
1705
  preview?: DeepSearchPreview;
1680
1706
  candidates?: ValidatedCandidate[];
@@ -1936,6 +1962,16 @@ interface SpecializedAgentParams {
1936
1962
  * Used by deep_people_search.
1937
1963
  */
1938
1964
  postsExtractAuthor?: boolean;
1965
+ /**
1966
+ * Whether to extract reactors from topic-based post search results.
1967
+ * Omitted lets the post-search agent decide per committed post.
1968
+ */
1969
+ postsExtractReactors?: boolean;
1970
+ /**
1971
+ * Whether to extract commenters from topic-based post search results.
1972
+ * Omitted lets the post-search agent decide per committed post.
1973
+ */
1974
+ postsExtractCommenters?: boolean;
1939
1975
  /**
1940
1976
  * Direct LinkedIn post URLs to extract candidates from.
1941
1977
  * System will extract authors, reactors, and commenters with full profile data.
@@ -3279,11 +3315,29 @@ interface CrmExclusionGrantListResponse {
3279
3315
  memberUserId: string;
3280
3316
  ownerUserIds: string[];
3281
3317
  }
3318
+ /**
3319
+ * Contact attributes to send with a prospect sync.
3320
+ *
3321
+ * Every field is optional. The server fills omitted values from its campaign
3322
+ * and profile data when available. Supply either `fullName` or
3323
+ * `firstName` + `lastName`; `fullName` takes precedence when both are set.
3324
+ */
3325
+ interface CrmContactInput {
3326
+ fullName?: string;
3327
+ firstName?: string;
3328
+ lastName?: string;
3329
+ email?: string;
3330
+ jobTitle?: string;
3331
+ company?: string;
3332
+ /** Accepted by the API but not mapped to a CRM field in v1. */
3333
+ location?: string;
3334
+ }
3282
3335
  /**
3283
3336
  * Push one Lumnis prospect to the connected CRM.
3284
3337
  *
3285
- * Prefer a `campaign_prospects` row owned by `userId` when present; otherwise
3286
- * the server enriches from profile cache / Fiber and creates the CRM record.
3338
+ * Caller-supplied contact attributes take precedence. The server gap-fills
3339
+ * omitted values from campaign/profile data and creates the CRM record when
3340
+ * no existing contact matches.
3287
3341
  * Provider-id/URN LinkedIn URLs are resolved to vanity before reconcile.
3288
3342
  */
3289
3343
  interface CrmSyncProspectRequest {
@@ -3292,6 +3346,13 @@ interface CrmSyncProspectRequest {
3292
3346
  provider: CrmProvider;
3293
3347
  /** Must contain `linkedin.com/in/`. */
3294
3348
  linkedinUrl: string;
3349
+ /** Optional contact details; omitted fields are gap-filled server-side. */
3350
+ contact?: CrmContactInput;
3351
+ /**
3352
+ * Provider-native CRM property/attribute names mapped to string values.
3353
+ * These are applied on create and fill empty fields on an existing record.
3354
+ */
3355
+ customFields?: Record<string, string>;
3295
3356
  }
3296
3357
  interface CrmSyncProspectResponse {
3297
3358
  /**
@@ -3362,8 +3423,9 @@ declare class CrmResource {
3362
3423
  * `crmRecordId`. Stale links (record deleted in the CRM) are detected
3363
3424
  * and re-created automatically.
3364
3425
  *
3365
- * Works with or without a `campaign_prospects` row search-sourced
3366
- * prospects are enriched from profile cache when needed.
3426
+ * Pass `contact` to avoid re-deriving attributes the caller already has.
3427
+ * Any omitted contact fields are gap-filled from campaign/profile data when
3428
+ * available. `customFields` keys are provider-native property names.
3367
3429
  *
3368
3430
  * @example
3369
3431
  * ```typescript
@@ -3371,6 +3433,13 @@ declare class CrmResource {
3371
3433
  * userId: 'user@example.com',
3372
3434
  * provider: 'attio',
3373
3435
  * linkedinUrl: 'https://www.linkedin.com/in/jane-doe/',
3436
+ * contact: {
3437
+ * fullName: 'Jane Doe',
3438
+ * email: 'jane@example.com',
3439
+ * jobTitle: 'VP of Sales',
3440
+ * company: 'Acme',
3441
+ * },
3442
+ * customFields: { lead_source: 'Lumnis' },
3374
3443
  * })
3375
3444
  * console.log(result.action, result.crmUrl)
3376
3445
  * ```
@@ -6039,7 +6108,9 @@ declare class ResponsesResource {
6039
6108
  * @param options.runSingleCriterion - Run only a single criterion by ID
6040
6109
  * @param options.addCriterion - Add a new criterion to existing criteria
6041
6110
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
6042
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
6111
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
6112
+ * and optional suggestedColumnName. Deep search still requires an existing criteria set;
6113
+ * use peopleScoring to bootstrap a column on a plain candidate list.
6043
6114
  * Example string: 'Must have 5+ years Python experience'
6044
6115
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
6045
6116
  * @param options.excludeProfiles - LinkedIn URLs to exclude from results
@@ -6091,6 +6162,8 @@ declare class ResponsesResource {
6091
6162
  postsEnableFiltering?: boolean;
6092
6163
  engagementScoreWeight?: number;
6093
6164
  postsExtractAuthor?: boolean;
6165
+ postsExtractReactors?: boolean;
6166
+ postsExtractCommenters?: boolean;
6094
6167
  searchJobSignal?: boolean | 'auto';
6095
6168
  deepVerify?: 'off' | 'auto' | 'always';
6096
6169
  deepValidationUseRelevanceReranker?: boolean;
@@ -6108,7 +6181,8 @@ declare class ResponsesResource {
6108
6181
  * @param options.runSingleCriterion - Run only a single criterion by ID
6109
6182
  * @param options.addCriterion - Add a new criterion to existing criteria
6110
6183
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
6111
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
6184
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
6185
+ * and optional suggestedColumnName. No existing criteria are required.
6112
6186
  * Example string: 'Must have 5+ years Python experience'
6113
6187
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
6114
6188
  * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -7786,4 +7860,4 @@ declare class ProgressTracker {
7786
7860
  */
7787
7861
  declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
7788
7862
 
7789
- 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 CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, 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 PauseProspectsRequest, type PauseProspectsResponse, 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, type ResumeProspectsRequest, 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 };
7863
+ 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 ColumnKind, 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 CrmContactInput, type CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, 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 PauseProspectsRequest, type PauseProspectsResponse, 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, type ResumeProspectsRequest, 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 CHANGED
@@ -1342,6 +1342,7 @@ interface ModelOverrides {
1342
1342
  [key: string]: string;
1343
1343
  }
1344
1344
  type CriterionType = 'universal' | 'varying' | 'validation_only';
1345
+ type ColumnKind = 'extraction' | 'verdict';
1345
1346
  /** SLM relevance reranker tier (deep_people_search / people_scoring output). */
1346
1347
  type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
1347
1348
  interface CriterionDefinition {
@@ -1350,6 +1351,12 @@ interface CriterionDefinition {
1350
1351
  criterionText: string;
1351
1352
  criterionType: CriterionType;
1352
1353
  weight: number;
1354
+ /** Expected answer shape for an extraction column. */
1355
+ answerFormat?: string;
1356
+ /** Whether this criterion extracts a value or produces a score-bearing verdict. */
1357
+ columnKind?: ColumnKind;
1358
+ /** Extraction columns are excluded from fit-score calculations. */
1359
+ scoringRelevance?: 'none';
1353
1360
  /** Set by the web-need classifier when deep verification runs (response output). */
1354
1361
  requiresWebVerification?: boolean;
1355
1362
  /** Whose fact must be verified: person, organization, or location (response output). */
@@ -1374,6 +1381,12 @@ interface AddCriterionRequest {
1374
1381
  interface AddAndRunCriterionRequest {
1375
1382
  criterionText: string;
1376
1383
  suggestedColumnName?: string;
1384
+ /** Expected answer shape, such as "Exactly one of: A, B, C". */
1385
+ answerFormat?: string;
1386
+ /** Extraction columns are score-neutral; verdict columns contribute to fit. */
1387
+ columnKind?: ColumnKind;
1388
+ /** Verify the answer with web retrieval. Defaults to true. */
1389
+ webVerify?: boolean;
1377
1390
  }
1378
1391
  interface CriteriaMetadata {
1379
1392
  version: number;
@@ -1439,6 +1452,10 @@ interface CriterionResult {
1439
1452
  score: number;
1440
1453
  /** Confidence in the evaluation (0.0-1.0) */
1441
1454
  confidence: number;
1455
+ /** Canonical cell value for extraction columns; null when no reliable answer was found. */
1456
+ extractedValue?: string | null;
1457
+ /** Risk that the result is unsupported or hallucinated. */
1458
+ hallucinationRisk?: 'low' | 'medium' | 'high';
1442
1459
  /** User-facing explanation of what was checked and found (min 2 sentences) */
1443
1460
  reasoning: string;
1444
1461
  /** Concrete evidence with sources */
@@ -1526,8 +1543,10 @@ interface ValidatedCandidate {
1526
1543
  overallConfidence: number;
1527
1544
  /** User-facing summary (3-5 sentences with highlights) */
1528
1545
  summary: string;
1529
- /** Results for each evaluated criterion */
1530
- criterionResults: CriterionResult[];
1546
+ /** Legacy criterion-results field returned by some scoring paths. */
1547
+ criterionResults?: CriterionResult[];
1548
+ /** Criterion results emitted by deep_people_search and people_scoring. */
1549
+ deepCriteria?: CriterionResult[];
1531
1550
  /** Warnings about criteria that couldn't be fully verified */
1532
1551
  criteriaQualityWarnings?: string[];
1533
1552
  /** Explanation of LinkedIn engagement relevance (if applicable) */
@@ -1672,9 +1691,16 @@ interface DeepPeopleSearchOutput {
1672
1691
  searchStats?: DeepSearchStats;
1673
1692
  /** Criteria metadata */
1674
1693
  criteria?: CriteriaMetadata;
1694
+ /** Definitions used by the scoring pipeline. */
1695
+ criteriaDefinitions?: CriterionDefinition[];
1696
+ /** Distinct canonical values for each extraction column. */
1697
+ columnValues?: Record<string, string[]>;
1675
1698
  }
1676
1699
  interface StructuredResponse extends Record<string, any> {
1677
1700
  criteria?: CriteriaMetadata;
1701
+ criteriaDefinitions?: CriterionDefinition[];
1702
+ /** Distinct canonical values for each extraction column. */
1703
+ columnValues?: Record<string, string[]>;
1678
1704
  /** Deep people search output (when using deep_people_search agent) */
1679
1705
  preview?: DeepSearchPreview;
1680
1706
  candidates?: ValidatedCandidate[];
@@ -1936,6 +1962,16 @@ interface SpecializedAgentParams {
1936
1962
  * Used by deep_people_search.
1937
1963
  */
1938
1964
  postsExtractAuthor?: boolean;
1965
+ /**
1966
+ * Whether to extract reactors from topic-based post search results.
1967
+ * Omitted lets the post-search agent decide per committed post.
1968
+ */
1969
+ postsExtractReactors?: boolean;
1970
+ /**
1971
+ * Whether to extract commenters from topic-based post search results.
1972
+ * Omitted lets the post-search agent decide per committed post.
1973
+ */
1974
+ postsExtractCommenters?: boolean;
1939
1975
  /**
1940
1976
  * Direct LinkedIn post URLs to extract candidates from.
1941
1977
  * System will extract authors, reactors, and commenters with full profile data.
@@ -3279,11 +3315,29 @@ interface CrmExclusionGrantListResponse {
3279
3315
  memberUserId: string;
3280
3316
  ownerUserIds: string[];
3281
3317
  }
3318
+ /**
3319
+ * Contact attributes to send with a prospect sync.
3320
+ *
3321
+ * Every field is optional. The server fills omitted values from its campaign
3322
+ * and profile data when available. Supply either `fullName` or
3323
+ * `firstName` + `lastName`; `fullName` takes precedence when both are set.
3324
+ */
3325
+ interface CrmContactInput {
3326
+ fullName?: string;
3327
+ firstName?: string;
3328
+ lastName?: string;
3329
+ email?: string;
3330
+ jobTitle?: string;
3331
+ company?: string;
3332
+ /** Accepted by the API but not mapped to a CRM field in v1. */
3333
+ location?: string;
3334
+ }
3282
3335
  /**
3283
3336
  * Push one Lumnis prospect to the connected CRM.
3284
3337
  *
3285
- * Prefer a `campaign_prospects` row owned by `userId` when present; otherwise
3286
- * the server enriches from profile cache / Fiber and creates the CRM record.
3338
+ * Caller-supplied contact attributes take precedence. The server gap-fills
3339
+ * omitted values from campaign/profile data and creates the CRM record when
3340
+ * no existing contact matches.
3287
3341
  * Provider-id/URN LinkedIn URLs are resolved to vanity before reconcile.
3288
3342
  */
3289
3343
  interface CrmSyncProspectRequest {
@@ -3292,6 +3346,13 @@ interface CrmSyncProspectRequest {
3292
3346
  provider: CrmProvider;
3293
3347
  /** Must contain `linkedin.com/in/`. */
3294
3348
  linkedinUrl: string;
3349
+ /** Optional contact details; omitted fields are gap-filled server-side. */
3350
+ contact?: CrmContactInput;
3351
+ /**
3352
+ * Provider-native CRM property/attribute names mapped to string values.
3353
+ * These are applied on create and fill empty fields on an existing record.
3354
+ */
3355
+ customFields?: Record<string, string>;
3295
3356
  }
3296
3357
  interface CrmSyncProspectResponse {
3297
3358
  /**
@@ -3362,8 +3423,9 @@ declare class CrmResource {
3362
3423
  * `crmRecordId`. Stale links (record deleted in the CRM) are detected
3363
3424
  * and re-created automatically.
3364
3425
  *
3365
- * Works with or without a `campaign_prospects` row search-sourced
3366
- * prospects are enriched from profile cache when needed.
3426
+ * Pass `contact` to avoid re-deriving attributes the caller already has.
3427
+ * Any omitted contact fields are gap-filled from campaign/profile data when
3428
+ * available. `customFields` keys are provider-native property names.
3367
3429
  *
3368
3430
  * @example
3369
3431
  * ```typescript
@@ -3371,6 +3433,13 @@ declare class CrmResource {
3371
3433
  * userId: 'user@example.com',
3372
3434
  * provider: 'attio',
3373
3435
  * linkedinUrl: 'https://www.linkedin.com/in/jane-doe/',
3436
+ * contact: {
3437
+ * fullName: 'Jane Doe',
3438
+ * email: 'jane@example.com',
3439
+ * jobTitle: 'VP of Sales',
3440
+ * company: 'Acme',
3441
+ * },
3442
+ * customFields: { lead_source: 'Lumnis' },
3374
3443
  * })
3375
3444
  * console.log(result.action, result.crmUrl)
3376
3445
  * ```
@@ -6039,7 +6108,9 @@ declare class ResponsesResource {
6039
6108
  * @param options.runSingleCriterion - Run only a single criterion by ID
6040
6109
  * @param options.addCriterion - Add a new criterion to existing criteria
6041
6110
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
6042
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
6111
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
6112
+ * and optional suggestedColumnName. Deep search still requires an existing criteria set;
6113
+ * use peopleScoring to bootstrap a column on a plain candidate list.
6043
6114
  * Example string: 'Must have 5+ years Python experience'
6044
6115
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
6045
6116
  * @param options.excludeProfiles - LinkedIn URLs to exclude from results
@@ -6091,6 +6162,8 @@ declare class ResponsesResource {
6091
6162
  postsEnableFiltering?: boolean;
6092
6163
  engagementScoreWeight?: number;
6093
6164
  postsExtractAuthor?: boolean;
6165
+ postsExtractReactors?: boolean;
6166
+ postsExtractCommenters?: boolean;
6094
6167
  searchJobSignal?: boolean | 'auto';
6095
6168
  deepVerify?: 'off' | 'auto' | 'always';
6096
6169
  deepValidationUseRelevanceReranker?: boolean;
@@ -6108,7 +6181,8 @@ declare class ResponsesResource {
6108
6181
  * @param options.runSingleCriterion - Run only a single criterion by ID
6109
6182
  * @param options.addCriterion - Add a new criterion to existing criteria
6110
6183
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
6111
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
6184
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
6185
+ * and optional suggestedColumnName. No existing criteria are required.
6112
6186
  * Example string: 'Must have 5+ years Python experience'
6113
6187
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
6114
6188
  * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -7786,4 +7860,4 @@ declare class ProgressTracker {
7786
7860
  */
7787
7861
  declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
7788
7862
 
7789
- 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 CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, 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 PauseProspectsRequest, type PauseProspectsResponse, 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, type ResumeProspectsRequest, 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 };
7863
+ 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 ColumnKind, 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 CrmContactInput, type CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, 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 PauseProspectsRequest, type PauseProspectsResponse, 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, type ResumeProspectsRequest, 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 CHANGED
@@ -963,8 +963,9 @@ class CrmResource {
963
963
  * `crmRecordId`. Stale links (record deleted in the CRM) are detected
964
964
  * and re-created automatically.
965
965
  *
966
- * Works with or without a `campaign_prospects` row search-sourced
967
- * prospects are enriched from profile cache when needed.
966
+ * Pass `contact` to avoid re-deriving attributes the caller already has.
967
+ * Any omitted contact fields are gap-filled from campaign/profile data when
968
+ * available. `customFields` keys are provider-native property names.
968
969
  *
969
970
  * @example
970
971
  * ```typescript
@@ -972,6 +973,13 @@ class CrmResource {
972
973
  * userId: 'user@example.com',
973
974
  * provider: 'attio',
974
975
  * linkedinUrl: 'https://www.linkedin.com/in/jane-doe/',
976
+ * contact: {
977
+ * fullName: 'Jane Doe',
978
+ * email: 'jane@example.com',
979
+ * jobTitle: 'VP of Sales',
980
+ * company: 'Acme',
981
+ * },
982
+ * customFields: { lead_source: 'Lumnis' },
975
983
  * })
976
984
  * console.log(result.action, result.crmUrl)
977
985
  * ```
@@ -1878,7 +1886,8 @@ function convertCase(obj, converter) {
1878
1886
  return obj.map((v) => convertCase(v, converter));
1879
1887
  } else if (obj !== null && typeof obj === "object") {
1880
1888
  return Object.keys(obj).reduce((acc, key) => {
1881
- acc[converter(key)] = convertCase(obj[key], converter);
1889
+ const value = key === "customFields" || key === "custom_fields" ? obj[key] : convertCase(obj[key], converter);
1890
+ acc[converter(key)] = value;
1882
1891
  return acc;
1883
1892
  }, {});
1884
1893
  }
@@ -3411,8 +3420,8 @@ class ResponsesResource {
3411
3420
  throw new ValidationError("add_criterion requires criterion_text");
3412
3421
  }
3413
3422
  if (addAndRunCriterion !== void 0) {
3414
- if (!reuseCriteriaFrom && !hasCriteria)
3415
- throw new ValidationError("add_and_run_criterion requires existing criteria (reuse or direct criteria).");
3423
+ if (!reuseCriteriaFrom && !hasCriteria && specializedAgent !== "people_scoring")
3424
+ throw new ValidationError("add_and_run_criterion requires existing criteria outside people_scoring.");
3416
3425
  if (typeof addAndRunCriterion === "string") {
3417
3426
  if (!addAndRunCriterion.trim())
3418
3427
  throw new ValidationError("add_and_run_criterion must be a non-empty string");
@@ -3423,10 +3432,19 @@ class ResponsesResource {
3423
3432
  "suggestedColumnName",
3424
3433
  "suggested_column_name"
3425
3434
  );
3426
- if (!criterionText || typeof criterionText !== "string")
3435
+ const answerFormat = this._getParamValue(addAndRunCriterion, "answerFormat", "answer_format");
3436
+ const columnKind = this._getParamValue(addAndRunCriterion, "columnKind", "column_kind");
3437
+ const webVerify = this._getParamValue(addAndRunCriterion, "webVerify", "web_verify");
3438
+ if (!criterionText || typeof criterionText !== "string" || !criterionText.trim())
3427
3439
  throw new ValidationError("add_and_run_criterion object requires criterion_text");
3428
3440
  if (suggestedColumnName !== void 0 && typeof suggestedColumnName !== "string")
3429
3441
  throw new ValidationError("add_and_run_criterion suggested_column_name must be a string if provided");
3442
+ if (answerFormat !== void 0 && typeof answerFormat !== "string")
3443
+ throw new ValidationError("add_and_run_criterion answer_format must be a string if provided");
3444
+ if (columnKind !== void 0 && columnKind !== "extraction" && columnKind !== "verdict")
3445
+ throw new ValidationError("add_and_run_criterion column_kind must be extraction or verdict");
3446
+ if (webVerify !== void 0 && typeof webVerify !== "boolean")
3447
+ throw new ValidationError("add_and_run_criterion web_verify must be a boolean if provided");
3430
3448
  } else {
3431
3449
  throw new ValidationError("add_and_run_criterion must be a string or an object");
3432
3450
  }
@@ -3618,7 +3636,9 @@ class ResponsesResource {
3618
3636
  * @param options.runSingleCriterion - Run only a single criterion by ID
3619
3637
  * @param options.addCriterion - Add a new criterion to existing criteria
3620
3638
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
3621
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
3639
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
3640
+ * and optional suggestedColumnName. Deep search still requires an existing criteria set;
3641
+ * use peopleScoring to bootstrap a column on a plain candidate list.
3622
3642
  * Example string: 'Must have 5+ years Python experience'
3623
3643
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
3624
3644
  * @param options.excludeProfiles - LinkedIn URLs to exclude from results
@@ -3701,6 +3721,10 @@ class ResponsesResource {
3701
3721
  params.engagementScoreWeight = options.engagementScoreWeight;
3702
3722
  if (options.postsExtractAuthor !== void 0)
3703
3723
  params.postsExtractAuthor = options.postsExtractAuthor;
3724
+ if (options.postsExtractReactors !== void 0)
3725
+ params.postsExtractReactors = options.postsExtractReactors;
3726
+ if (options.postsExtractCommenters !== void 0)
3727
+ params.postsExtractCommenters = options.postsExtractCommenters;
3704
3728
  if (options.searchJobSignal !== void 0)
3705
3729
  params.searchJobSignal = options.searchJobSignal;
3706
3730
  if (options.deepVerify !== void 0)
@@ -3722,7 +3746,8 @@ class ResponsesResource {
3722
3746
  * @param options.runSingleCriterion - Run only a single criterion by ID
3723
3747
  * @param options.addCriterion - Add a new criterion to existing criteria
3724
3748
  * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
3725
- * Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
3749
+ * Can be a string or an object with criterionText, columnKind, answerFormat, webVerify,
3750
+ * and optional suggestedColumnName. No existing criteria are required.
3726
3751
  * Example string: 'Must have 5+ years Python experience'
3727
3752
  * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
3728
3753
  * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -4705,7 +4730,8 @@ class Http {
4705
4730
  detail = JSON.parse(detail.raw);
4706
4731
  } catch {
4707
4732
  }
4708
- const errorMsg = detail?.error?.message || `Server error: ${response.status}`;
4733
+ const responseDetail = detail?.detail;
4734
+ const errorMsg = detail?.error?.message || detail?.message || (typeof responseDetail === "string" ? responseDetail : void 0) || (responseDetail !== void 0 ? JSON.stringify(responseDetail) : void 0) || `Server error: ${response.status}`;
4709
4735
  switch (response.status) {
4710
4736
  case 401:
4711
4737
  throw new AuthenticationError("Invalid or missing API key", { requestId, statusCode: 401, details: detail });
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "lumnisai",
3
3
  "type": "module",
4
- "version": "0.5.29",
4
+ "version": "0.5.31",
5
5
  "description": "Official Node.js SDK for the Lumnis AI API",
6
6
  "author": "Lumnis AI",
7
7
  "license": "MIT",