@ghostystudio/cli 0.12.0 → 0.13.0

package/README.md

@@ -35,6 +35,9 @@ ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--arg V]
 ghosty turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
 ghosty turns show <id> [turn-id|last]    # where a turn's time went: each tool with its seconds, output tokens
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
+ghosty channels whatsapp link|unlink <id> --integration ID --answer on|off   [--forward] [--dry-run]   # bring a WABA number from Formmy
+ghosty channels wa import <id> --from-file F --own-number yes|no   [--dry-run]   # personal WhatsApp session, no QR
+ghosty channels wa pair|status|pause <id>   [--phone N]
 ghosty channels wa groups ls|set|create <id> [group]      [--role equipo|cliente] [--on|--off] [--dry-run]   # personal WhatsApp groups
 ghosty board archive <id>                --integration X | --column X | --before 30d   [--dry-run]
 ghosty mcp get|set <id>                  [--file servers.json]
@@ -76,6 +79,10 @@ Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 - `try --replay FILE --out DIR`: replays real conversations from your machine. The report is written after every step, survives Ghosty deploys (it honors `Retry-After`), and `--resume` continues a partial run.
 - `agents doctor` speaks English like the rest of the CLI; `channels whatsapp ls` returns a full URL.
 
+### Changes in 0.13.0
+
+- Migrate WhatsApp numbers without signing up again: `channels whatsapp link|unlink` (a WhatsApp Business number that lives in Formmy; `--answer on|off` is required, `--dry-run` shows what changes in gs and in Formmy) and `channels wa import` (a personal WhatsApp session exported from EasyBits, no QR). Also `channels wa pair --phone` (pairing code), `wa status` and `wa pause`.
+
 ### Changes in 0.12.0
 
 - New: `channels wa groups ls|set|create`: which groups of the agent's personal WhatsApp it answers, and as `equipo` or `cliente`. Turning a group on asks first (`--yes` without a terminal); `--dry-run` shows the plan.

package/dist/index.js

@@ -282,7 +282,7 @@ async function postLong(path, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.12.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.13.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -324,7 +324,7 @@ async function request(path, opts = {}, retried = false) {
     method: opts.method ?? (opts.body !== void 0 || opts.raw !== void 0 ? "POST" : "GET"),
     headers: {
       authorization: `Bearer ${token}`,
-      "user-agent": `ghosty-cli/${"0.12.0"}`,
+      "user-agent": `ghosty-cli/${"0.13.0"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -1136,7 +1136,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.12.0"}`
+        "user-agent": `ghosty-cli/${"0.13.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1574,6 +1574,7 @@ async function credentialsCmd2(sub, provider, v) {
 }
 
 // src/commands/channels.ts
+import { readFile as readFile6 } from "node:fs/promises";
 var enc7 = encodeURIComponent;
 var digits = (s) => s.replace(/\D/g, "");
 function find(nums, ref) {
@@ -1585,6 +1586,8 @@ function find(nums, ref) {
 async function channelsCmd(kind, sub, id, ref, v) {
   if (kind !== "whatsapp" && kind !== "wa") throw usage(`Unknown channel: ${kind ?? "(none)"}.`, "Try: ghosty channels whatsapp ls <agent-id>");
   if (!id) throw usage("Missing agent id.", "Example: ghosty channels whatsapp ls <agent-id>");
+  if (sub === "link" || sub === "unlink") return linkCmd(sub, id, v);
+  if (sub === "import" || sub === "status" || sub === "pause" || sub === "pair") return waCmd(sub, id, v);
   if (sub === "enable" && !v["dry-run"]) requireYesIfHeadless(v.yes, `ghosty channels whatsapp enable ${id} ${ref ?? "<number>"}`);
   const path = `/api/v2/agents/${enc7(id)}/whatsapp`;
   const cur = await api(path);
@@ -1592,7 +1595,7 @@ async function channelsCmd(kind, sub, id, ref, v) {
     const rows = cur.numbers.map((n2) => ({ number: n2.label, answers: n2.mine ? lavender("this agent") : n2.takenByOther ? "another agent" : dim("nobody (silent)"), id: n2.id }));
     return out(cur, () => rows.length ? table(rows, ["number", "answers", "id"]) : dim(`No WhatsApp Business numbers yet. Pair one at ${cur.salesUrl}`));
   }
-  if (sub !== "enable" && sub !== "disable") throw usage(`Unknown subcommand: ${sub}.`, "Try: ghosty channels whatsapp ls | enable | disable <agent-id> <number>");
+  if (sub !== "enable" && sub !== "disable") throw usage(`Unknown subcommand: ${sub}.`, "Try: ghosty channels whatsapp ls | enable | disable | link | unlink \xB7 ghosty channels wa import | status | pause | groups");
   if (!ref) throw usage("Missing number.", `Example: ghosty channels whatsapp ${sub} ${id} +52 55 1234 5678`);
   const n = find(cur.numbers, ref);
   const on = sub === "enable";
@@ -1651,6 +1654,61 @@ The agent will start answering in this group as ${role}.`, { yes: v.yes, retry:
   const now = r.groups.find((x) => x.jid === g.jid);
   return out({ group: now ?? null, plan: [plan] }, () => `${lavender("\u2713")} ${g.name}: ${now?.enabled ? "on" : "off"} as ${now?.role ?? role}`);
 }
+async function waCmd(sub, id, v) {
+  if (!id) throw usage("Missing agent id.", `Example: ghosty channels wa ${sub} <agent-id>`);
+  const base = `/api/v2/agents/${enc7(id)}/wa`;
+  if (sub === "status") {
+    const s = await api(base);
+    return out(s, () => `${s.status === "connected" ? lavender("\u25CF connected") : dim(`\u25CB ${s.status}`)}  ${s.phone ? `+${s.phone}` : dim("(no number)")}${s.live ? "" : dim("  \xB7 no socket in gs")}${s.hasCreds ? "" : dim("  \xB7 no saved session")}${s.reason ? `
+${dim(s.reason)}` : ""}`);
+  }
+  if (sub === "pair") {
+    const phone = (v.phone ?? "").replace(/\D/g, "");
+    if (phone.length < 10) throw usage("Missing --phone (10-15 digits, with country code).", `Example: ghosty channels wa pair ${id} --phone 5215512345678`);
+    await api(base, { method: "POST", body: { phone } });
+    let s = { status: "connecting", phone: null, live: false, hasCreds: false };
+    for (let i = 0; i < 15 && !s.pairingCode && s.status !== "connected"; i++) {
+      await new Promise((r2) => setTimeout(r2, 1e3));
+      s = await api(base);
+    }
+    return out(s, () => s.status === "connected" ? `${lavender("\u2713")} Already connected (+${s.phone}).` : s.pairingCode ? `Code: ${bold(s.pairingCode)}
+${dim("On the phone: WhatsApp \u2192 Linked devices \u2192 Link with phone number \u2192 type it. Then: ghosty channels wa status " + id)}` : dim(`No code yet (status: ${s.status}${s.reason ? `, ${s.reason}` : ""}). Try again in a minute.`));
+  }
+  if (sub === "pause") {
+    await api(base, { method: "DELETE" });
+    return out({ paused: true }, () => `${lavender("\u2713")} Paused. The session is kept: ${dim(`ghosty channels wa import \u2026 or the Channels page reconnects it`)}`);
+  }
+  const file = v["from-file"];
+  if (!file) throw usage("Missing --from-file.", `Example: ghosty channels wa import ${id} --from-file creds.json --own-number no --dry-run`);
+  const own = v["own-number"];
+  if (own !== "yes" && own !== "no") throw usage("Missing --own-number yes|no.", "yes = the number belongs to the agent \xB7 no = it is a person's number (only their chat with themselves is the owner's)");
+  const data = JSON.parse(await readFile6(file, "utf8"));
+  const body = { authCreds: data.authCreds, authKeys: data.authKeys, phone: data.phone, groups: data.groups, ownNumber: own === "yes", replace: !!v.replace };
+  const plan = await api(`${base}/import`, { method: "POST", body: { ...body, dryRun: true } });
+  if (v["dry-run"]) return out(plan, () => `${plan.plan.join("\n")}
+${dim("Dry run: nothing changed.")}`);
+  await confirm(`${bold(plan.plan.join("\n"))}
+This number starts living in gs. Turn off its EasyBits socket first, WITHOUT logout (two sockets knock each other off).`, { yes: v.yes, expect: plan.phone.slice(-4), retry: `ghosty channels wa import ${id} --from-file ${file} --own-number ${own}${v.replace ? " --replace" : ""}` });
+  const r = await api(`${base}/import`, { method: "POST", body: { ...body, connect: !v["no-connect"] } });
+  return out(r, () => `${lavender("\u2713")} +${r.phone} imported \xB7 status: ${r.status === "connected" ? lavender("connected") : r.status}${r.reason ? dim(` (${r.reason})`) : ""}
+${dim(`Next: ghosty channels wa groups ls ${id}   \xB7 delete ${file}: it holds the account's keys`)}`);
+}
+async function linkCmd(sub, id, v) {
+  if (!id || !v.integration) throw usage("Missing agent id or --integration.", `Example: ghosty channels whatsapp ${sub} <agent-id> --integration <formmy-integration-id> --answer off --dry-run`);
+  if (sub === "link" && v.answer !== "on" && v.answer !== "off") throw usage("Missing --answer on|off.", "on = this agent answers real customers \xB7 off = it only records (add --forward so gs still sees the conversations)");
+  const path = `/api/v2/agents/${enc7(id)}/whatsapp/link`;
+  const body = { integrationId: v.integration, ...sub === "unlink" ? { unlink: true } : { answer: v.answer === "on", ...v.forward ? { forward: true } : {} } };
+  const plan = await api(path, { method: "POST", body: { ...body, dryRun: true } });
+  const text = `${plan.plan.join("\n")}
+${dim(`Formmy: ${plan.formmy.before.url ?? "null"} \u2192 ${plan.formmy.after.url ?? "null"} (as ${plan.formmy.by})`)}`;
+  if (v["dry-run"]) return out(plan, () => `${text}
+${dim("Dry run: nothing changed.")}`);
+  const digits4 = (plan.number.phoneNumberId ?? v.integration).slice(-4);
+  await confirm(`${bold(text)}
+${sub === "link" ? "From now on this number's messages reach this agent in gs." : "This number goes back to where it was before."}`, { yes: v.yes, expect: digits4, retry: `ghosty channels whatsapp ${sub} ${id} --integration ${v.integration}${sub === "link" ? ` --answer ${v.answer}${v.forward ? " --forward" : ""}` : ""}` });
+  const r = await api(path, { method: "POST", body });
+  return out(r, () => `${lavender("\u2713")} ${sub === "link" ? `Linked (link ${r.linkId}). Check: ghosty channels whatsapp ls ${id} \xB7 ghosty turns ls ${id} --since 10m` : "Unlinked: Formmy points where it did before."}`);
+}
 
 // src/commands/board.ts
 async function boardCmd(sub, id, v) {
@@ -1881,6 +1939,11 @@ HELPS.channels = {
     "ghosty channels whatsapp ls <agent-id>",
     "ghosty channels whatsapp enable <agent-id> <number> [--dry-run] [--yes]",
     "ghosty channels whatsapp disable <agent-id> <number> [--dry-run]",
+    "ghosty channels whatsapp link <agent-id> --integration <formmy-id> --answer on|off [--forward] [--dry-run] [--yes]",
+    "ghosty channels whatsapp unlink <agent-id> --integration <formmy-id> [--dry-run] [--yes]",
+    "ghosty channels wa import <agent-id> --from-file creds.json --own-number yes|no [--replace] [--no-connect] [--dry-run] [--yes]",
+    "ghosty channels wa pair <agent-id> --phone 5215512345678",
+    "ghosty channels wa status|pause <agent-id>",
     "ghosty channels wa groups ls <agent-id> [--cached]",
     "ghosty channels wa groups set <agent-id> <group> [--role equipo|cliente] [--on | --off] [--dry-run] [--yes]",
     'ghosty channels wa groups create <agent-id> "Name" [--role equipo|cliente]'
@@ -1890,19 +1953,30 @@ HELPS.channels = {
     ["--yes", "enable / groups set --on: skip the confirmation (required without a terminal)"],
     ["--role R", "groups: equipo (the team: writes to databases, admin tools) or cliente (like any customer)"],
     ["--on | --off", "groups set: the agent answers in that group, or stops"],
-    ["--cached", "groups ls: don't ask WhatsApp for the live list (faster; may miss new groups)"]
+    ["--cached", "groups ls: don't ask WhatsApp for the live list (faster; may miss new groups)"],
+    ["--integration ID", "link/unlink: the WhatsApp Business number's Integration id in Formmy"],
+    ["--answer on|off", "link (required, no default): on = this agent answers real customers; off = it only records"],
+    ["--forward", "link --answer off: still make Formmy forward, so gs sees the conversations"],
+    ["--from-file F", "import: {authCreds, authKeys, phone, groups} exported from EasyBits"],
+    ["--own-number yes|no", "import (required): the number is the agent's, or a person's (only their self-chat is the owner's)"],
+    ["--replace", "import: replace a session already saved in gs"],
+    ["--no-connect", "import: save it but don't connect yet"]
   ],
   examples: [
     "ghosty channels whatsapp ls <id>",
     "ghosty channels whatsapp enable <id> 5512345678 --dry-run",
     "ghosty channels whatsapp disable <id> 5512345678",
     "ghosty channels wa groups ls <id>",
-    'ghosty channels wa groups set <id> "Pia-cotizadora" --role equipo --on --dry-run'
+    'ghosty channels wa groups set <id> "Pia-cotizadora" --role equipo --on --dry-run',
+    "ghosty channels whatsapp link <id> --integration 6a3af395\u2026 --answer off --dry-run",
+    "ghosty channels wa import <id> --from-file pia-wa.json --own-number no --dry-run"
   ],
   notes: [
     "<number> is its id, its label or its last digits. One number, one agent: enabling it takes it from the other agent.",
     "Disabling keeps logging messages; nobody answers them.",
-    "Groups belong to the PERSONAL WhatsApp paired to the agent (not WhatsApp Business). <group> is its name or its jid."
+    "Groups belong to the PERSONAL WhatsApp paired to the agent (not WhatsApp Business). <group> is its name or its jid.",
+    "link moves a number that already lives in Formmy (EasyBits, a droplet) without redoing Meta's signup; unlink sends it back. Only the owner, an admin of the agent or Ghosty staff.",
+    "import: turn off the EasyBits socket first WITHOUT logout (two sockets knock each other off; a logout invalidates the keys). Delete the file afterwards."
   ],
   learn: `${REF}#canales-de-whatsapp`
 };
@@ -1941,7 +2015,7 @@ function helpText(cmd) {
 }
 
 // src/update.ts
-import { mkdir as mkdir4, readFile as readFile6, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile7, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
 import { dirname as dirname3, join as join4 } from "node:path";
 var FILE = join4(process.env.XDG_CONFIG_HOME || join4(homedir3(), ".config"), "ghosty", "update.json");
@@ -1957,7 +2031,7 @@ async function latestVersion() {
   if (process.env.GHOSTY_NO_UPDATE_CHECK || process.env.CI) return null;
   let cache = {};
   try {
-    cache = JSON.parse(await readFile6(FILE, "utf8"));
+    cache = JSON.parse(await readFile7(FILE, "utf8"));
   } catch {
   }
   if (!cache.checkedAt || Date.now() - cache.checkedAt > DAY) {
@@ -2009,6 +2083,10 @@ ${bold("Configure an agent")}
   dbs ls|tables|query|import|grant|revoke <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run]
   mcp get|set <id>                   MCP servers                    [--file servers.json]
   channels whatsapp ls|enable|disable <id> [number]   Which WhatsApp Business numbers it answers   [--dry-run]
+  channels whatsapp link|unlink <id> --integration ID --answer on|off   Bring a WhatsApp Business number from Formmy/EasyBits to this agent, or send it back   [--forward] [--dry-run]
+  channels wa import <id> --from-file F --own-number yes|no   Move a personal WhatsApp session here, no QR   [--dry-run] [--replace] [--no-connect]
+  channels wa pair <id> --phone N         Pair a personal WhatsApp by code (no QR)
+  channels wa status|pause <id>           Personal WhatsApp: how it is / pause it (keeps the session)
   channels wa groups ls|set|create <id> [group]        Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--on|--off] [--dry-run]
   board archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
@@ -2138,6 +2216,13 @@ async function main() {
       before: { type: "string" },
       recycle: { type: "boolean" },
       role: { type: "string" },
+      "from-file": { type: "string" },
+      "own-number": { type: "string" },
+      answer: { type: "string" },
+      phone: { type: "string" },
+      forward: { type: "boolean" },
+      replace: { type: "boolean" },
+      "no-connect": { type: "boolean" },
       cached: { type: "boolean" },
       check: { type: "string", multiple: true },
       contains: { type: "string", multiple: true }
@@ -2147,7 +2232,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.12.0" }, () => "0.12.0");
+  if (v.version) return out({ version: "0.13.0" }, () => "0.13.0");
   const [cmd, sub, a1, a2] = pos;
   if (cmd === "partner" && (v.help || !sub || sub === "help")) return out({ help: PARTNER_HELP }, () => PARTNER_HELP);
   const topic = cmd === "help" ? sub : v.help ? cmd : void 0;
@@ -2232,7 +2317,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.12.0").catch(() => null);
+var notice = updateNotice("0.13.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {