lumnisai 0.2.17 → 0.2.18

package/dist/index.cjs

@@ -2360,6 +2360,30 @@ class ResponsesResource {
         params.excludePreviouslyContacted = options.excludePreviouslyContacted;
       if (options.excludeNames)
         params.excludeNames = options.excludeNames;
+      if (options.searchProfiles !== void 0)
+        params.searchProfiles = options.searchProfiles;
+      if (options.searchPosts !== void 0)
+        params.searchPosts = options.searchPosts;
+      if (options.includeEngagementInScore !== void 0)
+        params.includeEngagementInScore = options.includeEngagementInScore;
+      if (options.postsMaxResults !== void 0)
+        params.postsMaxResults = options.postsMaxResults;
+      if (options.postsMaxKeywords !== void 0)
+        params.postsMaxKeywords = options.postsMaxKeywords;
+      if (options.postsDateRange)
+        params.postsDateRange = options.postsDateRange;
+      if (options.postsFields)
+        params.postsFields = options.postsFields;
+      if (options.postsMaxReactors !== void 0)
+        params.postsMaxReactors = options.postsMaxReactors;
+      if (options.postsMaxComments !== void 0)
+        params.postsMaxComments = options.postsMaxComments;
+      if (options.postsEnableEnrichment !== void 0)
+        params.postsEnableEnrichment = options.postsEnableEnrichment;
+      if (options.postsEnableFiltering !== void 0)
+        params.postsEnableFiltering = options.postsEnableFiltering;
+      if (options.engagementScoreWeight !== void 0)
+        params.engagementScoreWeight = options.engagementScoreWeight;
       if (Object.keys(params).length > 0)
         request.specializedAgentParams = params;
     }

package/dist/index.d.cts

@@ -228,7 +228,7 @@ interface TenantDetailsResponse {
     updatedAt: string;
 }
 
-type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'CORESIGNAL_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'E2B_API_KEY';
+type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'CORESIGNAL_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'PDL_API_KEY' | 'CRUSTDATA_API_KEY' | 'ENRICH_LAYER_API_KEY' | 'E2B_API_KEY' | 'AWS_ACCESS_KEY_ID' | 'AWS_SECRET_ACCESS_KEY';
 interface StoreApiKeyRequest {
     provider: ApiProvider;
     apiKey: string;
@@ -803,6 +803,94 @@ interface SpecializedAgentParams {
      * Each candidate must include at least one identifier: linkedin_url or email/emails.
      */
     candidateProfiles?: Array<Record<string, any>>;
+    /**
+     * Whether to search profile databases (CrustData/PDL).
+     * Options: true (always), false (never), 'auto' (LLM decides).
+     * @default true
+     * Used by deep_people_search.
+     */
+    searchProfiles?: boolean | 'auto';
+    /**
+     * Whether to search LinkedIn posts for engagement (authors, reactors, commenters).
+     * Options: true (always), false (never), 'auto' (LLM decides based on query).
+     * @default 'auto'
+     * Used by deep_people_search.
+     */
+    searchPosts?: boolean | 'auto';
+    /**
+     * Whether to include LinkedIn post engagement in candidate scoring.
+     * Options: true (always), false (never), 'auto' (LLM decides).
+     * @default 'auto'
+     * Used by deep_people_search.
+     */
+    includeEngagementInScore?: boolean | 'auto';
+    /**
+     * Maximum number of posts to search.
+     * Range: 1-500
+     * @default 50
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsMaxResults?: number;
+    /**
+     * Maximum number of keywords to use for posts search.
+     * If not provided, all extracted keywords are used.
+     * Range: 1-20
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsMaxKeywords?: number;
+    /**
+     * Date range for posts search.
+     * Options: 'past-24h', 'past-week', 'past-month', 'past-year'
+     * @default 'past-month'
+     * Used by deep_people_search.
+     */
+    postsDateRange?: 'past-24h' | 'past-week' | 'past-month' | 'past-year';
+    /**
+     * Engagement fields to fetch from posts.
+     * Options: 'reactors' (5 credits/post), 'comments' (5 credits/post), 'reactors,comments' (10 credits/post)
+     * @default 'reactors'
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsFields?: 'reactors' | 'comments' | 'reactors,comments';
+    /**
+     * Maximum reactors per post to fetch.
+     * Range: 1-5000
+     * @default 5000
+     * No additional cost (same 5 credits/post for 1-5000 reactors).
+     * Used by deep_people_search when postsFields includes 'reactors'.
+     */
+    postsMaxReactors?: number;
+    /**
+     * Maximum comments per post to fetch.
+     * Range: 1-5000
+     * @default 5000
+     * No additional cost (same 5 credits/post for 1-5000 comments).
+     * Used by deep_people_search when postsFields includes 'comments'.
+     */
+    postsMaxComments?: number;
+    /**
+     * Whether to enrich posts candidates with EnrichLayer.
+     * @default false
+     * CrustData posts API already provides rich data (skills, experience, education).
+     * Enable only if you need additional fields from EnrichLayer.
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsEnableEnrichment?: boolean;
+    /**
+     * Whether to filter posts for relevance before extracting people.
+     * @default true
+     * Uses LLM to identify and skip hiring posts, spam, and irrelevant content.
+     * Improves candidate quality at cost of ~1 LLM call per post.
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsEnableFiltering?: boolean;
+    /**
+     * Weight for engagement score when included in match score calculation.
+     * Range: 0.0-0.3
+     * @default 0.15
+     * Used by deep_people_search when includeEngagementInScore is true.
+     */
+    engagementScoreWeight?: number;
     /**
      * Additional parameters for any specialized agent
      * This allows flexibility for future agents without SDK updates
@@ -3055,6 +3143,18 @@ declare class ResponsesResource {
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
+        searchProfiles?: boolean | 'auto';
+        searchPosts?: boolean | 'auto';
+        includeEngagementInScore?: boolean | 'auto';
+        postsMaxResults?: number;
+        postsMaxKeywords?: number;
+        postsDateRange?: 'past-24h' | 'past-week' | 'past-month' | 'past-year';
+        postsFields?: 'reactors' | 'comments' | 'reactors,comments';
+        postsMaxReactors?: number;
+        postsMaxComments?: number;
+        postsEnableEnrichment?: boolean;
+        postsEnableFiltering?: boolean;
+        engagementScoreWeight?: number;
     }): Promise<CreateResponseResponse>;
     /**
      * Score provided candidates against AI-generated or provided criteria

package/dist/index.d.mts

@@ -228,7 +228,7 @@ interface TenantDetailsResponse {
     updatedAt: string;
 }
 
-type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'CORESIGNAL_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'E2B_API_KEY';
+type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'CORESIGNAL_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'PDL_API_KEY' | 'CRUSTDATA_API_KEY' | 'ENRICH_LAYER_API_KEY' | 'E2B_API_KEY' | 'AWS_ACCESS_KEY_ID' | 'AWS_SECRET_ACCESS_KEY';
 interface StoreApiKeyRequest {
     provider: ApiProvider;
     apiKey: string;
@@ -803,6 +803,94 @@ interface SpecializedAgentParams {
      * Each candidate must include at least one identifier: linkedin_url or email/emails.
      */
     candidateProfiles?: Array<Record<string, any>>;
+    /**
+     * Whether to search profile databases (CrustData/PDL).
+     * Options: true (always), false (never), 'auto' (LLM decides).
+     * @default true
+     * Used by deep_people_search.
+     */
+    searchProfiles?: boolean | 'auto';
+    /**
+     * Whether to search LinkedIn posts for engagement (authors, reactors, commenters).
+     * Options: true (always), false (never), 'auto' (LLM decides based on query).
+     * @default 'auto'
+     * Used by deep_people_search.
+     */
+    searchPosts?: boolean | 'auto';
+    /**
+     * Whether to include LinkedIn post engagement in candidate scoring.
+     * Options: true (always), false (never), 'auto' (LLM decides).
+     * @default 'auto'
+     * Used by deep_people_search.
+     */
+    includeEngagementInScore?: boolean | 'auto';
+    /**
+     * Maximum number of posts to search.
+     * Range: 1-500
+     * @default 50
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsMaxResults?: number;
+    /**
+     * Maximum number of keywords to use for posts search.
+     * If not provided, all extracted keywords are used.
+     * Range: 1-20
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsMaxKeywords?: number;
+    /**
+     * Date range for posts search.
+     * Options: 'past-24h', 'past-week', 'past-month', 'past-year'
+     * @default 'past-month'
+     * Used by deep_people_search.
+     */
+    postsDateRange?: 'past-24h' | 'past-week' | 'past-month' | 'past-year';
+    /**
+     * Engagement fields to fetch from posts.
+     * Options: 'reactors' (5 credits/post), 'comments' (5 credits/post), 'reactors,comments' (10 credits/post)
+     * @default 'reactors'
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsFields?: 'reactors' | 'comments' | 'reactors,comments';
+    /**
+     * Maximum reactors per post to fetch.
+     * Range: 1-5000
+     * @default 5000
+     * No additional cost (same 5 credits/post for 1-5000 reactors).
+     * Used by deep_people_search when postsFields includes 'reactors'.
+     */
+    postsMaxReactors?: number;
+    /**
+     * Maximum comments per post to fetch.
+     * Range: 1-5000
+     * @default 5000
+     * No additional cost (same 5 credits/post for 1-5000 comments).
+     * Used by deep_people_search when postsFields includes 'comments'.
+     */
+    postsMaxComments?: number;
+    /**
+     * Whether to enrich posts candidates with EnrichLayer.
+     * @default false
+     * CrustData posts API already provides rich data (skills, experience, education).
+     * Enable only if you need additional fields from EnrichLayer.
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsEnableEnrichment?: boolean;
+    /**
+     * Whether to filter posts for relevance before extracting people.
+     * @default true
+     * Uses LLM to identify and skip hiring posts, spam, and irrelevant content.
+     * Improves candidate quality at cost of ~1 LLM call per post.
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsEnableFiltering?: boolean;
+    /**
+     * Weight for engagement score when included in match score calculation.
+     * Range: 0.0-0.3
+     * @default 0.15
+     * Used by deep_people_search when includeEngagementInScore is true.
+     */
+    engagementScoreWeight?: number;
     /**
      * Additional parameters for any specialized agent
      * This allows flexibility for future agents without SDK updates
@@ -3055,6 +3143,18 @@ declare class ResponsesResource {
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
+        searchProfiles?: boolean | 'auto';
+        searchPosts?: boolean | 'auto';
+        includeEngagementInScore?: boolean | 'auto';
+        postsMaxResults?: number;
+        postsMaxKeywords?: number;
+        postsDateRange?: 'past-24h' | 'past-week' | 'past-month' | 'past-year';
+        postsFields?: 'reactors' | 'comments' | 'reactors,comments';
+        postsMaxReactors?: number;
+        postsMaxComments?: number;
+        postsEnableEnrichment?: boolean;
+        postsEnableFiltering?: boolean;
+        engagementScoreWeight?: number;
     }): Promise<CreateResponseResponse>;
     /**
      * Score provided candidates against AI-generated or provided criteria

package/dist/index.d.ts

@@ -228,7 +228,7 @@ interface TenantDetailsResponse {
     updatedAt: string;
 }
 
-type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'CORESIGNAL_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'E2B_API_KEY';
+type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'CORESIGNAL_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'PDL_API_KEY' | 'CRUSTDATA_API_KEY' | 'ENRICH_LAYER_API_KEY' | 'E2B_API_KEY' | 'AWS_ACCESS_KEY_ID' | 'AWS_SECRET_ACCESS_KEY';
 interface StoreApiKeyRequest {
     provider: ApiProvider;
     apiKey: string;
@@ -803,6 +803,94 @@ interface SpecializedAgentParams {
      * Each candidate must include at least one identifier: linkedin_url or email/emails.
      */
     candidateProfiles?: Array<Record<string, any>>;
+    /**
+     * Whether to search profile databases (CrustData/PDL).
+     * Options: true (always), false (never), 'auto' (LLM decides).
+     * @default true
+     * Used by deep_people_search.
+     */
+    searchProfiles?: boolean | 'auto';
+    /**
+     * Whether to search LinkedIn posts for engagement (authors, reactors, commenters).
+     * Options: true (always), false (never), 'auto' (LLM decides based on query).
+     * @default 'auto'
+     * Used by deep_people_search.
+     */
+    searchPosts?: boolean | 'auto';
+    /**
+     * Whether to include LinkedIn post engagement in candidate scoring.
+     * Options: true (always), false (never), 'auto' (LLM decides).
+     * @default 'auto'
+     * Used by deep_people_search.
+     */
+    includeEngagementInScore?: boolean | 'auto';
+    /**
+     * Maximum number of posts to search.
+     * Range: 1-500
+     * @default 50
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsMaxResults?: number;
+    /**
+     * Maximum number of keywords to use for posts search.
+     * If not provided, all extracted keywords are used.
+     * Range: 1-20
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsMaxKeywords?: number;
+    /**
+     * Date range for posts search.
+     * Options: 'past-24h', 'past-week', 'past-month', 'past-year'
+     * @default 'past-month'
+     * Used by deep_people_search.
+     */
+    postsDateRange?: 'past-24h' | 'past-week' | 'past-month' | 'past-year';
+    /**
+     * Engagement fields to fetch from posts.
+     * Options: 'reactors' (5 credits/post), 'comments' (5 credits/post), 'reactors,comments' (10 credits/post)
+     * @default 'reactors'
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsFields?: 'reactors' | 'comments' | 'reactors,comments';
+    /**
+     * Maximum reactors per post to fetch.
+     * Range: 1-5000
+     * @default 5000
+     * No additional cost (same 5 credits/post for 1-5000 reactors).
+     * Used by deep_people_search when postsFields includes 'reactors'.
+     */
+    postsMaxReactors?: number;
+    /**
+     * Maximum comments per post to fetch.
+     * Range: 1-5000
+     * @default 5000
+     * No additional cost (same 5 credits/post for 1-5000 comments).
+     * Used by deep_people_search when postsFields includes 'comments'.
+     */
+    postsMaxComments?: number;
+    /**
+     * Whether to enrich posts candidates with EnrichLayer.
+     * @default false
+     * CrustData posts API already provides rich data (skills, experience, education).
+     * Enable only if you need additional fields from EnrichLayer.
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsEnableEnrichment?: boolean;
+    /**
+     * Whether to filter posts for relevance before extracting people.
+     * @default true
+     * Uses LLM to identify and skip hiring posts, spam, and irrelevant content.
+     * Improves candidate quality at cost of ~1 LLM call per post.
+     * Used by deep_people_search when searchPosts is enabled.
+     */
+    postsEnableFiltering?: boolean;
+    /**
+     * Weight for engagement score when included in match score calculation.
+     * Range: 0.0-0.3
+     * @default 0.15
+     * Used by deep_people_search when includeEngagementInScore is true.
+     */
+    engagementScoreWeight?: number;
     /**
      * Additional parameters for any specialized agent
      * This allows flexibility for future agents without SDK updates
@@ -3055,6 +3143,18 @@ declare class ResponsesResource {
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
+        searchProfiles?: boolean | 'auto';
+        searchPosts?: boolean | 'auto';
+        includeEngagementInScore?: boolean | 'auto';
+        postsMaxResults?: number;
+        postsMaxKeywords?: number;
+        postsDateRange?: 'past-24h' | 'past-week' | 'past-month' | 'past-year';
+        postsFields?: 'reactors' | 'comments' | 'reactors,comments';
+        postsMaxReactors?: number;
+        postsMaxComments?: number;
+        postsEnableEnrichment?: boolean;
+        postsEnableFiltering?: boolean;
+        engagementScoreWeight?: number;
     }): Promise<CreateResponseResponse>;
     /**
      * Score provided candidates against AI-generated or provided criteria

package/dist/index.mjs

@@ -2354,6 +2354,30 @@ class ResponsesResource {
         params.excludePreviouslyContacted = options.excludePreviouslyContacted;
       if (options.excludeNames)
         params.excludeNames = options.excludeNames;
+      if (options.searchProfiles !== void 0)
+        params.searchProfiles = options.searchProfiles;
+      if (options.searchPosts !== void 0)
+        params.searchPosts = options.searchPosts;
+      if (options.includeEngagementInScore !== void 0)
+        params.includeEngagementInScore = options.includeEngagementInScore;
+      if (options.postsMaxResults !== void 0)
+        params.postsMaxResults = options.postsMaxResults;
+      if (options.postsMaxKeywords !== void 0)
+        params.postsMaxKeywords = options.postsMaxKeywords;
+      if (options.postsDateRange)
+        params.postsDateRange = options.postsDateRange;
+      if (options.postsFields)
+        params.postsFields = options.postsFields;
+      if (options.postsMaxReactors !== void 0)
+        params.postsMaxReactors = options.postsMaxReactors;
+      if (options.postsMaxComments !== void 0)
+        params.postsMaxComments = options.postsMaxComments;
+      if (options.postsEnableEnrichment !== void 0)
+        params.postsEnableEnrichment = options.postsEnableEnrichment;
+      if (options.postsEnableFiltering !== void 0)
+        params.postsEnableFiltering = options.postsEnableFiltering;
+      if (options.engagementScoreWeight !== void 0)
+        params.engagementScoreWeight = options.engagementScoreWeight;
       if (Object.keys(params).length > 0)
         request.specializedAgentParams = params;
     }

package/package.json

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