lumnisai 0.1.26 → 0.1.27

package/dist/index.cjs

@@ -2045,7 +2045,11 @@ class ResponsesResource {
     );
     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 addAndRunCriterion = this._getParamValue(
+      rawParams,
+      "addAndRunCriterion",
+      "add_and_run_criterion"
+    );
     const candidateProfiles = this._getParamValue(
       rawParams,
       "candidateProfiles",
@@ -2086,8 +2090,23 @@ class ResponsesResource {
     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" || !addAndRunCriterion.trim())
-        throw new ValidationError("add_and_run_criterion must be a non-empty string");
+      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)
@@ -2259,7 +2278,10 @@ class ResponsesResource {
    * @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
+   * @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
@@ -2312,7 +2334,10 @@ class ResponsesResource {
    * @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
+   * @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

package/dist/index.d.cts

@@ -660,6 +660,10 @@ interface AddCriterionRequest {
     criterionType?: CriterionType;
     weight?: number;
 }
+interface AddAndRunCriterionRequest {
+    criterionText: string;
+    suggestedColumnName?: string;
+}
 interface CriteriaMetadata {
     version: number;
     createdAt: string;
@@ -732,8 +736,12 @@ interface SpecializedAgentParams {
     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;
+    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.
@@ -2956,7 +2964,10 @@ declare class ResponsesResource {
      * @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
+     * @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
@@ -2978,7 +2989,7 @@ declare class ResponsesResource {
             criterionType?: CriterionType;
             weight?: number;
         };
-        addAndRunCriterion?: string;
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
@@ -2993,7 +3004,10 @@ declare class ResponsesResource {
      * @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
+     * @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
@@ -3009,7 +3023,7 @@ declare class ResponsesResource {
             criterionType?: CriterionType;
             weight?: number;
         };
-        addAndRunCriterion?: string;
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
     }): Promise<CreateResponseResponse>;
 }
 
@@ -3464,4 +3478,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, 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 };
+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

@@ -660,6 +660,10 @@ interface AddCriterionRequest {
     criterionType?: CriterionType;
     weight?: number;
 }
+interface AddAndRunCriterionRequest {
+    criterionText: string;
+    suggestedColumnName?: string;
+}
 interface CriteriaMetadata {
     version: number;
     createdAt: string;
@@ -732,8 +736,12 @@ interface SpecializedAgentParams {
     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;
+    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.
@@ -2956,7 +2964,10 @@ declare class ResponsesResource {
      * @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
+     * @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
@@ -2978,7 +2989,7 @@ declare class ResponsesResource {
             criterionType?: CriterionType;
             weight?: number;
         };
-        addAndRunCriterion?: string;
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
@@ -2993,7 +3004,10 @@ declare class ResponsesResource {
      * @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
+     * @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
@@ -3009,7 +3023,7 @@ declare class ResponsesResource {
             criterionType?: CriterionType;
             weight?: number;
         };
-        addAndRunCriterion?: string;
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
     }): Promise<CreateResponseResponse>;
 }
 
@@ -3464,4 +3478,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, 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 };
+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

@@ -660,6 +660,10 @@ interface AddCriterionRequest {
     criterionType?: CriterionType;
     weight?: number;
 }
+interface AddAndRunCriterionRequest {
+    criterionText: string;
+    suggestedColumnName?: string;
+}
 interface CriteriaMetadata {
     version: number;
     createdAt: string;
@@ -732,8 +736,12 @@ interface SpecializedAgentParams {
     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;
+    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.
@@ -2956,7 +2964,10 @@ declare class ResponsesResource {
      * @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
+     * @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
@@ -2978,7 +2989,7 @@ declare class ResponsesResource {
             criterionType?: CriterionType;
             weight?: number;
         };
-        addAndRunCriterion?: string;
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
@@ -2993,7 +3004,10 @@ declare class ResponsesResource {
      * @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
+     * @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
@@ -3009,7 +3023,7 @@ declare class ResponsesResource {
             criterionType?: CriterionType;
             weight?: number;
         };
-        addAndRunCriterion?: string;
+        addAndRunCriterion?: string | AddAndRunCriterionRequest;
     }): Promise<CreateResponseResponse>;
 }
 
@@ -3464,4 +3478,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, 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 };
+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

@@ -2039,7 +2039,11 @@ class ResponsesResource {
     );
     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 addAndRunCriterion = this._getParamValue(
+      rawParams,
+      "addAndRunCriterion",
+      "add_and_run_criterion"
+    );
     const candidateProfiles = this._getParamValue(
       rawParams,
       "candidateProfiles",
@@ -2080,8 +2084,23 @@ class ResponsesResource {
     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" || !addAndRunCriterion.trim())
-        throw new ValidationError("add_and_run_criterion must be a non-empty string");
+      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)
@@ -2253,7 +2272,10 @@ class ResponsesResource {
    * @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
+   * @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
@@ -2306,7 +2328,10 @@ class ResponsesResource {
    * @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
+   * @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

package/package.json

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