@erdoai/cli 0.105.0 → 0.108.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") {
@@ -6913,7 +7059,7 @@ var leadsCmd = program.command("leads").description(
   "Read leads in a lead dataset, merge two that are the same person, and run the lead playbook that suggests each lead's next action"
 );
 leadsCmd.command("get <dataset> <lead>").description(
-  "Read one lead: its permanent canonical_lead_id, the email and phone evidence bound to it, its dataset row, the leads merged into it, and its capture history. <lead> is either the canonical_lead_id UUID or the 22-character lead reference, and an id that has since been merged away resolves to the lead it became \u2014 so an id read off an old capture response still works."
+  "Read one lead: its permanent canonical_lead_id, what it told us (on the form and in every call, chat, text and email reply since), the email and phone evidence bound to it, its dataset row, the leads merged into it, and its capture history. <lead> is either the canonical_lead_id UUID or the 22-character lead reference, and an id that has since been merged away resolves to the lead it became \u2014 so an id read off an old capture response still works."
 ).option("--json", "print the raw JSON result instead of a summary").action(async (dataset, lead, opts) => {
   try {
     const res = await new ErdoClient().getLead(dataset, lead);
@@ -6999,7 +7145,7 @@ leadsCmd.command("merge <dataset> <survivor>").description(
         console.log(`Already one lead: ${res.absorbed_lead_id} resolves to ${res.lead.canonical_lead_id}.`);
       } else {
         console.log(
-          `Merged ${res.absorbed_lead_id} into ${res.lead.canonical_lead_id} \u2014 ${res.aliases_moved} contact ${res.aliases_moved === 1 ? "alias" : "aliases"} moved, ${res.rows_combined} ${res.rows_combined === 1 ? "row" : "rows"} combined.`
+          `Merged ${res.absorbed_lead_id} into ${res.lead.canonical_lead_id} \u2014 ${res.aliases_moved} contact ${res.aliases_moved === 1 ? "alias" : "aliases"} and ${res.details_moved ?? 0} ${res.details_moved === 1 ? "detail" : "details"} moved, ${res.rows_combined} ${res.rows_combined === 1 ? "row" : "rows"} combined.`
         );
       }
       printLead(res.lead);
@@ -7406,6 +7552,24 @@ function printRecordedLeadDecision(a) {
   console.log(`Recorded ${a.action_kind} on lead ${a.lead_reference}${a.action_kind === "hold" ? until : ""}.`);
   if (a.rationale) console.log(a.rationale);
 }
+function leadDetailSource(kind) {
+  switch (kind) {
+    case "form":
+      return "form";
+    case "phone_call":
+      return "call";
+    case "widget_conversation":
+      return "website chat";
+    case "sms":
+      return "text";
+    case "whatsapp":
+      return "WhatsApp";
+    case "email_reply":
+      return "email reply";
+    default:
+      return kind;
+  }
+}
 function printLead(lead) {
   console.log(`lead       ${lead.canonical_lead_id}`);
   console.log(`reference  ${lead.reference}`);
@@ -7419,6 +7583,16 @@ function printLead(lead) {
   if (lead.absorbed_lead_ids?.length) {
     console.log(`absorbed   ${lead.absorbed_lead_ids.join(", ")}`);
   }
+  if (lead.details?.length) {
+    console.log("\nwhat they told us");
+    printAlignedTable(
+      ["question", "answer", "from", "when"],
+      lead.details.flatMap((d) => [
+        [d.label, d.value, leadDetailSource(d.source_kind), d.observed_at],
+        ...(d.earlier ?? []).map((e) => ["", `  earlier: ${e.value}`, leadDetailSource(e.source_kind), e.observed_at])
+      ])
+    );
+  }
   if (lead.aliases?.length) {
     console.log("\ncontact evidence");
     printAlignedTable(

package/package.json

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