@erdoai/cli 0.75.0 → 0.76.0

package/dist/index.js

@@ -482,6 +482,32 @@ var ErdoClient = class {
   getVoiceCall(callID) {
     return this.request("GET", `/v1/voice/calls/${encodeURIComponent(callID)}`);
   }
+  // Website concierge widget conversations — the text/voice/video sessions
+  // visitors held on the customer's own pages. Covers every widget in the org
+  // unless narrowed by the widget handle (its name or public key, vw_...).
+  listWidgetConversations(params) {
+    const q = new URLSearchParams();
+    if (params?.widget) q.set("widget", params.widget);
+    if (params?.since) q.set("since", params.since);
+    if (params?.until) q.set("until", params.until);
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.offset !== void 0) q.set("offset", String(params.offset));
+    if (params?.cursor) q.set("cursor", params.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/voice/widget-conversations${qs ? `?${qs}` : ""}`
+    );
+  }
+  // The session id identifies the conversation on its own and another org's
+  // session is never returned, so the widget handle is optional.
+  getWidgetConversation(sessionID, widget) {
+    return this.request(
+      "POST",
+      `/v1/voice/widget-conversations/get`,
+      { session_id: sessionID, ...widget ? { widget } : {} }
+    );
+  }
   // 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.
@@ -4753,7 +4779,17 @@ sentEmailsCmd.command("get <emailID>").description("Read one sent email, includi
     fail(e);
   }
 });
-var voiceCmd = program.command("voice").description("Read voice agent phone conversations");
+var voiceCmd = program.command("voice").description("Read voice agent phone calls and website widget conversations");
+function contactLabel(contact) {
+  if (!contact) return "-";
+  const name = [contact.first_name, contact.last_name].filter(Boolean).join(" ");
+  const reach = contact.email || contact.phone;
+  if (!name && !reach) return "none";
+  return [name, reach].filter(Boolean).join(" \xB7 ");
+}
+function leadStatusLabel(outcome) {
+  return outcome ? outcome : "pending";
+}
 var voiceCallsCmd = voiceCmd.command("calls").description("Inbound and outbound phone call records");
 voiceCallsCmd.command("list").description("List the organization's phone calls, newest first").option("--agent <slug>", "only calls held by this voice agent, by slug").option("--direction <direction>", "only 'inbound' (calls to the agent's number) or 'outbound'").option("--limit <n>", "page size (default 25, max 100)").option("--offset <n>", "rows to skip").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) => {
@@ -4775,7 +4811,19 @@ voiceCallsCmd.command("list").description("List the organization's phone calls,
         return;
       }
       printAlignedTable(
-        ["call id", "direction", "from", "to", "status", "secs", "transcript", "started", "summary"],
+        [
+          "call id",
+          "direction",
+          "from",
+          "to",
+          "status",
+          "secs",
+          "transcript",
+          "contact",
+          "lead",
+          "started",
+          "summary"
+        ],
         calls.map((call) => [
           call.call_id,
           call.direction,
@@ -4784,6 +4832,8 @@ voiceCallsCmd.command("list").description("List the organization's phone calls,
           call.status,
           call.duration_seconds,
           call.has_transcript ? "yes" : "no",
+          contactLabel(call.contact),
+          leadStatusLabel(call.lead_status),
           call.created_at,
           call.transcript_summary
         ])
@@ -4799,13 +4849,82 @@ voiceCallsCmd.command("list").description("List the organization's phone calls,
     }
   }
 );
-voiceCallsCmd.command("get <callID>").description("Read one phone call in full: transcript, summary, and per-turn LLM metrics").action(async (callID) => {
+voiceCallsCmd.command("get <callID>").description(
+  "Read one phone call in full: transcript, summary, per-turn LLM metrics, and the lead it produced (contact, lead_status, lead_saved_at)"
+).action(async (callID) => {
   try {
     print(await new ErdoClient().getVoiceCall(callID));
   } catch (e) {
     fail(e);
   }
 });
+var widgetConversationsCmd = voiceCmd.command("widget-conversations").description("Website concierge widget conversations (text, voice and video sessions)");
+widgetConversationsCmd.command("list").description("List the organization's widget conversations, newest first").option("--widget <handle>", "only this widget's conversations \u2014 its name or public key (vw_...)").option("--since <rfc3339>", "only conversations that started at or after this time (inclusive)").option("--until <rfc3339>", "only conversations that started before this time (exclusive)").option("--limit <n>", "page size (default 25, max 100)").option("--offset <n>", "rows to skip").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().listWidgetConversations({
+        widget: opts.widget,
+        since: opts.since,
+        until: opts.until,
+        limit: opts.limit ? Number(opts.limit) : void 0,
+        offset: opts.offset ? Number(opts.offset) : void 0,
+        cursor: opts.cursor
+      });
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      const conversations = res.conversations ?? [];
+      if (conversations.length === 0) {
+        console.log("No conversations match those filters.");
+        return;
+      }
+      printAlignedTable(
+        [
+          "session id",
+          "widget",
+          "modality",
+          "secs",
+          "transcript",
+          "contact",
+          "lead",
+          "started",
+          "summary"
+        ],
+        conversations.map((c) => [
+          c.session_id,
+          c.widget_name || c.widget,
+          c.modality,
+          c.duration_seconds,
+          c.has_transcript ? "yes" : "no",
+          contactLabel(c.contact),
+          leadStatusLabel(c.lead_status),
+          c.created_at,
+          c.transcript_summary
+        ])
+      );
+      process.stderr.write(
+        `showing ${conversations.length} of ${res.total} conversation(s)
+`
+      );
+      if (res.next_cursor) {
+        process.stderr.write(`more available \u2014 re-run with --cursor ${res.next_cursor}
+`);
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+widgetConversationsCmd.command("get <sessionID>").description(
+  "Read one widget conversation in full: transcript, summary, topics, per-turn LLM metrics, and the lead it produced (contact, lead_status, lead_saved_at)"
+).option("--widget <handle>", "the widget it belongs to \u2014 optional, the session id identifies it").action(async (sessionID, opts) => {
+  try {
+    print(await new ErdoClient().getWidgetConversation(sessionID, opts.widget));
+  } 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.75.0",
+  "version": "0.76.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {