lumnisai 0.1.7 → 0.1.9

package/dist/index.d.cts

@@ -104,6 +104,7 @@ interface ConnectionStatusResponse {
     status: ConnectionStatus;
     connectedAt?: string | null;
     errorMessage?: string | null;
+    isEnabled?: boolean;
 }
 interface ConnectionInfo {
     connectionId: string | null;
@@ -183,6 +184,7 @@ interface GetConnectionStatusParams {
     userId: string;
     appName: string;
     provider?: ProviderType;
+    includeEnabled?: boolean;
 }
 interface GetUserConnectionsParams {
     userId: string;
@@ -198,6 +200,34 @@ interface UpdateAppStatusParams {
     enabled: boolean;
     provider?: ProviderType;
 }
+/**
+ * Request parameters for batch connection status check
+ */
+interface BatchConnectionRequest {
+    userId: string;
+    appNames: string[];
+    provider?: ProviderType;
+    includeEnabledStatus?: boolean;
+}
+/**
+ * Connection status in batch response
+ */
+interface BatchConnectionStatus {
+    appName: string;
+    status: ConnectionStatus;
+    connectedAt: string | null;
+    isEnabled: boolean;
+    errorMessage: string | null;
+}
+/**
+ * Response from batch connection status check
+ */
+interface BatchConnectionResponse {
+    userId: string;
+    connections: BatchConnectionStatus[];
+    totalChecked: number;
+    activeCount: number;
+}
 
 type MCPTransport = 'stdio' | 'streamable_http' | 'sse';
 type MCPScope = 'tenant' | 'user';
@@ -296,6 +326,170 @@ interface ModelAvailability {
     requiresApiKey: boolean;
 }
 
+/**
+ * Available people search data sources
+ */
+declare enum PeopleDataSource {
+    PDL = "PDL",
+    CORESIGNAL = "CORESIGNAL",
+    CRUST_DATA = "CRUST_DATA"
+}
+/**
+ * Salary range projection data.
+ * Note: Values represent total compensation (base salary + bonuses + equity),
+ * not just base salary. Only available for CoreSignal results.
+ */
+interface SalaryRange {
+    /** Minimum total compensation (includes base + bonuses + equity, etc.) */
+    min?: number;
+    /** Median total compensation projection */
+    median?: number;
+    /** Maximum total compensation (includes base + bonuses + equity, etc.) */
+    max?: number;
+    /** Currency code (e.g., "USD", "EUR") */
+    currency?: string;
+    /** Period (e.g., "yearly", "monthly") */
+    period?: string;
+}
+/**
+ * Simplified person result model returned in search results.
+ * Contains normalized data from multiple sources (PDL, CoreSignal, CrustData).
+ */
+interface PersonResult {
+    /** Unique identifier for the person */
+    id: string;
+    /** Full name */
+    name: string;
+    /** Current job title */
+    currentTitle?: string;
+    /** Current company name */
+    currentCompany?: string;
+    /** Current department */
+    currentDepartment?: string;
+    /** Full location string */
+    location?: string;
+    /** City */
+    city?: string;
+    /** Country */
+    country?: string;
+    /** Primary email address */
+    email?: string;
+    /** List of email addresses (up to 3) */
+    emails: string[];
+    /** LinkedIn profile URL */
+    linkedinUrl?: string;
+    /** Years of professional experience */
+    yearsExperience?: number;
+    /** List of skills (up to 15) */
+    skills: string[];
+    /** Seniority level (e.g., "Senior", "Director", "VP") */
+    seniorityLevel?: string;
+    /** Whether person is identified as a decision maker */
+    isDecisionMaker: boolean;
+    /** Number of LinkedIn connections */
+    connectionsCount?: number;
+    /** Whether person recently changed jobs */
+    recentlyChangedJobs: boolean;
+    /** Data source identifier ("PDL", "CORESIGNAL", or "CRUST_DATA") */
+    source: string;
+    /** Confidence score (0.0-1.0) if available */
+    confidenceScore?: number;
+    /** Salary range projection (CoreSignal only) */
+    salaryRange?: SalaryRange;
+    /** Number of certifications (CoreSignal only) */
+    certificationsCount?: number;
+    /** List of languages spoken (CoreSignal only) */
+    languages?: string[];
+    /** List of education degrees (CoreSignal only, up to 3) */
+    educationDegrees?: string[];
+}
+/**
+ * Request model for people search queries.
+ */
+interface PeopleSearchRequest {
+    /**
+     * Natural language search query describing the people you want to find.
+     * Examples:
+     * - "Senior software engineers in San Francisco with Python skills"
+     * - "Product managers at Google or Meta with MBA"
+     * - "Data scientists in NYC with 5+ years experience"
+     */
+    query: string;
+    /**
+     * Maximum number of results to return.
+     * Range: 1-100
+     * Default: 20
+     */
+    limit?: number;
+    /**
+     * Specific data sources to use for the search.
+     * If not provided, all available sources will be used.
+     * Valid values: "PDL", "CORESIGNAL", "CRUST_DATA"
+     *
+     * Note: The API accepts string values. SDKs should use enums for type safety
+     * but serialize them as strings when sending the request.
+     */
+    dataSources?: PeopleDataSource[];
+}
+/**
+ * Logic operator for filter values
+ */
+type FilterLogic = 'or' | 'and' | 'should';
+/**
+ * A filter with values and logic operator.
+ * Used in applied_filters response.
+ */
+interface FilterValue {
+    /** List of values for this filter */
+    values: string[];
+    /**
+     * Logic operator:
+     * - "or": ANY value matches (for alternatives like "SF or NYC")
+     * - "and": ALL values must match (for "must have Python AND Java")
+     * - "should": Optional/preferred (for "preferably PhD")
+     */
+    logic: FilterLogic;
+}
+/**
+ * Structure of the applied_filters field in the response.
+ * Contains extracted filters from the natural language query.
+ */
+interface AppliedFilters {
+    /** Cities for the search */
+    cities?: FilterValue;
+    /** Countries for the search */
+    countries?: FilterValue;
+    /** Job titles/roles */
+    jobTitles?: FilterValue;
+    /** Company names */
+    companies?: FilterValue;
+    /** Technical skills */
+    skills?: FilterValue;
+    /** Minimum years of professional experience */
+    minYearsExperience?: number;
+    /** Seniority levels (entry/junior/mid/senior/lead/principal/staff/director/vp/executive) */
+    seniorityLevels?: FilterValue;
+    /** Education levels (bachelors/masters/phd/mba) */
+    educationLevels?: FilterValue;
+    /** Industries/sectors */
+    industries?: FilterValue;
+}
+/**
+ * Response model for people search endpoint.
+ */
+interface PeopleSearchResponse {
+    /** List of matching candidates */
+    candidates: PersonResult[];
+    /** Total number of unique candidates found (may be more than returned) */
+    totalFound: number;
+    /** Filters extracted and applied from the query */
+    appliedFilters: AppliedFilters;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** List of data sources that were actually used */
+    dataSourcesUsed: string[];
+}
+
 type ResponseStatus = 'queued' | 'in_progress' | 'succeeded' | 'failed' | 'cancelled';
 interface FileAttachment {
     name: string;
@@ -320,6 +514,25 @@ interface AgentConfig {
 interface ModelOverrides {
     [key: string]: string;
 }
+/**
+ * Available specialized agents
+ */
+type SpecializedAgentType = 'quick_people_search';
+/**
+ * Parameters for specialized agent execution
+ */
+interface SpecializedAgentParams {
+    /**
+     * Maximum number of results (1-100)
+     * Agent-specific: For quick_people_search, limits the number of candidates returned
+     */
+    limit?: number;
+    /**
+     * Specific data sources to use (agent-specific)
+     * For quick_people_search: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     */
+    dataSources?: string[];
+}
 interface CreateResponseRequest {
     threadId?: UUID;
     messages: Message[];
@@ -330,6 +543,15 @@ interface CreateResponseRequest {
     responseFormat?: Record<string, any>;
     responseFormatInstructions?: string;
     modelOverrides?: ModelOverrides;
+    /**
+     * Route to a specialized agent instead of the main Lumnis agent
+     * Available agents: 'quick_people_search'
+     */
+    specializedAgent?: SpecializedAgentType;
+    /**
+     * Parameters specific to the specialized agent
+     */
+    specializedAgentParams?: SpecializedAgentParams;
 }
 interface ProgressEntry {
     ts: string;
@@ -430,6 +652,18 @@ interface FeedbackListResponse {
     feedback: FeedbackObject[];
     note: string;
 }
+/**
+ * Structured output from quick_people_search specialized agent
+ * This will be available in ResponseObject.structuredResponse
+ * Note: PersonResult is imported from './people' to avoid duplication
+ */
+interface QuickPeopleSearchOutput {
+    candidates: PersonResult[];
+    totalFound: number;
+    appliedFilters: Record<string, any>;
+    executionTimeMs: number;
+    dataSourcesUsed: string[];
+}
 
 interface SkillGuidelineBase {
     name: string;
@@ -870,6 +1104,11 @@ declare class IntegrationsResource {
      * Check the status of a specific connection
      */
     getConnectionStatus(params: GetConnectionStatusParams): Promise<ConnectionStatusResponse>;
+    /**
+     * Check connection status for multiple apps in a single request
+     * Optimized for onboarding flows - checks multiple connections in parallel
+     */
+    getConnectionsBatch(params: BatchConnectionRequest): Promise<BatchConnectionResponse>;
     /**
      * Get all connections for a user
      */
@@ -973,199 +1212,553 @@ declare class MCPServersResource {
     }): Promise<TestConnectionResponse>;
 }
 
-declare class ModelPreferencesResource {
-    private readonly http;
-    constructor(http: Http);
-    /**
-     * Get all model preferences for the tenant
-     */
-    get(includeDefaults?: boolean): Promise<TenantModelPreferencesResponse>;
-    /**
-     * Update multiple model preferences in a single request
-     */
-    updateBulk(data: ModelPreferencesBulkUpdate): Promise<TenantModelPreferencesResponse>;
-    /**
-     * Update a specific model type preference
-     */
-    update(modelType: ModelType, data: ModelPreferenceCreate): Promise<TenantModelPreference>;
-    /**
-     * Delete a model preference to revert to system default
-     */
-    delete(modelType: ModelType): Promise<void>;
-    /**
-     * Check which models are available based on API key configuration
-     */
-    checkAvailability(models: ModelPreferenceCreate[]): Promise<ModelAvailability[]>;
-    /**
-     * List all model preferences (alias for get)
-     */
-    list(params?: {
-        includeDefaults?: boolean;
-    }): Promise<TenantModelPreferencesResponse>;
+/**
+ * Channel types for messaging
+ */
+declare enum ChannelType {
+    GMAIL = "gmail",
+    OUTLOOK = "outlook",
+    LINKEDIN = "linkedin"
 }
-
 /**
- * Available people search data sources
+ * Outreach methods for LinkedIn
  */
-declare enum PeopleDataSource {
-    PDL = "PDL",
-    CORESIGNAL = "CORESIGNAL",
-    CRUST_DATA = "CRUST_DATA"
+declare enum OutreachMethod {
+    CONNECTION_REQUEST = "connection_request",
+    DIRECT_MESSAGE = "direct_message",
+    INMAIL = "inmail",
+    INMAIL_ESCALATION = "inmail_escalation",
+    EMAIL = "email"
 }
 /**
- * Salary range projection data.
- * Note: Values represent total compensation (base salary + bonuses + equity),
- * not just base salary. Only available for CoreSignal results.
+ * Conversation status types
  */
-interface SalaryRange {
-    /** Minimum total compensation (includes base + bonuses + equity, etc.) */
-    min?: number;
-    /** Median total compensation projection */
-    median?: number;
-    /** Maximum total compensation (includes base + bonuses + equity, etc.) */
-    max?: number;
-    /** Currency code (e.g., "USD", "EUR") */
-    currency?: string;
-    /** Period (e.g., "yearly", "monthly") */
-    period?: string;
+declare enum ConversationStatus {
+    ACTIVE = "active",
+    NEEDS_RESPONSE = "needs_response",
+    WAITING = "waiting",
+    BOOKED = "booked",
+    CLOSED = "closed"
 }
 /**
- * Simplified person result model returned in search results.
- * Contains normalized data from multiple sources (PDL, CoreSignal, CrustData).
+ * Message types in a conversation
  */
-interface PersonResult {
-    /** Unique identifier for the person */
-    id: string;
-    /** Full name */
+declare enum MessageType {
+    MESSAGE = "message",
+    CONNECTION_REQUEST = "connection_request",
+    CONNECTION_ACCEPTED = "connection_accepted",
+    INMAIL = "inmail"
+}
+/**
+ * Draft status types
+ */
+declare enum DraftStatus {
+    PENDING_REVIEW = "pending_review",
+    APPROVED = "approved",
+    SCHEDULED = "scheduled",
+    SENDING = "sending",
+    SENT = "sent",
+    FAILED = "failed",
+    DISCARDED = "discarded"
+}
+/**
+ * Sync job status types
+ */
+declare enum SyncJobStatus {
+    QUEUED = "queued",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/**
+ * Queue item status types
+ */
+declare enum QueueItemStatus {
+    QUEUED = "queued",
+    PROCESSING = "processing",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+/**
+ * LinkedIn subscription types
+ */
+declare enum LinkedInSubscriptionType {
+    BASIC = "basic",
+    PREMIUM = "premium",// Career Premium - 5 InMails/month
+    SALES_NAVIGATOR = "sales_navigator",
+    RECRUITER_LITE = "recruiter_lite",
+    RECRUITER_CORPORATE = "recruiter_corporate"
+}
+/**
+ * LinkedIn network distance values
+ */
+declare enum NetworkDistance {
+    FIRST_DEGREE = "FIRST_DEGREE",
+    SECOND_DEGREE = "SECOND_DEGREE",
+    THIRD_DEGREE = "THIRD_DEGREE",
+    OUT_OF_NETWORK = "OUT_OF_NETWORK"
+}
+/**
+ * Prospect identifier for sync operations
+ */
+interface ProspectSyncIdentifier {
+    prospectId?: string | null;
+    email?: string | null;
+    linkedinUrl?: string | null;
+    providerId?: string | null;
+}
+/**
+ * Request to sync conversations (prospects REQUIRED)
+ */
+interface SyncRequest {
+    channels?: string[] | null;
+    prospects: ProspectSyncIdentifier[];
+}
+/**
+ * Request to sync a single prospect
+ */
+interface SyncProspectRequest {
+    email?: string | null;
+    linkedinUrl?: string | null;
+    providerId?: string | null;
+    channel?: string | null;
+}
+/**
+ * Request to check LinkedIn connection
+ */
+interface CheckLinkedInConnectionRequest {
+    linkedinUrl?: string | null;
+    providerId?: string | null;
+}
+/**
+ * Request to send LinkedIn outreach
+ */
+interface LinkedInSendRequest {
+    prospectProviderId?: string | null;
+    prospectLinkedInUrl?: string | null;
+    prospectName: string;
+    content: string;
+    isPriority?: boolean;
+    enableEscalation?: boolean;
+    escalationDays?: number;
+    projectId?: string | null;
+    prospectExternalId?: string | null;
+}
+/**
+ * Request to send a message
+ */
+interface SendMessageRequest {
+    channel: string;
+    recipientId: string;
+    content: string;
+    conversationId?: string | null;
+    subject?: string | null;
+    recipientName?: string | null;
+    projectId?: string | null;
+    prospectExternalId?: string | null;
+}
+/**
+ * Request to reply to a conversation
+ */
+interface SendReplyRequest {
+    content: string;
+}
+/**
+ * Prospect connection check for batch operations
+ */
+interface ProspectConnectionCheck {
+    prospectId: string;
+    linkedinUrl?: string | null;
+    providerId?: string | null;
+}
+/**
+ * Request to batch check LinkedIn connections
+ */
+interface BatchCheckConnectionRequest {
+    prospects: ProspectConnectionCheck[];
+}
+/**
+ * Request to create a draft
+ */
+interface CreateDraftRequest {
+    channel: string;
+    content: string;
+    recipientEmail?: string | null;
+    recipientLinkedinUrl?: string | null;
+    recipientProviderId?: string | null;
+    recipientName?: string | null;
+    conversationId?: string | null;
+    projectId?: string | null;
+    prospectExternalId?: string | null;
+    subject?: string | null;
+    isPriority?: boolean;
+    outreachMethod?: string | null;
+}
+/**
+ * Prospect info for batch draft creation
+ */
+interface ProspectInfo {
+    externalId: string;
     name: string;
-    /** Current job title */
-    currentTitle?: string;
-    /** Current company name */
-    currentCompany?: string;
-    /** Current department */
-    currentDepartment?: string;
-    /** Full location string */
-    location?: string;
-    /** City */
-    city?: string;
-    /** Country */
-    country?: string;
-    /** Primary email address */
-    email?: string;
-    /** List of email addresses (up to 3) */
-    emails: string[];
-    /** LinkedIn profile URL */
-    linkedinUrl?: string;
-    /** Years of professional experience */
-    yearsExperience?: number;
-    /** List of skills (up to 15) */
-    skills: string[];
-    /** Seniority level (e.g., "Senior", "Director", "VP") */
-    seniorityLevel?: string;
-    /** Whether person is identified as a decision maker */
-    isDecisionMaker: boolean;
-    /** Number of LinkedIn connections */
-    connectionsCount?: number;
-    /** Whether person recently changed jobs */
-    recentlyChangedJobs: boolean;
-    /** Data source identifier ("PDL", "CORESIGNAL", or "CRUST_DATA") */
-    source: string;
-    /** Confidence score (0.0-1.0) if available */
-    confidenceScore?: number;
-    /** Salary range projection (CoreSignal only) */
-    salaryRange?: SalaryRange;
-    /** Number of certifications (CoreSignal only) */
-    certificationsCount?: number;
-    /** List of languages spoken (CoreSignal only) */
-    languages?: string[];
-    /** List of education degrees (CoreSignal only, up to 3) */
-    educationDegrees?: string[];
+    email?: string | null;
+    linkedinUrl?: string | null;
+    providerId?: string | null;
+    currentTitle?: string | null;
+    currentCompany?: string | null;
+    isPriority?: boolean;
+    selectedChannel?: string | null;
+    /** Outreach method to use for this prospect */
+    outreachMethod?: 'direct_message' | 'connection_request' | 'inmail' | 'email' | null;
+    /** Whether the user is already connected to this prospect on LinkedIn */
+    isConnected?: boolean | null;
 }
 /**
- * Request model for people search queries.
+ * Request to create batch drafts
  */
-interface PeopleSearchRequest {
-    /**
-     * Natural language search query describing the people you want to find.
-     * Examples:
-     * - "Senior software engineers in San Francisco with Python skills"
-     * - "Product managers at Google or Meta with MBA"
-     * - "Data scientists in NYC with 5+ years experience"
-     */
-    query: string;
-    /**
-     * Maximum number of results to return.
-     * Range: 1-100
-     * Default: 20
-     */
-    limit?: number;
-    /**
-     * Specific data sources to use for the search.
-     * If not provided, all available sources will be used.
-     * Valid values: "PDL", "CORESIGNAL", "CRUST_DATA"
-     *
-     * Note: The API accepts string values. SDKs should use enums for type safety
-     * but serialize them as strings when sending the request.
-     */
-    dataSources?: PeopleDataSource[];
+interface BatchDraftRequest {
+    prospects: ProspectInfo[];
+    projectId: string;
+    channel?: string;
+    subjectTemplate?: string | null;
+    contentTemplate?: string | null;
+    useAiGeneration?: boolean;
+    aiContext?: Record<string, any> | null;
 }
 /**
- * Logic operator for filter values
+ * Request to batch send drafts
  */
-type FilterLogic = 'or' | 'and' | 'should';
+interface BatchSendRequest {
+    draftIds: string[];
+    sendRatePerDay?: number;
+}
 /**
- * A filter with values and logic operator.
- * Used in applied_filters response.
+ * Request to update LinkedIn subscription
  */
-interface FilterValue {
-    /** List of values for this filter */
-    values: string[];
-    /**
-     * Logic operator:
-     * - "or": ANY value matches (for alternatives like "SF or NYC")
-     * - "and": ALL values must match (for "must have Python AND Java")
-     * - "should": Optional/preferred (for "preferably PhD")
-     */
-    logic: FilterLogic;
+interface UpdateLinkedInSubscriptionRequest {
+    subscriptionType: LinkedInSubscriptionType | string;
+    inmailCredits?: number | null;
 }
 /**
- * Structure of the applied_filters field in the response.
- * Contains extracted filters from the natural language query.
+ * Statistics from a sync operation
  */
-interface AppliedFilters {
-    /** Cities for the search */
-    cities?: FilterValue;
-    /** Countries for the search */
-    countries?: FilterValue;
-    /** Job titles/roles */
-    jobTitles?: FilterValue;
-    /** Company names */
-    companies?: FilterValue;
-    /** Technical skills */
-    skills?: FilterValue;
-    /** Minimum years of professional experience */
-    minYearsExperience?: number;
-    /** Seniority levels (entry/junior/mid/senior/lead/principal/staff/director/vp/executive) */
-    seniorityLevels?: FilterValue;
-    /** Education levels (bachelors/masters/phd/mba) */
-    educationLevels?: FilterValue;
-    /** Industries/sectors */
-    industries?: FilterValue;
+interface SyncStats {
+    synced: number;
+    created: number;
+    updated: number;
+    errors: number;
+    prospectsRequested?: number;
+    prospectsFound?: number;
 }
 /**
- * Response model for people search endpoint.
+ * Response from sync operations
  */
-interface PeopleSearchResponse {
-    /** List of matching candidates */
-    candidates: PersonResult[];
-    /** Total number of unique candidates found (may be more than returned) */
-    totalFound: number;
-    /** Filters extracted and applied from the query */
-    appliedFilters: AppliedFilters;
-    /** Execution time in milliseconds */
-    executionTimeMs: number;
-    /** List of data sources that were actually used */
-    dataSourcesUsed: string[];
+interface SyncJobResponse {
+    jobId: string;
+    status: SyncJobStatus | string;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    stats?: SyncStats | null;
+    error?: string | null;
+}
+/**
+ * Result for a single prospect sync
+ */
+interface ProspectSyncResult {
+    prospectId?: string | null;
+    email?: string | null;
+    linkedinUrl?: string | null;
+    conversationId?: string | null;
+    messagesSynced: number;
+    status: string;
+    error?: string | null;
+}
+/**
+ * Response from single prospect sync
+ */
+interface SyncProspectResponse {
+    result: ProspectSyncResult;
+    conversation?: ConversationSummary | null;
+}
+/**
+ * LinkedIn connection status
+ */
+interface LinkedInConnectionStatus {
+    connected: boolean;
+    providerId?: string | null;
+    chatId?: string | null;
+    canMessage: boolean;
+    canInmail: boolean;
+    isOpenProfile?: boolean;
+    networkDistance?: NetworkDistance | null;
+}
+/**
+ * Connection summary for batch operations
+ */
+interface ConnectionSummary {
+    total: number;
+    connected: number;
+    notConnected: number;
+}
+/**
+ * Response from batch connection check
+ */
+interface BatchConnectionStatusResponse {
+    results: Record<string, LinkedInConnectionStatus>;
+    summary: ConnectionSummary;
+}
+/**
+ * LinkedIn credits response
+ */
+interface LinkedInCreditsResponse {
+    subscriptionType?: string | null;
+    creditsRemaining?: number | null;
+    creditsUpdatedAt?: string | null;
+    isRealTime?: boolean;
+}
+/**
+ * Conversation summary
+ */
+interface ConversationSummary {
+    id: string;
+    channel: string;
+    outreachMethod?: string | null;
+    status: string;
+    prospectName: string;
+    prospectEmail?: string | null;
+    prospectCompany?: string | null;
+    prospectTitle?: string | null;
+    lastMessageAt?: string | null;
+    lastMessagePreview?: string | null;
+    messageCount: number;
+    aiSuggestedResponse?: string | null;
+    isLinkedinConnected?: boolean | null;
+    networkDistance?: NetworkDistance | null;
+    connectionRequestSentAt?: string | null;
+    connectionAcceptedAt?: string | null;
+    escalationScheduledFor?: string | null;
+    prospectExternalId?: string | null;
+    projectId?: string | null;
+}
+/**
+ * Message response
+ */
+interface MessageResponse {
+    id: string;
+    messageType?: string;
+    direction: string;
+    content: string;
+    subject?: string | null;
+    senderName: string;
+    sentAt: string;
+    aiGenerated?: boolean;
+}
+/**
+ * Conversation detail with messages
+ */
+interface ConversationDetail {
+    conversation: ConversationSummary;
+    messages: MessageResponse[];
+}
+/**
+ * Email thread summary
+ */
+interface EmailThreadSummary {
+    threadId: string;
+    subject?: string | null;
+    lastMessageAt: string;
+    messageCount: number;
+    preview?: string | null;
+    isLumnisInitiated: boolean;
+}
+/**
+ * Draft response
+ */
+interface DraftResponse {
+    id: string;
+    status: string;
+    content: string;
+    createdAt: string;
+    prospectExternalId?: string | null;
+    conversationId?: string | null;
+    /** Outreach method used for this draft: 'connection_request' | 'direct_message' | 'inmail' | 'email' */
+    outreachMethod?: 'direct_message' | 'connection_request' | 'inmail' | 'email' | null;
+}
+/**
+ * Response from batch draft creation
+ */
+interface BatchDraftResponse {
+    drafts: DraftResponse[];
+    created: number;
+    errors: number;
+    errorDetails?: Array<Record<string, any>> | null;
+}
+/**
+ * Send result (returned by reply, linkedin/send, drafts endpoints)
+ */
+interface SendResult {
+    success: boolean;
+    draftId?: string | null;
+    conversationId?: string | null;
+    messageId?: string | null;
+    outreachMethod?: string | null;
+    queued?: boolean | null;
+    isFreeInmail?: boolean | null;
+    error?: string | null;
+    errorCode?: string | null;
+    prospectExternalId?: string | null;
+}
+/**
+ * Response from the generic send message endpoint
+ */
+interface SendMessageResponse {
+    success: boolean;
+    messageId?: string | null;
+    conversationId?: string | null;
+    externalId?: string | null;
+}
+/**
+ * Response from batch send operation
+ */
+interface BatchSendResponse {
+    results: SendResult[];
+    sent: number;
+    failed: number;
+    queued: number;
+}
+
+declare class MessagingResource {
+    private readonly http;
+    constructor(http: Http);
+    /**
+     * Sync conversations from connected providers for specific prospects.
+     * Prospects list is REQUIRED.
+     */
+    syncConversations(userId: string, request: SyncRequest): Promise<SyncJobResponse>;
+    /**
+     * Sync conversation for a single prospect on-demand.
+     * Use when viewing a prospect's detail page.
+     */
+    syncProspect(userId: string, request: SyncProspectRequest): Promise<SyncProspectResponse>;
+    /**
+     * Get sync job status
+     */
+    getSyncStatus(jobId: string): Promise<SyncJobResponse>;
+    /**
+     * List conversations with filtering
+     */
+    listConversations(userId: string, params?: {
+        status?: string;
+        channel?: string;
+        projectId?: string;
+        networkDistance?: NetworkDistance | null;
+        limit?: number;
+        offset?: number;
+    }): Promise<ConversationSummary[]>;
+    /**
+     * Get all conversations for a project
+     */
+    listConversationsByProject(projectId: string, userId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ConversationSummary[]>;
+    /**
+     * Get conversation with messages
+     */
+    getConversation(conversationId: string, userId: string, params?: {
+        fetchLive?: boolean;
+    }): Promise<ConversationDetail>;
+    /**
+     * Send a message (creates new conversation or adds to existing)
+     */
+    sendMessage(userId: string, request: SendMessageRequest): Promise<SendMessageResponse>;
+    /**
+     * Reply to an existing conversation
+     */
+    replyToConversation(conversationId: string, userId: string, request: SendReplyRequest): Promise<SendResult>;
+    /**
+     * Get all email threads with a specific person
+     */
+    getEmailThreads(emailAddress: string, userId: string, params?: {
+        limit?: number;
+    }): Promise<EmailThreadSummary[]>;
+    /**
+     * Check if user is connected to a prospect on LinkedIn
+     */
+    checkLinkedInConnection(userId: string, request: CheckLinkedInConnectionRequest): Promise<LinkedInConnectionStatus>;
+    /**
+     * Batch check connection status for multiple prospects
+     */
+    batchCheckLinkedInConnections(userId: string, request: BatchCheckConnectionRequest): Promise<BatchConnectionStatusResponse>;
+    /**
+     * Smart LinkedIn outreach with automatic method selection
+     */
+    sendLinkedInOutreach(userId: string, request: LinkedInSendRequest): Promise<SendResult>;
+    /**
+     * Get InMail credit information.
+     * By default returns cached data. Set forceRefresh=true to fetch real-time data from Unipile API.
+     */
+    getLinkedInCredits(userId: string, options?: {
+        forceRefresh?: boolean;
+    }): Promise<LinkedInCreditsResponse>;
+    /**
+     * Force refresh InMail credits from Unipile API.
+     * Fetches real-time credit balance from provider and updates cache.
+     */
+    refreshLinkedInCredits(userId: string): Promise<LinkedInCreditsResponse>;
+    /**
+     * Update LinkedIn subscription type and credits
+     */
+    updateLinkedInSubscription(userId: string, request: UpdateLinkedInSubscriptionRequest): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Create a single draft message
+     */
+    createDraft(userId: string, request: CreateDraftRequest): Promise<DraftResponse>;
+    /**
+     * Create drafts for multiple prospects with AI generation
+     */
+    createBatchDrafts(userId: string, request: BatchDraftRequest): Promise<BatchDraftResponse>;
+    /**
+     * Approve and send a single draft
+     */
+    sendDraft(draftId: string, userId: string): Promise<SendResult>;
+    /**
+     * Send multiple drafts with rate limiting
+     */
+    sendBatchDrafts(userId: string, request: BatchSendRequest): Promise<BatchSendResponse>;
+}
+
+declare class ModelPreferencesResource {
+    private readonly http;
+    constructor(http: Http);
+    /**
+     * Get all model preferences for the tenant
+     */
+    get(includeDefaults?: boolean): Promise<TenantModelPreferencesResponse>;
+    /**
+     * Update multiple model preferences in a single request
+     */
+    updateBulk(data: ModelPreferencesBulkUpdate): Promise<TenantModelPreferencesResponse>;
+    /**
+     * Update a specific model type preference
+     */
+    update(modelType: ModelType, data: ModelPreferenceCreate): Promise<TenantModelPreference>;
+    /**
+     * Delete a model preference to revert to system default
+     */
+    delete(modelType: ModelType): Promise<void>;
+    /**
+     * Check which models are available based on API key configuration
+     */
+    checkAvailability(models: ModelPreferenceCreate[]): Promise<ModelAvailability[]>;
+    /**
+     * List all model preferences (alias for get)
+     */
+    list(params?: {
+        includeDefaults?: boolean;
+    }): Promise<TenantModelPreferencesResponse>;
 }
 
 declare class PeopleResource {
@@ -1257,6 +1850,23 @@ declare class ResponsesResource {
     listFeedback(responseId: string, options?: {
         progressId?: string;
     }): Promise<FeedbackListResponse>;
+    /**
+     * Perform a quick people search using the specialized quick_people_search agent
+     * @param query - Natural language search query (e.g., "Find engineers at Google in SF")
+     * @param options - Optional search parameters
+     * @param options.limit - Maximum number of results (1-100, default: 20)
+     * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * @returns Response with structured_response containing:
+     *   - candidates: List of person results
+     *   - totalFound: Total unique candidates found
+     *   - appliedFilters: Extracted search filters
+     *   - executionTimeMs: Search duration
+     *   - dataSourcesUsed: Which sources were queried
+     */
+    quickPeopleSearch(query: string, options?: {
+        limit?: number;
+        dataSources?: string[];
+    }): Promise<CreateResponseResponse>;
 }
 
 declare class SkillsResource {
@@ -1449,6 +2059,7 @@ declare class LumnisClient {
     readonly mcpServers: MCPServersResource;
     readonly skills: SkillsResource;
     readonly people: PeopleResource;
+    readonly messaging: MessagingResource;
     private readonly _scopedUserId?;
     private readonly _defaultScope;
     constructor(options?: LumnisClientOptions);
@@ -1483,6 +2094,16 @@ declare class LumnisClient {
     setAppEnabled(appName: string, enabled: boolean, provider?: string): Promise<UpdateAppStatusResponse>;
     initiateConnection(params: Parameters<IntegrationsResource['initiateConnection']>[0]): Promise<InitiateConnectionResponse>;
     getConnectionStatus(userId: string, appName: string, provider?: string): Promise<ConnectionStatusResponse>;
+    getConnectionStatus(userId: string, appName: string, options?: {
+        provider?: string;
+        includeEnabled?: boolean;
+    }): Promise<ConnectionStatusResponse>;
+    getConnectionsBatch(params: {
+        userId: string;
+        appNames: string[];
+        provider?: string;
+        includeEnabledStatus?: boolean;
+    }): Promise<BatchConnectionResponse>;
     listConnections(userId: string, params?: {
         appFilter?: string;
         provider?: string;
@@ -1552,6 +2173,79 @@ declare class SourcesNotAvailableError extends ValidationError {
     availableSources: string[];
     constructor(message: string, availableSources: string[]);
 }
+declare class MessagingAPIError extends LumnisError {
+    constructor(message: string, options?: LumnisErrorOptions);
+}
+declare class MessagingNotFoundError extends MessagingAPIError {
+    constructor(message: string, options?: LumnisErrorOptions);
+}
+declare class MessagingValidationError extends MessagingAPIError {
+    constructor(message: string, options?: LumnisErrorOptions);
+}
+declare class MessagingSendError extends MessagingAPIError {
+    constructor(message: string, options?: LumnisErrorOptions);
+}
+declare class MessagingConnectionError extends MessagingAPIError {
+    constructor(message: string, options?: LumnisErrorOptions);
+}
+
+/**
+ * Webhook event types
+ */
+type WebhookEvent = 'message.sent' | 'message.received' | 'connection.accepted';
+/**
+ * Base webhook payload structure
+ */
+interface WebhookPayload {
+    event: WebhookEvent;
+    data: MessageSentData | MessageReceivedData | ConnectionAcceptedData;
+    timestamp: string;
+}
+/**
+ * Data payload for message.sent event
+ * Sent when a queued message is actually sent by the queue processor
+ */
+interface MessageSentData {
+    conversationId: string;
+    prospectExternalId: string;
+    projectId?: string | null;
+    channel: string;
+    outreachMethod: string;
+    lastMessage: {
+        id?: string | null;
+        content?: string | null;
+        senderType: 'user';
+        sentAt: string;
+    };
+}
+/**
+ * Data payload for message.received event
+ * Sent when a prospect replies to a message
+ */
+interface MessageReceivedData {
+    conversationId: string;
+    prospectExternalId: string;
+    projectId?: string | null;
+    channel: string;
+    lastMessage: {
+        id?: string | null;
+        content?: string | null;
+        senderType: 'prospect';
+        senderName?: string | null;
+        sentAt: string;
+    };
+}
+/**
+ * Data payload for connection.accepted event
+ * Sent when a LinkedIn connection request is accepted
+ */
+interface ConnectionAcceptedData {
+    conversationId: string;
+    prospectExternalId: string;
+    projectId?: string | null;
+    prospectName?: string | null;
+    acceptedAt: string;
+}
 
 /**
  * Utility functions for displaying progress updates
@@ -1603,5 +2297,28 @@ declare class ProgressTracker {
     reset(): void;
 }
 
+/**
+ * Verify webhook signature using HMAC SHA-256
+ *
+ * @param payload - Raw request body as string
+ * @param signature - Signature from x-webhook-signature header
+ * @param secret - Shared secret key (must match backend's FRONTEND_WEBHOOK_SECRET)
+ * @returns true if signature is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const isValid = verifyWebhookSignature(
+ *   requestBody,
+ *   request.headers.get('x-webhook-signature') || '',
+ *   process.env.MESSAGING_WEBHOOK_SECRET!
+ * )
+ *
+ * if (!isValid) {
+ *   return NextResponse.json({ error: 'Invalid signature' }, { status: 401 })
+ * }
+ * ```
+ */
+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 BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelResponseResponse, type CheckAppEnabledParams, type ChunkingStrategy, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ContentType, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type DatabaseStatus, type DeleteApiKeyResponse, type DisconnectRequest, type DisconnectResponse, type DuplicateHandling, type Email, 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 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 ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NoDataSourcesError, NotFoundError, type PaginationInfo, type PaginationParams, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, ProviderType, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type SalaryRange, type Scope, type SelectedSkill, 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 StoreApiKeyRequest, 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 UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, displayProgress, formatProgressEntry };
+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 };