lumnisai 0.1.15 → 0.1.17

package/dist/index.cjs

@@ -9,6 +9,181 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 
 const crypto__default = /*#__PURE__*/_interopDefaultCompat(crypto$1);
 
+const LINKEDIN_LIMITS = {
+  basic: {
+    connectionRequests: {
+      weeklyMax: 100,
+      dailySafe: 15
+    },
+    messages: {
+      weeklyMax: 100,
+      dailySafe: 15
+    },
+    inmail: {
+      monthlyCredits: 0,
+      maxAccumulation: 0,
+      rollover: false
+    },
+    profileViews: {
+      dailyMax: 500,
+      dailySafe: 250
+    }
+  },
+  premium_career: {
+    connectionRequests: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    messages: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    inmail: {
+      monthlyCredits: 5,
+      maxAccumulation: 15,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 1e3,
+      // Premium (non-SN): 150-1000/day
+      dailySafe: 300
+    }
+  },
+  premium_business: {
+    connectionRequests: {
+      weeklyMax: 150,
+      // Same as Premium Career, SSI-dependent
+      dailySafe: 20
+    },
+    messages: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    inmail: {
+      monthlyCredits: 15,
+      maxAccumulation: 45,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 1e3,
+      // Premium (non-SN): 150-1000/day
+      dailySafe: 300
+    }
+  },
+  sales_navigator: {
+    connectionRequests: {
+      weeklyMax: 200,
+      dailySafe: 25
+    },
+    messages: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    inmail: {
+      monthlyCredits: 50,
+      maxAccumulation: 150,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 2e3,
+      dailySafe: 500
+    }
+  },
+  recruiter_lite: {
+    connectionRequests: {
+      weeklyMax: 200,
+      dailySafe: 25
+    },
+    messages: {
+      weeklyMax: 200,
+      dailySafe: 25
+    },
+    inmail: {
+      monthlyCredits: 30,
+      maxAccumulation: 120,
+      // LinkedIn official: 120 max per seat
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 2e3,
+      dailySafe: 500
+    }
+  },
+  recruiter_corporate: {
+    connectionRequests: {
+      weeklyMax: 250,
+      dailySafe: 30
+    },
+    messages: {
+      weeklyMax: 200,
+      dailySafe: 30
+    },
+    inmail: {
+      monthlyCredits: 150,
+      maxAccumulation: 600,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 2e3,
+      dailySafe: 500
+    }
+  }
+};
+const ACTION_DELAYS = {
+  betweenConnectionRequests: 30,
+  betweenMessages: 15,
+  betweenProfileViews: 5,
+  afterError: 60
+};
+function getLimits(subscriptionType) {
+  const type = subscriptionType || "basic";
+  return LINKEDIN_LIMITS[type] || LINKEDIN_LIMITS.basic;
+}
+function getConnectionRequestLimit(subscriptionType, useSafeLimit = true) {
+  const limits = getLimits(subscriptionType);
+  return useSafeLimit ? limits.connectionRequests.dailySafe : limits.connectionRequests.weeklyMax;
+}
+function getMessageLimit(subscriptionType, useSafeLimit = true) {
+  const limits = getLimits(subscriptionType);
+  return useSafeLimit ? limits.messages.dailySafe : limits.messages.weeklyMax;
+}
+function getInmailAllowance(subscriptionType) {
+  const limits = getLimits(subscriptionType);
+  return limits.inmail;
+}
+function canSendInmail(subscriptionType) {
+  const limits = getLimits(subscriptionType);
+  return limits.inmail.monthlyCredits > 0;
+}
+function getBestSubscriptionForAction(subscriptionTypes, action) {
+  if (subscriptionTypes.length === 0)
+    return null;
+  if (subscriptionTypes.length === 1)
+    return subscriptionTypes[0];
+  if (action === "inmail") {
+    const priority = ["recruiter_corporate", "recruiter_lite", "sales_navigator", "premium_business", "premium_career", "basic"];
+    for (const priorityType of priority) {
+      if (subscriptionTypes.includes(priorityType))
+        return priorityType;
+    }
+  }
+  if (action === "connection_requests") {
+    const priority = ["recruiter_corporate", "sales_navigator", "recruiter_lite", "premium_business", "premium_career", "basic"];
+    for (const priorityType of priority) {
+      if (subscriptionTypes.includes(priorityType))
+        return priorityType;
+    }
+  }
+  if (action === "messages") {
+    const priority = ["recruiter_corporate", "recruiter_lite", "sales_navigator", "premium_business", "premium_career", "basic"];
+    for (const priorityType of priority) {
+      if (subscriptionTypes.includes(priorityType))
+        return priorityType;
+    }
+  }
+  return subscriptionTypes[0];
+}
+
 const DEFAULT_BASE_URL = "https://api.lumnis.ai";
 const DEFAULT_POLL_INTERVAL_MS = 2e3;
 const LONG_POLL_TIMEOUT_S = 10;
@@ -714,6 +889,58 @@ class MessagingResource {
       request
     );
   }
+  /**
+   * Get comprehensive LinkedIn account information including subscriptions, InMail credits, and capabilities.
+   * By default returns cached data if fresh (< 1 hour old). Set forceRefresh=true to fetch real-time data from Unipile API.
+   *
+   * **Features:**
+   * - Multiple subscription detection (Sales Navigator + Recruiter simultaneously)
+   * - InMail credit tracking per subscription
+   * - Capability flags (canSendInmail, canUseSalesNavigatorApi, canUseRecruiterApi)
+   * - Smart caching with auto-refresh
+   *
+   * **Example:**
+   * ```typescript
+   * // Get account info (uses smart caching)
+   * const accountInfo = await client.messaging.getLinkedInAccountInfo('user@example.com');
+   *
+   * // Force refresh from Unipile API
+   * const freshInfo = await client.messaging.getLinkedInAccountInfo('user@example.com', {
+   *   forceRefresh: true
+   * });
+   *
+   * // Check capabilities
+   * if (accountInfo.canSendInmail) {
+   *   console.log(`User has ${accountInfo.inmailCreditsRemaining} InMail credits`);
+   * }
+   *
+   * // Check specific subscriptions
+   * const hasSalesNav = accountInfo.subscriptions.some(s => s.type === 'sales_navigator');
+   * const hasRecruiter = accountInfo.subscriptions.some(s =>
+   *   s.type === 'recruiter_lite' || s.type === 'recruiter_corporate'
+   * );
+   *
+   * // Get credits per subscription
+   * for (const sub of accountInfo.subscriptions) {
+   *   console.log(`${sub.type}: ${sub.inmailCreditsRemaining}/${sub.monthlyAllowance} credits`);
+   * }
+   * ```
+   *
+   * @param userId - User ID or email
+   * @param options - Optional parameters
+   * @param options.forceRefresh - Force refresh from Unipile API (default: false)
+   * @returns LinkedInAccountInfoResponse with account information
+   */
+  async getLinkedInAccountInfo(userId, options) {
+    const queryParams = new URLSearchParams();
+    queryParams.append("user_id", userId);
+    if (options?.forceRefresh) {
+      queryParams.append("force_refresh", "true");
+    }
+    return this.http.get(
+      `/messaging/linkedin/account-info?${queryParams.toString()}`
+    );
+  }
   /**
    * Get InMail credit information.
    * By default returns cached data. Set forceRefresh=true to fetch real-time data from Unipile API.
@@ -2487,11 +2714,13 @@ function verifyWebhookSignature(payload, signature, secret) {
   );
 }
 
+exports.ACTION_DELAYS = ACTION_DELAYS;
 exports.AuthenticationError = AuthenticationError;
 exports.ChannelType = ChannelType;
 exports.ConversationStatus = ConversationStatus;
 exports.DraftStatus = DraftStatus;
 exports.InternalServerError = InternalServerError;
+exports.LINKEDIN_LIMITS = LINKEDIN_LIMITS;
 exports.LinkedInSubscriptionType = LinkedInSubscriptionType;
 exports.LocalFileNotSupportedError = LocalFileNotSupportedError;
 exports.LumnisClient = LumnisClient;
@@ -2514,7 +2743,13 @@ exports.RateLimitError = RateLimitError;
 exports.SourcesNotAvailableError = SourcesNotAvailableError;
 exports.SyncJobStatus = SyncJobStatus;
 exports.ValidationError = ValidationError;
+exports.canSendInmail = canSendInmail;
 exports.default = LumnisClient;
 exports.displayProgress = displayProgress;
 exports.formatProgressEntry = formatProgressEntry;
+exports.getBestSubscriptionForAction = getBestSubscriptionForAction;
+exports.getConnectionRequestLimit = getConnectionRequestLimit;
+exports.getInmailAllowance = getInmailAllowance;
+exports.getLimits = getLimits;
+exports.getMessageLimit = getMessageLimit;
 exports.verifyWebhookSignature = verifyWebhookSignature;

package/dist/index.d.cts

@@ -1,3 +1,71 @@
+/**
+ * LinkedIn subscription types
+ */
+type LinkedInSubscriptionType$1 = 'basic' | 'premium_career' | 'premium_business' | 'sales_navigator' | 'recruiter_lite' | 'recruiter_corporate';
+/**
+ * LinkedIn limits by subscription type
+ */
+interface LinkedInLimits {
+    connectionRequests: {
+        weeklyMax: number;
+        dailySafe: number;
+    };
+    messages: {
+        weeklyMax: number;
+        dailySafe: number;
+    };
+    inmail: {
+        monthlyCredits: number;
+        maxAccumulation: number;
+        rollover: boolean;
+    };
+    profileViews: {
+        dailyMax: number;
+        dailySafe: number;
+    };
+}
+/**
+ * LinkedIn rate limits by subscription type
+ */
+declare const LINKEDIN_LIMITS: Record<LinkedInSubscriptionType$1, LinkedInLimits>;
+/**
+ * Action delays for human-like behavior (in seconds)
+ */
+declare const ACTION_DELAYS: {
+    readonly betweenConnectionRequests: 30;
+    readonly betweenMessages: 15;
+    readonly betweenProfileViews: 5;
+    readonly afterError: 60;
+};
+/**
+ * Get all limits for a subscription type
+ */
+declare function getLimits(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): LinkedInLimits;
+/**
+ * Get connection request limit for a subscription type
+ */
+declare function getConnectionRequestLimit(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined, useSafeLimit?: boolean): number;
+/**
+ * Get message limit for a subscription type
+ */
+declare function getMessageLimit(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined, useSafeLimit?: boolean): number;
+/**
+ * Get InMail allowance for a subscription type
+ */
+declare function getInmailAllowance(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): {
+    monthlyCredits: number;
+    maxAccumulation: number;
+    rollover: boolean;
+};
+/**
+ * Check if subscription can send InMail
+ */
+declare function canSendInmail(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): boolean;
+/**
+ * Get best subscription for a specific action when user has multiple subscriptions
+ */
+declare function getBestSubscriptionForAction(subscriptionTypes: (LinkedInSubscriptionType$1 | string)[], action: 'inmail' | 'connection_requests' | 'messages'): LinkedInSubscriptionType$1 | string | null;
+
 interface PaginationParams {
     page?: number;
     pageSize?: number;
@@ -516,10 +584,12 @@ interface ModelOverrides {
 }
 /**
  * Available specialized agents
+ * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search';
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | (string & {});
 /**
  * Parameters for specialized agent execution
+ * This is a flexible interface that supports any agent-specific parameters
  */
 interface SpecializedAgentParams {
     /**
@@ -527,11 +597,21 @@ interface SpecializedAgentParams {
      * Agent-specific: For quick_people_search, limits the number of candidates returned
      */
     limit?: number;
+    /**
+     * Number of candidates requested (for deep_people_search)
+     * Range: 1-1000
+     */
+    requestedCandidates?: number;
     /**
      * Specific data sources to use (agent-specific)
-     * For quick_people_search: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * For people search agents: ["PDL", "CORESIGNAL", "CRUST_DATA"]
      */
     dataSources?: string[];
+    /**
+     * Additional parameters for any specialized agent
+     * This allows flexibility for future agents without SDK updates
+     */
+    [key: string]: any;
 }
 interface CreateResponseRequest {
     threadId?: UUID;
@@ -545,7 +625,8 @@ interface CreateResponseRequest {
     modelOverrides?: ModelOverrides;
     /**
      * Route to a specialized agent instead of the main Lumnis agent
-     * Available agents: 'quick_people_search'
+     * Known agents: 'quick_people_search', 'deep_people_search'
+     * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
     /**
@@ -1521,6 +1602,37 @@ interface LinkedInCreditsResponse {
     creditsUpdatedAt?: string | null;
     isRealTime?: boolean;
 }
+/**
+ * LinkedIn subscription information
+ */
+interface LinkedInSubscriptionInfo {
+    type: string;
+    feature: string;
+    inmailCreditsRemaining?: number | null;
+    inmailCreditsUpdatedAt?: string | null;
+    monthlyAllowance: number;
+    maxAccumulation: number;
+    isActive: boolean;
+}
+/**
+ * Comprehensive LinkedIn account information response
+ */
+interface LinkedInAccountInfoResponse {
+    connected: boolean;
+    accountId?: string | null;
+    connectedAt?: string | null;
+    subscriptions: LinkedInSubscriptionInfo[];
+    subscriptionType?: string | null;
+    feature?: string | null;
+    inmailCreditsRemaining?: number | null;
+    inmailCreditsUpdatedAt?: string | null;
+    monthlyInmailAllowance?: number | null;
+    maxInmailAccumulation?: number | null;
+    canSendInmail: boolean;
+    canUseSalesNavigatorApi: boolean;
+    canUseRecruiterApi: boolean;
+    unipileStatus?: string | null;
+}
 /**
  * Conversation summary
  */
@@ -1899,6 +2011,51 @@ declare class MessagingResource {
      * Smart LinkedIn outreach with automatic method selection
      */
     sendLinkedInOutreach(userId: string, request: LinkedInSendRequest): Promise<SendResult>;
+    /**
+     * Get comprehensive LinkedIn account information including subscriptions, InMail credits, and capabilities.
+     * By default returns cached data if fresh (< 1 hour old). Set forceRefresh=true to fetch real-time data from Unipile API.
+     *
+     * **Features:**
+     * - Multiple subscription detection (Sales Navigator + Recruiter simultaneously)
+     * - InMail credit tracking per subscription
+     * - Capability flags (canSendInmail, canUseSalesNavigatorApi, canUseRecruiterApi)
+     * - Smart caching with auto-refresh
+     *
+     * **Example:**
+     * ```typescript
+     * // Get account info (uses smart caching)
+     * const accountInfo = await client.messaging.getLinkedInAccountInfo('user@example.com');
+     *
+     * // Force refresh from Unipile API
+     * const freshInfo = await client.messaging.getLinkedInAccountInfo('user@example.com', {
+     *   forceRefresh: true
+     * });
+     *
+     * // Check capabilities
+     * if (accountInfo.canSendInmail) {
+     *   console.log(`User has ${accountInfo.inmailCreditsRemaining} InMail credits`);
+     * }
+     *
+     * // Check specific subscriptions
+     * const hasSalesNav = accountInfo.subscriptions.some(s => s.type === 'sales_navigator');
+     * const hasRecruiter = accountInfo.subscriptions.some(s =>
+     *   s.type === 'recruiter_lite' || s.type === 'recruiter_corporate'
+     * );
+     *
+     * // Get credits per subscription
+     * for (const sub of accountInfo.subscriptions) {
+     *   console.log(`${sub.type}: ${sub.inmailCreditsRemaining}/${sub.monthlyAllowance} credits`);
+     * }
+     * ```
+     *
+     * @param userId - User ID or email
+     * @param options - Optional parameters
+     * @param options.forceRefresh - Force refresh from Unipile API (default: false)
+     * @returns LinkedInAccountInfoResponse with account information
+     */
+    getLinkedInAccountInfo(userId: string, options?: {
+        forceRefresh?: boolean;
+    }): Promise<LinkedInAccountInfoResponse>;
     /**
      * Get InMail credit information.
      * By default returns cached data. Set forceRefresh=true to fetch real-time data from Unipile API.
@@ -2732,4 +2889,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 BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, 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 };
+export { ACTION_DELAYS, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, 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, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, type LinkedInSubscriptionType$1 as 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, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, verifyWebhookSignature };

package/dist/index.d.mts

@@ -1,3 +1,71 @@
+/**
+ * LinkedIn subscription types
+ */
+type LinkedInSubscriptionType$1 = 'basic' | 'premium_career' | 'premium_business' | 'sales_navigator' | 'recruiter_lite' | 'recruiter_corporate';
+/**
+ * LinkedIn limits by subscription type
+ */
+interface LinkedInLimits {
+    connectionRequests: {
+        weeklyMax: number;
+        dailySafe: number;
+    };
+    messages: {
+        weeklyMax: number;
+        dailySafe: number;
+    };
+    inmail: {
+        monthlyCredits: number;
+        maxAccumulation: number;
+        rollover: boolean;
+    };
+    profileViews: {
+        dailyMax: number;
+        dailySafe: number;
+    };
+}
+/**
+ * LinkedIn rate limits by subscription type
+ */
+declare const LINKEDIN_LIMITS: Record<LinkedInSubscriptionType$1, LinkedInLimits>;
+/**
+ * Action delays for human-like behavior (in seconds)
+ */
+declare const ACTION_DELAYS: {
+    readonly betweenConnectionRequests: 30;
+    readonly betweenMessages: 15;
+    readonly betweenProfileViews: 5;
+    readonly afterError: 60;
+};
+/**
+ * Get all limits for a subscription type
+ */
+declare function getLimits(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): LinkedInLimits;
+/**
+ * Get connection request limit for a subscription type
+ */
+declare function getConnectionRequestLimit(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined, useSafeLimit?: boolean): number;
+/**
+ * Get message limit for a subscription type
+ */
+declare function getMessageLimit(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined, useSafeLimit?: boolean): number;
+/**
+ * Get InMail allowance for a subscription type
+ */
+declare function getInmailAllowance(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): {
+    monthlyCredits: number;
+    maxAccumulation: number;
+    rollover: boolean;
+};
+/**
+ * Check if subscription can send InMail
+ */
+declare function canSendInmail(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): boolean;
+/**
+ * Get best subscription for a specific action when user has multiple subscriptions
+ */
+declare function getBestSubscriptionForAction(subscriptionTypes: (LinkedInSubscriptionType$1 | string)[], action: 'inmail' | 'connection_requests' | 'messages'): LinkedInSubscriptionType$1 | string | null;
+
 interface PaginationParams {
     page?: number;
     pageSize?: number;
@@ -516,10 +584,12 @@ interface ModelOverrides {
 }
 /**
  * Available specialized agents
+ * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search';
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | (string & {});
 /**
  * Parameters for specialized agent execution
+ * This is a flexible interface that supports any agent-specific parameters
  */
 interface SpecializedAgentParams {
     /**
@@ -527,11 +597,21 @@ interface SpecializedAgentParams {
      * Agent-specific: For quick_people_search, limits the number of candidates returned
      */
     limit?: number;
+    /**
+     * Number of candidates requested (for deep_people_search)
+     * Range: 1-1000
+     */
+    requestedCandidates?: number;
     /**
      * Specific data sources to use (agent-specific)
-     * For quick_people_search: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * For people search agents: ["PDL", "CORESIGNAL", "CRUST_DATA"]
      */
     dataSources?: string[];
+    /**
+     * Additional parameters for any specialized agent
+     * This allows flexibility for future agents without SDK updates
+     */
+    [key: string]: any;
 }
 interface CreateResponseRequest {
     threadId?: UUID;
@@ -545,7 +625,8 @@ interface CreateResponseRequest {
     modelOverrides?: ModelOverrides;
     /**
      * Route to a specialized agent instead of the main Lumnis agent
-     * Available agents: 'quick_people_search'
+     * Known agents: 'quick_people_search', 'deep_people_search'
+     * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
     /**
@@ -1521,6 +1602,37 @@ interface LinkedInCreditsResponse {
     creditsUpdatedAt?: string | null;
     isRealTime?: boolean;
 }
+/**
+ * LinkedIn subscription information
+ */
+interface LinkedInSubscriptionInfo {
+    type: string;
+    feature: string;
+    inmailCreditsRemaining?: number | null;
+    inmailCreditsUpdatedAt?: string | null;
+    monthlyAllowance: number;
+    maxAccumulation: number;
+    isActive: boolean;
+}
+/**
+ * Comprehensive LinkedIn account information response
+ */
+interface LinkedInAccountInfoResponse {
+    connected: boolean;
+    accountId?: string | null;
+    connectedAt?: string | null;
+    subscriptions: LinkedInSubscriptionInfo[];
+    subscriptionType?: string | null;
+    feature?: string | null;
+    inmailCreditsRemaining?: number | null;
+    inmailCreditsUpdatedAt?: string | null;
+    monthlyInmailAllowance?: number | null;
+    maxInmailAccumulation?: number | null;
+    canSendInmail: boolean;
+    canUseSalesNavigatorApi: boolean;
+    canUseRecruiterApi: boolean;
+    unipileStatus?: string | null;
+}
 /**
  * Conversation summary
  */
@@ -1899,6 +2011,51 @@ declare class MessagingResource {
      * Smart LinkedIn outreach with automatic method selection
      */
     sendLinkedInOutreach(userId: string, request: LinkedInSendRequest): Promise<SendResult>;
+    /**
+     * Get comprehensive LinkedIn account information including subscriptions, InMail credits, and capabilities.
+     * By default returns cached data if fresh (< 1 hour old). Set forceRefresh=true to fetch real-time data from Unipile API.
+     *
+     * **Features:**
+     * - Multiple subscription detection (Sales Navigator + Recruiter simultaneously)
+     * - InMail credit tracking per subscription
+     * - Capability flags (canSendInmail, canUseSalesNavigatorApi, canUseRecruiterApi)
+     * - Smart caching with auto-refresh
+     *
+     * **Example:**
+     * ```typescript
+     * // Get account info (uses smart caching)
+     * const accountInfo = await client.messaging.getLinkedInAccountInfo('user@example.com');
+     *
+     * // Force refresh from Unipile API
+     * const freshInfo = await client.messaging.getLinkedInAccountInfo('user@example.com', {
+     *   forceRefresh: true
+     * });
+     *
+     * // Check capabilities
+     * if (accountInfo.canSendInmail) {
+     *   console.log(`User has ${accountInfo.inmailCreditsRemaining} InMail credits`);
+     * }
+     *
+     * // Check specific subscriptions
+     * const hasSalesNav = accountInfo.subscriptions.some(s => s.type === 'sales_navigator');
+     * const hasRecruiter = accountInfo.subscriptions.some(s =>
+     *   s.type === 'recruiter_lite' || s.type === 'recruiter_corporate'
+     * );
+     *
+     * // Get credits per subscription
+     * for (const sub of accountInfo.subscriptions) {
+     *   console.log(`${sub.type}: ${sub.inmailCreditsRemaining}/${sub.monthlyAllowance} credits`);
+     * }
+     * ```
+     *
+     * @param userId - User ID or email
+     * @param options - Optional parameters
+     * @param options.forceRefresh - Force refresh from Unipile API (default: false)
+     * @returns LinkedInAccountInfoResponse with account information
+     */
+    getLinkedInAccountInfo(userId: string, options?: {
+        forceRefresh?: boolean;
+    }): Promise<LinkedInAccountInfoResponse>;
     /**
      * Get InMail credit information.
      * By default returns cached data. Set forceRefresh=true to fetch real-time data from Unipile API.
@@ -2731,4 +2888,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 BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, 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 };
+export { ACTION_DELAYS, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, 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, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, type LinkedInSubscriptionType$1 as 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, canSendInmail, LumnisClient as default, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1,3 +1,71 @@
+/**
+ * LinkedIn subscription types
+ */
+type LinkedInSubscriptionType$1 = 'basic' | 'premium_career' | 'premium_business' | 'sales_navigator' | 'recruiter_lite' | 'recruiter_corporate';
+/**
+ * LinkedIn limits by subscription type
+ */
+interface LinkedInLimits {
+    connectionRequests: {
+        weeklyMax: number;
+        dailySafe: number;
+    };
+    messages: {
+        weeklyMax: number;
+        dailySafe: number;
+    };
+    inmail: {
+        monthlyCredits: number;
+        maxAccumulation: number;
+        rollover: boolean;
+    };
+    profileViews: {
+        dailyMax: number;
+        dailySafe: number;
+    };
+}
+/**
+ * LinkedIn rate limits by subscription type
+ */
+declare const LINKEDIN_LIMITS: Record<LinkedInSubscriptionType$1, LinkedInLimits>;
+/**
+ * Action delays for human-like behavior (in seconds)
+ */
+declare const ACTION_DELAYS: {
+    readonly betweenConnectionRequests: 30;
+    readonly betweenMessages: 15;
+    readonly betweenProfileViews: 5;
+    readonly afterError: 60;
+};
+/**
+ * Get all limits for a subscription type
+ */
+declare function getLimits(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): LinkedInLimits;
+/**
+ * Get connection request limit for a subscription type
+ */
+declare function getConnectionRequestLimit(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined, useSafeLimit?: boolean): number;
+/**
+ * Get message limit for a subscription type
+ */
+declare function getMessageLimit(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined, useSafeLimit?: boolean): number;
+/**
+ * Get InMail allowance for a subscription type
+ */
+declare function getInmailAllowance(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): {
+    monthlyCredits: number;
+    maxAccumulation: number;
+    rollover: boolean;
+};
+/**
+ * Check if subscription can send InMail
+ */
+declare function canSendInmail(subscriptionType: LinkedInSubscriptionType$1 | string | null | undefined): boolean;
+/**
+ * Get best subscription for a specific action when user has multiple subscriptions
+ */
+declare function getBestSubscriptionForAction(subscriptionTypes: (LinkedInSubscriptionType$1 | string)[], action: 'inmail' | 'connection_requests' | 'messages'): LinkedInSubscriptionType$1 | string | null;
+
 interface PaginationParams {
     page?: number;
     pageSize?: number;
@@ -516,10 +584,12 @@ interface ModelOverrides {
 }
 /**
  * Available specialized agents
+ * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search';
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | (string & {});
 /**
  * Parameters for specialized agent execution
+ * This is a flexible interface that supports any agent-specific parameters
  */
 interface SpecializedAgentParams {
     /**
@@ -527,11 +597,21 @@ interface SpecializedAgentParams {
      * Agent-specific: For quick_people_search, limits the number of candidates returned
      */
     limit?: number;
+    /**
+     * Number of candidates requested (for deep_people_search)
+     * Range: 1-1000
+     */
+    requestedCandidates?: number;
     /**
      * Specific data sources to use (agent-specific)
-     * For quick_people_search: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * For people search agents: ["PDL", "CORESIGNAL", "CRUST_DATA"]
      */
     dataSources?: string[];
+    /**
+     * Additional parameters for any specialized agent
+     * This allows flexibility for future agents without SDK updates
+     */
+    [key: string]: any;
 }
 interface CreateResponseRequest {
     threadId?: UUID;
@@ -545,7 +625,8 @@ interface CreateResponseRequest {
     modelOverrides?: ModelOverrides;
     /**
      * Route to a specialized agent instead of the main Lumnis agent
-     * Available agents: 'quick_people_search'
+     * Known agents: 'quick_people_search', 'deep_people_search'
+     * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
     /**
@@ -1521,6 +1602,37 @@ interface LinkedInCreditsResponse {
     creditsUpdatedAt?: string | null;
     isRealTime?: boolean;
 }
+/**
+ * LinkedIn subscription information
+ */
+interface LinkedInSubscriptionInfo {
+    type: string;
+    feature: string;
+    inmailCreditsRemaining?: number | null;
+    inmailCreditsUpdatedAt?: string | null;
+    monthlyAllowance: number;
+    maxAccumulation: number;
+    isActive: boolean;
+}
+/**
+ * Comprehensive LinkedIn account information response
+ */
+interface LinkedInAccountInfoResponse {
+    connected: boolean;
+    accountId?: string | null;
+    connectedAt?: string | null;
+    subscriptions: LinkedInSubscriptionInfo[];
+    subscriptionType?: string | null;
+    feature?: string | null;
+    inmailCreditsRemaining?: number | null;
+    inmailCreditsUpdatedAt?: string | null;
+    monthlyInmailAllowance?: number | null;
+    maxInmailAccumulation?: number | null;
+    canSendInmail: boolean;
+    canUseSalesNavigatorApi: boolean;
+    canUseRecruiterApi: boolean;
+    unipileStatus?: string | null;
+}
 /**
  * Conversation summary
  */
@@ -1899,6 +2011,51 @@ declare class MessagingResource {
      * Smart LinkedIn outreach with automatic method selection
      */
     sendLinkedInOutreach(userId: string, request: LinkedInSendRequest): Promise<SendResult>;
+    /**
+     * Get comprehensive LinkedIn account information including subscriptions, InMail credits, and capabilities.
+     * By default returns cached data if fresh (< 1 hour old). Set forceRefresh=true to fetch real-time data from Unipile API.
+     *
+     * **Features:**
+     * - Multiple subscription detection (Sales Navigator + Recruiter simultaneously)
+     * - InMail credit tracking per subscription
+     * - Capability flags (canSendInmail, canUseSalesNavigatorApi, canUseRecruiterApi)
+     * - Smart caching with auto-refresh
+     *
+     * **Example:**
+     * ```typescript
+     * // Get account info (uses smart caching)
+     * const accountInfo = await client.messaging.getLinkedInAccountInfo('user@example.com');
+     *
+     * // Force refresh from Unipile API
+     * const freshInfo = await client.messaging.getLinkedInAccountInfo('user@example.com', {
+     *   forceRefresh: true
+     * });
+     *
+     * // Check capabilities
+     * if (accountInfo.canSendInmail) {
+     *   console.log(`User has ${accountInfo.inmailCreditsRemaining} InMail credits`);
+     * }
+     *
+     * // Check specific subscriptions
+     * const hasSalesNav = accountInfo.subscriptions.some(s => s.type === 'sales_navigator');
+     * const hasRecruiter = accountInfo.subscriptions.some(s =>
+     *   s.type === 'recruiter_lite' || s.type === 'recruiter_corporate'
+     * );
+     *
+     * // Get credits per subscription
+     * for (const sub of accountInfo.subscriptions) {
+     *   console.log(`${sub.type}: ${sub.inmailCreditsRemaining}/${sub.monthlyAllowance} credits`);
+     * }
+     * ```
+     *
+     * @param userId - User ID or email
+     * @param options - Optional parameters
+     * @param options.forceRefresh - Force refresh from Unipile API (default: false)
+     * @returns LinkedInAccountInfoResponse with account information
+     */
+    getLinkedInAccountInfo(userId: string, options?: {
+        forceRefresh?: boolean;
+    }): Promise<LinkedInAccountInfoResponse>;
     /**
      * Get InMail credit information.
      * By default returns cached data. Set forceRefresh=true to fetch real-time data from Unipile API.
@@ -2732,4 +2889,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 BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, 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 };
+export { ACTION_DELAYS, type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, 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, LINKEDIN_LIMITS, type LinkedInAccountInfoResponse, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, type LinkedInSubscriptionType$1 as 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, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, verifyWebhookSignature };

package/dist/index.mjs

@@ -1,6 +1,181 @@
 import { Buffer } from 'node:buffer';
 import crypto$1 from 'node:crypto';
 
+const LINKEDIN_LIMITS = {
+  basic: {
+    connectionRequests: {
+      weeklyMax: 100,
+      dailySafe: 15
+    },
+    messages: {
+      weeklyMax: 100,
+      dailySafe: 15
+    },
+    inmail: {
+      monthlyCredits: 0,
+      maxAccumulation: 0,
+      rollover: false
+    },
+    profileViews: {
+      dailyMax: 500,
+      dailySafe: 250
+    }
+  },
+  premium_career: {
+    connectionRequests: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    messages: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    inmail: {
+      monthlyCredits: 5,
+      maxAccumulation: 15,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 1e3,
+      // Premium (non-SN): 150-1000/day
+      dailySafe: 300
+    }
+  },
+  premium_business: {
+    connectionRequests: {
+      weeklyMax: 150,
+      // Same as Premium Career, SSI-dependent
+      dailySafe: 20
+    },
+    messages: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    inmail: {
+      monthlyCredits: 15,
+      maxAccumulation: 45,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 1e3,
+      // Premium (non-SN): 150-1000/day
+      dailySafe: 300
+    }
+  },
+  sales_navigator: {
+    connectionRequests: {
+      weeklyMax: 200,
+      dailySafe: 25
+    },
+    messages: {
+      weeklyMax: 150,
+      dailySafe: 20
+    },
+    inmail: {
+      monthlyCredits: 50,
+      maxAccumulation: 150,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 2e3,
+      dailySafe: 500
+    }
+  },
+  recruiter_lite: {
+    connectionRequests: {
+      weeklyMax: 200,
+      dailySafe: 25
+    },
+    messages: {
+      weeklyMax: 200,
+      dailySafe: 25
+    },
+    inmail: {
+      monthlyCredits: 30,
+      maxAccumulation: 120,
+      // LinkedIn official: 120 max per seat
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 2e3,
+      dailySafe: 500
+    }
+  },
+  recruiter_corporate: {
+    connectionRequests: {
+      weeklyMax: 250,
+      dailySafe: 30
+    },
+    messages: {
+      weeklyMax: 200,
+      dailySafe: 30
+    },
+    inmail: {
+      monthlyCredits: 150,
+      maxAccumulation: 600,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 2e3,
+      dailySafe: 500
+    }
+  }
+};
+const ACTION_DELAYS = {
+  betweenConnectionRequests: 30,
+  betweenMessages: 15,
+  betweenProfileViews: 5,
+  afterError: 60
+};
+function getLimits(subscriptionType) {
+  const type = subscriptionType || "basic";
+  return LINKEDIN_LIMITS[type] || LINKEDIN_LIMITS.basic;
+}
+function getConnectionRequestLimit(subscriptionType, useSafeLimit = true) {
+  const limits = getLimits(subscriptionType);
+  return useSafeLimit ? limits.connectionRequests.dailySafe : limits.connectionRequests.weeklyMax;
+}
+function getMessageLimit(subscriptionType, useSafeLimit = true) {
+  const limits = getLimits(subscriptionType);
+  return useSafeLimit ? limits.messages.dailySafe : limits.messages.weeklyMax;
+}
+function getInmailAllowance(subscriptionType) {
+  const limits = getLimits(subscriptionType);
+  return limits.inmail;
+}
+function canSendInmail(subscriptionType) {
+  const limits = getLimits(subscriptionType);
+  return limits.inmail.monthlyCredits > 0;
+}
+function getBestSubscriptionForAction(subscriptionTypes, action) {
+  if (subscriptionTypes.length === 0)
+    return null;
+  if (subscriptionTypes.length === 1)
+    return subscriptionTypes[0];
+  if (action === "inmail") {
+    const priority = ["recruiter_corporate", "recruiter_lite", "sales_navigator", "premium_business", "premium_career", "basic"];
+    for (const priorityType of priority) {
+      if (subscriptionTypes.includes(priorityType))
+        return priorityType;
+    }
+  }
+  if (action === "connection_requests") {
+    const priority = ["recruiter_corporate", "sales_navigator", "recruiter_lite", "premium_business", "premium_career", "basic"];
+    for (const priorityType of priority) {
+      if (subscriptionTypes.includes(priorityType))
+        return priorityType;
+    }
+  }
+  if (action === "messages") {
+    const priority = ["recruiter_corporate", "recruiter_lite", "sales_navigator", "premium_business", "premium_career", "basic"];
+    for (const priorityType of priority) {
+      if (subscriptionTypes.includes(priorityType))
+        return priorityType;
+    }
+  }
+  return subscriptionTypes[0];
+}
+
 const DEFAULT_BASE_URL = "https://api.lumnis.ai";
 const DEFAULT_POLL_INTERVAL_MS = 2e3;
 const LONG_POLL_TIMEOUT_S = 10;
@@ -706,6 +881,58 @@ class MessagingResource {
       request
     );
   }
+  /**
+   * Get comprehensive LinkedIn account information including subscriptions, InMail credits, and capabilities.
+   * By default returns cached data if fresh (< 1 hour old). Set forceRefresh=true to fetch real-time data from Unipile API.
+   *
+   * **Features:**
+   * - Multiple subscription detection (Sales Navigator + Recruiter simultaneously)
+   * - InMail credit tracking per subscription
+   * - Capability flags (canSendInmail, canUseSalesNavigatorApi, canUseRecruiterApi)
+   * - Smart caching with auto-refresh
+   *
+   * **Example:**
+   * ```typescript
+   * // Get account info (uses smart caching)
+   * const accountInfo = await client.messaging.getLinkedInAccountInfo('user@example.com');
+   *
+   * // Force refresh from Unipile API
+   * const freshInfo = await client.messaging.getLinkedInAccountInfo('user@example.com', {
+   *   forceRefresh: true
+   * });
+   *
+   * // Check capabilities
+   * if (accountInfo.canSendInmail) {
+   *   console.log(`User has ${accountInfo.inmailCreditsRemaining} InMail credits`);
+   * }
+   *
+   * // Check specific subscriptions
+   * const hasSalesNav = accountInfo.subscriptions.some(s => s.type === 'sales_navigator');
+   * const hasRecruiter = accountInfo.subscriptions.some(s =>
+   *   s.type === 'recruiter_lite' || s.type === 'recruiter_corporate'
+   * );
+   *
+   * // Get credits per subscription
+   * for (const sub of accountInfo.subscriptions) {
+   *   console.log(`${sub.type}: ${sub.inmailCreditsRemaining}/${sub.monthlyAllowance} credits`);
+   * }
+   * ```
+   *
+   * @param userId - User ID or email
+   * @param options - Optional parameters
+   * @param options.forceRefresh - Force refresh from Unipile API (default: false)
+   * @returns LinkedInAccountInfoResponse with account information
+   */
+  async getLinkedInAccountInfo(userId, options) {
+    const queryParams = new URLSearchParams();
+    queryParams.append("user_id", userId);
+    if (options?.forceRefresh) {
+      queryParams.append("force_refresh", "true");
+    }
+    return this.http.get(
+      `/messaging/linkedin/account-info?${queryParams.toString()}`
+    );
+  }
   /**
    * Get InMail credit information.
    * By default returns cached data. Set forceRefresh=true to fetch real-time data from Unipile API.
@@ -2479,4 +2706,4 @@ function verifyWebhookSignature(payload, signature, secret) {
   );
 }
 
-export { AuthenticationError, ChannelType, ConversationStatus, DraftStatus, InternalServerError, LinkedInSubscriptionType, LocalFileNotSupportedError, LumnisClient, LumnisError, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingSendError, MessagingValidationError, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, PeopleDataSource, ProgressTracker, ProviderType, QueueItemStatus, RateLimitError, SourcesNotAvailableError, SyncJobStatus, ValidationError, LumnisClient as default, displayProgress, formatProgressEntry, verifyWebhookSignature };
+export { ACTION_DELAYS, AuthenticationError, ChannelType, ConversationStatus, DraftStatus, InternalServerError, LINKEDIN_LIMITS, LinkedInSubscriptionType, LocalFileNotSupportedError, LumnisClient, LumnisError, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingSendError, MessagingValidationError, NetworkDistance, NoDataSourcesError, NotFoundError, OutreachMethod, PeopleDataSource, ProgressTracker, ProviderType, QueueItemStatus, RateLimitError, SourcesNotAvailableError, SyncJobStatus, ValidationError, canSendInmail, LumnisClient as default, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getInmailAllowance, getLimits, getMessageLimit, verifyWebhookSignature };

package/package.json

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