@erdoai/cli 0.81.0 → 0.83.0

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import { readFileSync as readFileSync4 } from "fs";
 import { basename } from "path";
-import { select } from "@inquirer/prompts";
+import { password, select } from "@inquirer/prompts";
 import { Command as Command2 } from "commander";
 
 // src/config.ts
@@ -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;
@@ -534,6 +539,39 @@ var ErdoClient = class {
       `/v1/voice/sms-conversations/${encodeURIComponent(sessionID)}${qs ? `?${qs}` : ""}`
     );
   }
+  // The organization's business profile: its legal identity, which every A2P
+  // registration on the account is checked against. It follows the org
+  // convention rather than the voice one because it is the organization's, not
+  // any one number's.
+  getBusinessProfile() {
+    return this.request("GET", "/v1/org/business-profile");
+  }
+  // PUT rather than POST: there is exactly one profile per organization and a
+  // save replaces it, so a caller sending a partial body blanks what it omits.
+  setBusinessProfile(body) {
+    return this.request("PUT", "/v1/org/business-profile", body);
+  }
+  // The numbers the organization holds, with what each one's SMS registration
+  // is waiting on. Nothing here reaches the provider — the state is read from
+  // the row the registration action and the status cron maintain.
+  listVoicePhoneNumbers() {
+    return this.request("GET", "/v1/voice/phone-numbers");
+  }
+  getVoicePhoneNumberSMS(number) {
+    return this.request(
+      "GET",
+      `/v1/voice/phone-numbers/${encodeURIComponent(number)}/sms`
+    );
+  }
+  // Asking for a registration costs money at the carrier registry, so this
+  // files the same approval-gated action the chat agent files rather than
+  // registering anything itself.
+  provisionVoicePhoneNumberSMS(number) {
+    return this.request(
+      "POST",
+      `/v1/voice/phone-numbers/${encodeURIComponent(number)}/sms`
+    );
+  }
   // 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.
@@ -1635,6 +1673,25 @@ function readMaybeFile(value) {
   if (value.startsWith("@@")) return value.slice(1);
   return value.startsWith("@") ? readFileSync2(value.slice(1), "utf8") : value;
 }
+async function resolveSecretInput(options) {
+  if (options.fromStdin) {
+    const piped = (await options.readStdin()).trim();
+    if (!piped) {
+      throw new Error("--tax-id-stdin was given but standard input was empty");
+    }
+    return piped;
+  }
+  const wanted = options.replace || !options.stored;
+  if (wanted && options.interactive) {
+    return (await options.prompt(options.stored)).trim() || void 0;
+  }
+  if (options.replace) {
+    throw new Error(
+      "--replace-tax-id needs a terminal to prompt on. In a script, pipe the value in instead: `... | erdo org business-profile set --tax-id-stdin`"
+    );
+  }
+  return void 0;
+}
 
 // src/scope.ts
 import { Option } from "commander";
@@ -1800,6 +1857,16 @@ function timedOutMessage(threadID) {
 function print(value) {
   console.log(JSON.stringify(value, null, 2));
 }
+async function readAllStdin() {
+  if (process.stdin.isTTY) {
+    throw new Error("nothing is piped to standard input");
+  }
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
 function readJSONObject(file, label) {
   let parsed;
   try {
@@ -2057,6 +2124,139 @@ org.command("autonomy [mode]").description("Show or set the org's engine-autonom
     fail(e);
   }
 });
+var businessProfileCmd = org.command("business-profile").description("The org's legal identity, which A2P SMS registration is checked against");
+function printBusinessProfile(profile) {
+  printAlignedTable(
+    ["field", "value"],
+    [
+      ["legal name", profile.legal_name],
+      ["entity type", profile.entity_type],
+      ["legal structure", profile.legal_structure],
+      // Only shown for the one entity type that has them, so a private
+      // company's table does not carry two rows reading "—".
+      ...profile.stock_exchange || profile.stock_ticker ? [
+        ["stock exchange", profile.stock_exchange],
+        ["stock ticker", profile.stock_ticker]
+      ] : [],
+      ["tax id", profile.tax_id_stored ? `stored, ending ${profile.tax_id_last4 || "????"}` : "none stored"],
+      ["street", profile.street],
+      ["city", profile.city],
+      ["region", profile.region],
+      ["postal code", profile.postal_code],
+      ["country", profile.country],
+      ["website", profile.website_url],
+      ["industry", profile.industry],
+      ["privacy policy", profile.privacy_policy_url],
+      ["terms", profile.terms_and_conditions_url],
+      ["representative", `${profile.representative_first_name} ${profile.representative_last_name}`.trim()],
+      ["title", profile.representative_title],
+      ["job position", profile.representative_job_position],
+      ["email", profile.representative_email],
+      ["phone", profile.representative_phone],
+      ["updated", profile.updated_at ?? ""]
+    ]
+  );
+}
+function printMissingProfileFields(missing) {
+  if (missing.length === 0) return;
+  console.log("");
+  console.log(`Still needed before a number can be registered: ${missing.join(", ")}`);
+  console.log("Fill them in with: erdo org business-profile set --help");
+}
+businessProfileCmd.command("get").description("Show the stored business profile and what SMS registration still needs").option(
+  "--json",
+  "print the raw JSON result, which also carries the accepted entity types, legal structures, industries and job positions"
+).action(async (opts) => {
+  try {
+    const res = await new ErdoClient().getBusinessProfile();
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    if (!res.exists) {
+      console.log("No business profile saved for this organization.");
+      if (res.missing_fields.length > 0) {
+        console.log(`Registration needs: ${res.missing_fields.join(", ")}`);
+      }
+      console.log("Save one with: erdo org business-profile set --help");
+      return;
+    }
+    printBusinessProfile(res.profile);
+    printMissingProfileFields(res.missing_fields);
+  } catch (e) {
+    fail(e);
+  }
+});
+businessProfileCmd.command("set").description("Save the organization's business profile (unset flags keep what is stored)").option("--legal-name <name>", "registered legal name, exactly as it appears on the tax record").option(
+  "--entity-type <type>",
+  "private_for_profit, public_for_profit, non_profit, sole_proprietor or government"
+).option(
+  "--legal-structure <value>",
+  "the legal form the carrier registry checks against the tax record: sole_proprietorship, partnership, limited_liability_corporation, co_operative, non_profit_corporation or corporation"
+).option("--stock-exchange <exchange>", "a public company's exchange, e.g. NYSE \u2014 required for public_for_profit").option("--stock-ticker <ticker>", "a public company's ticker, e.g. ACME \u2014 required for public_for_profit").option(
+  "--replace-tax-id",
+  "replace the stored tax id: prompts for the new EIN without echoing it. Omit to keep what is stored"
+).option(
+  "--tax-id-stdin",
+  "read the tax id from standard input instead of prompting, for a script \u2014 e.g. `pass show ein | erdo org business-profile set --tax-id-stdin`"
+).option("--street <street>", "street address of the registered business").option("--city <city>", "city of the registered business").option("--region <region>", "state or province, e.g. FL").option("--postal-code <code>", "postal or ZIP code").option("--country <iso2>", "two-letter ISO country code, e.g. US").option("--website-url <url>", "the business's own website \u2014 carriers check that it describes it").option("--industry <industry>", "one of the industries listed by: erdo org business-profile get --json").option("--privacy-policy-url <url>", "the business's own privacy policy page (https) \u2014 a campaign without one is rejected").option("--terms-url <url>", "the business's own terms and conditions page (https) \u2014 required for the same reason").option("--first-name <name>", "given name of the person carriers may contact").option("--last-name <name>", "family name of that person").option("--title <title>", "their job title in the business's own words, e.g. Managing Partner").option(
+  "--job-position <position>",
+  "their role from the fixed list (ceo, cfo, director, general_counsel, gm, vp, other)"
+).option("--email <email>", "their email address").option("--phone <number>", "their phone number in E.164, e.g. +13055550123").option("--json", "print the raw JSON result instead of a table").action(
+  async (opts) => {
+    try {
+      const api = new ErdoClient();
+      const current = await api.getBusinessProfile();
+      const stored = current.profile;
+      const taxID = await resolveSecretInput({
+        replace: opts.replaceTaxId === true,
+        stored: stored.tax_id_stored,
+        fromStdin: opts.taxIdStdin === true,
+        interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+        readStdin: readAllStdin,
+        prompt: (replacing) => password({
+          message: replacing ? "New business tax id (EIN \u2014 digits; it replaces the stored one):" : "Business tax id (EIN \u2014 digits; leave blank if the business has none):",
+          mask: "*"
+        })
+      });
+      const entityType = opts.entityType ?? stored.entity_type;
+      const isPublic = entityType === "public_for_profit";
+      const body = {
+        legal_name: opts.legalName ?? stored.legal_name,
+        entity_type: entityType,
+        legal_structure: opts.legalStructure ?? stored.legal_structure,
+        stock_exchange: isPublic ? opts.stockExchange ?? stored.stock_exchange : void 0,
+        stock_ticker: isPublic ? opts.stockTicker ?? stored.stock_ticker : void 0,
+        tax_id: taxID,
+        street: opts.street ?? stored.street,
+        city: opts.city ?? stored.city,
+        region: opts.region ?? stored.region,
+        postal_code: opts.postalCode ?? stored.postal_code,
+        country: opts.country ?? stored.country,
+        website_url: opts.websiteUrl ?? stored.website_url,
+        industry: opts.industry ?? stored.industry,
+        privacy_policy_url: opts.privacyPolicyUrl ?? stored.privacy_policy_url,
+        terms_and_conditions_url: opts.termsUrl ?? stored.terms_and_conditions_url,
+        representative_first_name: opts.firstName ?? stored.representative_first_name,
+        representative_last_name: opts.lastName ?? stored.representative_last_name,
+        representative_title: opts.title ?? stored.representative_title,
+        representative_job_position: opts.jobPosition ?? stored.representative_job_position,
+        representative_email: opts.email ?? stored.representative_email,
+        representative_phone: opts.phone ?? stored.representative_phone
+      };
+      const res = await api.setBusinessProfile(body);
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      console.log("Business profile saved.");
+      printBusinessProfile(res.profile);
+      printMissingProfileFields(res.missing_fields);
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 var managed = org.command("managed").description("Operate client orgs via a manager account");
 managed.command("list").description("List the client orgs your org manages").action(async () => {
   try {
@@ -2153,6 +2353,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(
@@ -2161,6 +2364,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 {
@@ -2178,13 +2391,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;
@@ -4872,7 +5086,7 @@ sentEmailsCmd.command("get <emailID>").description("Read one sent email, includi
     fail(e);
   }
 });
-var voiceCmd = program.command("voice").description("Read a voice agent's phone calls, text conversations and website widget conversations");
+var voiceCmd = program.command("voice").description("A voice agent's phone calls, text conversations, website widget conversations, and its numbers");
 function contactLabel(contact) {
   if (!contact) return "-";
   const name = [contact.first_name, contact.last_name].filter(Boolean).join(" ");
@@ -5115,6 +5329,123 @@ voiceSMSCmd.command("get <sessionID>").description("Read one SMS conversation: i
     }
   }
 );
+var voiceNumbersCmd = voiceCmd.command("numbers").description("The organization's phone numbers and their A2P SMS registration state");
+function printRegistrationState(registration) {
+  if (registration === null || typeof registration !== "object") {
+    if (registration !== void 0) print(registration);
+    return;
+  }
+  const state = registration;
+  printAlignedTable(
+    ["number", "kind", "status", "waiting on", "reason"],
+    [
+      [
+        state.address ?? "",
+        state.sender_kind ?? "",
+        state.status ?? "",
+        state.next_step ?? "",
+        state.reason ?? ""
+      ]
+    ]
+  );
+  printProfileDriftNote([state]);
+}
+function printProfileDriftNote(numbers) {
+  const drifted = numbers.filter((n) => n.profile_out_of_date);
+  if (drifted.length === 0) return;
+  console.log("");
+  for (const number of drifted) {
+    const fields = number.profile_out_of_date_fields ?? [];
+    console.log(
+      `${number.address ?? "this number"}: the business profile has changed since it was registered${fields.length > 0 ? ` (${fields.join(", ")})` : ""} \u2014 the carriers still hold the previous legal identity.`
+    );
+  }
+  console.log(
+    "Re-send it with: erdo voice numbers provision-sms <number>. It re-opens carrier review, which takes days."
+  );
+}
+voiceNumbersCmd.command("list").description("List the organization's numbers with what each one's SMS registration is waiting on").option("--json", "print the raw JSON result instead of a table").action(async (opts) => {
+  try {
+    const res = await new ErdoClient().listVoicePhoneNumbers();
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    const numbers = res.numbers ?? [];
+    if (numbers.length === 0) {
+      console.log("This organization holds no phone numbers.");
+    } else {
+      printAlignedTable(
+        ["number", "agent", "kind", "status", "waiting on", "reason"],
+        numbers.map((n) => [
+          n.address,
+          n.agent_ref ?? "",
+          n.sender_kind,
+          n.status,
+          n.next_step ?? "",
+          n.reason ?? ""
+        ])
+      );
+      process.stderr.write(`showing ${numbers.length} number(s)
+`);
+      printProfileDriftNote(numbers);
+    }
+    if (!res.business_profile_complete) {
+      console.log("");
+      console.log(
+        res.missing_profile_fields.length > 0 ? `The business profile is incomplete \u2014 registration needs: ${res.missing_profile_fields.join(", ")}` : "The business profile is incomplete \u2014 no profile has been saved yet."
+      );
+      console.log("Complete it with: erdo org business-profile set --help, or in Settings \u2192 Business.");
+    }
+  } catch (e) {
+    fail(e);
+  }
+});
+voiceNumbersCmd.command("get <number>").description("Read one number's SMS registration state and what it is waiting on").option("--json", "print the raw JSON result instead of a summary").action(async (number, opts) => {
+  try {
+    const res = await new ErdoClient().getVoicePhoneNumberSMS(number);
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    printRegistrationState(res);
+    if (res.missing_profile_fields && res.missing_profile_fields.length > 0) {
+      console.log("");
+      console.log(
+        `The business profile is incomplete \u2014 registration needs: ${res.missing_profile_fields.join(", ")}`
+      );
+      console.log("Complete it with: erdo org business-profile set --help, or in Settings \u2192 Business.");
+    }
+  } catch (e) {
+    fail(e);
+  }
+});
+voiceNumbersCmd.command("provision-sms <number>").description("Ask for A2P SMS registration of one of the organization's numbers").option("--json", "print the raw JSON result instead of a summary").action(async (number, opts) => {
+  try {
+    const res = await new ErdoClient().provisionVoicePhoneNumberSMS(number);
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    if (res.status === "pending_approval") {
+      console.log("Nothing has been registered yet \u2014 an approval card was filed and awaits a decision.");
+      if (res.action_display) console.log(`action: ${res.action_display}`);
+      if (res.approval_request_id) {
+        console.log(`approval request: ${res.approval_request_id}`);
+        console.log(`  erdo approvals show ${res.approval_request_id}`);
+        console.log(`  erdo approvals decide ${res.approval_request_id} --approve`);
+      }
+    } else {
+      console.log(`Registration ${res.status}.`);
+      printRegistrationState(res.registration);
+    }
+    process.stderr.write(
+      "Carrier review takes days once submitted; the status updates on its own \u2014 re-read it with: erdo voice numbers list\n"
+    );
+  } 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.81.0",
+  "version": "0.83.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {