lumnisai 0.1.14 → 0.1.16

package/dist/index.cjs

@@ -416,42 +416,6 @@ class MCPServersResource {
   }
 }
 
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function isUUID(s) {
-  return UUID_PATTERN.test(s);
-}
-function toCamel(s) {
-  if (isUUID(s))
-    return s;
-  return s.replace(/([-_][a-z])/gi, ($1) => {
-    return $1.toUpperCase().replace("-", "").replace("_", "");
-  });
-}
-function toSnake(s) {
-  if (isUUID(s))
-    return s;
-  return s.replace(/[A-Z]/g, (letter, index) => {
-    return index === 0 ? letter.toLowerCase() : `_${letter.toLowerCase()}`;
-  });
-}
-function convertCase(obj, converter) {
-  if (Array.isArray(obj)) {
-    return obj.map((v) => convertCase(v, converter));
-  } else if (obj !== null && typeof obj === "object") {
-    return Object.keys(obj).reduce((acc, key) => {
-      acc[converter(key)] = convertCase(obj[key], converter);
-      return acc;
-    }, {});
-  }
-  return obj;
-}
-function toCamelCase(obj) {
-  return convertCase(obj, toCamel);
-}
-function toSnakeCase(obj) {
-  return convertCase(obj, toSnake);
-}
-
 class LumnisError extends Error {
   code;
   statusCode;
@@ -556,6 +520,42 @@ class MessagingConnectionError extends MessagingAPIError {
   }
 }
 
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUUID(s) {
+  return UUID_PATTERN.test(s);
+}
+function toCamel(s) {
+  if (isUUID(s))
+    return s;
+  return s.replace(/([-_][a-z])/gi, ($1) => {
+    return $1.toUpperCase().replace("-", "").replace("_", "");
+  });
+}
+function toSnake(s) {
+  if (isUUID(s))
+    return s;
+  return s.replace(/[A-Z]/g, (letter, index) => {
+    return index === 0 ? letter.toLowerCase() : `_${letter.toLowerCase()}`;
+  });
+}
+function convertCase(obj, converter) {
+  if (Array.isArray(obj)) {
+    return obj.map((v) => convertCase(v, converter));
+  } else if (obj !== null && typeof obj === "object") {
+    return Object.keys(obj).reduce((acc, key) => {
+      acc[converter(key)] = convertCase(obj[key], converter);
+      return acc;
+    }, {});
+  }
+  return obj;
+}
+function toCamelCase(obj) {
+  return convertCase(obj, toCamel);
+}
+function toSnakeCase(obj) {
+  return convertCase(obj, toSnake);
+}
+
 class MessagingResource {
   constructor(http) {
     this.http = http;
@@ -761,6 +761,34 @@ class MessagingResource {
       request
     );
   }
+  /**
+   * Get a draft by ID.
+   *
+   * @param userId - User ID or email
+   * @param draftId - Draft UUID
+   * @returns Promise resolving to DraftResponse
+   * @throws MessagingNotFoundError if draft not found (404) or other API error
+   *
+   * @example
+   * ```typescript
+   * const draft = await client.messaging.getDraft('user@example.com', 'draft-uuid');
+   * console.log(draft.content);
+   * ```
+   */
+  async getDraft(userId, draftId) {
+    try {
+      const queryParams = new URLSearchParams();
+      queryParams.append("user_id", userId);
+      return await this.http.get(
+        `/messaging/drafts/${encodeURIComponent(draftId)}?${queryParams.toString()}`
+      );
+    } catch (error) {
+      if (error instanceof NotFoundError) {
+        throw new MessagingNotFoundError(`Draft not found: ${draftId}`);
+      }
+      throw error;
+    }
+  }
   /**
    * Create drafts for multiple prospects with AI generation
    */
@@ -922,7 +950,7 @@ class MessagingResource {
                 break;
               }
             }
-          } catch (parseError) {
+          } catch {
             continue;
           }
         }
@@ -1049,7 +1077,7 @@ class MessagingResource {
                 errorDetails: completeData.errorDetails || []
               };
             }
-          } catch (parseError) {
+          } catch {
             continue;
           }
         }
@@ -1195,10 +1223,14 @@ class MessagingResource {
     const queryParams = new URLSearchParams();
     queryParams.append("user_id", userId);
     const payload = {};
-    if (request.email) payload.email = request.email;
-    if (request.linkedinUrl) payload.linkedin_url = request.linkedinUrl;
-    if (request.providerId) payload.provider_id = request.providerId;
-    if (request.channels) payload.channels = request.channels;
+    if (request.email)
+      payload.email = request.email;
+    if (request.linkedinUrl)
+      payload.linkedin_url = request.linkedinUrl;
+    if (request.providerId)
+      payload.provider_id = request.providerId;
+    if (request.channels)
+      payload.channels = request.channels;
     if (request.messageLimit !== void 0 && request.messageLimit !== null) {
       payload.message_limit = request.messageLimit;
     }
@@ -1266,7 +1298,8 @@ class MessagingResource {
         provider_id: p.providerId || void 0
       }))
     };
-    if (request.channels) payload.channels = request.channels;
+    if (request.channels)
+      payload.channels = request.channels;
     if (request.messageLimit !== void 0 && request.messageLimit !== null) {
       payload.message_limit = request.messageLimit;
     }

package/dist/index.d.cts

@@ -516,10 +516,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 +529,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 +557,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;
     /**
@@ -1588,6 +1601,8 @@ interface DraftResponse {
     conversationId?: string | null;
     /** Outreach method used for this draft: 'connection_request' | 'direct_message' | 'inmail' | 'email' */
     outreachMethod?: 'direct_message' | 'connection_request' | 'inmail' | 'email' | null;
+    /** Subject line for email drafts (optional) */
+    subject?: string | null;
 }
 /**
  * Response from batch draft creation
@@ -1919,6 +1934,21 @@ declare class MessagingResource {
      * Create a single draft message
      */
     createDraft(userId: string, request: CreateDraftRequest): Promise<DraftResponse>;
+    /**
+     * Get a draft by ID.
+     *
+     * @param userId - User ID or email
+     * @param draftId - Draft UUID
+     * @returns Promise resolving to DraftResponse
+     * @throws MessagingNotFoundError if draft not found (404) or other API error
+     *
+     * @example
+     * ```typescript
+     * const draft = await client.messaging.getDraft('user@example.com', 'draft-uuid');
+     * console.log(draft.content);
+     * ```
+     */
+    getDraft(userId: string, draftId: string): Promise<DraftResponse>;
     /**
      * Create drafts for multiple prospects with AI generation
      */

package/dist/index.d.mts

@@ -516,10 +516,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 +529,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 +557,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;
     /**
@@ -1588,6 +1601,8 @@ interface DraftResponse {
     conversationId?: string | null;
     /** Outreach method used for this draft: 'connection_request' | 'direct_message' | 'inmail' | 'email' */
     outreachMethod?: 'direct_message' | 'connection_request' | 'inmail' | 'email' | null;
+    /** Subject line for email drafts (optional) */
+    subject?: string | null;
 }
 /**
  * Response from batch draft creation
@@ -1919,6 +1934,21 @@ declare class MessagingResource {
      * Create a single draft message
      */
     createDraft(userId: string, request: CreateDraftRequest): Promise<DraftResponse>;
+    /**
+     * Get a draft by ID.
+     *
+     * @param userId - User ID or email
+     * @param draftId - Draft UUID
+     * @returns Promise resolving to DraftResponse
+     * @throws MessagingNotFoundError if draft not found (404) or other API error
+     *
+     * @example
+     * ```typescript
+     * const draft = await client.messaging.getDraft('user@example.com', 'draft-uuid');
+     * console.log(draft.content);
+     * ```
+     */
+    getDraft(userId: string, draftId: string): Promise<DraftResponse>;
     /**
      * Create drafts for multiple prospects with AI generation
      */

package/dist/index.d.ts

@@ -516,10 +516,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 +529,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 +557,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;
     /**
@@ -1588,6 +1601,8 @@ interface DraftResponse {
     conversationId?: string | null;
     /** Outreach method used for this draft: 'connection_request' | 'direct_message' | 'inmail' | 'email' */
     outreachMethod?: 'direct_message' | 'connection_request' | 'inmail' | 'email' | null;
+    /** Subject line for email drafts (optional) */
+    subject?: string | null;
 }
 /**
  * Response from batch draft creation
@@ -1919,6 +1934,21 @@ declare class MessagingResource {
      * Create a single draft message
      */
     createDraft(userId: string, request: CreateDraftRequest): Promise<DraftResponse>;
+    /**
+     * Get a draft by ID.
+     *
+     * @param userId - User ID or email
+     * @param draftId - Draft UUID
+     * @returns Promise resolving to DraftResponse
+     * @throws MessagingNotFoundError if draft not found (404) or other API error
+     *
+     * @example
+     * ```typescript
+     * const draft = await client.messaging.getDraft('user@example.com', 'draft-uuid');
+     * console.log(draft.content);
+     * ```
+     */
+    getDraft(userId: string, draftId: string): Promise<DraftResponse>;
     /**
      * Create drafts for multiple prospects with AI generation
      */

package/dist/index.mjs

@@ -408,42 +408,6 @@ class MCPServersResource {
   }
 }
 
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function isUUID(s) {
-  return UUID_PATTERN.test(s);
-}
-function toCamel(s) {
-  if (isUUID(s))
-    return s;
-  return s.replace(/([-_][a-z])/gi, ($1) => {
-    return $1.toUpperCase().replace("-", "").replace("_", "");
-  });
-}
-function toSnake(s) {
-  if (isUUID(s))
-    return s;
-  return s.replace(/[A-Z]/g, (letter, index) => {
-    return index === 0 ? letter.toLowerCase() : `_${letter.toLowerCase()}`;
-  });
-}
-function convertCase(obj, converter) {
-  if (Array.isArray(obj)) {
-    return obj.map((v) => convertCase(v, converter));
-  } else if (obj !== null && typeof obj === "object") {
-    return Object.keys(obj).reduce((acc, key) => {
-      acc[converter(key)] = convertCase(obj[key], converter);
-      return acc;
-    }, {});
-  }
-  return obj;
-}
-function toCamelCase(obj) {
-  return convertCase(obj, toCamel);
-}
-function toSnakeCase(obj) {
-  return convertCase(obj, toSnake);
-}
-
 class LumnisError extends Error {
   code;
   statusCode;
@@ -548,6 +512,42 @@ class MessagingConnectionError extends MessagingAPIError {
   }
 }
 
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUUID(s) {
+  return UUID_PATTERN.test(s);
+}
+function toCamel(s) {
+  if (isUUID(s))
+    return s;
+  return s.replace(/([-_][a-z])/gi, ($1) => {
+    return $1.toUpperCase().replace("-", "").replace("_", "");
+  });
+}
+function toSnake(s) {
+  if (isUUID(s))
+    return s;
+  return s.replace(/[A-Z]/g, (letter, index) => {
+    return index === 0 ? letter.toLowerCase() : `_${letter.toLowerCase()}`;
+  });
+}
+function convertCase(obj, converter) {
+  if (Array.isArray(obj)) {
+    return obj.map((v) => convertCase(v, converter));
+  } else if (obj !== null && typeof obj === "object") {
+    return Object.keys(obj).reduce((acc, key) => {
+      acc[converter(key)] = convertCase(obj[key], converter);
+      return acc;
+    }, {});
+  }
+  return obj;
+}
+function toCamelCase(obj) {
+  return convertCase(obj, toCamel);
+}
+function toSnakeCase(obj) {
+  return convertCase(obj, toSnake);
+}
+
 class MessagingResource {
   constructor(http) {
     this.http = http;
@@ -753,6 +753,34 @@ class MessagingResource {
       request
     );
   }
+  /**
+   * Get a draft by ID.
+   *
+   * @param userId - User ID or email
+   * @param draftId - Draft UUID
+   * @returns Promise resolving to DraftResponse
+   * @throws MessagingNotFoundError if draft not found (404) or other API error
+   *
+   * @example
+   * ```typescript
+   * const draft = await client.messaging.getDraft('user@example.com', 'draft-uuid');
+   * console.log(draft.content);
+   * ```
+   */
+  async getDraft(userId, draftId) {
+    try {
+      const queryParams = new URLSearchParams();
+      queryParams.append("user_id", userId);
+      return await this.http.get(
+        `/messaging/drafts/${encodeURIComponent(draftId)}?${queryParams.toString()}`
+      );
+    } catch (error) {
+      if (error instanceof NotFoundError) {
+        throw new MessagingNotFoundError(`Draft not found: ${draftId}`);
+      }
+      throw error;
+    }
+  }
   /**
    * Create drafts for multiple prospects with AI generation
    */
@@ -914,7 +942,7 @@ class MessagingResource {
                 break;
               }
             }
-          } catch (parseError) {
+          } catch {
             continue;
           }
         }
@@ -1041,7 +1069,7 @@ class MessagingResource {
                 errorDetails: completeData.errorDetails || []
               };
             }
-          } catch (parseError) {
+          } catch {
             continue;
           }
         }
@@ -1187,10 +1215,14 @@ class MessagingResource {
     const queryParams = new URLSearchParams();
     queryParams.append("user_id", userId);
     const payload = {};
-    if (request.email) payload.email = request.email;
-    if (request.linkedinUrl) payload.linkedin_url = request.linkedinUrl;
-    if (request.providerId) payload.provider_id = request.providerId;
-    if (request.channels) payload.channels = request.channels;
+    if (request.email)
+      payload.email = request.email;
+    if (request.linkedinUrl)
+      payload.linkedin_url = request.linkedinUrl;
+    if (request.providerId)
+      payload.provider_id = request.providerId;
+    if (request.channels)
+      payload.channels = request.channels;
     if (request.messageLimit !== void 0 && request.messageLimit !== null) {
       payload.message_limit = request.messageLimit;
     }
@@ -1258,7 +1290,8 @@ class MessagingResource {
         provider_id: p.providerId || void 0
       }))
     };
-    if (request.channels) payload.channels = request.channels;
+    if (request.channels)
+      payload.channels = request.channels;
     if (request.messageLimit !== void 0 && request.messageLimit !== null) {
       payload.message_limit = request.messageLimit;
     }

package/package.json

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