lumnisai 0.1.10 → 0.1.12

package/dist/index.cjs

@@ -757,6 +757,204 @@ class MessagingResource {
       request
     );
   }
+  /**
+   * Delete a single conversation and all its messages.
+   *
+   * @param conversationId - UUID of the conversation to delete
+   * @param userId - User ID or email
+   * @returns DeleteConversationResponse with success status and conversation_id
+   * @throws MessagingNotFoundError if conversation not found (404)
+   * @throws MessagingValidationError if conversation_id is invalid (400)
+   */
+  async deleteConversation(conversationId, userId) {
+    try {
+      const queryParams = new URLSearchParams();
+      queryParams.append("user_id", userId);
+      return await this.http.delete(
+        `/messaging/conversations/${encodeURIComponent(conversationId)}?${queryParams.toString()}`
+      );
+    } catch (error) {
+      if (error instanceof NotFoundError) {
+        throw new MessagingNotFoundError(
+          `Conversation ${conversationId} not found`
+        );
+      }
+      if (error instanceof ValidationError) {
+        throw new MessagingValidationError(
+          `Invalid conversation ID: ${conversationId}`
+        );
+      }
+      throw error;
+    }
+  }
+  /**
+   * Delete all conversations for a project.
+   *
+   * **Warning:** This permanently deletes conversations and messages.
+   * Consider using unlinkConversationsFromProject() instead.
+   *
+   * @param projectId - UUID of the project
+   * @param userId - User ID or email
+   * @returns DeleteConversationsByProjectResponse with deleted count
+   */
+  async deleteConversationsByProject(projectId, userId) {
+    const queryParams = new URLSearchParams();
+    queryParams.append("project_id", projectId);
+    queryParams.append("user_id", userId);
+    return this.http.delete(
+      `/messaging/conversations?${queryParams.toString()}`
+    );
+  }
+  /**
+   * Unlink conversations from a project without deleting them.
+   *
+   * This preserves conversation history by setting project_id = NULL.
+   * Recommended approach when deleting a project.
+   *
+   * @param projectId - UUID of the project
+   * @param userId - User ID or email
+   * @returns UnlinkConversationsResponse with unlinked count
+   */
+  async unlinkConversationsFromProject(projectId, userId) {
+    const queryParams = new URLSearchParams();
+    queryParams.append("project_id", projectId);
+    queryParams.append("user_id", userId);
+    return this.http.post(
+      `/messaging/conversations/unlink-project?${queryParams.toString()}`,
+      null
+    );
+  }
+  /**
+   * Check if there has been any prior contact with a person across all channels.
+   *
+   * This searches your connected messaging accounts (Gmail, Outlook, LinkedIn) to find
+   * any historical communication with a person, even if they're not in the system as a prospect.
+   *
+   * **Use cases:**
+   * - Before adding a new prospect, check if you've already contacted them
+   * - Detect duplicate outreach across different systems
+   * - Find historical conversation context before sending a new message
+   *
+   * **Required:** At least one of `email`, `linkedinUrl`, or `providerId` must be provided.
+   *
+   * **Channels:**
+   * - If `channels` is not specified, checks all channels based on identifiers provided:
+   *   - `email` → checks Gmail and Outlook
+   *   - `linkedinUrl` or `providerId` → checks LinkedIn
+   * - Specify `channels` to limit which accounts to search (e.g., `["linkedin"]`)
+   *
+   * **Returns:**
+   * - `hasPriorContact`: True if ANY communication exists on ANY channel
+   * - `channelsChecked`: List of channels that were searched
+   * - `channelsWithContact`: List of channels where contact was found
+   * - `contactHistory`: Per-channel details including:
+   *   - `isUserInitiated`: True if you sent the first message
+   *   - `messages`: Most recent N messages (configurable via `messageLimit`)
+   *   - `firstContactAt` / `lastContactAt`: Timestamps of first and last messages
+   * - `cached`: True if result was served from cache (results are cached for 2 hours)
+   *
+   * **Caching:**
+   * - Results are cached in Redis for 2 hours to improve performance
+   * - Set `skipCache: true` to force a fresh check
+   *
+   * @param userId - User ID or email
+   * @param request - CheckPriorContactRequest with identifiers and options
+   * @returns CheckPriorContactResponse with contact history
+   * @throws MessagingValidationError if no identifier provided
+   */
+  async checkPriorContact(userId, request) {
+    if (!request.email && !request.linkedinUrl && !request.providerId) {
+      throw new MessagingValidationError(
+        "At least one of email, linkedinUrl, or providerId must be provided",
+        { code: "VALIDATION_ERROR" }
+      );
+    }
+    const queryParams = new URLSearchParams();
+    queryParams.append("user_id", userId);
+    const payload = {};
+    if (request.email) payload.email = request.email;
+    if (request.linkedinUrl) payload.linkedin_url = request.linkedinUrl;
+    if (request.providerId) payload.provider_id = request.providerId;
+    if (request.channels) payload.channels = request.channels;
+    if (request.messageLimit !== void 0 && request.messageLimit !== null) {
+      payload.message_limit = request.messageLimit;
+    }
+    if (request.skipCache !== void 0 && request.skipCache !== null) {
+      payload.skip_cache = request.skipCache;
+    }
+    return this.http.post(
+      `/messaging/check-prior-contact?${queryParams.toString()}`,
+      payload
+    );
+  }
+  /**
+   * Check prior contact for multiple prospects at once (parallelized).
+   *
+   * This is the batch version of `checkPriorContact` for efficiently checking
+   * many prospects at once. Useful when importing a list of prospects and need to
+   * identify which ones have been contacted before.
+   *
+   * **Limits:**
+   * - Max 50 prospects per request
+   * - Max 10 messages per channel per prospect (to keep response size manageable)
+   *
+   * **Request:**
+   * ```typescript
+   * {
+   *   prospects: [
+   *     { prospectId: "p1", email: "john@acme.com" },
+   *     { prospectId: "p2", linkedinUrl: "https://linkedin.com/in/jane" },
+   *     { prospectId: "p3", email: "bob@xyz.com", linkedinUrl: "https://linkedin.com/in/bob" }
+   *   ],
+   *   channels: ["gmail", "linkedin"],  // Optional
+   *   messageLimit: 3  // Messages per channel (default: 3)
+   * }
+   * ```
+   *
+   * **Response:**
+   * - `results`: Dict keyed by `prospectId` with contact history for each
+   * - `summary`: Aggregated counts {total, withContact, withoutContact, errors, cached}
+   *
+   * **Caching:**
+   * - Results are cached in Redis for 2 hours to improve performance
+   * - Set `skipCache: true` to force fresh checks for all prospects
+   *
+   * @param userId - User ID or email
+   * @param request - BatchCheckPriorContactRequest with prospects and options
+   * @returns BatchCheckPriorContactResponse with results keyed by prospectId
+   * @throws MessagingValidationError if any prospect lacks identifiers
+   */
+  async batchCheckPriorContact(userId, request) {
+    for (const prospect of request.prospects) {
+      if (!prospect.email && !prospect.linkedinUrl && !prospect.providerId) {
+        throw new MessagingValidationError(
+          `Prospect '${prospect.prospectId}' must have at least one of: email, linkedinUrl, or providerId`,
+          { code: "VALIDATION_ERROR" }
+        );
+      }
+    }
+    const queryParams = new URLSearchParams();
+    queryParams.append("user_id", userId);
+    const payload = {
+      prospects: request.prospects.map((p) => ({
+        prospect_id: p.prospectId,
+        email: p.email || void 0,
+        linkedin_url: p.linkedinUrl || void 0,
+        provider_id: p.providerId || void 0
+      }))
+    };
+    if (request.channels) payload.channels = request.channels;
+    if (request.messageLimit !== void 0 && request.messageLimit !== null) {
+      payload.message_limit = request.messageLimit;
+    }
+    if (request.skipCache !== void 0 && request.skipCache !== null) {
+      payload.skip_cache = request.skipCache;
+    }
+    return this.http.post(
+      `/messaging/check-prior-contact/batch?${queryParams.toString()}`,
+      payload
+    );
+  }
 }
 
 class ModelPreferencesResource {

package/dist/index.d.cts

@@ -1626,6 +1626,145 @@ interface BatchSendResponse {
     failed: number;
     queued: number;
 }
+/**
+ * Response from deleting a single conversation
+ */
+interface DeleteConversationResponse {
+    success: boolean;
+    conversation_id: string;
+}
+/**
+ * Response from deleting conversations by project
+ */
+interface DeleteConversationsByProjectResponse {
+    success: boolean;
+    project_id: string;
+    deleted_count: number;
+}
+/**
+ * Response from unlinking conversations from project
+ */
+interface UnlinkConversationsResponse {
+    success: boolean;
+    project_id: string;
+    unlinked_count: number;
+}
+/**
+ * Request to check if there's been prior contact with a person
+ */
+interface CheckPriorContactRequest {
+    /** Email address to check (for Gmail/Outlook) */
+    email?: string | null;
+    /** LinkedIn profile URL to check */
+    linkedinUrl?: string | null;
+    /** LinkedIn provider ID to check */
+    providerId?: string | null;
+    /** Channels to check: 'gmail', 'outlook', 'linkedin'. Default: all connected channels */
+    channels?: string[] | null;
+    /** Max messages to return per channel (1-20, default: 5) */
+    messageLimit?: number | null;
+    /** Force fresh check, bypassing cache (default: false) */
+    skipCache?: boolean | null;
+}
+/**
+ * A message from prior contact history
+ */
+interface PriorContactMessage {
+    id: string;
+    /** 'inbound' | 'outbound' */
+    direction: string;
+    content: string;
+    subject?: string | null;
+    senderName: string;
+    /** ISO timestamp */
+    sentAt: string;
+}
+/**
+ * Contact history for a single channel
+ */
+interface ChannelContactHistory {
+    /** 'gmail' | 'outlook' | 'linkedin' */
+    channel: string;
+    hasContact: boolean;
+    /** True if user sent first message */
+    isUserInitiated: boolean;
+    threadId?: string | null;
+    /** Internal ID if we have one */
+    conversationId?: string | null;
+    messageCount: number;
+    /** ISO timestamp */
+    firstContactAt?: string | null;
+    /** ISO timestamp */
+    lastContactAt?: string | null;
+    prospectName?: string | null;
+    messages: PriorContactMessage[];
+}
+/**
+ * Response from prior contact check
+ */
+interface CheckPriorContactResponse {
+    /** True if ANY channel has contact */
+    hasPriorContact: boolean;
+    channelsChecked: string[];
+    channelsWithContact: string[];
+    contactHistory: ChannelContactHistory[];
+    /** True if result was served from cache */
+    cached?: boolean;
+}
+/**
+ * Identifier for a prospect in batch prior contact check
+ */
+interface BatchProspectIdentifier {
+    /** Unique identifier for this prospect (for mapping results) */
+    prospectId: string;
+    /** Email address to check */
+    email?: string | null;
+    /** LinkedIn profile URL */
+    linkedinUrl?: string | null;
+    /** LinkedIn provider ID */
+    providerId?: string | null;
+}
+/**
+ * Request to check prior contact for multiple prospects
+ */
+interface BatchCheckPriorContactRequest {
+    /** List of prospects to check (max 50) */
+    prospects: BatchProspectIdentifier[];
+    /** Channels to check: 'gmail', 'outlook', 'linkedin'. Default: all based on identifiers */
+    channels?: string[] | null;
+    /** Max messages per channel per prospect (1-10, default: 3) */
+    messageLimit?: number | null;
+    /** Force fresh check for all prospects, bypassing cache (default: false) */
+    skipCache?: boolean | null;
+}
+/**
+ * Prior contact result for a single prospect in batch
+ */
+interface ProspectPriorContactResult {
+    prospectId: string;
+    hasPriorContact: boolean;
+    channelsWithContact: string[];
+    contactHistory: ChannelContactHistory[];
+    /** True if this result was from cache */
+    cached?: boolean;
+    error?: string | null;
+}
+/**
+ * Response from batch prior contact check
+ */
+interface BatchCheckPriorContactResponse {
+    /** Keyed by prospect_id */
+    results: Record<string, ProspectPriorContactResult>;
+    /** Aggregated counts */
+    summary: {
+        total: number;
+        withContact: number;
+        withoutContact: number;
+        errors: number;
+        /** Number of results served from cache */
+        cached?: number;
+    };
+}
 
 declare class MessagingResource {
     private readonly http;
@@ -1728,6 +1867,115 @@ declare class MessagingResource {
      * Send multiple drafts with rate limiting
      */
     sendBatchDrafts(userId: string, request: BatchSendRequest): Promise<BatchSendResponse>;
+    /**
+     * Delete a single conversation and all its messages.
+     *
+     * @param conversationId - UUID of the conversation to delete
+     * @param userId - User ID or email
+     * @returns DeleteConversationResponse with success status and conversation_id
+     * @throws MessagingNotFoundError if conversation not found (404)
+     * @throws MessagingValidationError if conversation_id is invalid (400)
+     */
+    deleteConversation(conversationId: string, userId: string): Promise<DeleteConversationResponse>;
+    /**
+     * Delete all conversations for a project.
+     *
+     * **Warning:** This permanently deletes conversations and messages.
+     * Consider using unlinkConversationsFromProject() instead.
+     *
+     * @param projectId - UUID of the project
+     * @param userId - User ID or email
+     * @returns DeleteConversationsByProjectResponse with deleted count
+     */
+    deleteConversationsByProject(projectId: string, userId: string): Promise<DeleteConversationsByProjectResponse>;
+    /**
+     * Unlink conversations from a project without deleting them.
+     *
+     * This preserves conversation history by setting project_id = NULL.
+     * Recommended approach when deleting a project.
+     *
+     * @param projectId - UUID of the project
+     * @param userId - User ID or email
+     * @returns UnlinkConversationsResponse with unlinked count
+     */
+    unlinkConversationsFromProject(projectId: string, userId: string): Promise<UnlinkConversationsResponse>;
+    /**
+     * Check if there has been any prior contact with a person across all channels.
+     *
+     * This searches your connected messaging accounts (Gmail, Outlook, LinkedIn) to find
+     * any historical communication with a person, even if they're not in the system as a prospect.
+     *
+     * **Use cases:**
+     * - Before adding a new prospect, check if you've already contacted them
+     * - Detect duplicate outreach across different systems
+     * - Find historical conversation context before sending a new message
+     *
+     * **Required:** At least one of `email`, `linkedinUrl`, or `providerId` must be provided.
+     *
+     * **Channels:**
+     * - If `channels` is not specified, checks all channels based on identifiers provided:
+     *   - `email` → checks Gmail and Outlook
+     *   - `linkedinUrl` or `providerId` → checks LinkedIn
+     * - Specify `channels` to limit which accounts to search (e.g., `["linkedin"]`)
+     *
+     * **Returns:**
+     * - `hasPriorContact`: True if ANY communication exists on ANY channel
+     * - `channelsChecked`: List of channels that were searched
+     * - `channelsWithContact`: List of channels where contact was found
+     * - `contactHistory`: Per-channel details including:
+     *   - `isUserInitiated`: True if you sent the first message
+     *   - `messages`: Most recent N messages (configurable via `messageLimit`)
+     *   - `firstContactAt` / `lastContactAt`: Timestamps of first and last messages
+     * - `cached`: True if result was served from cache (results are cached for 2 hours)
+     *
+     * **Caching:**
+     * - Results are cached in Redis for 2 hours to improve performance
+     * - Set `skipCache: true` to force a fresh check
+     *
+     * @param userId - User ID or email
+     * @param request - CheckPriorContactRequest with identifiers and options
+     * @returns CheckPriorContactResponse with contact history
+     * @throws MessagingValidationError if no identifier provided
+     */
+    checkPriorContact(userId: string, request: CheckPriorContactRequest): Promise<CheckPriorContactResponse>;
+    /**
+     * Check prior contact for multiple prospects at once (parallelized).
+     *
+     * This is the batch version of `checkPriorContact` for efficiently checking
+     * many prospects at once. Useful when importing a list of prospects and need to
+     * identify which ones have been contacted before.
+     *
+     * **Limits:**
+     * - Max 50 prospects per request
+     * - Max 10 messages per channel per prospect (to keep response size manageable)
+     *
+     * **Request:**
+     * ```typescript
+     * {
+     *   prospects: [
+     *     { prospectId: "p1", email: "john@acme.com" },
+     *     { prospectId: "p2", linkedinUrl: "https://linkedin.com/in/jane" },
+     *     { prospectId: "p3", email: "bob@xyz.com", linkedinUrl: "https://linkedin.com/in/bob" }
+     *   ],
+     *   channels: ["gmail", "linkedin"],  // Optional
+     *   messageLimit: 3  // Messages per channel (default: 3)
+     * }
+     * ```
+     *
+     * **Response:**
+     * - `results`: Dict keyed by `prospectId` with contact history for each
+     * - `summary`: Aggregated counts {total, withContact, withoutContact, errors, cached}
+     *
+     * **Caching:**
+     * - Results are cached in Redis for 2 hours to improve performance
+     * - Set `skipCache: true` to force fresh checks for all prospects
+     *
+     * @param userId - User ID or email
+     * @param request - BatchCheckPriorContactRequest with prospects and options
+     * @returns BatchCheckPriorContactResponse with results keyed by prospectId
+     * @throws MessagingValidationError if any prospect lacks identifiers
+     */
+    batchCheckPriorContact(userId: string, request: BatchCheckPriorContactRequest): Promise<BatchCheckPriorContactResponse>;
 }
 
 declare class ModelPreferencesResource {
@@ -2321,4 +2569,4 @@ declare class ProgressTracker {
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
 export = LumnisClient;
-export { 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 BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftRequest, type BatchDraftResponse, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelResponseResponse, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, 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 DisconnectRequest, type DisconnectResponse, type DraftResponse, 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, IntegrationsResource, InternalServerError, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInSendRequest, 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 ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, 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, type UUID, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, displayProgress, formatProgressEntry, verifyWebhookSignature };
+export { 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 BatchDraftRequest, type BatchDraftResponse, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, 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, 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, IntegrationsResource, InternalServerError, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInSendRequest, 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, 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, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, displayProgress, formatProgressEntry, verifyWebhookSignature };

package/dist/index.d.mts

@@ -1626,6 +1626,145 @@ interface BatchSendResponse {
     failed: number;
     queued: number;
 }
+/**
+ * Response from deleting a single conversation
+ */
+interface DeleteConversationResponse {
+    success: boolean;
+    conversation_id: string;
+}
+/**
+ * Response from deleting conversations by project
+ */
+interface DeleteConversationsByProjectResponse {
+    success: boolean;
+    project_id: string;
+    deleted_count: number;
+}
+/**
+ * Response from unlinking conversations from project
+ */
+interface UnlinkConversationsResponse {
+    success: boolean;
+    project_id: string;
+    unlinked_count: number;
+}
+/**
+ * Request to check if there's been prior contact with a person
+ */
+interface CheckPriorContactRequest {
+    /** Email address to check (for Gmail/Outlook) */
+    email?: string | null;
+    /** LinkedIn profile URL to check */
+    linkedinUrl?: string | null;
+    /** LinkedIn provider ID to check */
+    providerId?: string | null;
+    /** Channels to check: 'gmail', 'outlook', 'linkedin'. Default: all connected channels */
+    channels?: string[] | null;
+    /** Max messages to return per channel (1-20, default: 5) */
+    messageLimit?: number | null;
+    /** Force fresh check, bypassing cache (default: false) */
+    skipCache?: boolean | null;
+}
+/**
+ * A message from prior contact history
+ */
+interface PriorContactMessage {
+    id: string;
+    /** 'inbound' | 'outbound' */
+    direction: string;
+    content: string;
+    subject?: string | null;
+    senderName: string;
+    /** ISO timestamp */
+    sentAt: string;
+}
+/**
+ * Contact history for a single channel
+ */
+interface ChannelContactHistory {
+    /** 'gmail' | 'outlook' | 'linkedin' */
+    channel: string;
+    hasContact: boolean;
+    /** True if user sent first message */
+    isUserInitiated: boolean;
+    threadId?: string | null;
+    /** Internal ID if we have one */
+    conversationId?: string | null;
+    messageCount: number;
+    /** ISO timestamp */
+    firstContactAt?: string | null;
+    /** ISO timestamp */
+    lastContactAt?: string | null;
+    prospectName?: string | null;
+    messages: PriorContactMessage[];
+}
+/**
+ * Response from prior contact check
+ */
+interface CheckPriorContactResponse {
+    /** True if ANY channel has contact */
+    hasPriorContact: boolean;
+    channelsChecked: string[];
+    channelsWithContact: string[];
+    contactHistory: ChannelContactHistory[];
+    /** True if result was served from cache */
+    cached?: boolean;
+}
+/**
+ * Identifier for a prospect in batch prior contact check
+ */
+interface BatchProspectIdentifier {
+    /** Unique identifier for this prospect (for mapping results) */
+    prospectId: string;
+    /** Email address to check */
+    email?: string | null;
+    /** LinkedIn profile URL */
+    linkedinUrl?: string | null;
+    /** LinkedIn provider ID */
+    providerId?: string | null;
+}
+/**
+ * Request to check prior contact for multiple prospects
+ */
+interface BatchCheckPriorContactRequest {
+    /** List of prospects to check (max 50) */
+    prospects: BatchProspectIdentifier[];
+    /** Channels to check: 'gmail', 'outlook', 'linkedin'. Default: all based on identifiers */
+    channels?: string[] | null;
+    /** Max messages per channel per prospect (1-10, default: 3) */
+    messageLimit?: number | null;
+    /** Force fresh check for all prospects, bypassing cache (default: false) */
+    skipCache?: boolean | null;
+}
+/**
+ * Prior contact result for a single prospect in batch
+ */
+interface ProspectPriorContactResult {
+    prospectId: string;
+    hasPriorContact: boolean;
+    channelsWithContact: string[];
+    contactHistory: ChannelContactHistory[];
+    /** True if this result was from cache */
+    cached?: boolean;
+    error?: string | null;
+}
+/**
+ * Response from batch prior contact check
+ */
+interface BatchCheckPriorContactResponse {
+    /** Keyed by prospect_id */
+    results: Record<string, ProspectPriorContactResult>;
+    /** Aggregated counts */
+    summary: {
+        total: number;
+        withContact: number;
+        withoutContact: number;
+        errors: number;
+        /** Number of results served from cache */
+        cached?: number;
+    };
+}
 
 declare class MessagingResource {
     private readonly http;
@@ -1728,6 +1867,115 @@ declare class MessagingResource {
      * Send multiple drafts with rate limiting
      */
     sendBatchDrafts(userId: string, request: BatchSendRequest): Promise<BatchSendResponse>;
+    /**
+     * Delete a single conversation and all its messages.
+     *
+     * @param conversationId - UUID of the conversation to delete
+     * @param userId - User ID or email
+     * @returns DeleteConversationResponse with success status and conversation_id
+     * @throws MessagingNotFoundError if conversation not found (404)
+     * @throws MessagingValidationError if conversation_id is invalid (400)
+     */
+    deleteConversation(conversationId: string, userId: string): Promise<DeleteConversationResponse>;
+    /**
+     * Delete all conversations for a project.
+     *
+     * **Warning:** This permanently deletes conversations and messages.
+     * Consider using unlinkConversationsFromProject() instead.
+     *
+     * @param projectId - UUID of the project
+     * @param userId - User ID or email
+     * @returns DeleteConversationsByProjectResponse with deleted count
+     */
+    deleteConversationsByProject(projectId: string, userId: string): Promise<DeleteConversationsByProjectResponse>;
+    /**
+     * Unlink conversations from a project without deleting them.
+     *
+     * This preserves conversation history by setting project_id = NULL.
+     * Recommended approach when deleting a project.
+     *
+     * @param projectId - UUID of the project
+     * @param userId - User ID or email
+     * @returns UnlinkConversationsResponse with unlinked count
+     */
+    unlinkConversationsFromProject(projectId: string, userId: string): Promise<UnlinkConversationsResponse>;
+    /**
+     * Check if there has been any prior contact with a person across all channels.
+     *
+     * This searches your connected messaging accounts (Gmail, Outlook, LinkedIn) to find
+     * any historical communication with a person, even if they're not in the system as a prospect.
+     *
+     * **Use cases:**
+     * - Before adding a new prospect, check if you've already contacted them
+     * - Detect duplicate outreach across different systems
+     * - Find historical conversation context before sending a new message
+     *
+     * **Required:** At least one of `email`, `linkedinUrl`, or `providerId` must be provided.
+     *
+     * **Channels:**
+     * - If `channels` is not specified, checks all channels based on identifiers provided:
+     *   - `email` → checks Gmail and Outlook
+     *   - `linkedinUrl` or `providerId` → checks LinkedIn
+     * - Specify `channels` to limit which accounts to search (e.g., `["linkedin"]`)
+     *
+     * **Returns:**
+     * - `hasPriorContact`: True if ANY communication exists on ANY channel
+     * - `channelsChecked`: List of channels that were searched
+     * - `channelsWithContact`: List of channels where contact was found
+     * - `contactHistory`: Per-channel details including:
+     *   - `isUserInitiated`: True if you sent the first message
+     *   - `messages`: Most recent N messages (configurable via `messageLimit`)
+     *   - `firstContactAt` / `lastContactAt`: Timestamps of first and last messages
+     * - `cached`: True if result was served from cache (results are cached for 2 hours)
+     *
+     * **Caching:**
+     * - Results are cached in Redis for 2 hours to improve performance
+     * - Set `skipCache: true` to force a fresh check
+     *
+     * @param userId - User ID or email
+     * @param request - CheckPriorContactRequest with identifiers and options
+     * @returns CheckPriorContactResponse with contact history
+     * @throws MessagingValidationError if no identifier provided
+     */
+    checkPriorContact(userId: string, request: CheckPriorContactRequest): Promise<CheckPriorContactResponse>;
+    /**
+     * Check prior contact for multiple prospects at once (parallelized).
+     *
+     * This is the batch version of `checkPriorContact` for efficiently checking
+     * many prospects at once. Useful when importing a list of prospects and need to
+     * identify which ones have been contacted before.
+     *
+     * **Limits:**
+     * - Max 50 prospects per request
+     * - Max 10 messages per channel per prospect (to keep response size manageable)
+     *
+     * **Request:**
+     * ```typescript
+     * {
+     *   prospects: [
+     *     { prospectId: "p1", email: "john@acme.com" },
+     *     { prospectId: "p2", linkedinUrl: "https://linkedin.com/in/jane" },
+     *     { prospectId: "p3", email: "bob@xyz.com", linkedinUrl: "https://linkedin.com/in/bob" }
+     *   ],
+     *   channels: ["gmail", "linkedin"],  // Optional
+     *   messageLimit: 3  // Messages per channel (default: 3)
+     * }
+     * ```
+     *
+     * **Response:**
+     * - `results`: Dict keyed by `prospectId` with contact history for each
+     * - `summary`: Aggregated counts {total, withContact, withoutContact, errors, cached}
+     *
+     * **Caching:**
+     * - Results are cached in Redis for 2 hours to improve performance
+     * - Set `skipCache: true` to force fresh checks for all prospects
+     *
+     * @param userId - User ID or email
+     * @param request - BatchCheckPriorContactRequest with prospects and options
+     * @returns BatchCheckPriorContactResponse with results keyed by prospectId
+     * @throws MessagingValidationError if any prospect lacks identifiers
+     */
+    batchCheckPriorContact(userId: string, request: BatchCheckPriorContactRequest): Promise<BatchCheckPriorContactResponse>;
 }
 
 declare class ModelPreferencesResource {
@@ -2320,4 +2568,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { 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 BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftRequest, type BatchDraftResponse, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelResponseResponse, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, 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 DisconnectRequest, type DisconnectResponse, type DraftResponse, 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, IntegrationsResource, InternalServerError, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInSendRequest, 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 ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, 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, type UUID, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, LumnisClient as default, displayProgress, formatProgressEntry, verifyWebhookSignature };
+export { 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 BatchDraftRequest, type BatchDraftResponse, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, 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, 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, IntegrationsResource, InternalServerError, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInSendRequest, 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, 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, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, LumnisClient as default, displayProgress, formatProgressEntry, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1626,6 +1626,145 @@ interface BatchSendResponse {
     failed: number;
     queued: number;
 }
+/**
+ * Response from deleting a single conversation
+ */
+interface DeleteConversationResponse {
+    success: boolean;
+    conversation_id: string;
+}
+/**
+ * Response from deleting conversations by project
+ */
+interface DeleteConversationsByProjectResponse {
+    success: boolean;
+    project_id: string;
+    deleted_count: number;
+}
+/**
+ * Response from unlinking conversations from project
+ */
+interface UnlinkConversationsResponse {
+    success: boolean;
+    project_id: string;
+    unlinked_count: number;
+}
+/**
+ * Request to check if there's been prior contact with a person
+ */
+interface CheckPriorContactRequest {
+    /** Email address to check (for Gmail/Outlook) */
+    email?: string | null;
+    /** LinkedIn profile URL to check */
+    linkedinUrl?: string | null;
+    /** LinkedIn provider ID to check */
+    providerId?: string | null;
+    /** Channels to check: 'gmail', 'outlook', 'linkedin'. Default: all connected channels */
+    channels?: string[] | null;
+    /** Max messages to return per channel (1-20, default: 5) */
+    messageLimit?: number | null;
+    /** Force fresh check, bypassing cache (default: false) */
+    skipCache?: boolean | null;
+}
+/**
+ * A message from prior contact history
+ */
+interface PriorContactMessage {
+    id: string;
+    /** 'inbound' | 'outbound' */
+    direction: string;
+    content: string;
+    subject?: string | null;
+    senderName: string;
+    /** ISO timestamp */
+    sentAt: string;
+}
+/**
+ * Contact history for a single channel
+ */
+interface ChannelContactHistory {
+    /** 'gmail' | 'outlook' | 'linkedin' */
+    channel: string;
+    hasContact: boolean;
+    /** True if user sent first message */
+    isUserInitiated: boolean;
+    threadId?: string | null;
+    /** Internal ID if we have one */
+    conversationId?: string | null;
+    messageCount: number;
+    /** ISO timestamp */
+    firstContactAt?: string | null;
+    /** ISO timestamp */
+    lastContactAt?: string | null;
+    prospectName?: string | null;
+    messages: PriorContactMessage[];
+}
+/**
+ * Response from prior contact check
+ */
+interface CheckPriorContactResponse {
+    /** True if ANY channel has contact */
+    hasPriorContact: boolean;
+    channelsChecked: string[];
+    channelsWithContact: string[];
+    contactHistory: ChannelContactHistory[];
+    /** True if result was served from cache */
+    cached?: boolean;
+}
+/**
+ * Identifier for a prospect in batch prior contact check
+ */
+interface BatchProspectIdentifier {
+    /** Unique identifier for this prospect (for mapping results) */
+    prospectId: string;
+    /** Email address to check */
+    email?: string | null;
+    /** LinkedIn profile URL */
+    linkedinUrl?: string | null;
+    /** LinkedIn provider ID */
+    providerId?: string | null;
+}
+/**
+ * Request to check prior contact for multiple prospects
+ */
+interface BatchCheckPriorContactRequest {
+    /** List of prospects to check (max 50) */
+    prospects: BatchProspectIdentifier[];
+    /** Channels to check: 'gmail', 'outlook', 'linkedin'. Default: all based on identifiers */
+    channels?: string[] | null;
+    /** Max messages per channel per prospect (1-10, default: 3) */
+    messageLimit?: number | null;
+    /** Force fresh check for all prospects, bypassing cache (default: false) */
+    skipCache?: boolean | null;
+}
+/**
+ * Prior contact result for a single prospect in batch
+ */
+interface ProspectPriorContactResult {
+    prospectId: string;
+    hasPriorContact: boolean;
+    channelsWithContact: string[];
+    contactHistory: ChannelContactHistory[];
+    /** True if this result was from cache */
+    cached?: boolean;
+    error?: string | null;
+}
+/**
+ * Response from batch prior contact check
+ */
+interface BatchCheckPriorContactResponse {
+    /** Keyed by prospect_id */
+    results: Record<string, ProspectPriorContactResult>;
+    /** Aggregated counts */
+    summary: {
+        total: number;
+        withContact: number;
+        withoutContact: number;
+        errors: number;
+        /** Number of results served from cache */
+        cached?: number;
+    };
+}
 
 declare class MessagingResource {
     private readonly http;
@@ -1728,6 +1867,115 @@ declare class MessagingResource {
      * Send multiple drafts with rate limiting
      */
     sendBatchDrafts(userId: string, request: BatchSendRequest): Promise<BatchSendResponse>;
+    /**
+     * Delete a single conversation and all its messages.
+     *
+     * @param conversationId - UUID of the conversation to delete
+     * @param userId - User ID or email
+     * @returns DeleteConversationResponse with success status and conversation_id
+     * @throws MessagingNotFoundError if conversation not found (404)
+     * @throws MessagingValidationError if conversation_id is invalid (400)
+     */
+    deleteConversation(conversationId: string, userId: string): Promise<DeleteConversationResponse>;
+    /**
+     * Delete all conversations for a project.
+     *
+     * **Warning:** This permanently deletes conversations and messages.
+     * Consider using unlinkConversationsFromProject() instead.
+     *
+     * @param projectId - UUID of the project
+     * @param userId - User ID or email
+     * @returns DeleteConversationsByProjectResponse with deleted count
+     */
+    deleteConversationsByProject(projectId: string, userId: string): Promise<DeleteConversationsByProjectResponse>;
+    /**
+     * Unlink conversations from a project without deleting them.
+     *
+     * This preserves conversation history by setting project_id = NULL.
+     * Recommended approach when deleting a project.
+     *
+     * @param projectId - UUID of the project
+     * @param userId - User ID or email
+     * @returns UnlinkConversationsResponse with unlinked count
+     */
+    unlinkConversationsFromProject(projectId: string, userId: string): Promise<UnlinkConversationsResponse>;
+    /**
+     * Check if there has been any prior contact with a person across all channels.
+     *
+     * This searches your connected messaging accounts (Gmail, Outlook, LinkedIn) to find
+     * any historical communication with a person, even if they're not in the system as a prospect.
+     *
+     * **Use cases:**
+     * - Before adding a new prospect, check if you've already contacted them
+     * - Detect duplicate outreach across different systems
+     * - Find historical conversation context before sending a new message
+     *
+     * **Required:** At least one of `email`, `linkedinUrl`, or `providerId` must be provided.
+     *
+     * **Channels:**
+     * - If `channels` is not specified, checks all channels based on identifiers provided:
+     *   - `email` → checks Gmail and Outlook
+     *   - `linkedinUrl` or `providerId` → checks LinkedIn
+     * - Specify `channels` to limit which accounts to search (e.g., `["linkedin"]`)
+     *
+     * **Returns:**
+     * - `hasPriorContact`: True if ANY communication exists on ANY channel
+     * - `channelsChecked`: List of channels that were searched
+     * - `channelsWithContact`: List of channels where contact was found
+     * - `contactHistory`: Per-channel details including:
+     *   - `isUserInitiated`: True if you sent the first message
+     *   - `messages`: Most recent N messages (configurable via `messageLimit`)
+     *   - `firstContactAt` / `lastContactAt`: Timestamps of first and last messages
+     * - `cached`: True if result was served from cache (results are cached for 2 hours)
+     *
+     * **Caching:**
+     * - Results are cached in Redis for 2 hours to improve performance
+     * - Set `skipCache: true` to force a fresh check
+     *
+     * @param userId - User ID or email
+     * @param request - CheckPriorContactRequest with identifiers and options
+     * @returns CheckPriorContactResponse with contact history
+     * @throws MessagingValidationError if no identifier provided
+     */
+    checkPriorContact(userId: string, request: CheckPriorContactRequest): Promise<CheckPriorContactResponse>;
+    /**
+     * Check prior contact for multiple prospects at once (parallelized).
+     *
+     * This is the batch version of `checkPriorContact` for efficiently checking
+     * many prospects at once. Useful when importing a list of prospects and need to
+     * identify which ones have been contacted before.
+     *
+     * **Limits:**
+     * - Max 50 prospects per request
+     * - Max 10 messages per channel per prospect (to keep response size manageable)
+     *
+     * **Request:**
+     * ```typescript
+     * {
+     *   prospects: [
+     *     { prospectId: "p1", email: "john@acme.com" },
+     *     { prospectId: "p2", linkedinUrl: "https://linkedin.com/in/jane" },
+     *     { prospectId: "p3", email: "bob@xyz.com", linkedinUrl: "https://linkedin.com/in/bob" }
+     *   ],
+     *   channels: ["gmail", "linkedin"],  // Optional
+     *   messageLimit: 3  // Messages per channel (default: 3)
+     * }
+     * ```
+     *
+     * **Response:**
+     * - `results`: Dict keyed by `prospectId` with contact history for each
+     * - `summary`: Aggregated counts {total, withContact, withoutContact, errors, cached}
+     *
+     * **Caching:**
+     * - Results are cached in Redis for 2 hours to improve performance
+     * - Set `skipCache: true` to force fresh checks for all prospects
+     *
+     * @param userId - User ID or email
+     * @param request - BatchCheckPriorContactRequest with prospects and options
+     * @returns BatchCheckPriorContactResponse with results keyed by prospectId
+     * @throws MessagingValidationError if any prospect lacks identifiers
+     */
+    batchCheckPriorContact(userId: string, request: BatchCheckPriorContactRequest): Promise<BatchCheckPriorContactResponse>;
 }
 
 declare class ModelPreferencesResource {
@@ -2321,4 +2569,4 @@ declare class ProgressTracker {
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
 export = LumnisClient;
-export { 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 BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftRequest, type BatchDraftResponse, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelResponseResponse, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, 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 DisconnectRequest, type DisconnectResponse, type DraftResponse, 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, IntegrationsResource, InternalServerError, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInSendRequest, 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 ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProspectConnectionCheck, type ProspectInfo, type ProspectSyncIdentifier, type ProspectSyncResult, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, 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, type UUID, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, displayProgress, formatProgressEntry, verifyWebhookSignature };
+export { 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 BatchDraftRequest, type BatchDraftResponse, type BatchProspectIdentifier, type BatchSendRequest, type BatchSendResponse, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, 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, 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, IntegrationsResource, InternalServerError, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInSendRequest, 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, 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, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateLinkedInSubscriptionRequest, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, type WebhookEvent, type WebhookPayload, displayProgress, formatProgressEntry, verifyWebhookSignature };

package/dist/index.mjs

@@ -749,6 +749,204 @@ class MessagingResource {
       request
     );
   }
+  /**
+   * Delete a single conversation and all its messages.
+   *
+   * @param conversationId - UUID of the conversation to delete
+   * @param userId - User ID or email
+   * @returns DeleteConversationResponse with success status and conversation_id
+   * @throws MessagingNotFoundError if conversation not found (404)
+   * @throws MessagingValidationError if conversation_id is invalid (400)
+   */
+  async deleteConversation(conversationId, userId) {
+    try {
+      const queryParams = new URLSearchParams();
+      queryParams.append("user_id", userId);
+      return await this.http.delete(
+        `/messaging/conversations/${encodeURIComponent(conversationId)}?${queryParams.toString()}`
+      );
+    } catch (error) {
+      if (error instanceof NotFoundError) {
+        throw new MessagingNotFoundError(
+          `Conversation ${conversationId} not found`
+        );
+      }
+      if (error instanceof ValidationError) {
+        throw new MessagingValidationError(
+          `Invalid conversation ID: ${conversationId}`
+        );
+      }
+      throw error;
+    }
+  }
+  /**
+   * Delete all conversations for a project.
+   *
+   * **Warning:** This permanently deletes conversations and messages.
+   * Consider using unlinkConversationsFromProject() instead.
+   *
+   * @param projectId - UUID of the project
+   * @param userId - User ID or email
+   * @returns DeleteConversationsByProjectResponse with deleted count
+   */
+  async deleteConversationsByProject(projectId, userId) {
+    const queryParams = new URLSearchParams();
+    queryParams.append("project_id", projectId);
+    queryParams.append("user_id", userId);
+    return this.http.delete(
+      `/messaging/conversations?${queryParams.toString()}`
+    );
+  }
+  /**
+   * Unlink conversations from a project without deleting them.
+   *
+   * This preserves conversation history by setting project_id = NULL.
+   * Recommended approach when deleting a project.
+   *
+   * @param projectId - UUID of the project
+   * @param userId - User ID or email
+   * @returns UnlinkConversationsResponse with unlinked count
+   */
+  async unlinkConversationsFromProject(projectId, userId) {
+    const queryParams = new URLSearchParams();
+    queryParams.append("project_id", projectId);
+    queryParams.append("user_id", userId);
+    return this.http.post(
+      `/messaging/conversations/unlink-project?${queryParams.toString()}`,
+      null
+    );
+  }
+  /**
+   * Check if there has been any prior contact with a person across all channels.
+   *
+   * This searches your connected messaging accounts (Gmail, Outlook, LinkedIn) to find
+   * any historical communication with a person, even if they're not in the system as a prospect.
+   *
+   * **Use cases:**
+   * - Before adding a new prospect, check if you've already contacted them
+   * - Detect duplicate outreach across different systems
+   * - Find historical conversation context before sending a new message
+   *
+   * **Required:** At least one of `email`, `linkedinUrl`, or `providerId` must be provided.
+   *
+   * **Channels:**
+   * - If `channels` is not specified, checks all channels based on identifiers provided:
+   *   - `email` → checks Gmail and Outlook
+   *   - `linkedinUrl` or `providerId` → checks LinkedIn
+   * - Specify `channels` to limit which accounts to search (e.g., `["linkedin"]`)
+   *
+   * **Returns:**
+   * - `hasPriorContact`: True if ANY communication exists on ANY channel
+   * - `channelsChecked`: List of channels that were searched
+   * - `channelsWithContact`: List of channels where contact was found
+   * - `contactHistory`: Per-channel details including:
+   *   - `isUserInitiated`: True if you sent the first message
+   *   - `messages`: Most recent N messages (configurable via `messageLimit`)
+   *   - `firstContactAt` / `lastContactAt`: Timestamps of first and last messages
+   * - `cached`: True if result was served from cache (results are cached for 2 hours)
+   *
+   * **Caching:**
+   * - Results are cached in Redis for 2 hours to improve performance
+   * - Set `skipCache: true` to force a fresh check
+   *
+   * @param userId - User ID or email
+   * @param request - CheckPriorContactRequest with identifiers and options
+   * @returns CheckPriorContactResponse with contact history
+   * @throws MessagingValidationError if no identifier provided
+   */
+  async checkPriorContact(userId, request) {
+    if (!request.email && !request.linkedinUrl && !request.providerId) {
+      throw new MessagingValidationError(
+        "At least one of email, linkedinUrl, or providerId must be provided",
+        { code: "VALIDATION_ERROR" }
+      );
+    }
+    const queryParams = new URLSearchParams();
+    queryParams.append("user_id", userId);
+    const payload = {};
+    if (request.email) payload.email = request.email;
+    if (request.linkedinUrl) payload.linkedin_url = request.linkedinUrl;
+    if (request.providerId) payload.provider_id = request.providerId;
+    if (request.channels) payload.channels = request.channels;
+    if (request.messageLimit !== void 0 && request.messageLimit !== null) {
+      payload.message_limit = request.messageLimit;
+    }
+    if (request.skipCache !== void 0 && request.skipCache !== null) {
+      payload.skip_cache = request.skipCache;
+    }
+    return this.http.post(
+      `/messaging/check-prior-contact?${queryParams.toString()}`,
+      payload
+    );
+  }
+  /**
+   * Check prior contact for multiple prospects at once (parallelized).
+   *
+   * This is the batch version of `checkPriorContact` for efficiently checking
+   * many prospects at once. Useful when importing a list of prospects and need to
+   * identify which ones have been contacted before.
+   *
+   * **Limits:**
+   * - Max 50 prospects per request
+   * - Max 10 messages per channel per prospect (to keep response size manageable)
+   *
+   * **Request:**
+   * ```typescript
+   * {
+   *   prospects: [
+   *     { prospectId: "p1", email: "john@acme.com" },
+   *     { prospectId: "p2", linkedinUrl: "https://linkedin.com/in/jane" },
+   *     { prospectId: "p3", email: "bob@xyz.com", linkedinUrl: "https://linkedin.com/in/bob" }
+   *   ],
+   *   channels: ["gmail", "linkedin"],  // Optional
+   *   messageLimit: 3  // Messages per channel (default: 3)
+   * }
+   * ```
+   *
+   * **Response:**
+   * - `results`: Dict keyed by `prospectId` with contact history for each
+   * - `summary`: Aggregated counts {total, withContact, withoutContact, errors, cached}
+   *
+   * **Caching:**
+   * - Results are cached in Redis for 2 hours to improve performance
+   * - Set `skipCache: true` to force fresh checks for all prospects
+   *
+   * @param userId - User ID or email
+   * @param request - BatchCheckPriorContactRequest with prospects and options
+   * @returns BatchCheckPriorContactResponse with results keyed by prospectId
+   * @throws MessagingValidationError if any prospect lacks identifiers
+   */
+  async batchCheckPriorContact(userId, request) {
+    for (const prospect of request.prospects) {
+      if (!prospect.email && !prospect.linkedinUrl && !prospect.providerId) {
+        throw new MessagingValidationError(
+          `Prospect '${prospect.prospectId}' must have at least one of: email, linkedinUrl, or providerId`,
+          { code: "VALIDATION_ERROR" }
+        );
+      }
+    }
+    const queryParams = new URLSearchParams();
+    queryParams.append("user_id", userId);
+    const payload = {
+      prospects: request.prospects.map((p) => ({
+        prospect_id: p.prospectId,
+        email: p.email || void 0,
+        linkedin_url: p.linkedinUrl || void 0,
+        provider_id: p.providerId || void 0
+      }))
+    };
+    if (request.channels) payload.channels = request.channels;
+    if (request.messageLimit !== void 0 && request.messageLimit !== null) {
+      payload.message_limit = request.messageLimit;
+    }
+    if (request.skipCache !== void 0 && request.skipCache !== null) {
+      payload.skip_cache = request.skipCache;
+    }
+    return this.http.post(
+      `/messaging/check-prior-contact/batch?${queryParams.toString()}`,
+      payload
+    );
+  }
 }
 
 class ModelPreferencesResource {

package/package.json

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