lumnisai 0.5.22 → 0.5.24

package/dist/index.cjs

@@ -1083,6 +1083,31 @@ class EmailResource {
       { params: { user_id: userId } }
     );
   }
+  // ==================== BYO Inboxes ====================
+  /**
+   * Connect a customer's own email inbox (Gmail/Outlook/IMAP) via Unipile.
+   *
+   * One call = one inbox. Returns a hosted-auth redirect URL; the user authes
+   * there and the connect webhook creates the `ready` mailbox. Call once per
+   * inbox to add multiple mailboxes.
+   */
+  async connectInbox(request) {
+    return this.http.post("/email/inboxes/connect", request);
+  }
+  /**
+   * Update a single mailbox's send settings (per-mailbox daily cap, pause).
+   *
+   * PATCH semantics — only provided fields change. The per-mailbox cap is the
+   * primary lever for BYO inboxes, which skip the InboxKit warmup ramp.
+   * Requires admin role on the org.
+   */
+  async updateMailbox(orgId, mailboxId, userId, update) {
+    return this.http.patch(
+      `/email/organizations/${encodeURIComponent(orgId)}/mailboxes/${encodeURIComponent(mailboxId)}`,
+      update,
+      { params: { user_id: userId } }
+    );
+  }
   // ==================== Teardown ====================
   /**
    * Teardown an email organization's infrastructure.
@@ -2845,6 +2870,71 @@ class ModelPreferencesResource {
   }
 }
 
+class OutreachResource {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List people at a funnel stage (connected/messaged/replied/meeting_booked),
+   * or `stage='all'` for one row per person at their furthest stage.
+   *
+   * Pass `stats: true` to also get the per-channel funnel counts + conversion
+   * ratios for the same scope (`userId`/`source`/`campaignId`) alongside the
+   * people list. Pass `campaignId` to restrict to specific campaigns (this
+   * excludes sequences).
+   *
+   * @example
+   * ```typescript
+   * const result = await client.outreach.listConnections({
+   *   userId: 'user@example.com',
+   *   stage: 'replied',
+   *   stats: true,
+   * })
+   * console.log(result.total, result.stats?.byChannel.linkedin.ratios.replyRate)
+   * ```
+   */
+  async listConnections(params) {
+    const query = new URLSearchParams();
+    query.append("user_id", params.userId);
+    if (params.stage !== void 0)
+      query.append("stage", params.stage);
+    if (params.channel !== void 0)
+      query.append("channel", params.channel);
+    if (params.source !== void 0)
+      query.append("source", params.source);
+    if (params.campaignId)
+      params.campaignId.forEach((id) => query.append("campaign_id", id));
+    if (params.since !== void 0)
+      query.append("since", params.since);
+    if (params.stats !== void 0)
+      query.append("stats", String(params.stats));
+    if (params.limit !== void 0)
+      query.append("limit", String(params.limit));
+    if (params.offset !== void 0)
+      query.append("offset", String(params.offset));
+    return this.http.get(`/outreach?${query.toString()}`);
+  }
+  /**
+   * Alias for `stage='connected'` — people who accepted a Lumnis-sent
+   * connection request.
+   */
+  async listAcceptedConnections(params) {
+    const query = new URLSearchParams();
+    query.append("user_id", params.userId);
+    if (params.source !== void 0)
+      query.append("source", params.source);
+    if (params.campaignId)
+      params.campaignId.forEach((id) => query.append("campaign_id", id));
+    if (params.since !== void 0)
+      query.append("since", params.since);
+    if (params.limit !== void 0)
+      query.append("limit", String(params.limit));
+    if (params.offset !== void 0)
+      query.append("offset", String(params.offset));
+    return this.http.get(`/outreach/accepted?${query.toString()}`);
+  }
+}
+
 var PeopleDataSource = /* @__PURE__ */ ((PeopleDataSource2) => {
   PeopleDataSource2["PDL"] = "PDL";
   PeopleDataSource2["CORESIGNAL"] = "CORESIGNAL";
@@ -3128,6 +3218,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 +3371,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 +3708,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 {
@@ -4501,6 +4710,7 @@ class LumnisClient {
   enrichment;
   email;
   crm;
+  outreach;
   _scopedUserId;
   _defaultScope;
   constructor(options = {}) {
@@ -4539,6 +4749,7 @@ class LumnisClient {
     this.enrichment = new EnrichmentResource(this.http);
     this.email = new EmailResource(this.http);
     this.crm = new CrmResource(this.http);
+    this.outreach = new OutreachResource(this.http);
   }
   forUser(userId) {
     return new LumnisClient({