lumnisai 0.5.31 → 0.5.33

package/dist/index.cjs

@@ -3366,6 +3366,62 @@ class ResponsesResource {
       throw new ValidationError("maxEngagementsPerRep must be between 1 and 1000");
     }
   }
+  _validateContentIntelligenceParams(params) {
+    const limit = this._getParamValue(params, "limit", "limit");
+    if (limit !== void 0 && (!Number.isInteger(limit) || limit < 1 || limit > 1e3))
+      throw new ValidationError("limit must be an integer between 1 and 1000 for content_intelligence");
+    const exaResultsPerQuery = this._getParamValue(
+      params,
+      "exaResultsPerQuery",
+      "exa_results_per_query"
+    );
+    if (exaResultsPerQuery !== void 0 && (!Number.isInteger(exaResultsPerQuery) || exaResultsPerQuery < 1)) {
+      throw new ValidationError("exaResultsPerQuery must be a positive integer");
+    }
+    const outputs = this._getParamValue(params, "outputs", "outputs");
+    if (outputs !== void 0) {
+      if (!Array.isArray(outputs) || outputs.length === 0)
+        throw new ValidationError("outputs must contain at least one value");
+      const supported = [
+        "top_posts",
+        "post_ideas",
+        "engagement_analysis"
+      ];
+      for (const output of outputs) {
+        if (!supported.includes(output)) {
+          throw new ValidationError(
+            `Invalid content_intelligence output: ${String(output)}. Supported outputs: ${supported.join(", ")}.`
+          );
+        }
+      }
+    }
+  }
+  _validateEngagementExpansionParams(params) {
+    const expandFromResponse = this._getParamValue(
+      params,
+      "expandFromResponse",
+      "expand_from_response"
+    );
+    if (typeof expandFromResponse !== "string" || !expandFromResponse.trim()) {
+      throw new ValidationError(
+        "expandFromResponse is required for engagement_expansion and must be a non-empty string"
+      );
+    }
+    for (const [camel, snake] of [
+      ["hops", "hops"],
+      ["postsPerHop", "posts_per_hop"],
+      ["peoplePerNextHop", "people_per_next_hop"],
+      ["limit", "limit"]
+    ]) {
+      const value = this._getParamValue(params, camel, snake);
+      if (value !== void 0 && (!Number.isInteger(value) || value < 1))
+        throw new ValidationError(`${camel} must be a positive integer for engagement_expansion`);
+    }
+    const excludeUrls = this._getParamValue(params, "excludeUrls", "exclude_urls");
+    if (excludeUrls !== void 0 && (!Array.isArray(excludeUrls) || excludeUrls.some((url) => typeof url !== "string"))) {
+      throw new ValidationError("excludeUrls must be an array of strings for engagement_expansion");
+    }
+  }
   _validateCriteriaParams(params, specializedAgent) {
     if (!params)
       return;
@@ -3477,6 +3533,10 @@ class ResponsesResource {
       this._validateCompetitorPostEngagementParams(rawParams);
     if (specializedAgent === "competitor_rep_engagement")
       this._validateCompetitorRepEngagementParams(rawParams);
+    if (specializedAgent === "content_intelligence")
+      this._validateContentIntelligenceParams(rawParams);
+    if (specializedAgent === "engagement_expansion")
+      this._validateEngagementExpansionParams(rawParams);
   }
   _validateFileReference(uri) {
     if (uri.startsWith("artifact_"))
@@ -3791,6 +3851,80 @@ class ResponsesResource {
     }
     return this.create(request);
   }
+  /**
+   * Discover what content a described audience engages with on LinkedIn.
+   *
+   * The backend searches for the audience, collects their reaction history,
+   * saves the normalized package, and produces grounded views from it. Pass
+   * `reusePackageFrom` to re-cook a saved package without collecting again.
+   *
+   * @param query - Natural-language description of the audience. A nonblank
+   *   message is required even when reusing a package.
+   * @param options - Audience, collection-window, package-reuse, and output controls.
+   *   Omit `outputs` to use the backend's default set.
+   */
+  async contentIntelligence(query, options = {}) {
+    if (!query.trim())
+      throw new ValidationError("contentIntelligence requires a non-empty audience query");
+    const params = {};
+    if (options.limit !== void 0)
+      params.limit = options.limit;
+    if (options.postsDateRange !== void 0)
+      params.postsDateRange = options.postsDateRange;
+    if (options.postsEnableFiltering !== void 0)
+      params.postsEnableFiltering = options.postsEnableFiltering;
+    if (options.exaResultsPerQuery !== void 0)
+      params.exaResultsPerQuery = options.exaResultsPerQuery;
+    if (options.reusePackageFrom !== void 0)
+      params.reusePackageFrom = options.reusePackageFrom;
+    if (options.outputs !== void 0)
+      params.outputs = options.outputs;
+    return this.create({
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "content_intelligence",
+      specializedAgentParams: params
+    });
+  }
+  /**
+   * Find new people by walking outward from a saved content-intelligence package.
+   *
+   * Hop 1 pulls the other engagers of the package's best posts. Additional hops
+   * select the highest-fit new people, rank posts from their feeds, and pull the
+   * engagers of those posts. Collection breadth is derived from `limit` unless
+   * `postsPerHop` is set explicitly. At the default limit, collection is about
+   * 300 credits for one hop and 1,060 for three hops; enrichment and validation
+   * use the standard deep-search economics on top.
+   *
+   * @param query - Persona prompt used to rank and validate discovered people.
+   * @param options - Source response plus hop, breadth, limit, and exclusion controls.
+   * @returns Response; poll with `get()` and read `structuredResponse` as
+   *   {@link EngagementExpansionOutput}.
+   */
+  async engagementExpansion(query, options) {
+    if (!query.trim())
+      throw new ValidationError("engagementExpansion requires a non-empty persona query");
+    const params = {
+      expandFromResponse: options?.expandFromResponse
+    };
+    if (options?.hops !== void 0)
+      params.hops = options.hops;
+    if (options?.postsPerHop !== void 0)
+      params.postsPerHop = options.postsPerHop;
+    if (options?.peoplePerNextHop !== void 0)
+      params.peoplePerNextHop = options.peoplePerNextHop;
+    if (options?.limit !== void 0)
+      params.limit = options.limit;
+    if (options?.excludeUrls !== void 0)
+      params.excludeUrls = options.excludeUrls;
+    if (options?.deepValidationUseRelevanceReranker !== void 0) {
+      params.deepValidationUseRelevanceReranker = options.deepValidationUseRelevanceReranker;
+    }
+    return this.create({
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "engagement_expansion",
+      specializedAgentParams: params
+    });
+  }
   /**
    * Score people who reacted to or commented on competitor LinkedIn posts.
    *