lumnisai 0.5.22 → 0.5.23

package/dist/index.cjs

@@ -3128,6 +3128,59 @@ class ResponsesResource {
       throw new ValidationError("maxCommentsPerPost must be between 1 and 100");
     }
   }
+  _validateCompetitorRepEngagementParams(params) {
+    const company = this._getParamValue(params, "company", "company");
+    const competitors = this._getParamValue(params, "competitors", "competitors");
+    const engagementTypes = this._getParamValue(
+      params,
+      "engagementTypes",
+      "engagement_types"
+    );
+    const hasCompany = typeof company === "string" && company.trim().length > 0;
+    const hasCompetitors = Array.isArray(competitors) && competitors.length > 0;
+    if (hasCompany === hasCompetitors) {
+      throw new ValidationError(
+        "Provide exactly one of `company` or `competitors` for competitor_rep_engagement."
+      );
+    }
+    if (engagementTypes !== void 0) {
+      if (!Array.isArray(engagementTypes) || engagementTypes.length === 0) {
+        throw new ValidationError("engagementTypes must contain at least one value");
+      }
+      const validTypes = ["reactor", "commenter"];
+      for (const type of engagementTypes) {
+        if (!validTypes.includes(type)) {
+          throw new ValidationError(
+            `Invalid engagementTypes value: ${String(type)}. Expected 'reactor' and/or 'commenter'.`
+          );
+        }
+      }
+    }
+    const limit = this._getParamValue(params, "limit", "limit");
+    if (limit !== void 0 && (limit < 1 || limit > 1e3)) {
+      throw new ValidationError("limit must be between 1 and 1000 for competitor_rep_engagement");
+    }
+    const maxCompetitors = this._getParamValue(params, "maxCompetitors", "max_competitors");
+    if (maxCompetitors !== void 0 && (maxCompetitors < 1 || maxCompetitors > 50)) {
+      throw new ValidationError("maxCompetitors must be between 1 and 50");
+    }
+    const maxRepsPerCompetitor = this._getParamValue(
+      params,
+      "maxRepsPerCompetitor",
+      "max_reps_per_competitor"
+    );
+    if (maxRepsPerCompetitor !== void 0 && (maxRepsPerCompetitor < 1 || maxRepsPerCompetitor > 100)) {
+      throw new ValidationError("maxRepsPerCompetitor must be between 1 and 100");
+    }
+    const maxEngagementsPerRep = this._getParamValue(
+      params,
+      "maxEngagementsPerRep",
+      "max_engagements_per_rep"
+    );
+    if (maxEngagementsPerRep !== void 0 && (maxEngagementsPerRep < 1 || maxEngagementsPerRep > 1e3)) {
+      throw new ValidationError("maxEngagementsPerRep must be between 1 and 1000");
+    }
+  }
   _validateCriteriaParams(params, specializedAgent) {
     if (!params)
       return;
@@ -3228,6 +3281,8 @@ class ResponsesResource {
     }
     if (specializedAgent === "competitor_post_engagement")
       this._validateCompetitorPostEngagementParams(rawParams);
+    if (specializedAgent === "competitor_rep_engagement")
+      this._validateCompetitorRepEngagementParams(rawParams);
   }
   _validateFileReference(uri) {
     if (uri.startsWith("artifact_"))
@@ -3563,6 +3618,70 @@ class ResponsesResource {
     request.specializedAgentParams = params;
     return this.create(request);
   }
+  /**
+   * Find a competitor's sales reps and surface the AUTHORS of the LinkedIn posts
+   * those reps engage with — i.e. the prospects the competitor is actively
+   * selling to. The INVERSE of {@link competitorPostEngagement}.
+   *
+   * **Discovery mode** — pass `company`: ReAct discovers competitors, then crawls
+   * each one's reps and harvests their outgoing engagement.
+   *
+   * **Explicit mode** — pass `competitors`: skips discovery, uses your list.
+   *
+   * Requires `FIBER_API_KEY` + `CRUSTDATA_API_KEY`.
+   *
+   * @param query - Persona prompt for the prospect-authors (e.g. "VP Eng at AI-native startups…")
+   * @param options - Exactly one of `company` or `competitors` is required
+   * @returns Response; poll with `get()` then read `structuredResponse` as
+   *   {@link CompetitorRepEngagementOutput}. See `src/types/competitor-rep-engagement.ts`
+   *   for the full agent reference (pipeline, API keys, engagementData shape).
+   */
+  async competitorRepEngagement(query, options) {
+    const hasCompany = typeof options.company === "string" && options.company.trim().length > 0;
+    const hasCompetitors = Array.isArray(options.competitors) && options.competitors.length > 0;
+    if (hasCompany === hasCompetitors) {
+      throw new ValidationError(
+        "Provide exactly one of `company` or `competitors` for competitorRepEngagement."
+      );
+    }
+    const request = {
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "competitor_rep_engagement"
+    };
+    const params = {};
+    if (options.company)
+      params.company = options.company;
+    if (options.competitors)
+      params.competitors = options.competitors;
+    if (options.companyContext)
+      params.companyContext = options.companyContext;
+    if (options.companyExamples)
+      params.companyExamples = options.companyExamples;
+    if (options.limit !== void 0)
+      params.limit = options.limit;
+    if (options.postsDateRange)
+      params.postsDateRange = options.postsDateRange;
+    if (options.engagementTypes)
+      params.engagementTypes = options.engagementTypes;
+    if (options.repTitles)
+      params.repTitles = options.repTitles;
+    if (options.maxRepsPerCompetitor !== void 0)
+      params.maxRepsPerCompetitor = options.maxRepsPerCompetitor;
+    if (options.maxEngagementsPerRep !== void 0)
+      params.maxEngagementsPerRep = options.maxEngagementsPerRep;
+    if (options.restrictEngagementToTenure !== void 0)
+      params.restrictEngagementToTenure = options.restrictEngagementToTenure;
+    if (options.excludeCompetitorEmployees !== void 0)
+      params.excludeCompetitorEmployees = options.excludeCompetitorEmployees;
+    if (options.expandExclusionViaDiscovery !== void 0)
+      params.expandExclusionViaDiscovery = options.expandExclusionViaDiscovery;
+    if (options.maxCompetitors !== void 0)
+      params.maxCompetitors = options.maxCompetitors;
+    if (options.thoroughEnrichment !== void 0)
+      params.thoroughEnrichment = options.thoroughEnrichment;
+    request.specializedAgentParams = params;
+    return this.create(request);
+  }
 }
 
 class SequencesResource {