@ghostystudio/cli 0.20.0 → 0.22.0

package/README.md

@@ -90,6 +90,18 @@ 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]` 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`.
+
 ### Changes in 0.20.0
 
 - **Your language.** Spanish with a Spanish locale (`LANG=es_*`), English otherwise; `--lang es|en` or `GHOSTY_LANG` forces it. The server's messages are translated to English too. `--json` output is unchanged.

package/dist/index.js

@@ -7569,6 +7569,19 @@ 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"],
+  ["pasa de 10 MB", "larger than 10 MB"],
+  ["table, keyColumn y column: nombres v\xE1lidos", "table, keyColumn and column: valid names"],
   ["no es JPEG/PNG/WebP ({})", "not JPEG/PNG/WebP ({})"],
   ["no se pudo bajar (respuesta vac\xEDa, no 2xx o m\xE1s de 10 MB)", "couldn't download (empty response, not 2xx or over 10 MB)"],
   ["no se pudo bajar: {}", "couldn't download: {}"],
@@ -8248,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.20.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.22.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8290,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.20.0"}`,
+      "user-agent": `ghosty-cli/${"0.22.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -8428,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)"))}` : "";
@@ -8608,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;
@@ -8629,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(", ")}.`);
 }
@@ -8903,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";
@@ -9278,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.20.0"}`
+        "user-agent": `ghosty-cli/${"0.22.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -9444,8 +9463,8 @@ async function partnerCmd(sub, a1, a2, v) {
 }
 
 // src/commands/data.ts
-import { readFile as readFile6 } from "node:fs/promises";
-import { basename as basename3 } from "node:path";
+import { readdir as readdir2, readFile as readFile6 } from "node:fs/promises";
+import { basename as basename3, join as join4 } from "node:path";
 
 // src/rows.ts
 var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -9473,6 +9492,21 @@ var need2 = (v, what, example) => {
   return v;
 };
 var csv = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+function importWarnings(ws) {
+  if (!ws?.length) return "";
+  const flag = ws.map((w) => `${w.table}.${w.column}`).join(",");
+  const lines = ws.map(
+    (w) => red(
+      t(
+        `  ! ${w.table}.${w.column}: ${w.permanent} permanent photo link(s) would go back to ${w.incomingExternal} external link(s)`,
+        `  ! ${w.table}.${w.column}: ${w.permanent} liga(s) de foto permanentes volver\xEDan a ${w.incomingExternal} liga(s) de fuera`
+      )
+    )
+  );
+  return `
+${lines.join("\n")}
+${dim(t(`Keep them permanent: add --rehost-images ${flag}`, `Para que sigan permanentes: agrega --rehost-images ${flag}`))}`;
+}
 function planText(plan) {
   return plan.map((p) => p.action === "create" ? t(`  + ${p.table}  create, ${p.sourceRows} row(s)`, `  + ${p.table}  crear, ${p.sourceRows} fila(s)`) : t(`  ~ ${p.table}  ${p.action} ${p.targetRows} \u2192 ${p.resultRows} row(s)`, `  ~ ${p.table}  ${p.action === "replace" ? "reemplazar" : "agregar"} ${p.targetRows} \u2192 ${p.resultRows} fila(s)`)).join("\n");
 }
@@ -9486,10 +9520,10 @@ async function dbsImport(id, db, v) {
   const path = agentPath2(id, `/dbs/${enc6(db)}/import`);
   const dry = await api(path, { body: { ...body, dryRun: true } });
   if (v["dry-run"]) return out(dry, () => `${dry.db} \u2190 easybits:${m[1]}
-${planText(dry.plan)}
+${planText(dry.plan)}${importWarnings(dry.warnings)}
 ${dim(t("Dry run: nothing changed.", "Simulaci\xF3n: no cambi\xF3 nada."))}`);
   const destructive = dry.plan.some((p) => p.action === "replace" && p.targetRows > 0);
-  if (destructive) await confirm(`${planText(dry.plan)}
+  if (destructive) await confirm(`${planText(dry.plan)}${importWarnings(dry.warnings)}
 ${t(`Replace the rows above in ${dry.db}?`, `\xBFReemplazar las filas de arriba en ${dry.db}?`)}`, { yes: v.yes, retry: `ghosty dbs import ${id} ${db} --from ${v.from}${v.tables ? ` --tables ${v.tables}` : ""}` });
   const r = await api(path, { body });
   const img = r.rehosted ? `
@@ -9547,8 +9581,16 @@ async function dbsCmd(sub, id, db, rest, v) {
       const ext = new Set(r.externalWriteTables);
       const own = r.externalRowScope ?? {};
       const rows = r.tables.map((tb) => ({ table: tb.name, rows: tb.rows, "customer writes": ext.has(tb.name) ? "yes" : "", "customer sees": own[tb.name] ? `own rows (${own[tb.name].join(", ")})` : "", columns: tb.columns.map((c) => `${c.name}${c.pk ? "*" : ""}`).join(", ") }));
+      const linkLines = r.tables.flatMap(
+        (tb) => (tb.links ?? []).map(
+          (l) => `  ${tb.name}.${l.column}: ${t(`${l.permanent} permanent \xB7 ${l.external} external \xB7 ${l.empty} empty`, `${l.permanent} permanentes \xB7 ${l.external} de fuera \xB7 ${l.empty} vac\xEDas`)}` + (l.external ? dim(`  \u2192 ghosty dbs rehost ${id} ${db} --table ${tb.name} --column ${l.column}`) : "")
+        )
+      );
+      const linksText = linkLines.length ? `
+${t("Photo/link columns", "Columnas de fotos/ligas")}:
+${linkLines.join("\n")}` : "";
       return out(r, () => `${bold(r.name)} ${r.granted ? lavender(t("granted", "concedida")) : dim(t("not granted", "no concedida"))}
-${table(rows, ["table", "rows", "customer writes", "customer sees", "columns"])}`);
+${table(rows, ["table", "rows", "customer writes", "customer sees", "columns"])}${linksText}`);
     }
     case "query":
     case "sql": {
@@ -9718,6 +9760,50 @@ async function agentsDoctor(id, v) {
     return exitAfterFlush(EXIT.API);
   }
 }
+var PHOTO_EXT = /\.(jpe?g|png|webp)$/i;
+function photoFiles(names2) {
+  return names2.filter((n) => PHOTO_EXT.test(n) && !n.startsWith(".")).sort().map((file) => ({ key: file.replace(PHOTO_EXT, ""), file }));
+}
+async function dbsPhotosCmd(verb, id, db, v) {
+  const ex = "ghosty dbs photos put <agent> <db> --table catalogo --key-column sku --dir fotos/ [--column imagen_url] [--dry-run]";
+  if (verb !== "put") throw usage(t(`Unknown dbs photos subcommand: ${verb ?? "(none)"}.`, `Subcomando desconocido de dbs photos: ${verb ?? "(ninguno)"}.`), `${t("Example", "Ejemplo")}: ${ex}`);
+  id = need2(id, t("agent", "el agente"), ex);
+  db = need2(db, t("database (id or name)", "la base (id o nombre)"), ex);
+  const tableName = need2(v.table, "--table", ex);
+  const keyColumn = need2(v["key-column"], "--key-column", ex);
+  const dir = need2(v.dir, "--dir", ex);
+  let column = v.column;
+  if (!column) {
+    const r = await api(agentPath2(id, `/dbs/${enc6(db)}`));
+    const tb = r.tables.find((x) => x.name === tableName);
+    if (!tb) throw usage(t(`${db} has no table ${tableName}.`, `${db} no tiene la tabla ${tableName}.`));
+    column = tb.columns.find((c) => c.name === "imagen_url")?.name;
+    if (!column) throw usage(t("Which column gets the photo link? Pass --column.", "\xBFEn qu\xE9 columna va la liga de la foto? Usa --column."), `${t("Columns", "Columnas")}: ${tb.columns.map((c) => c.name).join(", ")}`);
+  }
+  const files = photoFiles(await readdir2(dir));
+  if (!files.length) throw usage(t(`No .jpg/.png/.webp files in ${dir}.`, `No hay archivos .jpg/.png/.webp en ${dir}.`), t("Name each photo after its key: SKU-123.jpg", "Nombra cada foto con su clave: SKU-123.jpg"));
+  const path = agentPath2(id, `/dbs/${enc6(db)}/photos`);
+  const results = [];
+  for (let i = 0; i < files.length; i += 8) {
+    const batch = files.slice(i, i + 8);
+    const items = await Promise.all(batch.map(async (f) => ({ key: f.key, filename: f.file, contentBase64: (await readFile6(join4(dir, f.file))).toString("base64") })));
+    const r = await api(path, { body: { table: tableName, keyColumn, column, items, ...v["dry-run"] ? { dryRun: true } : {} } });
+    results.push(...r.items);
+    if (!globals.json && files.length > 8) info(dim(`  ${Math.min(i + 8, files.length)}/${files.length}`));
+  }
+  const by = (s) => results.filter((r) => r.status === s);
+  const stored = by(v["dry-run"] ? "would_store" : "stored");
+  const missing = by("missing_row");
+  const bad = [...by("bad_type"), ...by("too_big"), ...by("failed")];
+  const summary = [
+    `${lavender("\u2713")} ${v["dry-run"] ? t(`${stored.length} photo(s) would go to ${tableName}.${column}`, `${stored.length} foto(s) ir\xEDan a ${tableName}.${column}`) : t(`${stored.length} photo(s) stored in ${tableName}.${column} (permanent links)`, `${stored.length} foto(s) guardadas en ${tableName}.${column} (ligas permanentes)`)}`,
+    missing.length ? red(t(`${missing.length} with no row where ${keyColumn} = file name: ${missing.map((x) => x.key).join(", ")}`, `${missing.length} sin fila con ${keyColumn} = nombre del archivo: ${missing.map((x) => x.key).join(", ")}`)) : "",
+    bad.length ? red(t(`${bad.length} not stored: ${bad.map((b) => `${b.key} (${b.error ? serverText(b.error) : b.status})`).join(", ")}`, `${bad.length} sin guardar: ${bad.map((b) => `${b.key} (${b.error ?? b.status})`).join(", ")}`)) : "",
+    ...results.filter((x) => x.warning).map((x) => dim(`  ${x.key}: ${serverText(x.warning)}`)),
+    v["dry-run"] ? dim(t("Dry run: nothing uploaded.", "Simulaci\xF3n: no se subi\xF3 nada.")) : ""
+  ].filter(Boolean);
+  out({ table: tableName, keyColumn, column, dryRun: !!v["dry-run"], items: results }, () => summary.join("\n"));
+}
 
 // src/commands/credentials.ts
 async function hiddenPrompt(label) {
@@ -9794,8 +9880,8 @@ async function credentialsCmd2(sub, provider, v) {
 import { readFile as readFile8 } from "node:fs/promises";
 
 // src/wa-auth.ts
-import { readdir as readdir2, readFile as readFile7 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { readdir as readdir3, readFile as readFile7 } from "node:fs/promises";
+import { join as join5 } 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) {
@@ -9807,9 +9893,9 @@ function keyOfFileName(name) {
   return null;
 }
 async function readMultiFileAuth(dir) {
-  const files = (await readdir2(dir)).filter((f) => f.endsWith(".json"));
+  const files = (await readdir3(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 readFile7(join4(dir, "creds.json"), "utf8"));
+  const authCreds = JSON.parse(await readFile7(join5(dir, "creds.json"), "utf8"));
   const authKeys = {};
   const counts = {};
   const skipped = [];
@@ -9820,7 +9906,7 @@ async function readMultiFileAuth(dir) {
       skipped.push(f);
       continue;
     }
-    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile7(join4(dir, f), "utf8"));
+    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile7(join5(dir, f), "utf8"));
     counts[k.type] = (counts[k.type] ?? 0) + 1;
   }
   return { authCreds, authKeys, counts, skipped };
@@ -9974,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
@@ -10148,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.",
@@ -10188,9 +10304,13 @@ var HELPS_ES = {
       ["--append", "import: agrega filas en vez de reemplazarlas (reemplazar es el default idempotente)"],
       ["--rehost-images t.col,\u2026", "import: copia las ligas de imagen de esas columnas al almacenamiento p\xFAblico de Ghosty (ligas permanentes en img.ghosty.studio)"],
       ["--table T --column C", "rehost: la columna de ligas de imagen (p. ej. catalogo imagen_url) que se pasa a ligas permanentes en img.ghosty.studio; idempotente, una liga que falla se queda como estaba"],
-      ["-n, --dry-run", "import: imprime el plan (+ crear, ~ reemplazar N \u2192 M filas), no cambia nada"]
+      ["--key-column K --dir DIR", "photos put: cada archivo de DIR se llama como la clave de su fila (SKU-123.jpg \u2192 la fila donde K = SKU-123); va al almacenamiento permanente y su liga a --column (default imagen_url)"],
+      ["-n, --dry-run", "import: imprime el plan (+ crear, ~ reemplazar N \u2192 M filas), no cambia nada \xB7 photos put: lista las claves sin fila y los archivos que no son imagen"]
     ],
-    notes: ["<db> es el id de la base o su nombre. Desde canales del due\xF1o el agente lee y escribe todo lo concedido."]
+    notes: [
+      "<db> es el id de la base o su nombre. Desde canales del due\xF1o el agente lee y escribe todo lo concedido.",
+      "tables dice, por columna de fotos/ligas, cu\xE1ntas son permanentes (img.ghosty.studio), de fuera o vac\xEDas; import avisa antes de reemplazar ligas permanentes por ligas de fuera."
+    ]
   },
   turns: {
     summary: "Los turnos recientes de un agente: qu\xE9 contest\xF3, qu\xE9 fall\xF3 y por qu\xE9, y en qu\xE9 se fue el tiempo de un turno.",
@@ -10214,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"],
@@ -10256,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"],
@@ -10269,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."
     ]
   },
@@ -10303,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: [
@@ -10352,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" };
 
@@ -10367,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]",
@@ -10414,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",
@@ -10477,6 +10608,7 @@ var HELPS = {
       'ghosty dbs query <agent-id> <db> "SQL" [--arg V]\u2026 [--write]',
       "ghosty dbs import <agent-id> <db> --from easybits:<db-id> [--tables a,b] [--append] [--rehost-images t.col,\u2026] [--dry-run] [--yes]",
       "ghosty dbs rehost <agent-id> <db> --table T --column C [--dry-run]",
+      "ghosty dbs photos put <agent-id> <db> --table T --key-column K --dir DIR [--column C] [--dry-run]",
       "ghosty dbs grant <agent-id> <db> [--external-write t1,t2] [--external-rows t:col+col,\u2026]",
       "ghosty dbs revoke <agent-id> <db>"
     ],
@@ -10490,7 +10622,8 @@ var HELPS = {
       ["--append", "import: add rows instead of replacing them (replace is the idempotent default)"],
       ["--rehost-images t.col,\u2026", "import: copy the image links in those columns to Ghosty's public storage (permanent links at img.ghosty.studio)"],
       ["--table T --column C", "rehost: the column of image links (e.g. catalogo imagen_url) to move to permanent links at img.ghosty.studio; idempotent, a link that fails stays as it was"],
-      ["-n, --dry-run", "import: print the plan (+ create, ~ replace N \u2192 M rows), change nothing"]
+      ["--key-column K --dir DIR", "photos put: each file in DIR is named after its row's key (SKU-123.jpg \u2192 the row where K = SKU-123); it goes to permanent storage and its link to --column (default imagen_url)"],
+      ["-n, --dry-run", "import: print the plan (+ create, ~ replace N \u2192 M rows), change nothing \xB7 photos put: list keys with no row and files that aren't images"]
     ],
     examples: [
       "ghosty dbs ls <id>",
@@ -10498,9 +10631,13 @@ var HELPS = {
       'ghosty dbs query <id> totequim "SELECT count(*) AS n FROM productos"',
       "ghosty dbs grant <id> totequim --external-write cotizaciones,folio",
       "ghosty dbs grant <id> totequim --external-rows clientes:telefono+tel_secundario,cotizaciones:cliente_tel",
-      "ghosty dbs import <id> totequim --from easybits:6a10c84c\u2026 --dry-run   # reads $EASYBITS_API_KEY"
+      "ghosty dbs import <id> totequim --from easybits:6a10c84c\u2026 --dry-run   # reads $EASYBITS_API_KEY",
+      "ghosty dbs photos put <id> siiqtec --table catalogo --key-column sku --dir fotos/ --dry-run"
+    ],
+    notes: [
+      "<db> is the database id or its name. From owner channels the agent reads and writes everything granted.",
+      "tables shows, per photo/link column, how many links are permanent (img.ghosty.studio), external or empty; import warns before replacing permanent links with external ones."
     ],
-    notes: ["<db> is the database id or its name. From owner channels the agent reads and writes everything granted."],
     learn: `${REF}#bases-de-datos`
   },
   turns: {
@@ -10541,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"],
@@ -10605,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>",
@@ -10621,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"],
@@ -10637,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: [
@@ -10644,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`
@@ -10681,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"],
@@ -10742,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 and capacity per agent.",
+  usage: ["ghosty usage", "ghosty me usage", "ghosty usage --boxes [--workspace SLUG]"],
+  flags: [["--boxes", "per agent: conversations per box, boxes on, turns running now; plus what the plan allows (parallel, boxes, hosting)"], ["--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;
@@ -10768,8 +10923,8 @@ function helpText(cmd) {
 // src/update.ts
 import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
-import { dirname as dirname3, join as join5 } from "node:path";
-var FILE = join5(process.env.XDG_CONFIG_HOME || join5(homedir3(), ".config"), "ghosty", "update.json");
+import { dirname as dirname3, join as join6 } from "node:path";
+var FILE = join6(process.env.XDG_CONFIG_HOME || join6(homedir3(), ".config"), "ghosty", "update.json");
 var DAY = 24 * 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @ghostystudio/cli@latest";
 function newer(a, b) {
@@ -10843,6 +10998,7 @@ function agentArgIndex(pos) {
     case "mcp":
     case "dbs":
     case "db":
+      return sub === "photos" ? 3 : 2;
     case "turns":
     case "board":
     case "conversations":
@@ -10863,7 +11019,7 @@ function agentArgIndex(pos) {
 // src/completion.ts
 import { mkdir as mkdir5, readFile as readFile10, writeFile as writeFile5 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 var GLOBAL_FLAGS = ["--json", "--token", "--profile", "--yes", "--help", "--version", "--lang", "--dry-run"];
 var AGENT_FLAGS = /* @__PURE__ */ new Set(["--like", "--agent", "--prompt-base"]);
 var WORKSPACE_FLAGS = /* @__PURE__ */ new Set(["--workspace"]);
@@ -10901,7 +11057,7 @@ function completionFor(words, current2, commands) {
   if (agentArgIndex([...pos, current2]) === pos.length) return { kind: "agents" };
   return { kind: "words", words: [] };
 }
-var cacheFile = () => join6(process.env.XDG_CACHE_HOME || join6(homedir4(), ".cache"), "ghosty", `complete${process.env.GHOSTY_PROFILE ? `.${process.env.GHOSTY_PROFILE}` : ""}.json`);
+var cacheFile = () => join7(process.env.XDG_CACHE_HOME || join7(homedir4(), ".cache"), "ghosty", `complete${process.env.GHOSTY_PROFILE ? `.${process.env.GHOSTY_PROFILE}` : ""}.json`);
 async function names() {
   try {
     const c = JSON.parse(await readFile10(cacheFile(), "utf8"));
@@ -10911,7 +11067,7 @@ async function names() {
   const list = await listAgents();
   const agents = [...new Set(list.map((a) => a.nombre))];
   const workspaces = [...new Set(list.map((a) => a.espacio?.tipo === "workspace" ? a.espacio.nombre : void 0).filter((x) => !!x))];
-  await mkdir5(join6(cacheFile(), ".."), { recursive: true }).catch(() => {
+  await mkdir5(join7(cacheFile(), ".."), { recursive: true }).catch(() => {
   });
   await writeFile5(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
   });
@@ -10991,8 +11147,8 @@ function normalizeArgs(pos, v) {
 
 // src/commands/spec.ts
 var import_yaml = __toESM(require_dist(), 1);
-import { mkdir as mkdir6, readdir as readdir3, readFile as readFile11, stat, writeFile as writeFile6 } from "node:fs/promises";
-import { join as join7, resolve as resolve2 } from "node:path";
+import { mkdir as mkdir6, readdir as readdir4, readFile as readFile11, stat, writeFile as writeFile6 } from "node:fs/promises";
+import { join as join8, resolve as resolve2 } from "node:path";
 var enc9 = encodeURIComponent;
 async function agentsExport(id, v) {
   if (!id) throw usage(t("Missing agent.", "Falta el agente."), t("Example", "Ejemplo") + ": ghosty agents export pia-0 > pia.yaml   \xB7   ghosty agents export pia-0 --out ./pia");
@@ -11003,11 +11159,11 @@ async function agentsExport(id, v) {
   }
   const dir = resolve2(v.out);
   await mkdir6(dir, { recursive: true });
-  await writeFile6(join7(dir, "agent.yaml"), yaml);
+  await writeFile6(join8(dir, "agent.yaml"), yaml);
   const own = (0, import_yaml.parse)(yaml)["x-ghosty"]?.skills?.own ?? [];
   for (const slug of own) {
     const sk = await api(`/api/v2/agents/${enc9(id)}/skills/${enc9(slug)}`);
-    await writeSkill(join7(dir, "skills", slug), sk);
+    await writeSkill(join8(dir, "skills", slug), sk);
   }
   out({ saved: dir, skills: own }, () => `${lavender("\u2713")} ${dir}/agent.yaml${own.length ? ` + skills/ (${own.join(", ")})` : ""}
 ${dim(t(`Edit it, then: ghosty apply ${v.out} --dry-run`, `Ed\xEDtalo y luego: ghosty apply ${v.out} --dry-run`))}`);
@@ -11028,12 +11184,12 @@ function fillSecrets(file) {
   return missing;
 }
 async function readSkills(dir) {
-  const root = join7(dir, "skills");
+  const root = join8(dir, "skills");
   const out2 = {};
-  const slugs = await readdir3(root, { withFileTypes: true }).catch(() => []);
+  const slugs = await readdir4(root, { withFileTypes: true }).catch(() => []);
   for (const e of slugs) {
     if (!e.isDirectory() || e.name.startsWith(".")) continue;
-    const { markdown, assets } = await readSkillDir(join7(root, e.name));
+    const { markdown, assets } = await readSkillDir(join8(root, e.name));
     out2[e.name] = [{ path: "SKILL.md", contentBase64: Buffer.from(markdown).toString("base64") }, ...assets.map((a) => ({ path: a.name, contentBase64: a.contentBase64 }))];
   }
   return out2;
@@ -11042,7 +11198,7 @@ var line = (c) => c.op === "!" ? dim(`! ${c.what}`) : `${c.op === "+" ? lavender
 async function applyCmd(target, v) {
   if (!target) throw usage(t("Missing file or directory.", "Falta el archivo o el directorio."), t("Example: ghosty apply pia.yaml --dry-run   \xB7   ghosty apply ./pia (from agents export --out)", "Ejemplo: ghosty apply pia.yaml --dry-run   \xB7   ghosty apply ./pia (de agents export --out)"));
   const isDir = (await stat(target).catch(() => null))?.isDirectory() ?? false;
-  const text = await readFile11(isDir ? join7(target, "agent.yaml") : target, "utf8");
+  const text = await readFile11(isDir ? join8(target, "agent.yaml") : target, "utf8");
   const file = (0, import_yaml.parse)(text);
   if (!file || typeof file !== "object") throw usage(t(`${target} is not a YAML/JSON agent file.`, `${target} no es un archivo de agente YAML/JSON.`));
   const missing = fillSecrets(file);
@@ -11081,6 +11237,36 @@ ${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 on": a.boxesOn ?? "", "running now": a.activeTurns ?? "", ...a.error ? { note: a.error } : {} }));
+  out(r, () => `${bold(r.workspace)} ${dim(t(`plan: ${r.plan.parallel} in parallel \xB7 up to ${r.plan.maxBoxes} box(es) \xB7 ${r.plan.hotBoxes} hosting`, `plan: ${r.plan.parallel} en paralelo \xB7 hasta ${r.plan.maxBoxes} caja(s) \xB7 ${r.plan.hotBoxes} de hosting`))}
+${table(rows, ["agent", "engine", "per box", "boxes on", "running now"])}
+${dim(t(`${r.totals.boxesOn} box(es) on \xB7 ${r.totals.activeTurns} turn(s) running`, `${r.totals.boxesOn} caja(s) encendida(s) \xB7 ${r.totals.activeTurns} turno(s) corriendo`))}`);
+}
+
 // src/index.ts
 var HELP_EN = `${bold("Usage:")} ghosty <command> [options]
 
@@ -11091,7 +11277,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 and capacity per agent]
+  plan apply [workspace]    Apply a scheduled plan now, showing what changes   [--dry-run]
 
 ${bold("Agents")}
   agents ls                 List your agents
@@ -11126,10 +11313,11 @@ ${bold("Configure an agent")}
   skills ls|get|add|rm <id> [slug]   Skills (add from catalog, --file SKILL.md or --dir FOLDER; get lists, --out DIR saves; rm keeps a copy)
   skills templates <id>              pdf-doc templates it sees: its own and Ghosty's, and which folder wins
   dbs ls|tables|query|import|rehost|grant|revoke <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run] [--table T --column C]
+  dbs photos put <id> <db> --table T --key-column K --dir DIR   Loose photos to a catalog (SKU-123.jpg \u2192 its row), permanent links   [--column C] [--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 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)
@@ -11184,7 +11372,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 y capacidad por agente]
+  plan apply [espacio]      Aplica ya un plan programado, ense\xF1ando qu\xE9 cambia   [--dry-run]
 
 ${bold("Agentes")}
   agents ls                 Lista tus agentes
@@ -11219,10 +11408,11 @@ ${bold("Configurar un agente")}
   skills ls|get|add|rm <id> [slug]   Skills (add del cat\xE1logo, --file SKILL.md o --dir CARPETA; get lista, --out DIR guarda; rm deja copia)
   skills templates <id>              Plantillas de pdf-doc que ve: las suyas y las de Ghosty, y qu\xE9 carpeta gana
   dbs ls|tables|query|import|rehost|grant|revoke <id> [db]   Bases de datos que usa   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run] [--table T --column C]
+  dbs photos put <id> <db> --table T --key-column K --dir DIR   Fotos sueltas a un cat\xE1logo (SKU-123.jpg \u2192 su fila), ligas permanentes   [--column C] [--dry-run]
   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)
@@ -11268,7 +11458,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);
@@ -11298,6 +11488,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: {
@@ -11367,6 +11558,10 @@ async function main() {
       verbose: { type: "boolean" },
       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" },
@@ -11426,7 +11621,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.20.0" }, () => "0.20.0");
+  if (v.version) return out({ version: "0.22.0" }, () => "0.22.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -11500,6 +11695,7 @@ async function main() {
       return mcpCmd(sub, a1, v);
     case "dbs":
     case "db":
+      if (sub === "photos") return dbsPhotosCmd(a1, a2, pos[4], v);
       return dbsCmd(sub, a1, a2, pos.slice(4).filter((x) => x !== void 0), v);
     case "turns":
       return turnsCmd(sub, a1, a2, v);
@@ -11526,7 +11722,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();
@@ -11541,7 +11740,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.20.0").catch(() => null);
+var notice = updateNotice("0.22.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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