lumnisai 0.5.45 → 0.5.46

package/dist/index.cjs

@@ -3250,6 +3250,9 @@ const ENGAGEMENT_ACTIVITIES = [
   "comments",
   "authored_posts"
 ];
+const MAX_SIGNAL_CONTEXT_CHARS = 4e3;
+const MAX_CONTENT_INTELLIGENCE_COMPETITORS = 5;
+const MAX_CONTENT_INTELLIGENCE_COMPETITOR_CHARS = 200;
 class ResponsesResource {
   constructor(http) {
     this.http = http;
@@ -3499,12 +3502,16 @@ class ResponsesResource {
       }
       seen.add(name);
       for (const key of Object.keys(entry)) {
-        if (key !== "name" && key !== "settings") {
+        if (key !== "name" && key !== "settings" && key !== "context") {
           throw new ValidationError(
-            `Unknown signalDefinitions field '${key}'. Each entry accepts only name and settings.`
+            `Unknown signalDefinitions field '${key}'. Each entry accepts only name, settings, and context.`
           );
         }
       }
+      this._validateContextBrief(
+        this._getParamValue(entry, "context", "context"),
+        `signalDefinitions '${name}' context`
+      );
       this._validateSignalSettings(
         name,
         this._getParamValue(entry, "settings", "settings")
@@ -3545,6 +3552,14 @@ class ResponsesResource {
       "postsDateRange"
     );
   }
+  _validateContextBrief(value, field) {
+    if (value === void 0 || value === null)
+      return;
+    if (typeof value !== "string")
+      throw new ValidationError(`${field} must be plain text`);
+    if ([...value.trim()].length > MAX_SIGNAL_CONTEXT_CHARS)
+      throw new ValidationError(`${field} must be at most ${MAX_SIGNAL_CONTEXT_CHARS} characters`);
+  }
   _validateCompetitorRepEngagementParams(params) {
     const company = this._getParamValue(params, "company", "company");
     const competitors = this._getParamValue(params, "competitors", "competitors");
@@ -3627,6 +3642,91 @@ class ResponsesResource {
         }
       }
     }
+    const rawCompetitors = this._getParamValue(params, "competitors", "competitors");
+    const competitors = this._normalizedContentIntelligenceCompetitors(rawCompetitors);
+    if (competitors.length > MAX_CONTENT_INTELLIGENCE_COMPETITORS) {
+      throw new ValidationError(
+        `competitors must contain at most ${MAX_CONTENT_INTELLIGENCE_COMPETITORS} distinct values`
+      );
+    }
+    const rawCompany = this._getParamValue(params, "company", "company");
+    let company;
+    if (rawCompany !== void 0 && rawCompany !== null) {
+      if (typeof rawCompany !== "string")
+        throw new ValidationError("company must be a string for content_intelligence");
+      company = rawCompany.trim() || void 0;
+      if (company && [...company].length > MAX_CONTENT_INTELLIGENCE_COMPETITOR_CHARS) {
+        throw new ValidationError(
+          `company must be at most ${MAX_CONTENT_INTELLIGENCE_COMPETITOR_CHARS} characters`
+        );
+      }
+    }
+    const normalizedCompany = company?.toLowerCase();
+    if (normalizedCompany && competitors.some((competitor) => competitor.toLowerCase() === normalizedCompany)) {
+      throw new ValidationError(
+        `company '${company}' is also listed in competitors; name it on one side only`
+      );
+    }
+    for (const [camel, snake] of [
+      ["includeCompanyPosts", "include_company_posts"],
+      ["includeExecPosts", "include_exec_posts"]
+    ]) {
+      const value = this._getParamValue(params, camel, snake);
+      if (value !== void 0 && typeof value !== "boolean")
+        throw new ValidationError(`${camel} must be true or false`);
+    }
+    const includeCompanyPosts = this._getParamValue(
+      params,
+      "includeCompanyPosts",
+      "include_company_posts"
+    );
+    const includeExecPosts = this._getParamValue(
+      params,
+      "includeExecPosts",
+      "include_exec_posts"
+    );
+    if (competitors.length > 0 && includeCompanyPosts === false && includeExecPosts === false) {
+      throw new ValidationError(
+        "competitors were provided but includeCompanyPosts and includeExecPosts are both false"
+      );
+    }
+    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");
+    }
+    const maxExecsPerTarget = this._getParamValue(
+      params,
+      "maxExecsPerTarget",
+      "max_execs_per_target"
+    );
+    if (maxExecsPerTarget !== void 0 && (!Number.isInteger(maxExecsPerTarget) || maxExecsPerTarget < 1 || maxExecsPerTarget > 20)) {
+      throw new ValidationError("maxExecsPerTarget must be an integer between 1 and 20");
+    }
+  }
+  _normalizedContentIntelligenceCompetitors(value) {
+    if (value === void 0 || value === null)
+      return [];
+    const values = typeof value === "string" ? [value] : value;
+    if (!Array.isArray(values) || values.some((entry) => typeof entry !== "string"))
+      throw new ValidationError("competitors must be an array of strings");
+    const seen = /* @__PURE__ */ new Set();
+    const normalized = [];
+    for (const entry of values) {
+      const competitor = entry.trim();
+      if (!competitor)
+        continue;
+      if ([...competitor].length > MAX_CONTENT_INTELLIGENCE_COMPETITOR_CHARS) {
+        throw new ValidationError(
+          `each competitor must be at most ${MAX_CONTENT_INTELLIGENCE_COMPETITOR_CHARS} characters`
+        );
+      }
+      const key = competitor.toLowerCase();
+      if (!seen.has(key)) {
+        seen.add(key);
+        normalized.push(competitor);
+      }
+    }
+    return normalized;
   }
   _validateEngagementExpansionParams(params) {
     const expandFromResponse = this._getParamValue(
@@ -4317,6 +4417,10 @@ class ResponsesResource {
    * `reusePackageFrom` to re-cook a saved package without collecting again.
    * `companyContext` and `contentDirection` steer post ideas only; collection,
    * curation, and engagement analysis remain an unbiased read of the audience.
+   * Add `competitors` to receive a separate publication report over the same
+   * window; competitor posts never enter the audience package or metrics. Add
+   * `company` to put the caller's own publication activity beside those
+   * competitors in the report.
    *
    * @param query - Natural-language description of the audience. A nonblank
    *   message is required even when reusing a package.
@@ -4343,6 +4447,18 @@ class ResponsesResource {
       params.reusePackageFrom = options.reusePackageFrom;
     if (options.outputs !== void 0)
       params.outputs = options.outputs;
+    if (options.competitors !== void 0)
+      params.competitors = options.competitors;
+    if (options.company !== void 0)
+      params.company = options.company;
+    if (options.includeCompanyPosts !== void 0)
+      params.includeCompanyPosts = options.includeCompanyPosts;
+    if (options.includeExecPosts !== void 0)
+      params.includeExecPosts = options.includeExecPosts;
+    if (options.execTitles !== void 0)
+      params.execTitles = options.execTitles;
+    if (options.maxExecsPerTarget !== void 0)
+      params.maxExecsPerTarget = options.maxExecsPerTarget;
     return this.create({
       messages: [{ role: "user", content: query }],
       specializedAgent: "content_intelligence",