@erdoai/cli 0.80.0 → 0.81.0

package/dist/index.js

@@ -508,6 +508,32 @@ var ErdoClient = class {
       { session_id: sessionID, ...widget ? { widget } : {} }
     );
   }
+  // Text conversations on those same numbers. A conversation is one Erdo number
+  // and one person, for as long as they keep texting — so it is addressed by its
+  // session id rather than by a message id, and narrowed by the two numbers
+  // rather than by an agent slug and a direction.
+  listSMSConversations(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?.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/sms-conversations${qs ? `?${qs}` : ""}`
+    );
+  }
+  getSMSConversation(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/sms-conversations/${encodeURIComponent(sessionID)}${qs ? `?${qs}` : ""}`
+    );
+  }
   // Run a read-only HogQL query against the org's page-analytics events. Rows are
   // positional per columns; enabled:false means page analytics is off for the org
   // (not zero traffic). A rejected query surfaces PostHog's message as the error.
@@ -4846,7 +4872,7 @@ sentEmailsCmd.command("get <emailID>").description("Read one sent email, includi
     fail(e);
   }
 });
-var voiceCmd = program.command("voice").description("Read voice agent phone calls and website widget conversations");
+var voiceCmd = program.command("voice").description("Read a voice agent's phone calls, text conversations and website widget conversations");
 function contactLabel(contact) {
   if (!contact) return "-";
   const name = [contact.first_name, contact.last_name].filter(Boolean).join(" ");
@@ -4992,6 +5018,103 @@ widgetConversationsCmd.command("get <sessionID>").description(
     fail(e);
   }
 });
+var voiceSMSCmd = voiceCmd.command("sms").description("Text conversations on a voice agent's own number");
+voiceSMSCmd.command("list").description("List the organization's SMS 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("--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().listSMSConversations({
+        phone_number: opts.phoneNumber,
+        address: opts.address,
+        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 SMS conversations match those filters.");
+        return;
+      }
+      printAlignedTable(
+        ["session id", "phone", "address", "msgs", "last inbound", "last outbound", "summary"],
+        conversations.map((c) => [
+          c.session_id,
+          c.phone_number,
+          // An opted-out conversation is marked on the person, since that is
+          // what the flag governs: nothing may text THEM until they send START.
+          c.suppressed ? `${c.address} (suppressed)` : c.address,
+          c.message_count,
+          c.last_inbound_at ?? "",
+          c.last_outbound_at ?? "",
+          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);
+    }
+  }
+);
+voiceSMSCmd.command("get <sessionID>").description("Read one SMS conversation: its metadata, then every text oldest first").option("--limit <n>", "texts per page (default 50, max 200)").option("--cursor <cursor>", "next_cursor from the preceding page of texts").option("--json", "print the raw JSON result instead of a table").action(
+  async (sessionID, opts) => {
+    try {
+      const res = await new ErdoClient().getSMSConversation(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", "msgs", "last inbound", "last outbound", "summary"],
+        [
+          [
+            c.session_id,
+            c.phone_number,
+            c.suppressed ? `${c.address} (suppressed)` : c.address,
+            c.message_count,
+            c.last_inbound_at ?? "",
+            c.last_outbound_at ?? "",
+            c.summary
+          ]
+        ]
+      );
+      const messages = res.messages ?? [];
+      if (messages.length === 0) {
+        console.log("\nNo texts have been recorded in this conversation yet.");
+        return;
+      }
+      console.log("");
+      printAlignedTable(
+        ["at", "direction", "status", "media", "body"],
+        messages.map((m) => [
+          m.created_at,
+          m.direction,
+          m.status,
+          m.num_media > 0 ? m.num_media : "",
+          m.body
+        ])
+      );
+      process.stderr.write(`showing ${messages.length} text(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 datasetsCmd = program.command("datasets").description("Datasets");
 datasetsCmd.command("list").description("List datasets").option(
   "--class <class>",

package/package.json

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