@ghostystudio/cli 0.12.0 → 0.13.1

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 | --from-dir DIR --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,14 @@ 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.1
+
+- `channels wa import --from-dir DIR`: import a Baileys multi-file auth folder (`creds.json` + one file per key, e.g. nanoclaw's `store/auth`); it undoes Baileys' file-name escaping per key type.
+
+### 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.1"}`, "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.1"}`,
       ...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.1"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1573,6 +1573,42 @@ async function credentialsCmd2(sub, provider, v) {
   }
 }
 
+// src/commands/channels.ts
+import { readFile as readFile7 } from "node:fs/promises";
+
+// src/wa-auth.ts
+import { readdir as readdir2, readFile as readFile6 } from "node:fs/promises";
+import { join as join4 } from "node:path";
+var TYPES = ["app-state-sync-version", "app-state-sync-key", "sender-key-memory", "sender-key", "lid-mapping", "device-list", "identity-key", "pre-key", "session", "tctoken"];
+function keyOfFileName(name) {
+  for (const type of TYPES) {
+    if (!name.startsWith(`${type}-`)) continue;
+    let id = name.slice(type.length + 1).replace(/__/g, "/");
+    if (type === "sender-key" || type === "sender-key-memory") id = id.replace(/--/g, "::");
+    return id ? { type, id } : null;
+  }
+  return null;
+}
+async function readMultiFileAuth(dir) {
+  const files = (await readdir2(dir)).filter((f) => f.endsWith(".json"));
+  if (!files.includes("creds.json")) throw new Error(`${dir} has no creds.json: not a Baileys multi-file auth folder`);
+  const authCreds = JSON.parse(await readFile6(join4(dir, "creds.json"), "utf8"));
+  const authKeys = {};
+  const counts = {};
+  const skipped = [];
+  for (const f of files) {
+    if (f === "creds.json") continue;
+    const k = keyOfFileName(f.slice(0, -".json".length));
+    if (!k) {
+      skipped.push(f);
+      continue;
+    }
+    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile6(join4(dir, f), "utf8"));
+    counts[k.type] = (counts[k.type] ?? 0) + 1;
+  }
+  return { authCreds, authKeys, counts, skipped };
+}
+
 // src/commands/channels.ts
 var enc7 = encodeURIComponent;
 var digits = (s) => s.replace(/\D/g, "");
@@ -1585,6 +1621,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 +1630,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 +1689,66 @@ 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"] ?? v["from-dir"];
+  if (!file || v["from-file"] && v["from-dir"]) throw usage("Use --from-file F (EasyBits JSON) or --from-dir DIR (Baileys multi-file folder).", `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)");
+  let data;
+  if (v["from-dir"]) {
+    const m = await readMultiFileAuth(v["from-dir"]);
+    info(dim(`${v["from-dir"]}: ${Object.entries(m.counts).map(([t, n]) => `${t} ${n}`).join(" \xB7 ") || "no keys"}${m.skipped.length ? ` \xB7 skipped ${m.skipped.length} unknown file(s)` : ""}`));
+    data = { authCreds: m.authCreds, authKeys: m.authKeys };
+  } else data = JSON.parse(await readFile7(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} ${v["from-dir"] ? "--from-dir" : "--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 +1979,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 | --from-dir auth/ --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 +1993,31 @@ 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"],
+    ["--from-dir DIR", "import: a Baileys multi-file auth folder (creds.json + one file per key; e.g. nanoclaw's store/auth)"],
+    ["--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,10 +2056,10 @@ 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 readFile8, 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");
+import { dirname as dirname3, join as join5 } from "node:path";
+var FILE = join5(process.env.XDG_CONFIG_HOME || join5(homedir3(), ".config"), "ghosty", "update.json");
 var DAY = 24 * 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @ghostystudio/cli@latest";
 function newer(a, b) {
@@ -1957,7 +2072,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 readFile8(FILE, "utf8"));
   } catch {
   }
   if (!cache.checkedAt || Date.now() - cache.checkedAt > DAY) {
@@ -2009,6 +2124,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 | --from-dir DIR --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 +2257,14 @@ async function main() {
       before: { type: "string" },
       recycle: { type: "boolean" },
       role: { type: "string" },
+      "from-file": { type: "string" },
+      "from-dir": { 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 +2274,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.1" }, () => "0.13.1");
   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 +2359,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.12.0").catch(() => null);
+var notice = updateNotice("0.13.1").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.1",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
   "scripts": {
     "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --outfile=dist/index.js --banner:js='#!/usr/bin/env node' --define:__VERSION__=\\\"$npm_package_version\\\"",
     "prepack": "npm run build",
-    "test": "for t in flags prompt api rows; do esbuild src/$t.test.ts --bundle --platform=node --format=esm --outfile=/tmp/ghosty-cli-$t.test.mjs --log-level=error || exit 1; done && node --test /tmp/ghosty-cli-*.test.mjs"
+    "test": "for t in flags prompt api rows wa-auth; do esbuild src/$t.test.ts --bundle --platform=node --format=esm --outfile=/tmp/ghosty-cli-$t.test.mjs --log-level=error || exit 1; done && node --test /tmp/ghosty-cli-*.test.mjs"
   },
   "keywords": [
     "ghosty",