@erdoai/cli 0.74.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.
@@ -2246,20 +2272,27 @@ wsCmd.command("get <slug>").description("Show a workstream \u2014 status, phases
     fail(e);
   }
 });
-wsCmd.command("create").description("Create a workstream in a project").requiredOption("--project <slug>", "project slug").requiredOption("--slug <slug>", "workstream slug (unique per org)").requiredOption("--title <title>", "human-readable title").option("--description <text>", "free-form description").action(async (opts) => {
-  try {
-    print(
-      await new ErdoClient().createWorkstream({
-        project_slug: opts.project,
-        slug: opts.slug,
-        title: opts.title,
-        description: opts.description
-      })
-    );
-  } catch (e) {
-    fail(e);
+wsCmd.command("create").description("Create a workstream in a project").requiredOption("--project <slug>", "project slug").requiredOption("--slug <slug>", "workstream slug (unique per org)").requiredOption("--title <title>", "human-readable title").option("--description <text>", "free-form description").option(
+  "--token-budget <millicents>",
+  "spend ceiling in millicents \u2014 100,000 per dollar, so 10000000 = $100 and 25000000 = $250; omit for unlimited",
+  (v) => parseInt(v, 10)
+).action(
+  async (opts) => {
+    try {
+      print(
+        await new ErdoClient().createWorkstream({
+          project_slug: opts.project,
+          slug: opts.slug,
+          title: opts.title,
+          description: opts.description,
+          token_budget_millicents: opts.tokenBudget
+        })
+      );
+    } catch (e) {
+      fail(e);
+    }
   }
-});
+);
 wsCmd.command("log <slug> <body...>").description("Append a line to the workstream's event log").action(async (slug, body) => {
   try {
     print(await new ErdoClient().appendWorkstreamEvent(slug, body.join(" ")));
@@ -2290,6 +2323,10 @@ wsCmd.command("phase-add <slug>").description("Append a new phase to a workstrea
   }
 );
 wsCmd.command("set-state <slug>").description("Update a workstream's status / title / description / phase statuses").option("--status <status>", "active, awaiting_user, blocked, completed").option("--title <title>", "retitle").option("--description <text>", "describe current state / surface a blocker").option("--summary <text>", "one-line audit-log summary of this update").option(
+  "--token-budget <millicents>",
+  "spend ceiling in millicents \u2014 100,000 per dollar, so 25000000 = $250; this is how you raise a ceiling a loop has spent through",
+  (v) => parseInt(v, 10)
+).option("--escalation-budget <n>", "max urgent attention items per rolling 24h", (v) => parseInt(v, 10)).option(
   "--phase <slug=status>",
   "set one phase's status (repeatable), e.g. --phase brand-brief=completed --phase landing-pages=running; statuses: pending, running, awaiting_user, blocked, completed, skipped, failed",
   collect,
@@ -2312,6 +2349,8 @@ wsCmd.command("set-state <slug>").description("Update a workstream's status / ti
           title: opts.title,
           description: opts.description,
           summary: opts.summary,
+          token_budget_millicents: opts.tokenBudget,
+          escalation_budget_per_day: opts.escalationBudget,
           phase_updates: phaseUpdates.length > 0 ? phaseUpdates : void 0
         })
       );
@@ -2320,7 +2359,11 @@ wsCmd.command("set-state <slug>").description("Update a workstream's status / ti
     }
   }
 );
-wsCmd.command("arm <slug>").description("Arm the recurring reconciliation loop (allocator pass) for a workstream").option("--interval <minutes>", "how often the loop runs", (v) => parseInt(v, 10)).option("--model <id>", "model the loop runs on").option("--timezone <tz>", "timezone for scheduling").option("--token-budget <millicents>", "total spend ceiling in millicents (tenths of a cent)", (v) => parseInt(v, 10)).option("--escalation-budget <n>", "max escalations to a human per day", (v) => parseInt(v, 10)).action(
+wsCmd.command("arm <slug>").description("Arm the recurring reconciliation loop (allocator pass) for a workstream").option("--interval <minutes>", "how often the loop runs", (v) => parseInt(v, 10)).option("--model <id>", "model the loop runs on").option("--timezone <tz>", "timezone for scheduling").option(
+  "--token-budget <millicents>",
+  "total spend ceiling in millicents \u2014 100,000 per dollar, so 25000000 = $250; also how you raise a ceiling a loop has spent through",
+  (v) => parseInt(v, 10)
+).option("--escalation-budget <n>", "max escalations to a human per day", (v) => parseInt(v, 10)).action(
   async (slug, opts) => {
     try {
       const client = new ErdoClient();
@@ -4736,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) => {
@@ -4758,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,
@@ -4767,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
         ])
@@ -4782,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.74.0",
+  "version": "0.76.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {