@ghostystudio/cli 0.24.2 → 0.25.0

package/README.md

@@ -90,6 +90,12 @@ 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.25.0
+
+- `channels whatsapp history` says how many conversations arrive paused by Formmy (and how many "until 9999") or in manual mode; `cards ls --paused` lists them.
+- `history` retries by itself on 502/503/504 or a dropped connection (a gs deploy mid-import) and says where it resumes.
+- `channels wa import --from easybits:<agent-id>`: straight from EasyBits (no loose script); first prints whether the origin session is alive, its keys and groups. The keys stay in memory.
+
 ### Changes in 0.24.2
 
 - `channels whatsapp integrations` also lists numbers the workspace already linked in gs (even if another Formmy account owns them); staff: `--email`.

package/dist/index.js

@@ -8268,7 +8268,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.24.2"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.25.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8310,7 +8310,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.24.2"}`,
+      "user-agent": `ghosty-cli/${"0.25.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9305,7 +9305,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.24.2"}`
+        "user-agent": `ghosty-cli/${"0.25.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10087,6 +10087,31 @@ ${t(`The agent will start answering in this group as ${role}.`, `El agente empez
   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"} ${t("as", "como")} ${now?.role ?? role}`);
 }
+var EB_EXPORT = (agentId) => `${(process.env.EASYBITS_URL ?? "https://www.easybits.cloud").replace(/\/+$/, "")}/api/v2/fleet-agents/${enc7(agentId)}/baileys/export`;
+async function easybitsSession(agentId, keys) {
+  const key = process.env.EASYBITS_API_KEY;
+  if (!key) throw usage(t("EASYBITS_API_KEY is not set.", "EASYBITS_API_KEY no est\xE1 definida."), t("Export the EasyBits API key of the agent's owner and run again.", "Exporta la API key de EasyBits del due\xF1o del agente y vuelve a correrlo."));
+  const res = await fetch(EB_EXPORT(agentId), { method: "POST", headers: { authorization: `Bearer ${key}`, "content-type": "application/json" }, body: JSON.stringify(keys ? { confirm: "export" } : { dryRun: true }) });
+  const body = await res.json().catch(() => ({}));
+  if (res.status === 404) throw usage(t(`EasyBits has no agent ${agentId} for that key.`, `EasyBits no tiene el agente ${agentId} con esa llave.`), t("The key must be the agent owner's.", "La llave tiene que ser del due\xF1o del agente."));
+  if (!res.ok) throw usage(`EasyBits ${res.status}: ${body.error ?? ""}`);
+  return body;
+}
+function originText(o) {
+  const label = {
+    alive: lavender(t("\u25CF alive", "\u25CF viva")),
+    stale: t("! stale (no recent activity)", "! sin actividad reciente"),
+    logged_out: t("\u2717 logged out", "\u2717 cerr\xF3 sesi\xF3n"),
+    never_paired: t("\u2717 never paired", "\u2717 nunca se pare\xF3")
+  };
+  const seen = o.status.lastSeenAt ? ` \xB7 ${t("last seen", "\xFAltima se\xF1al")} ${o.status.lastSeenAt.slice(0, 16).replace("T", " ")}` : "";
+  const groups = o.groupDetails.length ? o.groupDetails.map((g) => `  ${g.enabled ? "\u2713" : dim("\xB7")} ${g.name ?? g.jid}${g.main ? dim(" (main)") : ""}`).join("\n") : dim(t("  no groups", "  sin grupos"));
+  return [
+    `${bold(t("Origin (EasyBits)", "Origen (EasyBits)"))} ${o.name ?? o.agentId} ${o.phone ? `+${o.phone}` : ""}: ${label[o.health] ?? o.health}${seen}`,
+    dim(`  ${t("keys", "llaves")} ${o.keyCount} \xB7 ${o.registered ? t("registered", "registrada") : t("not registered", "sin registrar")}${o.status.lastError ? ` \xB7 ${o.status.lastError}` : ""}`),
+    groups
+  ].join("\n");
+}
 async function waCmd(sub, id, v) {
   if (!id) throw usage(t("Missing agent id.", "Falta el id del agente."), t("Example", "Ejemplo") + `: ghosty channels wa ${sub} <agent-id>`);
   const base = `/api/v2/agents/${enc7(id)}/wa`;
@@ -10111,25 +10136,36 @@ ${dim(t("On the phone: WhatsApp \u2192 Linked devices \u2192 Link with phone num
     await api(base, { method: "DELETE" });
     return out({ paused: true }, () => `${lavender("\u2713")} ${t("Paused. The session is kept:", "En pausa. La sesi\xF3n se conserva:")} ${dim(t("ghosty channels wa import \u2026 or the Channels page reconnects it", "ghosty channels wa import \u2026 o la p\xE1gina Canales la reconecta"))}`);
   }
-  const file = v["from-file"] ?? v["from-dir"];
-  if (!file || v["from-file"] && v["from-dir"]) throw usage(t("Use --from-file F (EasyBits JSON) or --from-dir DIR (Baileys multi-file folder).", "Usa --from-file F (JSON de EasyBits) o --from-dir DIR (carpeta multi-archivo de Baileys)."), t("Example", "Ejemplo") + `: ghosty channels wa import ${id} --from-file creds.json --own-number no --dry-run`);
+  const eb = /^easybits:(.+)$/.exec(v.from ?? "")?.[1];
+  if (v.from && !eb) throw usage(t("--from takes easybits:<agent-id>.", "--from acepta easybits:<id-del-agente>."));
+  const file = eb ? `easybits:${eb}` : v["from-file"] ?? v["from-dir"];
+  if (!file || [eb, v["from-file"], v["from-dir"]].filter(Boolean).length > 1) throw usage(t("Use --from easybits:<agent-id>, --from-file F (EasyBits JSON) or --from-dir DIR (Baileys multi-file folder).", "Usa --from easybits:<id-del-agente>, --from-file F (JSON de EasyBits) o --from-dir DIR (carpeta multi-archivo de Baileys)."), t("Example", "Ejemplo") + `: ghosty channels wa import ${id} --from easybits:<agent-id> --own-number no --dry-run`);
+  let origin;
+  if (eb) {
+    origin = await easybitsSession(eb, false);
+    if (!globals.json) info(originText(origin));
+    if (origin.health !== "alive" && !globals.json) info(lavender(t("The origin session is not alive: importing it will not connect. Pair the number again instead (ghosty channels wa pair).", "La sesi\xF3n del origen no est\xE1 viva: importarla no va a conectar. Mejor parea el n\xFAmero de nuevo (ghosty channels wa pair).")));
+  }
   const own = v["own-number"];
   if (own !== "yes" && own !== "no") throw usage(t("Missing --own-number yes|no.", "Falta --own-number yes|no."), t("yes = the number belongs to the agent \xB7 no = it is a person's number (only their chat with themselves is the owner's)", "yes = el n\xFAmero es del agente \xB7 no = es el n\xFAmero de una persona (s\xF3lo su chat consigo misma es \xABdel due\xF1o\xBB)"));
   let data;
-  if (v["from-dir"]) {
+  if (eb) {
+    const full = await easybitsSession(eb, true);
+    data = { authCreds: full.authCreds, authKeys: full.authKeys, phone: full.phone, groups: full.groups };
+  } else if (v["from-dir"]) {
     const m = await readMultiFileAuth(v["from-dir"]);
     info(dim(`${v["from-dir"]}: ${Object.entries(m.counts).map(([k, n]) => `${k} ${n}`).join(" \xB7 ") || t("no keys", "sin llaves")}${m.skipped.length ? t(` \xB7 skipped ${m.skipped.length} unknown file(s)`, ` \xB7 se omitieron ${m.skipped.length} archivo(s) desconocido(s)`) : ""}`));
     data = { authCreds: m.authCreds, authKeys: m.authKeys };
   } else data = JSON.parse(await readFile8(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.map((x) => serverText(x)).join("\n")}
+  if (v["dry-run"]) return out(origin ? { origin, ...plan } : plan, () => `${plan.plan.map((x) => serverText(x)).join("\n")}
 ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
   await confirm(`${bold(plan.plan.map((x) => serverText(x)).join("\n"))}
-${t("This number starts living in gs. Turn off its EasyBits socket first, WITHOUT logout (two sockets knock each other off).", "Este n\xFAmero empieza a vivir en gs. Apaga antes su socket de EasyBits, SIN logout (dos sockets se tumban entre s\xED).")}`, { 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" : ""}` });
+${t("This number starts living in gs. Turn off its EasyBits socket first, WITHOUT logout (two sockets knock each other off).", "Este n\xFAmero empieza a vivir en gs. Apaga antes su socket de EasyBits, SIN logout (dos sockets se tumban entre s\xED).")}`, { yes: v.yes, expect: plan.phone.slice(-4), retry: `ghosty channels wa import ${id} ${eb ? "--from" : 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} ${t("imported \xB7 status", "importado \xB7 estado")}: ${r.status === "connected" ? lavender(t("connected", "conectado")) : r.status}${r.reason ? dim(` (${serverText(r.reason)})`) : ""}
-${dim(t(`Next: ghosty channels wa groups ls ${id}   \xB7 delete ${file}: it holds the account's keys`, `Sigue: ghosty channels wa groups ls ${id}   \xB7 borra ${file}: guarda las llaves de la cuenta`))}`);
+${dim(eb ? t(`Next: ghosty channels wa groups ls ${id}`, `Sigue: ghosty channels wa groups ls ${id}`) : t(`Next: ghosty channels wa groups ls ${id}   \xB7 delete ${file}: it holds the account's keys`, `Sigue: ghosty channels wa groups ls ${id}   \xB7 borra ${file}: guarda las llaves de la cuenta`))}`);
 }
 async function linkCmd(sub, id, v) {
   if (!id || !v.integration) throw usage(t("Missing agent id or --integration.", "Falta el id del agente o --integration."), t("Example", "Ejemplo") + `: ghosty channels whatsapp ${sub} <agent-id> --integration <formmy-integration-id> --answer off --dry-run`);
@@ -10151,6 +10187,29 @@ function bareMediaFlag(argv) {
   if (argv[0] !== "channels" || !argv.includes("history")) return argv;
   return argv.map((a, i) => a === "--media" && (argv[i + 1] === void 0 || argv[i + 1].startsWith("-")) ? "--media=" : a);
 }
+function pausedLine(s, id) {
+  if (!s.paused && !s.manual) return "";
+  const txt = t(
+    `${s.paused} paused by Formmy${s.pausedForever ? ` (${s.pausedForever} indefinitely)` : ""}, ${s.manual} in manual mode: the agent doesn't answer them`,
+    `${s.paused} pausada(s) por Formmy${s.pausedForever ? ` (${s.pausedForever} sin fecha)` : ""}, ${s.manual} en modo manual: el agente no las contesta`
+  );
+  return `
+${lavender(txt)}
+${dim(`${t("See them", "Verlas")}: ghosty board ls ${id} --paused --limit 200`)}`;
+}
+async function pageWithRetry(fetchPage, where, waitMs = (n) => 5e3 * n, tries = 6) {
+  for (let n = 1; ; n++) {
+    try {
+      return await fetchPage();
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      const transient = e instanceof TypeError || /^(502|503|504)\b/.test(msg) || /fetch failed|ECONNRESET|ETIMEDOUT/i.test(msg);
+      if (!transient || n >= tries) throw e;
+      if (!globals.json) info(dim(t(`  ${msg.slice(0, 60)} \u2014 resuming at ${where} in ${Math.round(waitMs(n) / 1e3)} s (${n}/${tries - 1})`, `  ${msg.slice(0, 60)} \u2014 reanudando en ${where} en ${Math.round(waitMs(n) / 1e3)} s (${n}/${tries - 1})`)));
+      await new Promise((r) => setTimeout(r, waitMs(n)));
+    }
+  }
+}
 async function integrationsCmd(id, email) {
   const r = await api(`/api/v2/agents/${enc7(id)}/whatsapp/integrations${email ? `?email=${enc7(email)}` : ""}`);
   const who2 = { gs: "gs", easybits: "EasyBits", droplet: "droplet", formmy: "Formmy", other: t("other", "otro") };
@@ -10188,7 +10247,8 @@ ${dim(v["dry-run"] ? t("Dry run: nothing copied.", "Simulacro: no se copi\xF3 na
     let cursor2 = 0;
     let done2 = 0;
     while (cursor2 !== null) {
-      const p = await api(path, { method: "POST", body: { integrationId: v.integration, days, cursor: cursor2, media: true } });
+      const at = cursor2;
+      const p = await pageWithRetry(() => api(path, { method: "POST", body: { integrationId: v.integration, days, cursor: at, media: true } }), `${done2}/${c.conversations}`);
       sum2.mediaCopied += p.mediaCopied ?? 0;
       sum2.mediaFailed += p.mediaFailed ?? 0;
       done2 += p.page;
@@ -10209,27 +10269,29 @@ ${dim(t("Dry run: nothing imported. Re-running later never duplicates.", "Simula
   if (!c.conversations) return out({ ...c, imported: 0 }, () => dim(t(`Nothing to import: ${plan}.`, `Nada que importar: ${plan}.`)));
   await confirm(`${bold(plan)}
 ${t(`Cards appear on the team's board (no "new lead" alerts).`, "Las tarjetas aparecen en el tablero del equipo (sin avisos de \xABlead nuevo\xBB).")}`, { yes: v.yes, retry: `ghosty channels whatsapp history ${id} --integration ${v.integration} --days ${days}` });
-  const sum = { newCards: 0, updatedCards: 0, messages: 0, orders: 0, suppressed: 0, mediaCopied: 0, mediaFailed: 0 };
+  const sum = { newCards: 0, updatedCards: 0, messages: 0, orders: 0, suppressed: 0, mediaCopied: 0, mediaFailed: 0, paused: 0, pausedForever: 0, manual: 0 };
   let cursor = 0;
   let done = 0;
   while (cursor !== null) {
-    const p = await api(path, { method: "POST", body: { integrationId: v.integration, days, cursor } });
+    const at = cursor;
+    const p = await pageWithRetry(() => api(path, { method: "POST", body: { integrationId: v.integration, days, cursor: at } }), `${done}/${c.conversations}`);
     for (const k of Object.keys(sum)) sum[k] += p[k] ?? 0;
     done += p.page;
     if (!globals.json) info(dim(`  ${done}/${p.total} ${t("conversations", "conversaciones")}`));
     cursor = p.nextCursor;
   }
-  out({ ...sum, conversations: done }, () => `${lavender("\u2713")} ${t(`${sum.newCards} new card(s), ${sum.updatedCards} updated, ${sum.messages} message(s), ${sum.orders} order(s)`, `${sum.newCards} tarjeta(s) nueva(s), ${sum.updatedCards} actualizada(s), ${sum.messages} mensaje(s), ${sum.orders} pedido(s)`)}${files(sum)}${sum.suppressed ? dim(t(` \xB7 ${sum.suppressed} bot draft(s) the customer never saw, skipped`, ` \xB7 se omitieron ${sum.suppressed} borrador(es) del bot que el cliente nunca vio`)) : ""}`);
+  out({ ...sum, conversations: done }, () => `${lavender("\u2713")} ${t(`${sum.newCards} new card(s), ${sum.updatedCards} updated, ${sum.messages} message(s), ${sum.orders} order(s)`, `${sum.newCards} tarjeta(s) nueva(s), ${sum.updatedCards} actualizada(s), ${sum.messages} mensaje(s), ${sum.orders} pedido(s)`)}${files(sum)}${sum.suppressed ? dim(t(` \xB7 ${sum.suppressed} bot draft(s) the customer never saw, skipped`, ` \xB7 se omitieron ${sum.suppressed} borrador(es) del bot que el cliente nunca vio`)) : ""}${pausedLine(sum, id)}`);
 }
 
 // src/commands/board.ts
 var who = (role) => ({ user: t("customer", "cliente"), assistant: t("agent", "agente"), operator: t("operator", "operador") })[role] ?? role;
 async function boardLs(id, v) {
-  const qs = new URLSearchParams({ ...v.q ? { q: v.q } : {}, ...v.limit ? { limit: v.limit } : {} });
+  const qs = new URLSearchParams({ ...v.q ? { q: v.q } : {}, ...v.limit ? { limit: v.limit } : {}, ...v.paused ? { paused: "1" } : {} });
   const r = await api(`/api/v2/agents/${encodeURIComponent(id)}/board/conversations?${qs}`);
-  const rows = r.conversations.map((c) => ({ folio: c.folio ? `#${c.folio}` : "", name: c.name ?? "", phone: c.phone, column: c.column ?? "", msgs: c.messages, last: (c.lastActivity ?? "").slice(0, 16).replace("T", " ") }));
-  out(r, () => rows.length ? `${table(rows, ["folio", "name", "phone", "column", "msgs", "last"])}
-${dim(`\xAB${r.board}\xBB \xB7 ${t("thread", "hilo")}: ghosty board show ${id} <folio|phone>`)}` : dim(t(`No cards on \xAB${r.board}\xBB${v.q ? ` matching "${v.q}"` : ""}.`, `No hay tarjetas en \xAB${r.board}\xBB${v.q ? ` que coincidan con "${v.q}"` : ""}.`)));
+  const paused = (c) => c.manual ? t("manual", "manual") : c.pausedUntil ? Date.parse(c.pausedUntil) - Date.now() > 365 * 864e5 ? t("indefinite", "indefinida") : c.pausedUntil.slice(0, 16).replace("T", " ") : "";
+  const rows = r.conversations.map((c) => ({ folio: c.folio ? `#${c.folio}` : "", name: c.name ?? "", phone: c.phone, column: c.column ?? "", msgs: c.messages, last: (c.lastActivity ?? "").slice(0, 16).replace("T", " "), paused: paused(c) }));
+  out(r, () => rows.length ? `${table(rows, ["folio", "name", "phone", "column", "msgs", "last", ...v.paused || rows.some((x) => x.paused) ? ["paused"] : []])}
+${dim(`\xAB${r.board}\xBB \xB7 ${t("thread", "hilo")}: ghosty board show ${id} <folio|phone>`)}` : dim(t(`No ${v.paused ? "paused " : ""}cards on \xAB${r.board}\xBB${v.q ? ` matching "${v.q}"` : ""}.`, `No hay tarjetas${v.paused ? " pausadas" : ""} en \xAB${r.board}\xBB${v.q ? ` que coincidan con "${v.q}"` : ""}.`)));
 }
 async function boardShow(id, ref, v) {
   if (!ref) throw usage(t("Missing conversation.", "Falta la conversaci\xF3n."), t(`Example: ghosty board show ${id} "#12"   (folio, phone, session or id; list them with ghosty board ls ${id})`, `Ejemplo: ghosty board show ${id} "#12"   (folio, tel\xE9fono, sesi\xF3n o id; l\xEDstalas con ghosty board ls ${id})`));
@@ -10491,6 +10553,7 @@ var HELPS_ES = {
       ["--media", "history: s\xF3lo re-copia los archivos que faltan (fotos, PDF, audios) de las conversaciones ya importadas"],
       ["--answer on|off", "link (obligatorio, sin default): on = este agente contesta a clientes reales; off = s\xF3lo registra"],
       ["--forward", "link --answer off: igual hace que Formmy reenv\xEDe, para que gs vea las conversaciones"],
+      ["--from easybits:ID", "import: directo del agente de EasyBits ($EASYBITS_API_KEY del due\xF1o); primero dice si su sesi\xF3n est\xE1 viva, sus llaves y grupos; las llaves s\xF3lo viven en memoria"],
       ["--from-file F", "import: {authCreds, authKeys, phone, groups} exportado de EasyBits"],
       ["--from-dir DIR", "import: una carpeta de auth multi-archivo de Baileys (creds.json + un archivo por llave; p. ej. store/auth de nanoclaw)"],
       ["--own-number yes|no", "import (obligatorio): el n\xFAmero es del agente, o de una persona (s\xF3lo su chat consigo misma es del due\xF1o)"],
@@ -10579,6 +10642,7 @@ var HELPS_ES = {
     summary: "Las tarjetas del tablero de ventas de un agente (su tablero es del ESPACIO: debes ser miembro, un agente compartido no basta). Los tableros del espacio en s\xED: ghosty boards.",
     flags: [
       ["--q TEXT", "ls: tarjetas cuyo nombre, tel\xE9fono o \xFAltimo mensaje contiene TEXT"],
+      ["--paused", "ls: s\xF3lo las tarjetas que el agente no contesta (pausadas, p. ej. las que trae history de Formmy \xABhasta 9999\xBB, o en modo manual)"],
       ["--limit N", "ls: tarjetas (default 20) \xB7 show: \xFAltimos N mensajes (default 20, m\xE1x. 500)"],
       ["--integration ID", "tarjetas de este canal/integraci\xF3n (p. ej. prueba)"],
       ["--column NAME", "tarjetas en esta columna"],
@@ -10866,7 +10930,7 @@ HELPS.channels = {
     "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 whatsapp history <agent-id> --integration <formmy-id> [--days 7] [--media] [--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 import <agent-id> --from easybits:<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]",
@@ -10885,6 +10949,7 @@ HELPS.channels = {
     ["--media", "history: only re-copy the missing files (photos, PDFs, audio) of conversations already imported"],
     ["--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 easybits:ID", "import: straight from the EasyBits agent (owner's $EASYBITS_API_KEY); first prints whether its session is alive, its keys and groups; the keys stay in memory"],
     ["--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)"],
@@ -10901,6 +10966,7 @@ HELPS.channels = {
     "ghosty channels whatsapp link <id> --integration 6a3af395\u2026 --answer off --dry-run",
     "ghosty channels whatsapp history <id> --integration 6a3af395\u2026 --days 7 --dry-run",
     "ghosty channels whatsapp history <id> --integration 6a3af395\u2026 --days 7 --media",
+    "ghosty channels wa import <id> --from easybits:6a50056c\u2026 --own-number no --dry-run   # reads $EASYBITS_API_KEY",
     "ghosty channels wa import <id> --from-file pia-wa.json --own-number no --dry-run"
   ],
   notes: [
@@ -10996,12 +11062,13 @@ HELPS.boards = {
 HELPS.cards = {
   summary: "The cards on an agent's sales board (its board belongs to the WORKSPACE: you must be a member, a shared agent is not enough). The workspace's boards themselves: ghosty boards.",
   usage: [
-    "ghosty cards ls <agent-id> [--q TEXT] [--limit 20]",
+    "ghosty cards ls <agent-id> [--q TEXT] [--paused] [--limit 20]",
     "ghosty cards show <agent-id> <folio|phone|session|id> [--limit 20]",
     "ghosty cards archive <agent-id> [--integration ID] [--column NAME] [--before 30d|ISO] [--dry-run] [--yes]"
   ],
   flags: [
     ["--q TEXT", "ls: cards whose name, phone or last message contains TEXT"],
+    ["--paused", "ls: only cards the agent doesn't answer (paused, e.g. the ones history brings from Formmy until 9999, or in manual mode)"],
     ["--limit N", "ls: cards (default 20) \xB7 show: last N messages (default 20, max 500)"],
     ["--integration ID", "cards from this channel/integration (e.g. prueba)"],
     ["--column NAME", "cards in this column"],
@@ -11009,7 +11076,7 @@ HELPS.cards = {
     ["-n, --dry-run", "count and show a sample, change nothing"],
     ["--yes", "skip the confirmation (required without a terminal)"]
   ],
-  examples: ["ghosty cards ls <id> --q 7712", 'ghosty cards show <id> "#12"', "ghosty cards show <id> 5210000009922 --limit 50", "ghosty cards archive <id> --integration prueba --dry-run", "ghosty cards archive <id> --column Perdido --before 30d --yes"],
+  examples: ["ghosty cards ls <id> --q 7712", "ghosty cards ls <id> --paused --limit 200", 'ghosty cards show <id> "#12"', "ghosty cards show <id> 5210000009922 --limit 50", "ghosty cards archive <id> --integration prueba --dry-run", "ghosty cards archive <id> --column Perdido --before 30d --yes"],
   notes: ["show prints each message with who wrote it (customer, agent, operator), its attachment and whether gs keeps a copy of it.", "Archiving is reversible: when the customer writes again the card comes back. At least one filter is required."],
   learn: `${REF}#tablero`
 };
@@ -11452,12 +11519,12 @@ ${bold("Configure an agent")}
   channels whatsapp integrations <id>    Its owner's WhatsApp Business numbers in Formmy (number, who answers today, Integration id)
   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 whatsapp history <id> --integration ID [--days 7]   Bring its recent cards, messages, orders and files from Formmy (no duplicates; Formmy keeps files 7 days)   [--media] [--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 import <id> --from easybits: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|enable|disable|set|create <id> [group]   Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--dry-run]
   boards ls|create|assign|move-cards|rm   A workspace's boards: create (--columns-from), where an agent sends cards, move cards
-  cards ls <id>             Recent cards on its sales board   [--q TEXT] [--limit 20]
+  cards ls <id>             Recent cards on its sales board   [--q TEXT] [--paused] [--limit 20]
   cards show <id> <card>    A card's thread: who wrote, text, attachments and whether gs kept a copy   (folio, phone or id)
   cards archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
@@ -11548,12 +11615,12 @@ ${bold("Configurar un agente")}
   channels whatsapp integrations <id>    Los n\xFAmeros de WhatsApp Business de su due\xF1o en Formmy (n\xFAmero, qui\xE9n contesta hoy, id de la Integration)
   channels whatsapp link|unlink <id> --integration ID --answer on|off   Trae un n\xFAmero de WhatsApp Business de Formmy/EasyBits a este agente, o devu\xE9lvelo   [--forward] [--dry-run]
   channels whatsapp history <id> --integration ID [--days 7]   Trae de Formmy sus tarjetas, mensajes, pedidos y archivos recientes (sin duplicar; Formmy guarda los archivos 7 d\xEDas)   [--media] [--dry-run]
-  channels wa import <id> --from-file F | --from-dir DIR --own-number yes|no   Mueve aqu\xED una sesi\xF3n de WhatsApp personal, sin QR   [--dry-run] [--replace] [--no-connect]
+  channels wa import <id> --from easybits:ID | --from-file F | --from-dir DIR --own-number yes|no   Mueve aqu\xED una sesi\xF3n de WhatsApp personal, sin QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Vincula un WhatsApp personal con c\xF3digo (sin QR)
   channels wa status|pause <id>           WhatsApp personal: c\xF3mo est\xE1 / pausarlo (conserva la sesi\xF3n)
   channels wa groups ls|enable|disable|set|create <id> [grupo]   Grupos de WhatsApp personal que contesta, y como qui\xE9n   [--role equipo|cliente] [--dry-run]
   boards ls|create|assign|move-cards|rm   Los tableros de un espacio: crear (--columns-from), a d\xF3nde manda tarjetas un agente, mover tarjetas
-  cards ls <id>             Tarjetas recientes de su tablero de ventas   [--q TEXTO] [--limit 20]
+  cards ls <id>             Tarjetas recientes de su tablero de ventas   [--q TEXTO] [--paused] [--limit 20]
   cards show <id> <tarjeta> El hilo de una tarjeta: qui\xE9n escribi\xF3, texto, adjuntos y si gs guard\xF3 copia   (folio, tel\xE9fono o id)
   cards archive <id>        Archiva tarjetas en bloque (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
@@ -11697,6 +11764,7 @@ async function main() {
       "unset-env": { type: "string" },
       orphans: { type: "boolean" },
       skipped: { type: "boolean" },
+      paused: { type: "boolean" },
       email: { type: "string" },
       keep: { type: "boolean" },
       boxes: { type: "boolean" },
@@ -11759,7 +11827,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.24.2" }, () => "0.24.2");
+  if (v.version) return out({ version: "0.25.0" }, () => "0.25.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -11878,7 +11946,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.24.2").catch(() => null);
+var notice = updateNotice("0.25.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.24.2",
+  "version": "0.25.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": {
@@ -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\nimport { createRequire as __cr } from \"node:module\"; const require = __cr(import.meta.url);' --define:__VERSION__=\\\"$npm_package_version\\\"",
     "prepack": "npm run build",
-    "test": "for t in flags prompt api rows wa-auth resolve aliases i18n help completion photos; 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 resolve aliases i18n help completion photos channels-retry; 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",