lumnisai 0.5.46 → 0.5.48

package/dist/index.cjs

@@ -1934,12 +1934,18 @@ function toSnake(s) {
     return index === 0 ? letter.toLowerCase() : `_${letter.toLowerCase()}`;
   });
 }
+const PASSTHROUGH_VALUE_KEYS = /* @__PURE__ */ new Set([
+  "customFields",
+  "custom_fields",
+  "engagementProfile",
+  "engagement_profile"
+]);
 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) => {
-      const value = key === "customFields" || key === "custom_fields" ? obj[key] : convertCase(obj[key], converter);
+      const value = PASSTHROUGH_VALUE_KEYS.has(key) ? obj[key] : convertCase(obj[key], converter);
       acc[converter(key)] = value;
       return acc;
     }, {});
@@ -3669,7 +3675,8 @@ class ResponsesResource {
     }
     for (const [camel, snake] of [
       ["includeCompanyPosts", "include_company_posts"],
-      ["includeExecPosts", "include_exec_posts"]
+      ["includeExecPosts", "include_exec_posts"],
+      ["includeMentionPosts", "include_mention_posts"]
     ]) {
       const value = this._getParamValue(params, camel, snake);
       if (value !== void 0 && typeof value !== "boolean")
@@ -3685,11 +3692,24 @@ class ResponsesResource {
       "includeExecPosts",
       "include_exec_posts"
     );
-    if (competitors.length > 0 && includeCompanyPosts === false && includeExecPosts === false) {
+    const includeMentionPosts = this._getParamValue(
+      params,
+      "includeMentionPosts",
+      "include_mention_posts"
+    );
+    if (competitors.length > 0 && includeCompanyPosts === false && includeExecPosts === false && includeMentionPosts === false) {
       throw new ValidationError(
-        "competitors were provided but includeCompanyPosts and includeExecPosts are both false"
+        "competitors were provided but includeCompanyPosts, includeExecPosts, and includeMentionPosts are all false"
       );
     }
+    const maxMentionsPerTarget = this._getParamValue(
+      params,
+      "maxMentionsPerTarget",
+      "max_mentions_per_target"
+    );
+    if (maxMentionsPerTarget !== void 0 && (!Number.isInteger(maxMentionsPerTarget) || maxMentionsPerTarget < 1 || maxMentionsPerTarget > 500)) {
+      throw new ValidationError("maxMentionsPerTarget must be an integer between 1 and 500");
+    }
     const execTitles = this._getParamValue(params, "execTitles", "exec_titles");
     if (execTitles !== void 0 && (!Array.isArray(execTitles) || execTitles.some((title) => typeof title !== "string"))) {
       throw new ValidationError("execTitles must be an array of strings");
@@ -4455,6 +4475,10 @@ class ResponsesResource {
       params.includeCompanyPosts = options.includeCompanyPosts;
     if (options.includeExecPosts !== void 0)
       params.includeExecPosts = options.includeExecPosts;
+    if (options.includeMentionPosts !== void 0)
+      params.includeMentionPosts = options.includeMentionPosts;
+    if (options.maxMentionsPerTarget !== void 0)
+      params.maxMentionsPerTarget = options.maxMentionsPerTarget;
     if (options.execTitles !== void 0)
       params.execTitles = options.execTitles;
     if (options.maxExecsPerTarget !== void 0)

package/dist/index.d.cts

@@ -1640,6 +1640,19 @@ interface ContentIntelligenceOptions {
     includeCompanyPosts?: boolean;
     /** Read posts from each competitor's executives. @default true */
     includeExecPosts?: boolean;
+    /**
+     * Read posts by other people that tag each competitor's LinkedIn page, plus
+     * the caller's own company when provided. Targets are matched by page rather
+     * than name. This incurs one CrustData call per target and one credit per post.
+     * @default true
+     */
+    includeMentionPosts?: boolean;
+    /**
+     * Mentions read per target, returned in vendor relevance order.
+     * This is also the worst-case per-target credit charge for mention collection.
+     * @default 50 @minimum 1 @maximum 500
+     */
+    maxMentionsPerTarget?: number;
     /**
      * Executive title stems, most senior first. Supplying this list replaces the
      * backend's default title list.
@@ -1665,6 +1678,10 @@ interface ContentIntelligenceResolvedParams {
     includeCompanyPosts?: boolean;
     /** @default true */
     includeExecPosts?: boolean;
+    /** @default true */
+    includeMentionPosts?: boolean;
+    /** @default 50 */
+    maxMentionsPerTarget?: number;
     /** Null means the backend's default executive-title list was used. */
     execTitles?: string[] | null;
     /** @default 10 */
@@ -3307,6 +3324,8 @@ interface AutoSearchSelection {
     reasoning: string;
     /** True when automatic planning failed and the backend used its standard fallback. */
     plannerFailed?: boolean;
+    /** Last planner failure, present when `plannerFailed` is true. */
+    plannerError?: string;
     /** True when the discovery lane was chosen automatically. */
     autoSelectedLane?: boolean;
     /** True when the signal list was chosen automatically. */
@@ -3970,6 +3989,23 @@ interface SpecializedAgentParams {
      * @default true
      */
     includeExecPosts?: boolean;
+    /**
+     * Include posts by other people that tag each competitor's LinkedIn page,
+     * plus the caller's own company when named. Page identity is used for
+     * matching, so namesakes are excluded. This costs one CrustData call per
+     * target and one credit per returned post.
+     * Used by content_intelligence.
+     * @default true
+     */
+    includeMentionPosts?: boolean;
+    /**
+     * Mentions read per content-intelligence target, in vendor relevance order.
+     * This is also the worst-case per-target credit charge for mention collection.
+     * @default 50
+     * @minimum 1
+     * @maximum 500
+     */
+    maxMentionsPerTarget?: number;
     /**
      * Drop candidates whose current employer is one of the analyzed competitors.
      * Competitor employees reacting to their own company's posts are noise.

package/dist/index.d.mts

@@ -1640,6 +1640,19 @@ interface ContentIntelligenceOptions {
     includeCompanyPosts?: boolean;
     /** Read posts from each competitor's executives. @default true */
     includeExecPosts?: boolean;
+    /**
+     * Read posts by other people that tag each competitor's LinkedIn page, plus
+     * the caller's own company when provided. Targets are matched by page rather
+     * than name. This incurs one CrustData call per target and one credit per post.
+     * @default true
+     */
+    includeMentionPosts?: boolean;
+    /**
+     * Mentions read per target, returned in vendor relevance order.
+     * This is also the worst-case per-target credit charge for mention collection.
+     * @default 50 @minimum 1 @maximum 500
+     */
+    maxMentionsPerTarget?: number;
     /**
      * Executive title stems, most senior first. Supplying this list replaces the
      * backend's default title list.
@@ -1665,6 +1678,10 @@ interface ContentIntelligenceResolvedParams {
     includeCompanyPosts?: boolean;
     /** @default true */
     includeExecPosts?: boolean;
+    /** @default true */
+    includeMentionPosts?: boolean;
+    /** @default 50 */
+    maxMentionsPerTarget?: number;
     /** Null means the backend's default executive-title list was used. */
     execTitles?: string[] | null;
     /** @default 10 */
@@ -3307,6 +3324,8 @@ interface AutoSearchSelection {
     reasoning: string;
     /** True when automatic planning failed and the backend used its standard fallback. */
     plannerFailed?: boolean;
+    /** Last planner failure, present when `plannerFailed` is true. */
+    plannerError?: string;
     /** True when the discovery lane was chosen automatically. */
     autoSelectedLane?: boolean;
     /** True when the signal list was chosen automatically. */
@@ -3970,6 +3989,23 @@ interface SpecializedAgentParams {
      * @default true
      */
     includeExecPosts?: boolean;
+    /**
+     * Include posts by other people that tag each competitor's LinkedIn page,
+     * plus the caller's own company when named. Page identity is used for
+     * matching, so namesakes are excluded. This costs one CrustData call per
+     * target and one credit per returned post.
+     * Used by content_intelligence.
+     * @default true
+     */
+    includeMentionPosts?: boolean;
+    /**
+     * Mentions read per content-intelligence target, in vendor relevance order.
+     * This is also the worst-case per-target credit charge for mention collection.
+     * @default 50
+     * @minimum 1
+     * @maximum 500
+     */
+    maxMentionsPerTarget?: number;
     /**
      * Drop candidates whose current employer is one of the analyzed competitors.
      * Competitor employees reacting to their own company's posts are noise.

package/dist/index.d.ts

@@ -1640,6 +1640,19 @@ interface ContentIntelligenceOptions {
     includeCompanyPosts?: boolean;
     /** Read posts from each competitor's executives. @default true */
     includeExecPosts?: boolean;
+    /**
+     * Read posts by other people that tag each competitor's LinkedIn page, plus
+     * the caller's own company when provided. Targets are matched by page rather
+     * than name. This incurs one CrustData call per target and one credit per post.
+     * @default true
+     */
+    includeMentionPosts?: boolean;
+    /**
+     * Mentions read per target, returned in vendor relevance order.
+     * This is also the worst-case per-target credit charge for mention collection.
+     * @default 50 @minimum 1 @maximum 500
+     */
+    maxMentionsPerTarget?: number;
     /**
      * Executive title stems, most senior first. Supplying this list replaces the
      * backend's default title list.
@@ -1665,6 +1678,10 @@ interface ContentIntelligenceResolvedParams {
     includeCompanyPosts?: boolean;
     /** @default true */
     includeExecPosts?: boolean;
+    /** @default true */
+    includeMentionPosts?: boolean;
+    /** @default 50 */
+    maxMentionsPerTarget?: number;
     /** Null means the backend's default executive-title list was used. */
     execTitles?: string[] | null;
     /** @default 10 */
@@ -3307,6 +3324,8 @@ interface AutoSearchSelection {
     reasoning: string;
     /** True when automatic planning failed and the backend used its standard fallback. */
     plannerFailed?: boolean;
+    /** Last planner failure, present when `plannerFailed` is true. */
+    plannerError?: string;
     /** True when the discovery lane was chosen automatically. */
     autoSelectedLane?: boolean;
     /** True when the signal list was chosen automatically. */
@@ -3970,6 +3989,23 @@ interface SpecializedAgentParams {
      * @default true
      */
     includeExecPosts?: boolean;
+    /**
+     * Include posts by other people that tag each competitor's LinkedIn page,
+     * plus the caller's own company when named. Page identity is used for
+     * matching, so namesakes are excluded. This costs one CrustData call per
+     * target and one credit per returned post.
+     * Used by content_intelligence.
+     * @default true
+     */
+    includeMentionPosts?: boolean;
+    /**
+     * Mentions read per content-intelligence target, in vendor relevance order.
+     * This is also the worst-case per-target credit charge for mention collection.
+     * @default 50
+     * @minimum 1
+     * @maximum 500
+     */
+    maxMentionsPerTarget?: number;
     /**
      * Drop candidates whose current employer is one of the analyzed competitors.
      * Competitor employees reacting to their own company's posts are noise.

package/dist/index.mjs

@@ -1928,12 +1928,18 @@ function toSnake(s) {
     return index === 0 ? letter.toLowerCase() : `_${letter.toLowerCase()}`;
   });
 }
+const PASSTHROUGH_VALUE_KEYS = /* @__PURE__ */ new Set([
+  "customFields",
+  "custom_fields",
+  "engagementProfile",
+  "engagement_profile"
+]);
 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) => {
-      const value = key === "customFields" || key === "custom_fields" ? obj[key] : convertCase(obj[key], converter);
+      const value = PASSTHROUGH_VALUE_KEYS.has(key) ? obj[key] : convertCase(obj[key], converter);
       acc[converter(key)] = value;
       return acc;
     }, {});
@@ -3663,7 +3669,8 @@ class ResponsesResource {
     }
     for (const [camel, snake] of [
       ["includeCompanyPosts", "include_company_posts"],
-      ["includeExecPosts", "include_exec_posts"]
+      ["includeExecPosts", "include_exec_posts"],
+      ["includeMentionPosts", "include_mention_posts"]
     ]) {
       const value = this._getParamValue(params, camel, snake);
       if (value !== void 0 && typeof value !== "boolean")
@@ -3679,11 +3686,24 @@ class ResponsesResource {
       "includeExecPosts",
       "include_exec_posts"
     );
-    if (competitors.length > 0 && includeCompanyPosts === false && includeExecPosts === false) {
+    const includeMentionPosts = this._getParamValue(
+      params,
+      "includeMentionPosts",
+      "include_mention_posts"
+    );
+    if (competitors.length > 0 && includeCompanyPosts === false && includeExecPosts === false && includeMentionPosts === false) {
       throw new ValidationError(
-        "competitors were provided but includeCompanyPosts and includeExecPosts are both false"
+        "competitors were provided but includeCompanyPosts, includeExecPosts, and includeMentionPosts are all false"
       );
     }
+    const maxMentionsPerTarget = this._getParamValue(
+      params,
+      "maxMentionsPerTarget",
+      "max_mentions_per_target"
+    );
+    if (maxMentionsPerTarget !== void 0 && (!Number.isInteger(maxMentionsPerTarget) || maxMentionsPerTarget < 1 || maxMentionsPerTarget > 500)) {
+      throw new ValidationError("maxMentionsPerTarget must be an integer between 1 and 500");
+    }
     const execTitles = this._getParamValue(params, "execTitles", "exec_titles");
     if (execTitles !== void 0 && (!Array.isArray(execTitles) || execTitles.some((title) => typeof title !== "string"))) {
       throw new ValidationError("execTitles must be an array of strings");
@@ -4449,6 +4469,10 @@ class ResponsesResource {
       params.includeCompanyPosts = options.includeCompanyPosts;
     if (options.includeExecPosts !== void 0)
       params.includeExecPosts = options.includeExecPosts;
+    if (options.includeMentionPosts !== void 0)
+      params.includeMentionPosts = options.includeMentionPosts;
+    if (options.maxMentionsPerTarget !== void 0)
+      params.maxMentionsPerTarget = options.maxMentionsPerTarget;
     if (options.execTitles !== void 0)
       params.execTitles = options.execTitles;
     if (options.maxExecsPerTarget !== void 0)

package/package.json

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