@erdoai/cli 0.80.0 → 0.82.0

package/dist/index.js

@@ -342,13 +342,18 @@ var ErdoClient = class {
     );
   }
   // Creates the container — a sub-account under the manager's MCC plus the
-  // delegated connection inside the managed org. `replaceCurrentAccount` is the
-  // one input with consequences: provisioning refuses outright when the org is
-  // already running campaigns in another account, and passing this accepts that
-  // those campaigns are left behind, so the key is sent only when it is asked
-  // for rather than as a `false` the server has to read.
+  // delegated connection inside the managed org. `customerId` switches the call
+  // from creating an account to adopting one that already sits directly under
+  // the manager, which is the only way to attach a sub-account somebody made by
+  // hand: Google Ads cannot delete an account, so creating a second one beside
+  // it is permanent. `replaceCurrentAccount` is the one input with consequences:
+  // provisioning refuses outright when the org is already running campaigns in
+  // another account, and passing this accepts that those campaigns are left
+  // behind, so the key is sent only when it is asked for rather than as a
+  // `false` the server has to read.
   provisionManagedOrganizationAdsContainer(slug, input) {
     const body = {};
+    if (input.customerId) body.customer_id = input.customerId;
     if (input.descriptiveName) body.descriptive_name = input.descriptiveName;
     if (input.currencyCode) body.currency_code = input.currencyCode;
     if (input.timeZone) body.time_zone = input.timeZone;
@@ -508,6 +513,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.
@@ -2127,6 +2158,9 @@ function printAdsContainer(c) {
 managed.command("ads-container <orgSlug>").description(
   "Read the Google Ads account a managed org runs its campaigns in, or --provision one under your manager account"
 ).option("--provision", "create the account and the org's delegated google_ads connection instead of reading them").option(
+  "--adopt <customerId>",
+  "with --provision: connect an existing client account already sitting directly under your manager account instead of creating a new one \u2014 for a sub-account created by hand in the Google Ads UI"
+).option(
   "--replace-current-account",
   "with --provision: go ahead even though the org already runs campaigns in another account. Google Ads cannot move a campaign, so those campaigns stay behind and have to be rebuilt"
 ).option("--name <descriptiveName>", "display name for the new account (default: the org's name and slug)").option("--currency <code>", "ISO currency code for the new account, e.g. USD").option("--time-zone <tz>", "IANA time zone for the new account, e.g. America/New_York").action(
@@ -2135,6 +2169,16 @@ managed.command("ads-container <orgSlug>").description(
       if (opts.replaceCurrentAccount && !opts.provision) {
         fail(new Error("--replace-current-account only applies with --provision"));
       }
+      if (opts.adopt && !opts.provision) {
+        fail(new Error("--adopt only applies with --provision"));
+      }
+      if (opts.adopt && (opts.name || opts.currency || opts.timeZone)) {
+        fail(
+          new Error(
+            "--adopt takes an account that already exists, so --name, --currency and --time-zone do not apply \u2014 they describe an account being created"
+          )
+        );
+      }
       const api = new ErdoClient();
       if (!opts.provision) {
         try {
@@ -2152,13 +2196,14 @@ managed.command("ads-container <orgSlug>").description(
         return;
       }
       const c = await api.provisionManagedOrganizationAdsContainer(orgSlug, {
+        customerId: opts.adopt,
         descriptiveName: opts.name,
         currencyCode: opts.currency,
         timeZone: opts.timeZone,
         replaceCurrentAccount: opts.replaceCurrentAccount
       });
       console.log(
-        c.already_provisioned ? `Google Ads container already existed for ${c.org_slug}` : `Created Google Ads container for ${c.org_slug}`
+        c.already_provisioned ? `Google Ads container already existed for ${c.org_slug}` : c.adopted ? `Adopted Google Ads account ${c.customer_id} as the container for ${c.org_slug}` : `Created Google Ads container for ${c.org_slug}`
       );
       printAdsContainer(c);
       const leftBehind = c.previous_campaign_count ?? 0;
@@ -4846,7 +4891,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 +5037,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.82.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {