@ghostystudio/cli 0.21.0 → 0.23.0

package/README.md

@@ -90,6 +90,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.22.0
+
+- `try --waba` archives its test card when it ends (`--keep` leaves it) and auto-stage no longer runs on tests.
+- `agents set --unset-env K1,K2`.
+- `ghosty plan apply [workspace] [--dry-run]`: apply a scheduled plan now, showing what changes (staff, or the owner without a subscription).
+- `agents box` shows capacity (conversations per box, boxes on, turns running, plan); `ghosty usage --boxes [--workspace]`: the workspace's boxes against its limit (spares, asleep) and per agent.
+- `channels whatsapp history` also copies photos/PDFs/audio into gs (`--media` re-copies missing ones; Formmy keeps files 7 days).
+
 ### Changes in 0.21.0
 
 - Catalog photos: `dbs tables` shows, per photo/link column, how many links are permanent (img.ghosty.studio), external or empty; `dbs import` warns before replacing permanent links with external ones (and gives the exact `--rehost-images`); `dbs photos put <agent> <db> --table T --key-column sku --dir photos/` uploads loose photos (SKU-123.jpg → its row) to permanent links, with `--dry-run`.

package/dist/index.js

@@ -7569,6 +7569,14 @@ var SERVER_MESSAGES = [
   ["el almacenamiento no est\xE1 configurado", "storage isn't configured"],
   ["storage sin configurar (TIGRIS_*/STORAGE_*)", "storage not configured (TIGRIS_*/STORAGE_*)"],
   ["storage sin configurar", "storage not configured"],
+  // — Plan programado, cajas y altas (`plan apply`, `usage --boxes`, `agents create`)
+  ["No puedes bajar de {}: {}.", "You can't go below {}: {}."],
+  ["con suscripci\xF3n, el plan nuevo se aplica al pagarse la factura; p\xEDdelo a soporte si urge", "with a subscription, the new plan is applied when the invoice is paid; ask support if it's urgent"],
+  ["dryRun va con like (ense\xF1a lo que se copiar\xEDa); sin like no hay ensayo", "dryRun goes with like (it shows what would be copied); without like there is no dry run"],
+  ["no existe el espacio {}", "workspace {} doesn't exist"],
+  ["no pude leer sus cajas", "couldn't read its boxes"],
+  ["s\xF3lo el due\xF1o del espacio o staff de gs aplican su plan", "only the workspace owner or gs staff can apply its plan"],
+  ["{} no tiene un plan programado", "{} has no scheduled plan"],
   // — Fotos sueltas de un catálogo (`dbs photos put`)
   ["items: de 1 a 20 fotos por petici\xF3n", "items: 1 to 20 photos per request"],
   ["no es JPEG/PNG/WebP", "not a JPEG/PNG/WebP"],
@@ -8253,7 +8261,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.21.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.23.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8295,7 +8303,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.21.0"}`,
+      "user-agent": `ghosty-cli/${"0.23.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -8433,7 +8441,7 @@ async function tryWaba(id, text, v) {
   }
   const media = v.media?.[0] ? await uploadMedia(v.media[0]) : void 0;
   if (process.stderr.isTTY && !globals.json && (text || media)) info(dim(t("Thinking\u2026 (the real WhatsApp path; nothing is sent)", "Pensando\u2026 (el camino real de WhatsApp; no se manda nada)")));
-  const r = await tryPost(id, { as: "waba", session: phone, reset: v.reset, text: text ?? "", ...media ? { media } : {}, ...history ? { history } : {}, ...v["as-formmy"] ? { asFormmy: true } : {} });
+  const r = await tryPost(id, { as: "waba", session: phone, reset: v.reset, text: text ?? "", ...media ? { media } : {}, ...history ? { history } : {}, ...v["as-formmy"] ? { asFormmy: true } : {}, ...v.keep ? { keep: true } : {} });
   if (r.status !== 200) throw Object.assign(new Error(`${r.status} ${r.body.error ? serverText(r.body.error) : t("turn failed", "el turno fall\xF3")}`), { code: 1 });
   const via = r.body.media ? `
 ${r.body.media.copied ? dim(t("attachment: downloaded through the Formmy-like proxy and copied to gs", "adjunto: descargado por el proxy tipo Formmy y copiado a gs")) : red(t("attachment: NOT copied to gs (the proxy download failed)", "adjunto: NO se copi\xF3 a gs (fall\xF3 la descarga por el proxy)"))}` : "";
@@ -8613,7 +8621,8 @@ ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
     body.tools = { toolsets: [...next] };
   }
   const env = parseEnv(v.env);
-  if (env) body.env = env;
+  const unset = (v["unset-env"] ?? "").split(",").map((k) => k.trim()).filter(Boolean);
+  if (env || unset.length) body.env = { ...env ?? {}, ...Object.fromEntries(unset.map((k) => [k, ""])) };
   const connectors = {};
   for (const c of (v.connect ?? "").split(",").map((s) => s.trim()).filter(Boolean)) connectors[c] = {};
   for (const c of (v.disconnect ?? "").split(",").map((s) => s.trim()).filter(Boolean)) connectors[c] = null;
@@ -8634,7 +8643,7 @@ ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
     if (v["auto-stage"] !== "on" && v["auto-stage"] !== "off") throw usage(t("--auto-stage takes on or off.", "--auto-stage acepta on u off."));
     body.autoStage = v["auto-stage"] === "on";
   }
-  if (!Object.keys(body).length) throw usage(t("Nothing to change.", "Nada que cambiar."), t("Use", "Usa") + " --name, --engine, --model, --prompt, --prompt-file, --env, --channels, --toolsets, --connect, --disconnect, --voice, --voice-replies " + t("or", "o") + " --auto-stage.");
+  if (!Object.keys(body).length) throw usage(t("Nothing to change.", "Nada que cambiar."), t("Use", "Usa") + " --name, --engine, --model, --prompt, --prompt-file, --env, --unset-env, --channels, --toolsets, --connect, --disconnect, --voice, --voice-replies " + t("or", "o") + " --auto-stage.");
   const r = await api(agentPath(id), { method: "PATCH", body });
   out(r, () => `${lavender("\u2713")} ${t("Updated", "Actualizado")}: ${Object.keys(body).join(", ")}.`);
 }
@@ -8908,15 +8917,20 @@ ${dim(`${t("Verify after one turn", "Verifica despu\xE9s de un turno")}: ghosty
   for (const c of v.contains ?? []) q.append("contains", c);
   const r = await api(agentPath(id, `/box?${q}`));
   out(r, () => {
-    if (!r.boxes.length) return dim(r.note ? serverText(r.note) : t("No live box.", "No hay caja viva."));
+    const cap = r.capacity ? capacityLine(r.capacity) : "";
+    if (!r.boxes.length) return [cap, dim(r.note ? serverText(r.note) : t("No live box.", "No hay caja viva."))].filter(Boolean).join("\n");
     const lines = r.boxes.flatMap((b) => [
       `${bold(b.sandboxId)} ${dim(b.lastMessageAt ? `${t("last message", "\xFAltimo mensaje")} ${b.lastMessageAt}` : r.kind)}${b.error ? ` ${red(serverText(b.error))}` : ""}`,
       ...b.checks.map((c) => `  ${c.ok ? lavender("\u2713") : red("\u2717")} ${c.path}${c.contains !== void 0 ? ` \u220B ${c.contains}` : ""}`)
     ]);
     const verdict = !(v.check?.length || v.contains?.length) ? dim(t("Alive. Add --check PATH to confirm the new image.", "Viva. Agrega --check PATH para confirmar la imagen nueva.")) : r.stale ? red(t(`${r.stale} box(es) on an OLD image: ghosty agents box ${id} --recycle`, `${r.stale} caja(s) con imagen VIEJA: ghosty agents box ${id} --recycle`)) : `${lavender("\u2713")} ${t("Serving with the expected image.", "Atiende con la imagen esperada.")}`;
-    return [...lines, verdict].join("\n");
+    return [cap, ...lines, verdict].filter(Boolean).join("\n");
   });
 }
+function capacityLine(c) {
+  const plan = c.plan ? t(` \xB7 plan ${c.plan.workspace}: ${c.plan.parallel} in parallel, up to ${c.plan.maxBoxes} box(es)`, ` \xB7 plan de ${c.plan.workspace}: ${c.plan.parallel} en paralelo, hasta ${c.plan.maxBoxes} caja(s)`) : "";
+  return dim(t(`${c.conversationsPerBox} conversation(s) per box \xB7 ${c.boxesOn} box(es) on \xB7 ${c.activeTurns} turn(s) running now${plan}`, `${c.conversationsPerBox} conversaci\xF3n(es) por caja \xB7 ${c.boxesOn} caja(s) encendida(s) \xB7 ${c.activeTurns} turno(s) corriendo ahora${plan}`));
+}
 
 // src/commands/chat.ts
 import { randomUUID } from "node:crypto";
@@ -9283,7 +9297,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.21.0"}`
+        "user-agent": `ghosty-cli/${"0.23.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10046,32 +10060,61 @@ ${sub === "link" ? t("From now on this number's messages reach this agent in gs.
   const r = await api(path, { method: "POST", body });
   return out(r, () => `${lavender("\u2713")} ${sub === "link" ? t(`Linked (link ${r.linkId}). Check: ghosty channels whatsapp ls ${id} \xB7 ghosty turns ls ${id} --since 10m`, `Enlazado (enlace ${r.linkId}). Revisa: ghosty channels whatsapp ls ${id} \xB7 ghosty turns ls ${id} --since 10m`) : t("Unlinked: Formmy points where it did before.", "Desenlazado: Formmy apunta a donde apuntaba antes.")}`);
 }
+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);
+}
 async function historyCmd(id, v) {
   if (!v.integration) throw usage(t("Missing --integration.", "Falta --integration."), t("Example", "Ejemplo") + `: ghosty channels whatsapp history ${id} --integration <formmy-integration-id> --days 7 --dry-run`);
   const days = Number(v.days ?? 7);
   if (!Number.isInteger(days) || days < 1 || days > 30) throw usage(t("--days takes 1 to 30.", "--days acepta de 1 a 30."));
   const path = `/api/v2/agents/${enc7(id)}/whatsapp/history`;
-  const c = await api(path, { method: "POST", body: { integrationId: v.integration, days, dryRun: true } });
+  const media = v.media !== void 0;
+  const c = await api(path, { method: "POST", body: { integrationId: v.integration, days, dryRun: true, media } });
+  const files = (p) => (p.mediaCopied ?? 0) + (p.mediaFailed ?? 0) ? ` \xB7 ${t(`${p.mediaCopied ?? 0} file(s) copied`, `${p.mediaCopied ?? 0} archivo(s) copiado(s)`)}${p.mediaFailed ? lavender(t(`, ${p.mediaFailed} failed (retry: --media)`, `, ${p.mediaFailed} fallaron (reintenta: --media)`)) : ""}` : "";
+  if (media) {
+    const missing = c.mediaMissing ?? 0;
+    const mplan = t(
+      `${missing} file(s) of +${c.phoneNumber ?? "?"} from the last ${days} day(s) have no copy in gs (board ${c.board}); Formmy keeps them 7 days`,
+      `${missing} archivo(s) de +${c.phoneNumber ?? "?"} de los \xFAltimos ${days} d\xEDa(s) no tienen copia en gs (tablero ${c.board}); Formmy los guarda 7 d\xEDas`
+    );
+    if (v["dry-run"] || !missing) return out(c, () => `${mplan}
+${dim(v["dry-run"] ? t("Dry run: nothing copied.", "Simulacro: no se copi\xF3 nada.") : t("Nothing to copy.", "Nada que copiar."))}`);
+    const sum2 = { mediaCopied: 0, mediaFailed: 0 };
+    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 } });
+      sum2.mediaCopied += p.mediaCopied ?? 0;
+      sum2.mediaFailed += p.mediaFailed ?? 0;
+      done2 += p.page;
+      if (!globals.json) info(dim(`  ${done2}/${p.total} ${t("conversations", "conversaciones")}`));
+      cursor2 = p.nextCursor;
+    }
+    return out({ ...sum2, conversations: done2 }, () => `${lavender("\u2713")} ${t(`${sum2.mediaCopied} file(s) copied`, `${sum2.mediaCopied} archivo(s) copiado(s)`)}${sum2.mediaFailed ? lavender(t(`, ${sum2.mediaFailed} failed (Formmy may have deleted them already)`, `, ${sum2.mediaFailed} fallaron (Formmy pudo haberlos borrado ya)`)) : ""}`);
+  }
   const plan = t(
     `${c.conversations} conversation(s), ${c.messages} message(s), ${c.orders} order(s) from the last ${days} day(s)${c.phoneNumber ? ` of +${c.phoneNumber}` : ""} \u2192 board ${c.board}`,
     `${c.conversations} conversaci\xF3n(es), ${c.messages} mensaje(s), ${c.orders} pedido(s) de los \xFAltimos ${days} d\xEDa(s)${c.phoneNumber ? ` de +${c.phoneNumber}` : ""} \u2192 tablero ${c.board}`
   );
-  if (v["dry-run"]) return out(c, () => `${plan}
+  const missingHint = c.mediaMissing ? `
+${lavender(t(`${c.mediaMissing} file(s) already imported have no copy in gs: add --media to copy them (Formmy keeps them 7 days).`, `${c.mediaMissing} archivo(s) ya importado(s) no tienen copia en gs: agrega --media para copiarlos (Formmy los guarda 7 d\xEDas).`))}` : "";
+  if (v["dry-run"]) return out(c, () => `${plan}${missingHint}
 ${dim(t("Dry run: nothing imported. Re-running later never duplicates.", "Simulacro: no se import\xF3 nada. Correrlo otra vez nunca duplica."))}`);
   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 };
+  const sum = { newCards: 0, updatedCards: 0, messages: 0, orders: 0, suppressed: 0, mediaCopied: 0, mediaFailed: 0 };
   let cursor = 0;
   let done = 0;
   while (cursor !== null) {
     const p = await api(path, { method: "POST", body: { integrationId: v.integration, days, cursor } });
-    for (const k of Object.keys(sum)) sum[k] += p[k];
+    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)`)}${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`)) : ""}`);
 }
 
 // src/commands/board.ts
@@ -10220,7 +10263,8 @@ var HELPS_ES = {
       ["--rotate", "demo: c\xF3digo nuevo; la liga vieja deja de servir"],
       ["--check PATH", "box: este archivo debe existir en la m\xE1quina (repetible), p. ej. un archivo que trae la imagen nueva"],
       ["--contains PATH=TEXT", "box: ese archivo debe contener TEXT (un cambio que no agrega archivos)"],
-      ["--recycle", "box: reemplaza sus m\xE1quinas (no a media respuesta); la nueva arranca en el siguiente turno. ACP: usa restart"]
+      ["--recycle", "box: reemplaza sus m\xE1quinas (no a media respuesta); la nueva arranca en el siguiente turno. ACP: usa restart"],
+      ["--unset-env K1,K2", "set: borra esas variables del env (--env K= tambi\xE9n borra K)"]
     ],
     notes: [
       "doctor sale con 1 cuando encuentra un problema, as\xED puede frenar un script o un CI.",
@@ -10290,6 +10334,7 @@ var HELPS_ES = {
       ["--session PHONE", "con --waba: un tel\xE9fono de cliente inventado (10-15 d\xEDgitos); cada tel\xE9fono es su propia conversaci\xF3n"],
       ["--media FILE", "con --waba: el cliente manda esta foto/audio/PDF (uno por turno)"],
       ["--as-formmy", "con --media: llega como un reenv\xEDo real de Formmy (proxy con credencial, copia a gs, transcripci\xF3n) y dice si la copia funcion\xF3"],
+      ["--keep", "con --waba: deja la tarjeta de prueba en el tablero (por default se archiva al terminar, y el tablero autom\xE1tico nunca corre en pruebas)"],
       ["--history FILE", "con --waba: lo que se dijo antes, como [{role: user|agent, text, at?}]; cuenta en el primer turno (--reset)"],
       ["--reset", "olvida esa sesi\xF3n de prueba (con --waba tambi\xE9n su hilo de prueba)"],
       ["--replay FILE", "corre las conversaciones de FILE ({sample: [{id, fakePhone, messages}]}) contra el agente"],
@@ -10332,6 +10377,7 @@ var HELPS_ES = {
       ["--cached", "groups ls: no le pide a WhatsApp la lista en vivo (m\xE1s r\xE1pido; puede faltar alg\xFAn grupo nuevo)"],
       ["--integration ID", "link/unlink/history: el id de la Integration del n\xFAmero de WhatsApp Business en Formmy"],
       ["--days N", "history: conversaciones activas en los \xFAltimos N d\xEDas (1-30, default 7)"],
+      ["--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-file F", "import: {authCreds, authKeys, phone, groups} exportado de EasyBits"],
@@ -10345,7 +10391,7 @@ var HELPS_ES = {
       "Apagarlo sigue registrando los mensajes; nadie los contesta.",
       "Los grupos son del WhatsApp PERSONAL emparejado al agente (no de WhatsApp Business). <group> es su nombre o su jid.",
       "link mueve un n\xFAmero que ya vive en Formmy (EasyBits, un droplet) sin rehacer el alta de Meta; unlink lo regresa. S\xF3lo el due\xF1o, un admin del agente o el staff de Ghosty.",
-      "history trae al tablero las tarjetas, mensajes y pedidos recientes del n\xFAmero desde Formmy (enl\xE1zalo antes). Repetirlo nunca duplica: c\xF3rrelo antes del corte y otra vez justo en el corte.",
+      "history trae al tablero las tarjetas, mensajes y pedidos recientes del n\xFAmero desde Formmy (enl\xE1zalo antes). Repetirlo nunca duplica: c\xF3rrelo antes del corte y otra vez justo en el corte. Los archivos (fotos, PDF, audios) tambi\xE9n se copian a gs: Formmy los borra a los 7 d\xEDas, as\xED que trae el n\xFAmero dentro de esa semana; una copia que fall\xF3 se reintenta con --media.",
       "import: apaga primero el socket de EasyBits SIN logout (dos sockets se tumban entre s\xED; un logout invalida las llaves). Borra el archivo despu\xE9s."
     ]
   },
@@ -10379,6 +10425,11 @@ var HELPS_ES = {
       "Antes de aplicar se guarda la versi\xF3n actual del agente (Versiones en la web)."
     ]
   },
+  plan: {
+    summary: "Aplica ya el plan programado de un espacio (asientos, agentes en paralelo, hosting, tokens), ense\xF1ando antes qu\xE9 cambia. Staff, o el due\xF1o si no hay suscripci\xF3n (con suscripci\xF3n lo aplica la factura pagada).",
+    flags: [["-n, --dry-run", "ense\xF1a qu\xE9 cambia y el total al mes, no aplica nada"], ["--yes", "omite la confirmaci\xF3n (obligatorio sin terminal)"]],
+    notes: ["Sin espacio usa el de ghosty use."]
+  },
   completion: {
     summary: "Autocompletado con TAB en tu shell: comandos, subcomandos y opciones (de esta ayuda), nombres de agentes y espacios (de tu cuenta, con cach\xE9 de 5 min).",
     replace: [
@@ -10428,7 +10479,10 @@ var HELPS_ES = {
       "Archivar es reversible: cuando el cliente vuelve a escribir, la tarjeta regresa. Se necesita al menos un filtro."
     ]
   },
-  usage: { summary: "Tu plan y cu\xE1nto llevas usado esta semana y este mes." }
+  usage: {
+    summary: "Tu plan y cu\xE1nto llevas usado esta semana y este mes. Con --boxes: las cajas y la capacidad de un espacio, por agente.",
+    flags: [["--boxes", "por agente: conversaciones por caja, cajas encendidas, turnos corriendo ahora; y lo que da el plan (paralelo, cajas, hosting)"], ["--workspace SLUG", "--boxes: qu\xE9 espacio (default: el de ghosty use)"]]
+  }
 };
 var HELP_ALIASES = { creds: "credentials", board: "cards", conversations: "chat" };
 
@@ -10443,7 +10497,7 @@ var HELPS = {
       "ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,\u2026] [--workspace SLUG] [--channels teams=off,\u2026] [--like AGENT [--copy-dbs] [--board same|main|new|NAME] [--no-notify] [--dry-run]]",
       "ghosty agents get <agent-id> [--fields name,model,prompt] [--prompt-out FILE]",
       "ghosty agents export <agent-id> [--out DIR]   # the agent as a file; see ghosty apply --help",
-      "ghosty agents set <agent-id> [--name] [--engine] [--model] [--prompt | --prompt-file] [--env K=V,\u2026] [--connect ID,\u2026] [--disconnect ID,\u2026] [--voice E:ID] [--voice-replies auto|off] [--auto-stage on|off] [--toolsets crm,sales | +crm,-sales]",
+      "ghosty agents set <agent-id> [--name] [--engine] [--model] [--prompt | --prompt-file] [--env K=V,\u2026] [--unset-env K1,K2] [--connect ID,\u2026] [--disconnect ID,\u2026] [--voice E:ID] [--voice-replies auto|off] [--auto-stage on|off] [--toolsets crm,sales | +crm,-sales]",
       "ghosty agents set <agent-id> --prompt-base <base-agent-id> --prompt-overlay overlay.json [--dry-run [--out FILE]]   |   --prompt-base none",
       "ghosty agents doctor <agent-id> [--verbose]",
       "ghosty agents docs ls|grant|revoke <agent-id> [doc\u2026] [--write] [--no-deliver] [--like AGENT]",
@@ -10490,7 +10544,8 @@ var HELPS = {
       ["--rotate", "demo: new code; the old link stops working"],
       ["--check PATH", "box: this file must exist in the machine (repeatable), e.g. a file the new image brings"],
       ["--contains PATH=TEXT", "box: that file must contain TEXT (a change that adds no files)"],
-      ["--recycle", "box: replace its machines (not mid-turn); the new one starts on the next turn. ACP: use restart"]
+      ["--recycle", "box: replace its machines (not mid-turn); the new one starts on the next turn. ACP: use restart"],
+      ["--unset-env K1,K2", "set: delete these env variables (--env K= also deletes K)"]
     ],
     examples: [
       "ghosty agents doctor cmu7pgbyr0001gee3ruk172mm",
@@ -10623,6 +10678,7 @@ var HELPS = {
       ["--session PHONE", "with --waba: a made-up customer phone (10-15 digits); each phone is its own conversation"],
       ["--media FILE", "with --waba: the customer sends this photo/audio/PDF (one per turn)"],
       ["--as-formmy", "with --media: it arrives like a real Formmy forward (proxy with credential, copy to gs, transcription) and says if the copy worked"],
+      ["--keep", "with --waba: leave the test card on the board (by default it's archived when the test ends, and auto-stage never runs on tests)"],
       ["--history FILE", "with --waba: what was said before, as [{role: user|agent, text, at?}]; counts on the first turn (--reset)"],
       ["--reset", "forget that test session (with --waba also its test thread)"],
       ["--replay FILE", "run the conversations in FILE ({sample: [{id, fakePhone, messages}]}) against the agent"],
@@ -10687,7 +10743,7 @@ HELPS.channels = {
     "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 whatsapp history <agent-id> --integration <formmy-id> [--days 7] [--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 pair <agent-id> --phone 5215512345678",
     "ghosty channels wa status|pause <agent-id>",
@@ -10703,6 +10759,7 @@ HELPS.channels = {
     ["--cached", "groups ls: don't ask WhatsApp for the live list (faster; may miss new groups)"],
     ["--integration ID", "link/unlink/history: the WhatsApp Business number's Integration id in Formmy"],
     ["--days N", "history: conversations active in the last N days (1-30, default 7)"],
+    ["--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-file F", "import: {authCreds, authKeys, phone, groups} exported from EasyBits"],
@@ -10719,6 +10776,7 @@ HELPS.channels = {
     'ghosty channels wa groups enable <id> "Pia-cotizadora" --role equipo --dry-run',
     "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-file pia-wa.json --own-number no --dry-run"
   ],
   notes: [
@@ -10726,7 +10784,7 @@ HELPS.channels = {
     "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.",
     "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.",
-    "history brings the number's recent cards, messages and orders from Formmy to the board (link it first). Re-running never duplicates: run it before the cutover and again right at it.",
+    "history brings the number's recent cards, messages and orders from Formmy to the board (link it first). Re-running never duplicates: run it before the cutover and again right at it. Files (photos, PDFs, audio) are copied to gs too: Formmy deletes them after 7 days, so bring the number within that week; a copy that failed is retried with --media.",
     "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`
@@ -10763,6 +10821,14 @@ HELPS.apply = {
   ],
   learn: `${REF}#el-agente-como-archivo`
 };
+HELPS.plan = {
+  summary: "Apply a workspace's scheduled plan now (seats, parallel agents, hosting, tokens), showing what changes first. Staff, or the owner when there's no subscription (with one, the paid invoice applies it).",
+  usage: ["ghosty plan apply [workspace] [--dry-run] [--yes]"],
+  flags: [["-n, --dry-run", "show what changes and the monthly total, apply nothing"], ["--yes", "skip the confirmation (required without a terminal)"]],
+  examples: ["ghosty plan apply business --dry-run", "ghosty plan apply business --yes"],
+  notes: ["Without a workspace it uses the one from ghosty use."],
+  learn: `${REF}#tu-cuenta`
+};
 HELPS.completion = {
   summary: "Tab completion for your shell: commands, subcommands and flags (from this help), agent and workspace names (from your account, cached 5 min).",
   usage: ["ghosty completion zsh|bash|fish"],
@@ -10824,7 +10890,14 @@ HELPS.cards = {
 };
 HELPS.board = HELPS.cards;
 HELPS.conversations = HELPS.chat;
-HELPS.usage = { ...HELPS.me, summary: "Your plan and how much you've used this week and month.", usage: ["ghosty usage", "ghosty me usage"], examples: ["ghosty usage", "ghosty usage --json"], learn: `${REF}#uso` };
+HELPS.usage = {
+  ...HELPS.me,
+  summary: "Your plan and how much you've used this week and month. With --boxes: a workspace's boxes against its limit, and per agent.",
+  usage: ["ghosty usage", "ghosty me usage", "ghosty usage --boxes [--workspace SLUG]"],
+  flags: [["--boxes", "the workspace's boxes against its limit (spares, asleep) and, per agent: conversations per box, boxes, awake, spares, turns running now"], ["--workspace SLUG", "--boxes: which workspace (default: the one from ghosty use)"]],
+  examples: ["ghosty usage", "ghosty usage --json", "ghosty usage --boxes --workspace siiqtec"],
+  learn: `${REF}#uso`
+};
 function helpText(cmd) {
   const base = HELPS[cmd];
   if (!base) return void 0;
@@ -11164,6 +11237,44 @@ ${t(`Apply ${actionable.length} change(s) to ${id}?`, `\xBFAplicar ${actionable.
 ${red(t(`Stopped at \xAB${r.failed.what}\xBB: ${serverText(r.failed.error)}`, `Se detuvo en \xAB${r.failed.what}\xBB: ${r.failed.error}`))}` : ""}`);
 }
 
+// src/commands/plan.ts
+async function planCmd(sub, slug, v, context) {
+  if (sub !== "apply") throw usage(t(`Unknown plan subcommand: ${sub ?? "(none)"}.`, `Subcomando desconocido de plan: ${sub ?? "(ninguno)"}.`), "ghosty plan apply <workspace> [--dry-run]");
+  slug ??= context;
+  if (!slug) throw usage(t("Missing workspace.", "Falta el espacio."), "ghosty plan apply <workspace> [--dry-run]   (or ghosty use <workspace>)");
+  const path = `/api/v2/workspaces/${encodeURIComponent(slug)}/plan/apply`;
+  const plan = await api(path, { method: "POST", body: { dryRun: true } });
+  const money = (n) => `$${n.toLocaleString("es-MX")} MXN`;
+  const text = [
+    `${bold(plan.workspace)} ${dim(plan.scheduledFor ? t(`scheduled for ${plan.scheduledFor.slice(0, 10)}`, `programado para el ${plan.scheduledFor.slice(0, 10)}`) : "")}`,
+    ...plan.changes.map((c) => `  ~ ${c.label}: ${String(c.from)} \u2192 ${String(c.to)}`),
+    `  ${t("monthly", "al mes")}: ${money(plan.monthlyTotal.from)} \u2192 ${money(plan.monthlyTotal.to)}`
+  ].join("\n");
+  if (v["dry-run"]) return out(plan, () => `${text}
+${dim(t("Dry run: nothing applied.", "Simulaci\xF3n: no se aplic\xF3 nada."))}`);
+  requireYesIfHeadless(v.yes, `ghosty plan apply ${slug}`);
+  await confirm(`${text}
+${t("Apply this plan now?", "\xBFAplicar este plan ya?")}`, { yes: v.yes, retry: `ghosty plan apply ${slug}` });
+  const r = await api(path, { method: "POST", body: {} });
+  out(r, () => `${lavender("\u2713")} ${r.applied ? t(`Plan applied to ${r.workspace}.`, `Plan aplicado a ${r.workspace}.`) : t("Nothing applied.", "No se aplic\xF3 nada.")}`);
+}
+async function boxesUsage(slug) {
+  if (!slug) throw usage(t("Which workspace?", "\xBFQu\xE9 espacio?"), "ghosty usage --boxes --workspace <slug>   (or ghosty use <workspace>)");
+  const r = await api(`/api/v2/workspaces/${encodeURIComponent(slug)}/boxes`);
+  const rows = r.agents.map((a) => ({ agent: a.name ?? a.id, engine: a.engine, "per box": a.conversationsPerBox ?? "", boxes: a.boxes ?? "", on: a.boxesOn ?? "", spares: a.spares ?? "", "running now": a.activeTurns ?? "", ...a.error ? { note: a.error } : {} }));
+  const head = `${bold(r.workspace)} ${dim(t(`plan: ${r.plan.parallel} in parallel \xB7 up to ${r.plan.maxBoxes} box(es) \xB7 ${r.plan.hotBoxes} always-on spare(s)`, `plan: ${r.plan.parallel} en paralelo \xB7 hasta ${r.plan.maxBoxes} caja(s) \xB7 ${r.plan.hotBoxes} spare(s) siempre encendido(s)`))}`;
+  const space = r.space ? (r.space.used > r.space.limit ? (s) => s : dim)(
+    t(
+      `${r.space.used} of ${r.space.limit} box(es) in use \xB7 ${r.space.spares} spare \xB7 ${r.space.asleep} asleep${r.space.used > r.space.limit ? " \xB7 OVER the limit" : ""}`,
+      `${r.space.used} de ${r.space.limit} caja(s) \xB7 ${r.space.spares} spare \xB7 ${r.space.asleep} dormida(s)${r.space.used > r.space.limit ? " \xB7 SOBRE el tope" : ""}`
+    )
+  ) : dim(t("(could not read the host)", "(no pude leer el host)"));
+  out(r, () => `${head}
+${space}
+${table(rows, ["agent", "engine", "per box", "boxes", "on", "spares", "running now"])}
+${dim(t(`${r.totals.activeTurns} turn(s) running`, `${r.totals.activeTurns} turno(s) corriendo`))}`);
+}
+
 // src/index.ts
 var HELP_EN = `${bold("Usage:")} ghosty <command> [options]
 
@@ -11174,7 +11285,8 @@ ${bold("Session")}
   whoami                    Show who you are signed in as
   use [workspace]           Default workspace for boards, agents create and agents ls   [--clear]
   completion zsh|bash|fish  Tab completion for commands, flags, agents and workspaces
-  usage                     Your plan and how much you've used this week and month
+  usage                     Your plan and how much you've used this week and month   [--boxes: boxes vs the workspace limit]
+  plan apply [workspace]    Apply a scheduled plan now, showing what changes   [--dry-run]
 
 ${bold("Agents")}
   agents ls                 List your agents
@@ -11213,7 +11325,7 @@ ${bold("Configure an agent")}
   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 whatsapp history <id> --integration ID [--days 7]   Bring its recent cards, messages and orders from Formmy (no duplicates)   [--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 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)
@@ -11268,7 +11380,8 @@ ${bold("Sesi\xF3n")}
   whoami                    Muestra con qu\xE9 cuenta entraste
   use [espacio]             Espacio por default para boards, agents create y agents ls   [--clear]
   completion zsh|bash|fish  Autocompletado con TAB: comandos, opciones, agentes y espacios
-  usage                     Tu plan y cu\xE1nto llevas usado esta semana y este mes
+  usage                     Tu plan y cu\xE1nto llevas usado esta semana y este mes   [--boxes: cajas contra el tope del espacio]
+  plan apply [espacio]      Aplica ya un plan programado, ense\xF1ando qu\xE9 cambia   [--dry-run]
 
 ${bold("Agentes")}
   agents ls                 Lista tus agentes
@@ -11307,7 +11420,7 @@ ${bold("Configurar un agente")}
   mcp get|set <id>                   Servidores MCP                 [--file servers.json]
   channels whatsapp ls|enable|disable <id> [n\xFAmero]   Qu\xE9 n\xFAmeros de WhatsApp Business contesta   [--dry-run]
   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 y pedidos recientes (sin duplicar)   [--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 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)
@@ -11353,7 +11466,7 @@ ${bold("Opciones globales")}
 ${bold("C\xF3digos de salida")}  0 bien \xB7 1 error de la API \xB7 2 uso incorrecto \xB7 3 sin sesi\xF3n
 ${dim("Nota: `ghosty` puede chocar con otro binario en tu PATH (p. ej. la TUI de Ghosty). Rev\xEDsalo con `which -a ghosty`; corre `npx @ghostystudio/cli` para ir a la segura.")}
 ${dim("Documentaci\xF3n: https://www.ghosty.studio/docs/cli")}`;
-var COMMANDS = ["login", "logout", "whoami", "usage", "use", "apply", "completion", "cards", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "partner", "me", "channels", "board", "boards", "credentials", "docs", "help"];
+var COMMANDS = ["login", "logout", "whoami", "usage", "use", "apply", "plan", "completion", "cards", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "partner", "me", "channels", "board", "boards", "credentials", "docs", "help"];
 var AGENTS_SUBS = ["ls", "create", "get", "set", "export", "doctor", "docs", "share", "unshare", "shares", "rm", "restart", "demo", "box"];
 function unknown(what, input, known, helpCmd) {
   const s = suggest(input, known);
@@ -11383,6 +11496,7 @@ async function main() {
   const langAt = process.argv.findIndex((a) => a === "--lang" || a.startsWith("--lang="));
   if (langAt >= 0) setLang(detectLang(process.argv[langAt].includes("=") ? process.argv[langAt].split("=")[1] : process.argv[langAt + 1]));
   const { values: v, positionals: pos } = parseArgs({
+    args: bareMediaFlag(process.argv.slice(2)),
     allowPositionals: true,
     strict: true,
     options: {
@@ -11453,6 +11567,9 @@ async function main() {
       full: { type: "boolean" },
       "as-formmy": { type: "boolean" },
       "key-column": { type: "string" },
+      "unset-env": { type: "string" },
+      keep: { type: "boolean" },
+      boxes: { type: "boolean" },
       like: { type: "string" },
       "copy-dbs": { type: "boolean" },
       "no-notify": { type: "boolean" },
@@ -11512,7 +11629,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.21.0" }, () => "0.21.0");
+  if (v.version) return out({ version: "0.23.0" }, () => "0.23.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -11613,7 +11730,10 @@ async function main() {
     case "partner":
       return partnerCmd(sub, a1, a2, { ...v, token: tokens.turn });
     case "usage":
+      if (v.boxes) return boxesUsage(v.workspace ?? context);
       return meUsage();
+    case "plan":
+      return planCmd(sub, a1, v, context);
     case "me":
       if (sub === "files") return meFiles(a1, a2, v);
       if (sub === "usage") return meUsage();
@@ -11628,7 +11748,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.21.0").catch(() => null);
+var notice = updateNotice("0.23.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.21.0",
+  "version": "0.23.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": {