lumnisai 0.1.25 → 0.1.27

package/dist/index.cjs

@@ -1966,6 +1966,167 @@ class ResponsesResource {
   constructor(http) {
     this.http = http;
   }
+  _getParamValue(obj, camel, snake) {
+    if (!obj)
+      return void 0;
+    if (Object.prototype.hasOwnProperty.call(obj, camel))
+      return obj[camel];
+    if (Object.prototype.hasOwnProperty.call(obj, snake))
+      return obj[snake];
+    return void 0;
+  }
+  _isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+  }
+  _validateCriteriaDefinitions(criteriaDefinitions) {
+    if (!Array.isArray(criteriaDefinitions))
+      throw new ValidationError("criteria_definitions must be a list");
+    if (criteriaDefinitions.length === 0)
+      throw new ValidationError("criteria_definitions cannot be empty");
+    const criterionIds = /* @__PURE__ */ new Set();
+    const columnNames = /* @__PURE__ */ new Set();
+    const validTypes = ["universal", "varying", "validation_only"];
+    criteriaDefinitions.forEach((criterion, index) => {
+      if (!this._isPlainObject(criterion))
+        throw new ValidationError(`Criterion ${index} must be an object`);
+      const criterionId = this._getParamValue(criterion, "criterionId", "criterion_id");
+      const columnName = this._getParamValue(criterion, "columnName", "column_name");
+      const criterionText = this._getParamValue(criterion, "criterionText", "criterion_text");
+      const criterionType = this._getParamValue(criterion, "criterionType", "criterion_type");
+      const weightRaw = this._getParamValue(criterion, "weight", "weight");
+      if (!criterionId || typeof criterionId !== "string")
+        throw new ValidationError(`Criterion ${index} criterion_id must be a non-empty string`);
+      if (criterionIds.has(criterionId))
+        throw new ValidationError(`Duplicate criterion_id: ${criterionId}`);
+      criterionIds.add(criterionId);
+      if (!columnName || typeof columnName !== "string")
+        throw new ValidationError(`Criterion ${index} column_name must be a non-empty string`);
+      if (columnNames.has(columnName))
+        throw new ValidationError(`Duplicate column_name: ${columnName}`);
+      columnNames.add(columnName);
+      if (!criterionText || typeof criterionText !== "string")
+        throw new ValidationError(`Criterion ${index} criterion_text must be a non-empty string`);
+      if (!criterionType || !validTypes.includes(criterionType))
+        throw new ValidationError(`Criterion ${index} has invalid criterion_type: ${String(criterionType)}`);
+      const weight = Number(weightRaw);
+      if (!Number.isFinite(weight))
+        throw new ValidationError(`Criterion ${index} weight must be a number`);
+      if (weight <= 0)
+        throw new ValidationError(`Criterion ${index} weight must be positive`);
+    });
+  }
+  _validateCriteriaClassification(criteriaClassification) {
+    if (!this._isPlainObject(criteriaClassification))
+      throw new ValidationError("criteria_classification must be an object");
+    const universalCriteria = this._getParamValue(criteriaClassification, "universalCriteria", "universal_criteria");
+    const varyingCriteria = this._getParamValue(criteriaClassification, "varyingCriteria", "varying_criteria");
+    const validationOnlyCriteria = this._getParamValue(criteriaClassification, "validationOnlyCriteria", "validation_only_criteria");
+    if (!Array.isArray(universalCriteria))
+      throw new ValidationError("criteria_classification missing or invalid universal_criteria");
+    if (!Array.isArray(varyingCriteria))
+      throw new ValidationError("criteria_classification missing or invalid varying_criteria");
+    if (!Array.isArray(validationOnlyCriteria))
+      throw new ValidationError("criteria_classification missing or invalid validation_only_criteria");
+  }
+  _validateCriteriaParams(params, specializedAgent) {
+    if (!params)
+      return;
+    const rawParams = params;
+    const reuseCriteriaFrom = this._getParamValue(rawParams, "reuseCriteriaFrom", "reuse_criteria_from");
+    const criteriaDefinitions = this._getParamValue(
+      rawParams,
+      "criteriaDefinitions",
+      "criteria_definitions"
+    );
+    const criteriaClassification = this._getParamValue(
+      rawParams,
+      "criteriaClassification",
+      "criteria_classification"
+    );
+    const runSingleCriterion = this._getParamValue(rawParams, "runSingleCriterion", "run_single_criterion");
+    const addCriterion = this._getParamValue(rawParams, "addCriterion", "add_criterion");
+    const addAndRunCriterion = this._getParamValue(
+      rawParams,
+      "addAndRunCriterion",
+      "add_and_run_criterion"
+    );
+    const candidateProfiles = this._getParamValue(
+      rawParams,
+      "candidateProfiles",
+      "candidate_profiles"
+    );
+    const hasCriteria = !!criteriaDefinitions && !!criteriaClassification;
+    if (criteriaDefinitions && !criteriaClassification || !criteriaDefinitions && criteriaClassification) {
+      throw new ValidationError(
+        "When providing criteria directly, both criteria_definitions and criteria_classification must be provided."
+      );
+    }
+    if (criteriaDefinitions || criteriaClassification) {
+      this._validateCriteriaDefinitions(criteriaDefinitions);
+      this._validateCriteriaClassification(criteriaClassification);
+    }
+    if (runSingleCriterion) {
+      if (!reuseCriteriaFrom && !hasCriteria) {
+        throw new ValidationError(
+          "run_single_criterion requires reuse_criteria_from or explicit criteria_definitions/criteria_classification."
+        );
+      }
+      if (typeof runSingleCriterion !== "string" || !runSingleCriterion.trim()) {
+        throw new ValidationError("run_single_criterion must be a non-empty string");
+      }
+    }
+    if (addCriterion) {
+      if (!reuseCriteriaFrom && !hasCriteria)
+        throw new ValidationError("add_criterion requires existing criteria (reuse or direct criteria).");
+      if (!this._isPlainObject(addCriterion))
+        throw new ValidationError("add_criterion must be an object");
+      const columnName = this._getParamValue(addCriterion, "columnName", "column_name");
+      const criterionText = this._getParamValue(addCriterion, "criterionText", "criterion_text");
+      if (!columnName || typeof columnName !== "string")
+        throw new ValidationError("add_criterion requires column_name");
+      if (!criterionText || typeof criterionText !== "string")
+        throw new ValidationError("add_criterion requires criterion_text");
+    }
+    if (addAndRunCriterion !== void 0) {
+      if (!reuseCriteriaFrom && !hasCriteria)
+        throw new ValidationError("add_and_run_criterion requires existing criteria (reuse or direct criteria).");
+      if (typeof addAndRunCriterion === "string") {
+        if (!addAndRunCriterion.trim())
+          throw new ValidationError("add_and_run_criterion must be a non-empty string");
+      } else if (this._isPlainObject(addAndRunCriterion)) {
+        const criterionText = this._getParamValue(addAndRunCriterion, "criterionText", "criterion_text");
+        const suggestedColumnName = this._getParamValue(
+          addAndRunCriterion,
+          "suggestedColumnName",
+          "suggested_column_name"
+        );
+        if (!criterionText || typeof criterionText !== "string")
+          throw new ValidationError("add_and_run_criterion object requires criterion_text");
+        if (suggestedColumnName !== void 0 && typeof suggestedColumnName !== "string")
+          throw new ValidationError("add_and_run_criterion suggested_column_name must be a string if provided");
+      } else {
+        throw new ValidationError("add_and_run_criterion must be a string or an object");
+      }
+    }
+    if (specializedAgent === "people_scoring") {
+      if (!candidateProfiles || !Array.isArray(candidateProfiles) || candidateProfiles.length === 0)
+        throw new ValidationError("candidate_profiles is required for people_scoring agent and must be a non-empty list");
+      const missingIds = [];
+      candidateProfiles.forEach((candidate, index) => {
+        const c = candidate || {};
+        const linkedinUrl = c.linkedin_url || c.linkedinUrl;
+        const email = c.email;
+        const emails = c.emails;
+        if (!linkedinUrl && !email && (!emails || !Array.isArray(emails) || emails.length === 0))
+          missingIds.push({ index, name: c.name });
+      });
+      if (missingIds.length > 0) {
+        throw new ValidationError(
+          `Each candidate in candidate_profiles must include at least one identifier: linkedin_url or email. Missing identifiers for ${missingIds.length} candidates: ${JSON.stringify(missingIds)}`
+        );
+      }
+    }
+  }
   _validateFileReference(uri) {
     if (uri.startsWith("artifact_"))
       return;
@@ -2006,6 +2167,8 @@ class ResponsesResource {
       for (const file of request.files)
         this._validateFileReference(file.uri);
     }
+    if (request.specializedAgentParams)
+      this._validateCriteriaParams(request.specializedAgentParams, request.specializedAgent);
     return this.http.post("/responses", request);
   }
   /**
@@ -2104,6 +2267,105 @@ class ResponsesResource {
     }
     return this.create(request);
   }
+  /**
+   * Perform a deep people search with AI-generated criteria and validation
+   * @param query - Natural language search query describing ideal candidates
+   * @param options - Optional search parameters
+   * @param options.requestedCandidates - Number of candidates to find (default: 100)
+   * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+   * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+   * @param options.criteriaDefinitions - Pre-defined criteria definitions
+   * @param options.criteriaClassification - Pre-defined criteria classification
+   * @param options.runSingleCriterion - Run only a single criterion by ID
+   * @param options.addCriterion - Add a new criterion to existing criteria
+   * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+   *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+   *   Example string: 'Must have 5+ years Python experience'
+   *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+   * @param options.excludeProfiles - LinkedIn URLs to exclude from results
+   * @param options.excludePreviouslyContacted - Exclude previously contacted people
+   * @param options.excludeNames - Names to exclude from results
+   * @returns Response with structured_response containing:
+   *   - candidates: Validated and scored candidates
+   *   - criteria: Generated/reused criteria definitions and classification
+   *   - searchStats: Search execution statistics
+   */
+  async deepPeopleSearch(query, options) {
+    const request = {
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "deep_people_search"
+    };
+    if (options) {
+      const params = {};
+      if (options.requestedCandidates !== void 0)
+        params.requestedCandidates = options.requestedCandidates;
+      if (options.dataSources)
+        params.dataSources = options.dataSources;
+      if (options.reuseCriteriaFrom)
+        params.reuseCriteriaFrom = options.reuseCriteriaFrom;
+      if (options.criteriaDefinitions)
+        params.criteriaDefinitions = options.criteriaDefinitions;
+      if (options.criteriaClassification)
+        params.criteriaClassification = options.criteriaClassification;
+      if (options.runSingleCriterion)
+        params.runSingleCriterion = options.runSingleCriterion;
+      if (options.addCriterion)
+        params.addCriterion = options.addCriterion;
+      if (options.addAndRunCriterion)
+        params.addAndRunCriterion = options.addAndRunCriterion;
+      if (options.excludeProfiles)
+        params.excludeProfiles = options.excludeProfiles;
+      if (options.excludePreviouslyContacted !== void 0)
+        params.excludePreviouslyContacted = options.excludePreviouslyContacted;
+      if (options.excludeNames)
+        params.excludeNames = options.excludeNames;
+      if (Object.keys(params).length > 0)
+        request.specializedAgentParams = params;
+    }
+    return this.create(request);
+  }
+  /**
+   * Score provided candidates against AI-generated or provided criteria
+   * @param query - Natural language description of ideal candidate criteria
+   * @param candidateProfiles - List of candidates to score (each must have linkedin_url or email)
+   * @param options - Optional scoring parameters
+   * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+   * @param options.criteriaDefinitions - Pre-defined criteria definitions
+   * @param options.criteriaClassification - Pre-defined criteria classification
+   * @param options.runSingleCriterion - Run only a single criterion by ID
+   * @param options.addCriterion - Add a new criterion to existing criteria
+   * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+   *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+   *   Example string: 'Must have 5+ years Python experience'
+   *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+   * @returns Response with structured_response containing:
+   *   - candidates: Scored candidates with validation results
+   *   - criteria: Generated/reused criteria definitions and classification
+   */
+  async peopleScoring(query, candidateProfiles, options) {
+    const request = {
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "people_scoring",
+      specializedAgentParams: {
+        candidateProfiles
+      }
+    };
+    if (options) {
+      if (options.reuseCriteriaFrom)
+        request.specializedAgentParams.reuseCriteriaFrom = options.reuseCriteriaFrom;
+      if (options.criteriaDefinitions)
+        request.specializedAgentParams.criteriaDefinitions = options.criteriaDefinitions;
+      if (options.criteriaClassification)
+        request.specializedAgentParams.criteriaClassification = options.criteriaClassification;
+      if (options.runSingleCriterion)
+        request.specializedAgentParams.runSingleCriterion = options.runSingleCriterion;
+      if (options.addCriterion)
+        request.specializedAgentParams.addCriterion = options.addCriterion;
+      if (options.addAndRunCriterion)
+        request.specializedAgentParams.addAndRunCriterion = options.addAndRunCriterion;
+    }
+    return this.create(request);
+  }
 }
 
 class SkillsResource {

package/dist/index.d.cts

@@ -638,11 +638,48 @@ interface AgentConfig {
 interface ModelOverrides {
     [key: string]: string;
 }
+type CriterionType = 'universal' | 'varying' | 'validation_only';
+interface CriterionDefinition {
+    criterionId: string;
+    columnName: string;
+    criterionText: string;
+    criterionType: CriterionType;
+    weight: number;
+}
+interface CriteriaClassification {
+    universalCriteria: CriterionDefinition[];
+    varyingCriteria: CriterionDefinition[];
+    validationOnlyCriteria: CriterionDefinition[];
+    universalReasoning?: string;
+    varyingReasoning?: string;
+    validationReasoning?: string;
+}
+interface AddCriterionRequest {
+    columnName: string;
+    criterionText: string;
+    criterionType?: CriterionType;
+    weight?: number;
+}
+interface AddAndRunCriterionRequest {
+    criterionText: string;
+    suggestedColumnName?: string;
+}
+interface CriteriaMetadata {
+    version: number;
+    createdAt: string;
+    source: 'generated' | 'reused' | 'provided';
+    sourceResponseId?: string;
+    criteriaDefinitions: CriterionDefinition[];
+    criteriaClassification: CriteriaClassification;
+}
+interface StructuredResponse extends Record<string, any> {
+    criteria?: CriteriaMetadata;
+}
 /**
  * Available specialized agents
  * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | (string & {});
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | (string & {});
 /**
  * Parameters for specialized agent execution
  * This is a flexible interface that supports any agent-specific parameters
@@ -677,6 +714,39 @@ interface SpecializedAgentParams {
      * Names to exclude from results (passed through to CrustData post-processing when supported).
      */
     excludeNames?: string[];
+    /**
+     * Response ID to reuse criteria from.
+     */
+    reuseCriteriaFrom?: string;
+    /**
+     * Pre-defined criteria definitions to use.
+     */
+    criteriaDefinitions?: CriterionDefinition[];
+    /**
+     * Pre-defined criteria classification to use.
+     */
+    criteriaClassification?: CriteriaClassification;
+    /**
+     * Run validation against a single criterion ID.
+     */
+    runSingleCriterion?: string;
+    /**
+     * Add a new criterion to existing criteria.
+     */
+    addCriterion?: AddCriterionRequest;
+    /**
+     * Add a new criterion from English text and run only that criterion.
+     * Can be a string (criterion text) or an object with criterion_text and optional suggested_column_name.
+     * Example string: 'Must have 5+ years Python experience'
+     * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * If suggestedColumnName not provided, it will be auto-generated from the text.
+     */
+    addAndRunCriterion?: string | AddAndRunCriterionRequest;
+    /**
+     * List of candidate profiles to score (for people_scoring agent).
+     * Each candidate must include at least one identifier: linkedin_url or email/emails.
+     */
+    candidateProfiles?: Array<Record<string, any>>;
     /**
      * Additional parameters for any specialized agent
      * This allows flexibility for future agents without SDK updates
@@ -695,7 +765,7 @@ interface CreateResponseRequest {
     modelOverrides?: ModelOverrides;
     /**
      * Route to a specialized agent instead of the main Lumnis agent
-     * Known agents: 'quick_people_search', 'deep_people_search'
+     * Known agents: 'quick_people_search', 'deep_people_search', 'people_scoring'
      * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
@@ -728,7 +798,7 @@ interface ResponseObject {
     outputText?: string | null;
     content?: string | null;
     responseTitle?: string | null;
-    structuredResponse?: Record<string, any> | null;
+    structuredResponse?: StructuredResponse | null;
     artifacts?: ResponseArtifact[] | null;
     createdAt: string;
     completedAt?: string | null;
@@ -2806,6 +2876,11 @@ declare class PeopleResource {
 declare class ResponsesResource {
     private readonly http;
     constructor(http: Http);
+    private _getParamValue;
+    private _isPlainObject;
+    private _validateCriteriaDefinitions;
+    private _validateCriteriaClassification;
+    private _validateCriteriaParams;
     private _validateFileReference;
     /**
      * Create a new response request for asynchronous processing
@@ -2878,6 +2953,78 @@ declare class ResponsesResource {
         limit?: number;
         dataSources?: string[];
     }): Promise<CreateResponseResponse>;
+    /**
+     * Perform a deep people search with AI-generated criteria and validation
+     * @param query - Natural language search query describing ideal candidates
+     * @param options - Optional search parameters
+     * @param options.requestedCandidates - Number of candidates to find (default: 100)
+     * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+     * @param options.criteriaDefinitions - Pre-defined criteria definitions
+     * @param options.criteriaClassification - Pre-defined criteria classification
+     * @param options.runSingleCriterion - Run only a single criterion by ID
+     * @param options.addCriterion - Add a new criterion to existing criteria
+     * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+     *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+     *   Example string: 'Must have 5+ years Python experience'
+     *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @param options.excludeProfiles - LinkedIn URLs to exclude from results
+     * @param options.excludePreviouslyContacted - Exclude previously contacted people
+     * @param options.excludeNames - Names to exclude from results
+     * @returns Response with structured_response containing:
+     *   - candidates: Validated and scored candidates
+     *   - criteria: Generated/reused criteria definitions and classification
+     *   - searchStats: Search execution statistics
+     */
+    deepPeopleSearch(query: string, options?: {
+        requestedCandidates?: number;
+        dataSources?: string[];
+        reuseCriteriaFrom?: string;
+        criteriaDefinitions?: CriterionDefinition[];
+        criteriaClassification?: CriteriaClassification;
+        runSingleCriterion?: string;
+        addCriterion?: {
+            columnName: string;
+            criterionText: string;
+            criterionType?: CriterionType;
+            weight?: number;
+        };
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
+        excludeProfiles?: string[];
+        excludePreviouslyContacted?: boolean;
+        excludeNames?: string[];
+    }): Promise<CreateResponseResponse>;
+    /**
+     * Score provided candidates against AI-generated or provided criteria
+     * @param query - Natural language description of ideal candidate criteria
+     * @param candidateProfiles - List of candidates to score (each must have linkedin_url or email)
+     * @param options - Optional scoring parameters
+     * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+     * @param options.criteriaDefinitions - Pre-defined criteria definitions
+     * @param options.criteriaClassification - Pre-defined criteria classification
+     * @param options.runSingleCriterion - Run only a single criterion by ID
+     * @param options.addCriterion - Add a new criterion to existing criteria
+     * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+     *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+     *   Example string: 'Must have 5+ years Python experience'
+     *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @returns Response with structured_response containing:
+     *   - candidates: Scored candidates with validation results
+     *   - criteria: Generated/reused criteria definitions and classification
+     */
+    peopleScoring(query: string, candidateProfiles: Array<Record<string, any>>, options?: {
+        reuseCriteriaFrom?: string;
+        criteriaDefinitions?: CriterionDefinition[];
+        criteriaClassification?: CriteriaClassification;
+        runSingleCriterion?: string;
+        addCriterion?: {
+            columnName: string;
+            criterionText: string;
+            criterionType?: CriterionType;
+            weight?: number;
+        };
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
+    }): Promise<CreateResponseResponse>;
 }
 
 declare class SkillsResource {
@@ -3331,4 +3478,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, 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, BatchJobStatus, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelDraftResponse, type CancelResponseResponse, type ChannelContactHistory, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type DatabaseStatus, type DeleteApiKeyResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type Email, type EmailThreadSummary, type ErrorResponse, 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 GetConnectionStatusParams, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, InternalServerError, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type ListProvidersResponse, 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 Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, type PaginationInfo, type PaginationParams, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, 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, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type StoreApiKeyRequest, type SyncJobResponse, SyncJobStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, hasOpenProfileMessages, verifyWebhookSignature };
+export { ACTION_DELAYS, type AddAndRunCriterionRequest, type AddCriterionRequest, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, 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, BatchJobStatus, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelDraftResponse, type CancelResponseResponse, type ChannelContactHistory, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, 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 CriterionType, type DatabaseStatus, type DeleteApiKeyResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type Email, type EmailThreadSummary, type ErrorResponse, 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 GetConnectionStatusParams, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, InternalServerError, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type ListProvidersResponse, 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 Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, type PaginationInfo, type PaginationParams, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, 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, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, hasOpenProfileMessages, verifyWebhookSignature };

package/dist/index.d.mts

@@ -638,11 +638,48 @@ interface AgentConfig {
 interface ModelOverrides {
     [key: string]: string;
 }
+type CriterionType = 'universal' | 'varying' | 'validation_only';
+interface CriterionDefinition {
+    criterionId: string;
+    columnName: string;
+    criterionText: string;
+    criterionType: CriterionType;
+    weight: number;
+}
+interface CriteriaClassification {
+    universalCriteria: CriterionDefinition[];
+    varyingCriteria: CriterionDefinition[];
+    validationOnlyCriteria: CriterionDefinition[];
+    universalReasoning?: string;
+    varyingReasoning?: string;
+    validationReasoning?: string;
+}
+interface AddCriterionRequest {
+    columnName: string;
+    criterionText: string;
+    criterionType?: CriterionType;
+    weight?: number;
+}
+interface AddAndRunCriterionRequest {
+    criterionText: string;
+    suggestedColumnName?: string;
+}
+interface CriteriaMetadata {
+    version: number;
+    createdAt: string;
+    source: 'generated' | 'reused' | 'provided';
+    sourceResponseId?: string;
+    criteriaDefinitions: CriterionDefinition[];
+    criteriaClassification: CriteriaClassification;
+}
+interface StructuredResponse extends Record<string, any> {
+    criteria?: CriteriaMetadata;
+}
 /**
  * Available specialized agents
  * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | (string & {});
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | (string & {});
 /**
  * Parameters for specialized agent execution
  * This is a flexible interface that supports any agent-specific parameters
@@ -677,6 +714,39 @@ interface SpecializedAgentParams {
      * Names to exclude from results (passed through to CrustData post-processing when supported).
      */
     excludeNames?: string[];
+    /**
+     * Response ID to reuse criteria from.
+     */
+    reuseCriteriaFrom?: string;
+    /**
+     * Pre-defined criteria definitions to use.
+     */
+    criteriaDefinitions?: CriterionDefinition[];
+    /**
+     * Pre-defined criteria classification to use.
+     */
+    criteriaClassification?: CriteriaClassification;
+    /**
+     * Run validation against a single criterion ID.
+     */
+    runSingleCriterion?: string;
+    /**
+     * Add a new criterion to existing criteria.
+     */
+    addCriterion?: AddCriterionRequest;
+    /**
+     * Add a new criterion from English text and run only that criterion.
+     * Can be a string (criterion text) or an object with criterion_text and optional suggested_column_name.
+     * Example string: 'Must have 5+ years Python experience'
+     * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * If suggestedColumnName not provided, it will be auto-generated from the text.
+     */
+    addAndRunCriterion?: string | AddAndRunCriterionRequest;
+    /**
+     * List of candidate profiles to score (for people_scoring agent).
+     * Each candidate must include at least one identifier: linkedin_url or email/emails.
+     */
+    candidateProfiles?: Array<Record<string, any>>;
     /**
      * Additional parameters for any specialized agent
      * This allows flexibility for future agents without SDK updates
@@ -695,7 +765,7 @@ interface CreateResponseRequest {
     modelOverrides?: ModelOverrides;
     /**
      * Route to a specialized agent instead of the main Lumnis agent
-     * Known agents: 'quick_people_search', 'deep_people_search'
+     * Known agents: 'quick_people_search', 'deep_people_search', 'people_scoring'
      * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
@@ -728,7 +798,7 @@ interface ResponseObject {
     outputText?: string | null;
     content?: string | null;
     responseTitle?: string | null;
-    structuredResponse?: Record<string, any> | null;
+    structuredResponse?: StructuredResponse | null;
     artifacts?: ResponseArtifact[] | null;
     createdAt: string;
     completedAt?: string | null;
@@ -2806,6 +2876,11 @@ declare class PeopleResource {
 declare class ResponsesResource {
     private readonly http;
     constructor(http: Http);
+    private _getParamValue;
+    private _isPlainObject;
+    private _validateCriteriaDefinitions;
+    private _validateCriteriaClassification;
+    private _validateCriteriaParams;
     private _validateFileReference;
     /**
      * Create a new response request for asynchronous processing
@@ -2878,6 +2953,78 @@ declare class ResponsesResource {
         limit?: number;
         dataSources?: string[];
     }): Promise<CreateResponseResponse>;
+    /**
+     * Perform a deep people search with AI-generated criteria and validation
+     * @param query - Natural language search query describing ideal candidates
+     * @param options - Optional search parameters
+     * @param options.requestedCandidates - Number of candidates to find (default: 100)
+     * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+     * @param options.criteriaDefinitions - Pre-defined criteria definitions
+     * @param options.criteriaClassification - Pre-defined criteria classification
+     * @param options.runSingleCriterion - Run only a single criterion by ID
+     * @param options.addCriterion - Add a new criterion to existing criteria
+     * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+     *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+     *   Example string: 'Must have 5+ years Python experience'
+     *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @param options.excludeProfiles - LinkedIn URLs to exclude from results
+     * @param options.excludePreviouslyContacted - Exclude previously contacted people
+     * @param options.excludeNames - Names to exclude from results
+     * @returns Response with structured_response containing:
+     *   - candidates: Validated and scored candidates
+     *   - criteria: Generated/reused criteria definitions and classification
+     *   - searchStats: Search execution statistics
+     */
+    deepPeopleSearch(query: string, options?: {
+        requestedCandidates?: number;
+        dataSources?: string[];
+        reuseCriteriaFrom?: string;
+        criteriaDefinitions?: CriterionDefinition[];
+        criteriaClassification?: CriteriaClassification;
+        runSingleCriterion?: string;
+        addCriterion?: {
+            columnName: string;
+            criterionText: string;
+            criterionType?: CriterionType;
+            weight?: number;
+        };
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
+        excludeProfiles?: string[];
+        excludePreviouslyContacted?: boolean;
+        excludeNames?: string[];
+    }): Promise<CreateResponseResponse>;
+    /**
+     * Score provided candidates against AI-generated or provided criteria
+     * @param query - Natural language description of ideal candidate criteria
+     * @param candidateProfiles - List of candidates to score (each must have linkedin_url or email)
+     * @param options - Optional scoring parameters
+     * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+     * @param options.criteriaDefinitions - Pre-defined criteria definitions
+     * @param options.criteriaClassification - Pre-defined criteria classification
+     * @param options.runSingleCriterion - Run only a single criterion by ID
+     * @param options.addCriterion - Add a new criterion to existing criteria
+     * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+     *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+     *   Example string: 'Must have 5+ years Python experience'
+     *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @returns Response with structured_response containing:
+     *   - candidates: Scored candidates with validation results
+     *   - criteria: Generated/reused criteria definitions and classification
+     */
+    peopleScoring(query: string, candidateProfiles: Array<Record<string, any>>, options?: {
+        reuseCriteriaFrom?: string;
+        criteriaDefinitions?: CriterionDefinition[];
+        criteriaClassification?: CriteriaClassification;
+        runSingleCriterion?: string;
+        addCriterion?: {
+            columnName: string;
+            criterionText: string;
+            criterionType?: CriterionType;
+            weight?: number;
+        };
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
+    }): Promise<CreateResponseResponse>;
 }
 
 declare class SkillsResource {
@@ -3331,4 +3478,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, 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, BatchJobStatus, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelDraftResponse, type CancelResponseResponse, type ChannelContactHistory, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type DatabaseStatus, type DeleteApiKeyResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type Email, type EmailThreadSummary, type ErrorResponse, 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 GetConnectionStatusParams, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, InternalServerError, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type ListProvidersResponse, 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 Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, type PaginationInfo, type PaginationParams, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, 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, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type StoreApiKeyRequest, type SyncJobResponse, SyncJobStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, hasOpenProfileMessages, verifyWebhookSignature };
+export { ACTION_DELAYS, type AddAndRunCriterionRequest, type AddCriterionRequest, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, 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, BatchJobStatus, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelDraftResponse, type CancelResponseResponse, type ChannelContactHistory, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, 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 CriterionType, type DatabaseStatus, type DeleteApiKeyResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type Email, type EmailThreadSummary, type ErrorResponse, 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 GetConnectionStatusParams, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, InternalServerError, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type ListProvidersResponse, 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 Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, type PaginationInfo, type PaginationParams, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, 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, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, hasOpenProfileMessages, verifyWebhookSignature };

package/dist/index.d.ts

@@ -638,11 +638,48 @@ interface AgentConfig {
 interface ModelOverrides {
     [key: string]: string;
 }
+type CriterionType = 'universal' | 'varying' | 'validation_only';
+interface CriterionDefinition {
+    criterionId: string;
+    columnName: string;
+    criterionText: string;
+    criterionType: CriterionType;
+    weight: number;
+}
+interface CriteriaClassification {
+    universalCriteria: CriterionDefinition[];
+    varyingCriteria: CriterionDefinition[];
+    validationOnlyCriteria: CriterionDefinition[];
+    universalReasoning?: string;
+    varyingReasoning?: string;
+    validationReasoning?: string;
+}
+interface AddCriterionRequest {
+    columnName: string;
+    criterionText: string;
+    criterionType?: CriterionType;
+    weight?: number;
+}
+interface AddAndRunCriterionRequest {
+    criterionText: string;
+    suggestedColumnName?: string;
+}
+interface CriteriaMetadata {
+    version: number;
+    createdAt: string;
+    source: 'generated' | 'reused' | 'provided';
+    sourceResponseId?: string;
+    criteriaDefinitions: CriterionDefinition[];
+    criteriaClassification: CriteriaClassification;
+}
+interface StructuredResponse extends Record<string, any> {
+    criteria?: CriteriaMetadata;
+}
 /**
  * Available specialized agents
  * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | (string & {});
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | (string & {});
 /**
  * Parameters for specialized agent execution
  * This is a flexible interface that supports any agent-specific parameters
@@ -677,6 +714,39 @@ interface SpecializedAgentParams {
      * Names to exclude from results (passed through to CrustData post-processing when supported).
      */
     excludeNames?: string[];
+    /**
+     * Response ID to reuse criteria from.
+     */
+    reuseCriteriaFrom?: string;
+    /**
+     * Pre-defined criteria definitions to use.
+     */
+    criteriaDefinitions?: CriterionDefinition[];
+    /**
+     * Pre-defined criteria classification to use.
+     */
+    criteriaClassification?: CriteriaClassification;
+    /**
+     * Run validation against a single criterion ID.
+     */
+    runSingleCriterion?: string;
+    /**
+     * Add a new criterion to existing criteria.
+     */
+    addCriterion?: AddCriterionRequest;
+    /**
+     * Add a new criterion from English text and run only that criterion.
+     * Can be a string (criterion text) or an object with criterion_text and optional suggested_column_name.
+     * Example string: 'Must have 5+ years Python experience'
+     * Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * If suggestedColumnName not provided, it will be auto-generated from the text.
+     */
+    addAndRunCriterion?: string | AddAndRunCriterionRequest;
+    /**
+     * List of candidate profiles to score (for people_scoring agent).
+     * Each candidate must include at least one identifier: linkedin_url or email/emails.
+     */
+    candidateProfiles?: Array<Record<string, any>>;
     /**
      * Additional parameters for any specialized agent
      * This allows flexibility for future agents without SDK updates
@@ -695,7 +765,7 @@ interface CreateResponseRequest {
     modelOverrides?: ModelOverrides;
     /**
      * Route to a specialized agent instead of the main Lumnis agent
-     * Known agents: 'quick_people_search', 'deep_people_search'
+     * Known agents: 'quick_people_search', 'deep_people_search', 'people_scoring'
      * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
@@ -728,7 +798,7 @@ interface ResponseObject {
     outputText?: string | null;
     content?: string | null;
     responseTitle?: string | null;
-    structuredResponse?: Record<string, any> | null;
+    structuredResponse?: StructuredResponse | null;
     artifacts?: ResponseArtifact[] | null;
     createdAt: string;
     completedAt?: string | null;
@@ -2806,6 +2876,11 @@ declare class PeopleResource {
 declare class ResponsesResource {
     private readonly http;
     constructor(http: Http);
+    private _getParamValue;
+    private _isPlainObject;
+    private _validateCriteriaDefinitions;
+    private _validateCriteriaClassification;
+    private _validateCriteriaParams;
     private _validateFileReference;
     /**
      * Create a new response request for asynchronous processing
@@ -2878,6 +2953,78 @@ declare class ResponsesResource {
         limit?: number;
         dataSources?: string[];
     }): Promise<CreateResponseResponse>;
+    /**
+     * Perform a deep people search with AI-generated criteria and validation
+     * @param query - Natural language search query describing ideal candidates
+     * @param options - Optional search parameters
+     * @param options.requestedCandidates - Number of candidates to find (default: 100)
+     * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+     * @param options.criteriaDefinitions - Pre-defined criteria definitions
+     * @param options.criteriaClassification - Pre-defined criteria classification
+     * @param options.runSingleCriterion - Run only a single criterion by ID
+     * @param options.addCriterion - Add a new criterion to existing criteria
+     * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+     *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+     *   Example string: 'Must have 5+ years Python experience'
+     *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @param options.excludeProfiles - LinkedIn URLs to exclude from results
+     * @param options.excludePreviouslyContacted - Exclude previously contacted people
+     * @param options.excludeNames - Names to exclude from results
+     * @returns Response with structured_response containing:
+     *   - candidates: Validated and scored candidates
+     *   - criteria: Generated/reused criteria definitions and classification
+     *   - searchStats: Search execution statistics
+     */
+    deepPeopleSearch(query: string, options?: {
+        requestedCandidates?: number;
+        dataSources?: string[];
+        reuseCriteriaFrom?: string;
+        criteriaDefinitions?: CriterionDefinition[];
+        criteriaClassification?: CriteriaClassification;
+        runSingleCriterion?: string;
+        addCriterion?: {
+            columnName: string;
+            criterionText: string;
+            criterionType?: CriterionType;
+            weight?: number;
+        };
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
+        excludeProfiles?: string[];
+        excludePreviouslyContacted?: boolean;
+        excludeNames?: string[];
+    }): Promise<CreateResponseResponse>;
+    /**
+     * Score provided candidates against AI-generated or provided criteria
+     * @param query - Natural language description of ideal candidate criteria
+     * @param candidateProfiles - List of candidates to score (each must have linkedin_url or email)
+     * @param options - Optional scoring parameters
+     * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+     * @param options.criteriaDefinitions - Pre-defined criteria definitions
+     * @param options.criteriaClassification - Pre-defined criteria classification
+     * @param options.runSingleCriterion - Run only a single criterion by ID
+     * @param options.addCriterion - Add a new criterion to existing criteria
+     * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+     *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+     *   Example string: 'Must have 5+ years Python experience'
+     *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+     * @returns Response with structured_response containing:
+     *   - candidates: Scored candidates with validation results
+     *   - criteria: Generated/reused criteria definitions and classification
+     */
+    peopleScoring(query: string, candidateProfiles: Array<Record<string, any>>, options?: {
+        reuseCriteriaFrom?: string;
+        criteriaDefinitions?: CriterionDefinition[];
+        criteriaClassification?: CriteriaClassification;
+        runSingleCriterion?: string;
+        addCriterion?: {
+            columnName: string;
+            criterionText: string;
+            criterionType?: CriterionType;
+            weight?: number;
+        };
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
+    }): Promise<CreateResponseResponse>;
 }
 
 declare class SkillsResource {
@@ -3331,4 +3478,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, 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, BatchJobStatus, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelDraftResponse, type CancelResponseResponse, type ChannelContactHistory, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type DatabaseStatus, type DeleteApiKeyResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type Email, type EmailThreadSummary, type ErrorResponse, 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 GetConnectionStatusParams, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, InternalServerError, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type ListProvidersResponse, 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 Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, type PaginationInfo, type PaginationParams, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, 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, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type StoreApiKeyRequest, type SyncJobResponse, SyncJobStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, hasOpenProfileMessages, verifyWebhookSignature };
+export { ACTION_DELAYS, type AddAndRunCriterionRequest, type AddCriterionRequest, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, 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, BatchJobStatus, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelDraftResponse, type CancelResponseResponse, type ChannelContactHistory, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, 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 CriterionType, type DatabaseStatus, type DeleteApiKeyResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type Email, type EmailThreadSummary, type ErrorResponse, 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 GetConnectionStatusParams, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, InternalServerError, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type ListProvidersResponse, 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 Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, type PaginationInfo, type PaginationParams, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, 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, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, hasOpenProfileMessages, verifyWebhookSignature };

package/dist/index.mjs

@@ -1960,6 +1960,167 @@ class ResponsesResource {
   constructor(http) {
     this.http = http;
   }
+  _getParamValue(obj, camel, snake) {
+    if (!obj)
+      return void 0;
+    if (Object.prototype.hasOwnProperty.call(obj, camel))
+      return obj[camel];
+    if (Object.prototype.hasOwnProperty.call(obj, snake))
+      return obj[snake];
+    return void 0;
+  }
+  _isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+  }
+  _validateCriteriaDefinitions(criteriaDefinitions) {
+    if (!Array.isArray(criteriaDefinitions))
+      throw new ValidationError("criteria_definitions must be a list");
+    if (criteriaDefinitions.length === 0)
+      throw new ValidationError("criteria_definitions cannot be empty");
+    const criterionIds = /* @__PURE__ */ new Set();
+    const columnNames = /* @__PURE__ */ new Set();
+    const validTypes = ["universal", "varying", "validation_only"];
+    criteriaDefinitions.forEach((criterion, index) => {
+      if (!this._isPlainObject(criterion))
+        throw new ValidationError(`Criterion ${index} must be an object`);
+      const criterionId = this._getParamValue(criterion, "criterionId", "criterion_id");
+      const columnName = this._getParamValue(criterion, "columnName", "column_name");
+      const criterionText = this._getParamValue(criterion, "criterionText", "criterion_text");
+      const criterionType = this._getParamValue(criterion, "criterionType", "criterion_type");
+      const weightRaw = this._getParamValue(criterion, "weight", "weight");
+      if (!criterionId || typeof criterionId !== "string")
+        throw new ValidationError(`Criterion ${index} criterion_id must be a non-empty string`);
+      if (criterionIds.has(criterionId))
+        throw new ValidationError(`Duplicate criterion_id: ${criterionId}`);
+      criterionIds.add(criterionId);
+      if (!columnName || typeof columnName !== "string")
+        throw new ValidationError(`Criterion ${index} column_name must be a non-empty string`);
+      if (columnNames.has(columnName))
+        throw new ValidationError(`Duplicate column_name: ${columnName}`);
+      columnNames.add(columnName);
+      if (!criterionText || typeof criterionText !== "string")
+        throw new ValidationError(`Criterion ${index} criterion_text must be a non-empty string`);
+      if (!criterionType || !validTypes.includes(criterionType))
+        throw new ValidationError(`Criterion ${index} has invalid criterion_type: ${String(criterionType)}`);
+      const weight = Number(weightRaw);
+      if (!Number.isFinite(weight))
+        throw new ValidationError(`Criterion ${index} weight must be a number`);
+      if (weight <= 0)
+        throw new ValidationError(`Criterion ${index} weight must be positive`);
+    });
+  }
+  _validateCriteriaClassification(criteriaClassification) {
+    if (!this._isPlainObject(criteriaClassification))
+      throw new ValidationError("criteria_classification must be an object");
+    const universalCriteria = this._getParamValue(criteriaClassification, "universalCriteria", "universal_criteria");
+    const varyingCriteria = this._getParamValue(criteriaClassification, "varyingCriteria", "varying_criteria");
+    const validationOnlyCriteria = this._getParamValue(criteriaClassification, "validationOnlyCriteria", "validation_only_criteria");
+    if (!Array.isArray(universalCriteria))
+      throw new ValidationError("criteria_classification missing or invalid universal_criteria");
+    if (!Array.isArray(varyingCriteria))
+      throw new ValidationError("criteria_classification missing or invalid varying_criteria");
+    if (!Array.isArray(validationOnlyCriteria))
+      throw new ValidationError("criteria_classification missing or invalid validation_only_criteria");
+  }
+  _validateCriteriaParams(params, specializedAgent) {
+    if (!params)
+      return;
+    const rawParams = params;
+    const reuseCriteriaFrom = this._getParamValue(rawParams, "reuseCriteriaFrom", "reuse_criteria_from");
+    const criteriaDefinitions = this._getParamValue(
+      rawParams,
+      "criteriaDefinitions",
+      "criteria_definitions"
+    );
+    const criteriaClassification = this._getParamValue(
+      rawParams,
+      "criteriaClassification",
+      "criteria_classification"
+    );
+    const runSingleCriterion = this._getParamValue(rawParams, "runSingleCriterion", "run_single_criterion");
+    const addCriterion = this._getParamValue(rawParams, "addCriterion", "add_criterion");
+    const addAndRunCriterion = this._getParamValue(
+      rawParams,
+      "addAndRunCriterion",
+      "add_and_run_criterion"
+    );
+    const candidateProfiles = this._getParamValue(
+      rawParams,
+      "candidateProfiles",
+      "candidate_profiles"
+    );
+    const hasCriteria = !!criteriaDefinitions && !!criteriaClassification;
+    if (criteriaDefinitions && !criteriaClassification || !criteriaDefinitions && criteriaClassification) {
+      throw new ValidationError(
+        "When providing criteria directly, both criteria_definitions and criteria_classification must be provided."
+      );
+    }
+    if (criteriaDefinitions || criteriaClassification) {
+      this._validateCriteriaDefinitions(criteriaDefinitions);
+      this._validateCriteriaClassification(criteriaClassification);
+    }
+    if (runSingleCriterion) {
+      if (!reuseCriteriaFrom && !hasCriteria) {
+        throw new ValidationError(
+          "run_single_criterion requires reuse_criteria_from or explicit criteria_definitions/criteria_classification."
+        );
+      }
+      if (typeof runSingleCriterion !== "string" || !runSingleCriterion.trim()) {
+        throw new ValidationError("run_single_criterion must be a non-empty string");
+      }
+    }
+    if (addCriterion) {
+      if (!reuseCriteriaFrom && !hasCriteria)
+        throw new ValidationError("add_criterion requires existing criteria (reuse or direct criteria).");
+      if (!this._isPlainObject(addCriterion))
+        throw new ValidationError("add_criterion must be an object");
+      const columnName = this._getParamValue(addCriterion, "columnName", "column_name");
+      const criterionText = this._getParamValue(addCriterion, "criterionText", "criterion_text");
+      if (!columnName || typeof columnName !== "string")
+        throw new ValidationError("add_criterion requires column_name");
+      if (!criterionText || typeof criterionText !== "string")
+        throw new ValidationError("add_criterion requires criterion_text");
+    }
+    if (addAndRunCriterion !== void 0) {
+      if (!reuseCriteriaFrom && !hasCriteria)
+        throw new ValidationError("add_and_run_criterion requires existing criteria (reuse or direct criteria).");
+      if (typeof addAndRunCriterion === "string") {
+        if (!addAndRunCriterion.trim())
+          throw new ValidationError("add_and_run_criterion must be a non-empty string");
+      } else if (this._isPlainObject(addAndRunCriterion)) {
+        const criterionText = this._getParamValue(addAndRunCriterion, "criterionText", "criterion_text");
+        const suggestedColumnName = this._getParamValue(
+          addAndRunCriterion,
+          "suggestedColumnName",
+          "suggested_column_name"
+        );
+        if (!criterionText || typeof criterionText !== "string")
+          throw new ValidationError("add_and_run_criterion object requires criterion_text");
+        if (suggestedColumnName !== void 0 && typeof suggestedColumnName !== "string")
+          throw new ValidationError("add_and_run_criterion suggested_column_name must be a string if provided");
+      } else {
+        throw new ValidationError("add_and_run_criterion must be a string or an object");
+      }
+    }
+    if (specializedAgent === "people_scoring") {
+      if (!candidateProfiles || !Array.isArray(candidateProfiles) || candidateProfiles.length === 0)
+        throw new ValidationError("candidate_profiles is required for people_scoring agent and must be a non-empty list");
+      const missingIds = [];
+      candidateProfiles.forEach((candidate, index) => {
+        const c = candidate || {};
+        const linkedinUrl = c.linkedin_url || c.linkedinUrl;
+        const email = c.email;
+        const emails = c.emails;
+        if (!linkedinUrl && !email && (!emails || !Array.isArray(emails) || emails.length === 0))
+          missingIds.push({ index, name: c.name });
+      });
+      if (missingIds.length > 0) {
+        throw new ValidationError(
+          `Each candidate in candidate_profiles must include at least one identifier: linkedin_url or email. Missing identifiers for ${missingIds.length} candidates: ${JSON.stringify(missingIds)}`
+        );
+      }
+    }
+  }
   _validateFileReference(uri) {
     if (uri.startsWith("artifact_"))
       return;
@@ -2000,6 +2161,8 @@ class ResponsesResource {
       for (const file of request.files)
         this._validateFileReference(file.uri);
     }
+    if (request.specializedAgentParams)
+      this._validateCriteriaParams(request.specializedAgentParams, request.specializedAgent);
     return this.http.post("/responses", request);
   }
   /**
@@ -2098,6 +2261,105 @@ class ResponsesResource {
     }
     return this.create(request);
   }
+  /**
+   * Perform a deep people search with AI-generated criteria and validation
+   * @param query - Natural language search query describing ideal candidates
+   * @param options - Optional search parameters
+   * @param options.requestedCandidates - Number of candidates to find (default: 100)
+   * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+   * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+   * @param options.criteriaDefinitions - Pre-defined criteria definitions
+   * @param options.criteriaClassification - Pre-defined criteria classification
+   * @param options.runSingleCriterion - Run only a single criterion by ID
+   * @param options.addCriterion - Add a new criterion to existing criteria
+   * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+   *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+   *   Example string: 'Must have 5+ years Python experience'
+   *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+   * @param options.excludeProfiles - LinkedIn URLs to exclude from results
+   * @param options.excludePreviouslyContacted - Exclude previously contacted people
+   * @param options.excludeNames - Names to exclude from results
+   * @returns Response with structured_response containing:
+   *   - candidates: Validated and scored candidates
+   *   - criteria: Generated/reused criteria definitions and classification
+   *   - searchStats: Search execution statistics
+   */
+  async deepPeopleSearch(query, options) {
+    const request = {
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "deep_people_search"
+    };
+    if (options) {
+      const params = {};
+      if (options.requestedCandidates !== void 0)
+        params.requestedCandidates = options.requestedCandidates;
+      if (options.dataSources)
+        params.dataSources = options.dataSources;
+      if (options.reuseCriteriaFrom)
+        params.reuseCriteriaFrom = options.reuseCriteriaFrom;
+      if (options.criteriaDefinitions)
+        params.criteriaDefinitions = options.criteriaDefinitions;
+      if (options.criteriaClassification)
+        params.criteriaClassification = options.criteriaClassification;
+      if (options.runSingleCriterion)
+        params.runSingleCriterion = options.runSingleCriterion;
+      if (options.addCriterion)
+        params.addCriterion = options.addCriterion;
+      if (options.addAndRunCriterion)
+        params.addAndRunCriterion = options.addAndRunCriterion;
+      if (options.excludeProfiles)
+        params.excludeProfiles = options.excludeProfiles;
+      if (options.excludePreviouslyContacted !== void 0)
+        params.excludePreviouslyContacted = options.excludePreviouslyContacted;
+      if (options.excludeNames)
+        params.excludeNames = options.excludeNames;
+      if (Object.keys(params).length > 0)
+        request.specializedAgentParams = params;
+    }
+    return this.create(request);
+  }
+  /**
+   * Score provided candidates against AI-generated or provided criteria
+   * @param query - Natural language description of ideal candidate criteria
+   * @param candidateProfiles - List of candidates to score (each must have linkedin_url or email)
+   * @param options - Optional scoring parameters
+   * @param options.reuseCriteriaFrom - Response ID to reuse criteria from
+   * @param options.criteriaDefinitions - Pre-defined criteria definitions
+   * @param options.criteriaClassification - Pre-defined criteria classification
+   * @param options.runSingleCriterion - Run only a single criterion by ID
+   * @param options.addCriterion - Add a new criterion to existing criteria
+   * @param options.addAndRunCriterion - Add criterion from text and run only that criterion.
+   *   Can be a string (criterion text) or an object with criterionText and optional suggestedColumnName.
+   *   Example string: 'Must have 5+ years Python experience'
+   *   Example object: { criterionText: 'Has ML experience', suggestedColumnName: 'ml_experience' }
+   * @returns Response with structured_response containing:
+   *   - candidates: Scored candidates with validation results
+   *   - criteria: Generated/reused criteria definitions and classification
+   */
+  async peopleScoring(query, candidateProfiles, options) {
+    const request = {
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "people_scoring",
+      specializedAgentParams: {
+        candidateProfiles
+      }
+    };
+    if (options) {
+      if (options.reuseCriteriaFrom)
+        request.specializedAgentParams.reuseCriteriaFrom = options.reuseCriteriaFrom;
+      if (options.criteriaDefinitions)
+        request.specializedAgentParams.criteriaDefinitions = options.criteriaDefinitions;
+      if (options.criteriaClassification)
+        request.specializedAgentParams.criteriaClassification = options.criteriaClassification;
+      if (options.runSingleCriterion)
+        request.specializedAgentParams.runSingleCriterion = options.runSingleCriterion;
+      if (options.addCriterion)
+        request.specializedAgentParams.addCriterion = options.addCriterion;
+      if (options.addAndRunCriterion)
+        request.specializedAgentParams.addAndRunCriterion = options.addAndRunCriterion;
+    }
+    return this.create(request);
+  }
 }
 
 class SkillsResource {

package/package.json

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