@erdoai/cli 0.89.0 → 0.91.0

package/dist/index.js

@@ -489,10 +489,15 @@ var ErdoClient = class {
   // Phone conversation records: inbound calls to a voice agent's own number and
   // the outbound calls Erdo placed. Website chat widget conversations are a
   // different resource — they live under /v1/voice/widget-conversations.
+  // canonical_lead_id narrows to one lead's calls, by its UUID or its lead
+  // reference — the same filter every conversation list takes.
   listVoiceCalls(params) {
     const q = new URLSearchParams();
     if (params?.agent) q.set("agent", params.agent);
     if (params?.direction) q.set("direction", params.direction);
+    if (params?.since) q.set("since", params.since);
+    if (params?.until) q.set("until", params.until);
+    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?.offset !== void 0) q.set("offset", String(params.offset));
     if (params?.cursor) q.set("cursor", params.cursor);
@@ -510,6 +515,7 @@ var ErdoClient = class {
     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?.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?.offset !== void 0) q.set("offset", String(params.offset));
     if (params?.cursor) q.set("cursor", params.cursor);
@@ -536,6 +542,7 @@ var ErdoClient = class {
     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();
@@ -5215,13 +5222,20 @@ function contactLabel(contact) {
 function leadStatusLabel(outcome) {
   return outcome ? outcome : "pending";
 }
+function leadReferenceLabel(reference) {
+  return reference ? reference : "-";
+}
+var LEAD_FILTER_HELP = "only this lead's conversations \u2014 its canonical lead id (UUID) or its 22-character lead reference";
 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(
+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("--since <rfc3339>", "only calls that started at or after this time (inclusive)").option("--until <rfc3339>", "only calls that started before this time (exclusive)").option("--lead <lead>", LEAD_FILTER_HELP).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().listVoiceCalls({
         agent: opts.agent,
         direction: opts.direction,
+        since: opts.since,
+        until: opts.until,
+        canonical_lead_id: opts.lead,
         limit: opts.limit ? Number(opts.limit) : void 0,
         offset: opts.offset ? Number(opts.offset) : void 0,
         cursor: opts.cursor
@@ -5232,7 +5246,14 @@ voiceCallsCmd.command("list").description("List the organization's phone calls,
       }
       const calls = res.conversations ?? [];
       if (calls.length === 0) {
-        console.log("No calls match those filters.");
+        if (res.total > 0) {
+          process.stderr.write(
+            `showing 0 of ${res.total} call(s) \u2014 offset/cursor is past the last one
+`
+          );
+        } else {
+          console.log("No calls match those filters.");
+        }
         return;
       }
       printAlignedTable(
@@ -5246,6 +5267,7 @@ voiceCallsCmd.command("list").description("List the organization's phone calls,
           "transcript",
           "contact",
           "lead",
+          "lead ref",
           "started",
           "summary"
         ],
@@ -5259,11 +5281,12 @@ voiceCallsCmd.command("list").description("List the organization's phone calls,
           call.has_transcript ? "yes" : "no",
           contactLabel(call.contact),
           leadStatusLabel(call.lead_status),
+          leadReferenceLabel(call.lead_reference),
           call.created_at,
           call.transcript_summary
         ])
       );
-      process.stderr.write(`showing ${calls.length} call(s)
+      process.stderr.write(`showing ${calls.length} of ${res.total} call(s)
 `);
       if (res.next_cursor) {
         process.stderr.write(`more available \u2014 re-run with --cursor ${res.next_cursor}
@@ -5275,7 +5298,7 @@ voiceCallsCmd.command("list").description("List the organization's phone calls,
   }
 );
 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)"
+  "Read one phone call in full: transcript, summary, per-turn LLM metrics, and the lead it produced (contact, lead_status, lead_saved_at, canonical_lead_id, lead_reference)"
 ).action(async (callID) => {
   try {
     print(await new ErdoClient().getVoiceCall(callID));
@@ -5284,13 +5307,14 @@ voiceCallsCmd.command("get <callID>").description(
   }
 });
 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(
+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("--lead <lead>", LEAD_FILTER_HELP).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,
+        canonical_lead_id: opts.lead,
         limit: opts.limit ? Number(opts.limit) : void 0,
         offset: opts.offset ? Number(opts.offset) : void 0,
         cursor: opts.cursor
@@ -5301,7 +5325,14 @@ widgetConversationsCmd.command("list").description("List the organization's widg
       }
       const conversations = res.conversations ?? [];
       if (conversations.length === 0) {
-        console.log("No conversations match those filters.");
+        if (res.total > 0) {
+          process.stderr.write(
+            `showing 0 of ${res.total} conversation(s) \u2014 offset/cursor is past the last one
+`
+          );
+        } else {
+          console.log("No conversations match those filters.");
+        }
         return;
       }
       printAlignedTable(
@@ -5313,6 +5344,7 @@ widgetConversationsCmd.command("list").description("List the organization's widg
           "transcript",
           "contact",
           "lead",
+          "lead ref",
           "started",
           "summary"
         ],
@@ -5324,6 +5356,7 @@ widgetConversationsCmd.command("list").description("List the organization's widg
           c.has_transcript ? "yes" : "no",
           contactLabel(c.contact),
           leadStatusLabel(c.lead_status),
+          leadReferenceLabel(c.lead_reference),
           c.created_at,
           c.transcript_summary
         ])
@@ -5342,7 +5375,7 @@ widgetConversationsCmd.command("list").description("List the organization's widg
   }
 );
 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)"
+  "Read one widget conversation in full: transcript, summary, topics, per-turn LLM metrics, and the lead it produced (contact, lead_status, lead_saved_at, canonical_lead_id, lead_reference)"
 ).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));
@@ -5351,12 +5384,13 @@ widgetConversationsCmd.command("get <sessionID>").description(
   }
 });
 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(
+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("--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().listSMSConversations({
         phone_number: opts.phoneNumber,
         address: opts.address,
+        canonical_lead_id: opts.lead,
         limit: opts.limit ? Number(opts.limit) : void 0,
         cursor: opts.cursor
       });
@@ -5370,7 +5404,7 @@ voiceSMSCmd.command("list").description("List the organization's SMS conversatio
         return;
       }
       printAlignedTable(
-        ["session id", "phone", "address", "msgs", "last inbound", "last outbound", "summary"],
+        ["session id", "phone", "address", "msgs", "last inbound", "last outbound", "lead ref", "summary"],
         conversations.map((c) => [
           c.session_id,
           c.phone_number,
@@ -5380,6 +5414,7 @@ voiceSMSCmd.command("list").description("List the organization's SMS conversatio
           c.message_count,
           c.last_inbound_at ?? "",
           c.last_outbound_at ?? "",
+          leadReferenceLabel(c.lead_reference),
           c.summary
         ])
       );
@@ -5426,6 +5461,9 @@ voiceSMSCmd.command("get <sessionID>").description("Read one SMS conversation: i
         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 texts have been recorded in this conversation yet.");
@@ -6290,8 +6328,20 @@ function printLead(lead) {
   if (lead.captures?.length) {
     console.log("\ncaptures");
     printAlignedTable(
-      ["when", "producer", "resolution", "conversion"],
-      lead.captures.map((c) => [c.created_at, c.producer, c.resolution, c.conversion_status])
+      ["when", "producer", "pipeline", "resolution", "conversion"],
+      lead.captures.map((c) => [c.created_at, c.producer, c.pipeline_id ?? "", c.resolution, c.conversion_status])
+    );
+  }
+  if (lead.refused_captures?.length) {
+    console.log("\nrefused captures (this lead was one of the candidates)");
+    printAlignedTable(
+      ["when", "pipeline", "resolution", "candidates"],
+      lead.refused_captures.map((c) => [
+        c.created_at,
+        c.pipeline_id ?? "",
+        c.resolution,
+        (c.candidate_lead_ids ?? []).join(", ")
+      ])
     );
   }
   if (lead.row) {

package/package.json

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