@erdoai/cli 0.105.0 → 0.107.0

package/dist/index.js

@@ -576,6 +576,31 @@ var ErdoClient = class {
       `/v1/voice/sms-conversations/${encodeURIComponent(sessionID)}${qs ? `?${qs}` : ""}`
     );
   }
+  // WhatsApp conversations on those same numbers — their own resource rather
+  // than a channel on the SMS reads, addressed and filtered the same way.
+  listWhatsAppConversations(params) {
+    const q = new URLSearchParams();
+    if (params?.phone_number) q.set("phone_number", params.phone_number);
+    if (params?.address) q.set("address", params.address);
+    if (params?.canonical_lead_id) q.set("canonical_lead_id", params.canonical_lead_id);
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.cursor) q.set("cursor", params.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/voice/whatsapp-conversations${qs ? `?${qs}` : ""}`
+    );
+  }
+  getWhatsAppConversation(sessionID, params) {
+    const q = new URLSearchParams();
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.cursor) q.set("cursor", params.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/voice/whatsapp-conversations/${encodeURIComponent(sessionID)}${qs ? `?${qs}` : ""}`
+    );
+  }
   // The organization's business profile: its legal identity, which every A2P
   // registration on the account is checked against. It follows the org
   // convention rather than the voice one because it is the organization's, not
@@ -5968,6 +5993,127 @@ contact: ${parts.join(" \xB7 ")}`);
     }
   }
 );
+var voiceWhatsAppCmd = voiceCmd.command("whatsapp").description("WhatsApp conversations on a voice agent's own number");
+voiceWhatsAppCmd.command("list").description("List the organization's WhatsApp conversations, most recently active first").option("--phone-number <number>", "only conversations on this Erdo number (any format)").option("--address <number>", "only the conversation with this person (any format)").option("--lead <lead>", LEAD_FILTER_HELP).option("--limit <n>", "page size (default 25, max 100)").option("--cursor <cursor>", "next_cursor from the preceding page (stable paging)").option("--json", "print the raw JSON result instead of a table").action(
+  async (opts) => {
+    try {
+      const res = await new ErdoClient().listWhatsAppConversations({
+        phone_number: opts.phoneNumber,
+        address: opts.address,
+        canonical_lead_id: opts.lead,
+        limit: opts.limit ? Number(opts.limit) : void 0,
+        cursor: opts.cursor
+      });
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      const conversations = res.conversations ?? [];
+      if (conversations.length === 0) {
+        console.log("No WhatsApp conversations match those filters.");
+        return;
+      }
+      printAlignedTable(
+        ["session id", "phone", "address", "name", "msgs", "last inbound", "last outbound", "lead ref", "summary"],
+        conversations.map((c) => [
+          c.session_id,
+          c.phone_number,
+          c.suppressed ? `${c.address} (suppressed)` : c.address,
+          c.display_name ?? "",
+          c.message_count,
+          c.last_inbound_at ?? "",
+          c.last_outbound_at ?? "",
+          leadReferenceLabel(c.lead_reference),
+          c.summary
+        ])
+      );
+      process.stderr.write(`showing ${conversations.length} conversation(s)
+`);
+      if (res.next_cursor) {
+        process.stderr.write(`more available \u2014 re-run with --cursor ${res.next_cursor}
+`);
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+function whatsAppMessageText(m) {
+  const parts = [];
+  if (m.body) parts.push(m.body);
+  if (m.location) {
+    const where = [m.location.label, m.location.address].filter(Boolean).join(", ");
+    parts.push(`[location ${m.location.latitude},${m.location.longitude}${where ? ` ${where}` : ""}]`);
+  }
+  if (m.context?.button_text) parts.push(`[tapped "${m.context.button_text}"]`);
+  else if (m.context?.replied_message_id) parts.push(`[reply to ${m.context.replied_message_id}]`);
+  if (m.referral) parts.push(`[from ad${m.referral.Headline ? ` "${m.referral.Headline}"` : ""}]`);
+  if (parts.length === 0 && m.message_type && m.message_type !== "text") parts.push(`[${m.message_type}]`);
+  return parts.join(" ");
+}
+voiceWhatsAppCmd.command("get <sessionID>").description("Read one WhatsApp conversation: its metadata, then every message oldest first").option("--limit <n>", "messages per page (default 50, max 200)").option("--cursor <cursor>", "next_cursor from the preceding page of messages").option("--json", "print the raw JSON result instead of a table").action(
+  async (sessionID, opts) => {
+    try {
+      const res = await new ErdoClient().getWhatsAppConversation(sessionID, {
+        limit: opts.limit ? Number(opts.limit) : void 0,
+        cursor: opts.cursor
+      });
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      const c = res.conversation;
+      printAlignedTable(
+        ["session id", "phone", "address", "name", "msgs", "last inbound", "last outbound", "summary"],
+        [
+          [
+            c.session_id,
+            c.phone_number,
+            c.suppressed ? `${c.address} (suppressed)` : c.address,
+            c.display_name ?? "",
+            c.message_count,
+            c.last_inbound_at ?? "",
+            c.last_outbound_at ?? "",
+            c.summary
+          ]
+        ]
+      );
+      const contact = c.contact;
+      if (contact && (contact.name || contact.email || contact.phone || contact.company)) {
+        const parts = [contact.name, contact.email, contact.phone, contact.company].filter(Boolean);
+        console.log(`
+contact: ${parts.join(" \xB7 ")}`);
+      }
+      if (c.lead_reference) {
+        console.log(`lead: ${c.lead_reference} (${c.canonical_lead_id})`);
+      }
+      const messages = res.messages ?? [];
+      if (messages.length === 0) {
+        console.log("\nNo messages have been recorded in this conversation yet.");
+        return;
+      }
+      console.log("");
+      printAlignedTable(
+        ["at", "direction", "status", "media", "message"],
+        messages.map((m) => [
+          m.created_at,
+          m.direction,
+          m.status,
+          m.num_media > 0 ? m.num_media : "",
+          whatsAppMessageText(m)
+        ])
+      );
+      process.stderr.write(`showing ${messages.length} message(s), oldest first
+`);
+      if (res.next_cursor) {
+        process.stderr.write(`more available \u2014 re-run with --cursor ${res.next_cursor}
+`);
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 var voiceNumbersCmd = voiceCmd.command("numbers").description("The organization's phone numbers, their A2P SMS registration and their caller name");
 function printRegistrationState(registration) {
   if (registration === null || typeof registration !== "object") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.105.0",
+  "version": "0.107.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {