@erdoai/cli 0.75.0 → 0.77.0

package/dist/index.js

@@ -4,7 +4,7 @@
 import { readFileSync as readFileSync4 } from "fs";
 import { basename } from "path";
 import { select } from "@inquirer/prompts";
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -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.
@@ -1556,6 +1582,32 @@ function readMaybeFile(value) {
   return value.startsWith("@") ? readFileSync2(value.slice(1), "utf8") : value;
 }
 
+// src/scope.ts
+import { Option } from "commander";
+var ORG_ENV = "ERDO_ORG";
+var PROJECT_ENV = "ERDO_PROJECT";
+function bindScopeFlags(program2) {
+  program2.option("--org <idOrSlug>", "org to target for this command (overrides the active org)").option(
+    "--project <slugOrId>",
+    "project context for this command \u2014 slug or UUID (must belong to the active org)"
+  );
+  program2.on("option:org", (value) => {
+    process.env[ORG_ENV] = value;
+  });
+  program2.on("option:project", (value) => {
+    process.env[PROJECT_ENV] = value;
+  });
+  return program2;
+}
+function projectOption(description, opts = {}) {
+  const option = new Option("--project <slug>", description).env(PROJECT_ENV);
+  if (opts.mandatory) option.makeOptionMandatory();
+  return option;
+}
+function orgOption(description) {
+  return new Option("--org <idOrSlug>", description).env(ORG_ENV);
+}
+
 // src/update.ts
 import { spawn as spawn2, spawnSync } from "child_process";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
@@ -1770,14 +1822,9 @@ function compactEvalRunAttribution(run) {
   ].filter((part) => part !== void 0);
   return [run.triggered_by, ...revisions].join("	");
 }
-var program = new Command();
-program.name("erdo").description("Erdo CLI").version(pkg.version).option("--org <idOrSlug>", "org to target for this command (overrides the active org)").option("--project <uuid>", "project context for this command (must belong to the active org)");
-program.hook("preAction", (thisCommand) => {
-  const opts = thisCommand.opts();
-  const org2 = opts.org;
-  if (org2) process.env.ERDO_ORG = org2;
-  if (opts.project) process.env.ERDO_PROJECT = opts.project;
-});
+var program = new Command2();
+program.name("erdo").description("Erdo CLI").version(pkg.version);
+bindScopeFlags(program);
 async function doLogin(opts) {
   let token;
   let me;
@@ -2144,7 +2191,9 @@ This key operates every org you manage; target one with X-Organization-ID (or \`
   }
 });
 var tokenCmd = program.command("token").description("Manage your API tokens (account-level credentials)");
-tokenCmd.command("create").description("Mint a new API token; the secret is printed ONCE").requiredOption("--name <name>", "a label for the token").option("--expires-days <n>", "days until expiry (default: 30)", (v) => parseInt(v, 10)).option("--org <idOrSlug>", "the token's default org (defaults to your active org; must be one you belong to)").action(async (opts) => {
+tokenCmd.command("create").description("Mint a new API token; the secret is printed ONCE").requiredOption("--name <name>", "a label for the token").option("--expires-days <n>", "days until expiry (default: 30)", (v) => parseInt(v, 10)).addOption(
+  orgOption("the token's default org (defaults to your active org; must be one you belong to)")
+).action(async (opts) => {
   try {
     const res = await new ErdoClient().createToken({
       name: opts.name,
@@ -2246,7 +2295,7 @@ 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").option(
+wsCmd.command("create").description("Create a workstream in a project").addOption(projectOption("project slug", { mandatory: true })).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)
@@ -2540,7 +2589,7 @@ expCmd.command("policy <slug>").description(
     fail(e);
   }
 });
-expCmd.command("create").description("Create an experiment with its variants, evidence datasets and decision rule").requiredOption("--project <slug>", "project slug").requiredOption("--slug <slug>", "experiment slug (unique per org)").requiredOption("--title <title>", "title").option("--workstream <slug>", "host workstream").option("--scope <scope>", "local (default), platform_canary, platform_global").option("--hypothesis <text>", "hypothesis markdown").option("--primary-metric <metric>", "the metric the decision rule reads").option("--decision-rule <text>", "the rule that decides ship/stop from the primary metric").option("--guardrail <metric>", "a metric that must not regress (repeatable)", collect, []).option(
+expCmd.command("create").description("Create an experiment with its variants, evidence datasets and decision rule").addOption(projectOption("project slug", { mandatory: true })).requiredOption("--slug <slug>", "experiment slug (unique per org)").requiredOption("--title <title>", "title").option("--workstream <slug>", "host workstream").option("--scope <scope>", "local (default), platform_canary, platform_global").option("--hypothesis <text>", "hypothesis markdown").option("--primary-metric <metric>", "the metric the decision rule reads").option("--decision-rule <text>", "the rule that decides ship/stop from the primary metric").option("--guardrail <metric>", "a metric that must not regress (repeatable)", collect, []).option(
   "--variant <spec>",
   `a variant "key=b,label=3-field form,page=<artifact-id>,alloc=50,class=form_length_change,control" (repeatable). Fields: key=, label=, page= (Erdo artifact id) OR url=<https://\u2026> (an external page the persona panel visits, e.g. a client's live landing page \u2014 mutually exclusive with page=), alloc=, class=, and the bare flag control (or control=true) to mark the baseline. class= declares the structural change vs control for cross-experiment learning: headline_change | hero_media_change | cta_change | form_length_change | social_proof_add | layout_reorder | offer_change | full_page_rebuild`,
   collect,
@@ -2678,7 +2727,7 @@ expCmd.command("set-status <slug> <status>").description("Set an experiment's st
 });
 expCmd.command("calibration").description(
   "Read each judge's track record \u2014 paired predictions and pairwise agreement vs measured reality (the trust dial)"
-).option("--project <slug>", "limit to one project (default: every project you can view)").option("--judge <slug>", "show only judges whose slug contains this text").option("-n, --limit <n>", "max ledger rows scanned (default 5000)", (v) => parseInt(v, 10)).action(async (opts) => {
+).addOption(projectOption("limit to one project (default: every project you can view)")).option("--judge <slug>", "show only judges whose slug contains this text").option("-n, --limit <n>", "max ledger rows scanned (default 5000)", (v) => parseInt(v, 10)).action(async (opts) => {
   try {
     const res = await new ErdoClient().judgeCalibration({
       project_slug: opts.project,
@@ -4753,7 +4802,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 +4834,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 +4855,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 +4872,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.77.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {