@ghostystudio/cli 0.58.0 → 0.58.1

package/README.md

@@ -84,7 +84,7 @@ ghosty schedule add|ls|rm <id> … --teams <workspace>#<room>[/<thread-id>]   #
 
 ghosty me files ls|get|export|upload|rm  [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]
 ghosty me memories ls|add|edit|rm
-ghosty conversations archive|rm <id> --kind test|channel [--before 7d] [--dry-run]
+ghosty conversations archive|rm <id> --kind test|channel|personal [--before 7d] [--dry-run]
 ghosty agents docs dedupe [--dry-run]    # your account: merge documents with the same content
 # Ghosty staff
 ghosty conversations ls --user EMAIL [--since 30d] · conversations show <id> <conv> --why|--tools
@@ -109,6 +109,10 @@ Every command has its own help with examples: `ghosty <command> --help` or `ghos
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.58.1
+
+- `agents docs add|replace --file` sends the file type from its extension. Before, the server stored every CLI upload as `application/octet-stream`, and a PDF reached WhatsApp customers as `.bin`.
+
 ### Changes in 0.57.1 (0.57.0 + the 0.56.1 factory fix)
 
 - `sites pin <slug>` / `sites unpin <slug>` / `sites pins [--cancel|--resume]`: «Pinned sites» — $49 USD/yr or $5 USD/mo ($990 / $99 MXN), includes up to 3 sites per pack; a pinned site never pauses and has no banner. `--interval year|month`, `--currency usd|mxn`, `--add-pack`.

package/dist/index.js

@@ -7863,11 +7863,11 @@ var SERVER_MESSAGES = [
   ["la caja ACP {} arranc\xF3 en error: {}", "ACP box {} started in error: {}"],
   ["la caja ACP {} no lleg\xF3 a running en 90s", "ACP box {} didn't reach running in 90s"],
   ["la caja {} no lleg\xF3 a running (\xFAltimo estado: {})", "box {} didn't reach running (last state: {})"],
+  ["la caja {} no arranc\xF3: {}", "box {} failed to boot: {}"],
   ["la caja del agente naci\xF3 muda (no arranc\xF3 {}-runtime): {}", "the agent's box came up mute ({}-runtime didn't start): {}"],
   ["no se pudo re-rutear tras caja muerta", "couldn't re-route after a dead box"],
   ["fleet route race sin ganador", "fleet route race with no winner"],
   ["create: respuesta sin sandboxId", "create: response without sandboxId"],
-  ["warmpool.claim: respuesta sin sandboxId", "warmpool.claim: response without sandboxId"],
   ["expose: respuesta sin url", "expose: response without url"],
   ["expose-raw: respuesta sin hostPort", "expose-raw: response without hostPort"],
   // — Cajas compartidas: voz, render, video, ortografía, eventos
@@ -8468,7 +8468,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.58.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.58.1"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8510,7 +8510,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.58.0"}`,
+      "user-agent": `ghosty-cli/${"0.58.1"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9095,7 +9095,7 @@ ${dim(t(`only ${workspace} (ghosty use) \xB7 all: --all`, `s\xF3lo ${workspace}
 function parseEnv(raw) {
   if (!raw) return void 0;
   const env = {};
-  for (const pair of raw.split(",")) {
+  for (const pair of raw.split(/,(?=[A-Za-z_][A-Za-z0-9_]*=)/)) {
     const i = pair.indexOf("=");
     if (i < 1) throw usage(t(`Bad --env entry: ${pair}.`, `Entrada de --env inv\xE1lida: ${pair}.`), t("Example", "Ejemplo") + ": --env GHOSTY_THINKING_EFFORT=max");
     env[pair.slice(0, i).trim()] = pair.slice(i + 1);
@@ -10305,6 +10305,7 @@ ${bold("Partner space")}  ${dim("(you, signed in as the space owner)")}
   partner credentials rotate <keyId> [--grace MIN]   New secret, same keyId (old one valid MIN, default 60)
   partner credentials revoke <keyId>      Revoke it (idempotent)
   partner audit                           Who did what, when
+  partner usage [--tenant ID] [--from YYYY-MM-DD] [--to YYYY-MM-DD]   Turns, tokens, cost and errors per business (30 days by default)
 
 ${bold("Shared agents (solo-MCP)")}  ${dim("(--agent SLUG picks another agent of the partner: nik-admin, nik-public\u2026)")}
   partner agent get [--agent SLUG]        The agent template and its version
@@ -10350,6 +10351,7 @@ ${bold("Espacio de partner")}  ${dim("(t\xFA, con sesi\xF3n como due\xF1a del es
   partner credentials rotate <keyId> [--grace MIN]   Secreto nuevo, mismo keyId (el viejo vale MIN, default 60)
   partner credentials revoke <keyId>      La revoca (idempotente)
   partner audit                           Qui\xE9n hizo qu\xE9 y cu\xE1ndo
+  partner usage [--tenant ID] [--from AAAA-MM-DD] [--to AAAA-MM-DD]   Turnos, tokens, costo y fallas por negocio (30 d\xEDas por default)
 
 ${bold("Agentes compartidos (solo-MCP)")}  ${dim("(--agent SLUG elige otro agente del partner: nik-admin, nik-public\u2026)")}
   partner agent get [--agent SLUG]        La plantilla del agente y su versi\xF3n
@@ -10406,7 +10408,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.58.0"}`
+        "user-agent": `ghosty-cli/${"0.58.1"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10649,6 +10651,29 @@ async function partnerCmd(sub, a1, a2, v, a3) {
       const r = await json("/api/v2/partner/audit", v, { ownerOnly: true });
       return out(r, () => table(r.events.map((e) => ({ when: fmt(e.ts), action: e.action, externalId: e.externalId, actor: e.actor })), ["when", "action", "externalId", "actor"]));
     }
+    case "usage": {
+      const q = new URLSearchParams();
+      if (v.tenant) q.set("externalId", v.tenant);
+      if (v.from) q.set("from", v.from);
+      if (v.to) q.set("to", v.to);
+      const r = await json(
+        `/api/v2/partner/usage${q.size ? `?${q}` : ""}`,
+        v
+      );
+      return out(
+        r,
+        () => r.tenants.length ? table(
+          r.tenants.map((x) => ({
+            tenant: x.name ? `${x.name} (${x.externalId})` : x.externalId,
+            turns: x.turns,
+            tokens: x.tokens,
+            usd: x.costUsd.toFixed(4),
+            errors: Object.entries(x.errors).map(([k, n]) => `${k}\xD7${n}`).join(" ") || "\u2014"
+          })),
+          ["tenant", "turns", "tokens", "usd", "errors"]
+        ) : dim(t("No usage in that range.", "Sin consumo en ese rango."))
+      );
+    }
     case "try":
       return tryCmd(a1, a2, v);
     case "wa":
@@ -10986,7 +11011,7 @@ async function agentDocsCmd(sub, id, docs, v) {
       if (!v.url === !v.file) throw usage(t("Use --url URL or --file PATH (one of them).", "Usa --url URL o --file RUTA (uno de los dos)."), t("Example", "Ejemplo") + ': ghosty agents docs add <agent-id> --url https://\u2026/lista.pdf --description "Precios 2026"');
       if (v.grant && !["read", "write", "no"].includes(v.grant)) throw usage(t("--grant takes read, write or no.", "--grant acepta read, write o no."));
       const body = {
-        ...v.url ? { url: v.url } : { contentBase64: (await readFile6(v.file)).toString("base64"), name: v.name ?? basename3(v.file) },
+        ...v.url ? { url: v.url } : { contentBase64: (await readFile6(v.file)).toString("base64"), name: v.name ?? basename3(v.file), ...mimeField(v.file) },
         ...v.url && v.name ? { name: v.name } : {},
         ...v.description ? { description: v.description } : {},
         grant: v.grant === "no" ? false : v.grant === "write" || v.write ? "write" : "read",
@@ -11005,7 +11030,7 @@ async function agentDocsCmd(sub, id, docs, v) {
       doc = need2(doc, t("document (id or exact name)", "el documento (id o nombre exacto)"), ex);
       if (!v.url === !v.file) throw usage(t("Use --url URL or --file PATH (one of them).", "Usa --url URL o --file RUTA (uno de los dos)."), t("Example", "Ejemplo") + ": " + ex);
       const body = {
-        ...v.url ? { url: v.url } : { contentBase64: (await readFile6(v.file)).toString("base64") },
+        ...v.url ? { url: v.url } : { contentBase64: (await readFile6(v.file)).toString("base64"), ...mimeField(v.file) },
         ...v.note ? { note: v.note } : {}
       };
       const r = await api(agentPath2(id, `/documents/${enc6(doc)}/versions`), { method: "POST", body });
@@ -11121,6 +11146,33 @@ async function turnsGrep(id, text, v) {
   out(r, () => rows.length ? `${table(rows, ["at", "who", "turn", "state", "session", "text"])}
 ${dim(`${t("open one", "abre uno")}: ghosty turns show ${id} <turn>`)}` : dim(t(`Nothing says \xAB${text}\xBB${v.since ? ` since ${v.since}` : ""}.`, `Nada dice \xAB${text}\xBB${v.since ? ` desde ${v.since}` : ""}.`)));
 }
+function mimeField(path) {
+  const types = {
+    pdf: "application/pdf",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    mp3: "audio/mpeg",
+    ogg: "audio/ogg",
+    wav: "audio/wav",
+    m4a: "audio/mp4",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    csv: "text/csv",
+    md: "text/markdown",
+    txt: "text/plain",
+    html: "text/html",
+    json: "application/json",
+    zip: "application/zip",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+  };
+  const mime = types[path.split(".").pop()?.toLowerCase() ?? ""];
+  return mime ? { mime } : {};
+}
 async function turnShow(id, turnId, full = false) {
   id = need2(id, t("agent id", "el id del agente"), "ghosty turns show <agent-id> [turn-id|last] [--full]");
   const r = await api(agentPath2(id, `/turns/${enc6(turnId ?? "last")}`));
@@ -11489,9 +11541,10 @@ async function channelsCmd(kind, sub, id, ref, v) {
       answers: n2.mine ? lavender(t("this agent", "este agente")) : n2.recordsOnly ? t("this agent (records only)", "este agente (s\xF3lo registra)") : n2.takenByOther ? t("another agent", "otro agente") : dim(t("nobody (silent)", "nadie (en silencio)")),
       "formmy forwards": fwd(n2),
       "ads only": n2.adsOnly ? lavender(t("yes", "s\xED")) : "",
+      board: n2.board ? n2.board.name : dim(t("the agent's", "el del agente")),
       id: n2.id
     }));
-    return out(cur, () => rows.length ? table(rows, ["number", "answers", "formmy forwards", "ads only", "id"]) : dim(t(`No WhatsApp Business numbers yet. Pair one at ${cur.salesUrl}`, `Todav\xEDa no hay n\xFAmeros de WhatsApp Business. Parea uno en ${cur.salesUrl}`)));
+    return out(cur, () => rows.length ? table(rows, ["number", "answers", "formmy forwards", "ads only", "board", "id"]) : dim(t(`No WhatsApp Business numbers yet. Pair one at ${cur.salesUrl}`, `Todav\xEDa no hay n\xFAmeros de WhatsApp Business. Parea uno en ${cur.salesUrl}`)));
   }
   if (sub !== "enable" && sub !== "disable") throw usage(t(`Unknown subcommand: ${sub}.`, `Subcomando desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty channels whatsapp ls | enable | disable | integrations | link | unlink | history \xB7 ghosty channels wa import | status | pause | groups");
   if (!ref) throw usage(t("Missing number.", "Falta el n\xFAmero."), t("Example", "Ejemplo") + `: ghosty channels whatsapp ${sub} ${id} +52 55 1234 5678`);
@@ -11654,19 +11707,21 @@ async function linkCmd(sub, id, v) {
   if (!id || !v.integration) throw usage(t("Missing agent id or --integration.", "Falta el id del agente o --integration."), t("Example", "Ejemplo") + `: ghosty channels whatsapp ${sub} <agent-id> --integration <formmy-integration-id> --answer off --dry-run`);
   if (v["ads-only"] !== void 0 && v["ads-only"] !== "on" && v["ads-only"] !== "off") throw usage(t("--ads-only takes on or off.", "--ads-only acepta on u off."));
   const adsOnly = v["ads-only"] === void 0 ? void 0 : v["ads-only"] === "on";
-  if (sub === "link" && adsOnly !== void 0 && v.answer === void 0) {
+  const board = v.board === void 0 ? void 0 : /^(agent|agente)$/i.test(v.board) ? null : v.board;
+  const boardFlag = v.board !== void 0 ? ` --board ${JSON.stringify(v.board)}` : "";
+  if (sub === "link" && (adsOnly !== void 0 || board !== void 0) && v.answer === void 0) {
     const path2 = `/api/v2/agents/${enc7(id)}/whatsapp/link`;
-    const r2 = await api(path2, { method: "POST", body: { integrationId: v.integration, adsOnly, ...v["dry-run"] ? { dryRun: true } : {} } });
+    const r2 = await api(path2, { method: "POST", body: { integrationId: v.integration, ...adsOnly !== void 0 ? { adsOnly } : {}, ...board !== void 0 ? { board } : {}, ...v["dry-run"] ? { dryRun: true } : {} } });
     return out(r2, () => `${r2.plan.map((x) => serverText(x)).join("\n")}${v["dry-run"] ? `
-${dim(applyHint(`ghosty channels whatsapp link ${id} --integration ${v.integration} --ads-only ${v["ads-only"]}`))}` : ""}`);
+${dim(applyHint(`ghosty channels whatsapp link ${id} --integration ${v.integration}${v["ads-only"] ? ` --ads-only ${v["ads-only"]}` : ""}${boardFlag}`))}` : ""}`);
   }
   if (sub === "link" && v.answer !== "on" && v.answer !== "off") throw usage(t("Missing --answer on|off.", "Falta --answer on|off."), t("on = this agent answers real customers \xB7 off = it only records (add --forward so gs still sees the conversations)", "on = este agente contesta a clientes reales \xB7 off = s\xF3lo registra (agrega --forward para que gs siga viendo las conversaciones)"));
   const path = `/api/v2/agents/${enc7(id)}/whatsapp/link`;
   if (v["partner-agent"] && !v["partner-tenant"]) throw usage(t("--partner-agent needs --partner-tenant <externalId>.", "--partner-agent necesita --partner-tenant <externalId>."));
   const partner = v["partner-tenant"] ? { partnerExternalId: v["partner-tenant"], ...v["partner-agent"] ? { partnerAgentSlug: v["partner-agent"] } : {} } : {};
-  const body = { integrationId: v.integration, ...sub === "unlink" ? { unlink: true } : { answer: v.answer === "on", ...v.forward ? { forward: true } : {}, ...adsOnly !== void 0 ? { adsOnly } : {}, ...partner } };
+  const body = { integrationId: v.integration, ...sub === "unlink" ? { unlink: true } : { answer: v.answer === "on", ...v.forward ? { forward: true } : {}, ...adsOnly !== void 0 ? { adsOnly } : {}, ...board !== void 0 ? { board } : {}, ...partner } };
   const partnerFlags = v["partner-tenant"] ? ` --partner-tenant ${v["partner-tenant"]}${v["partner-agent"] ? ` --partner-agent ${v["partner-agent"]}` : ""}` : "";
-  const cmd = `ghosty channels whatsapp ${sub} ${id} --integration ${v.integration}${sub === "link" ? ` --answer ${v.answer}${v.forward ? " --forward" : ""}${v["ads-only"] ? ` --ads-only ${v["ads-only"]}` : ""}${partnerFlags}` : ""}`;
+  const cmd = `ghosty channels whatsapp ${sub} ${id} --integration ${v.integration}${sub === "link" ? ` --answer ${v.answer}${v.forward ? " --forward" : ""}${v["ads-only"] ? ` --ads-only ${v["ads-only"]}` : ""}${boardFlag}${partnerFlags}` : ""}`;
   const plan = await api(path, { method: "POST", body: { ...body, dryRun: true } });
   const text = `${plan.plan.map((x) => serverText(x)).join("\n")}
 ${dim(`Formmy: ${plan.formmy.before.url ?? "null"} \u2192 ${plan.formmy.after.url ?? "null"} (${t("as", "como")} ${plan.formmy.by})`)}`;
@@ -12041,7 +12096,7 @@ var HELPS_ES = {
       ["--engine E --dry-run", "set: qu\xE9 hace cambiar de motor (sesiones que se olvidan, caja que se levanta y cu\xE1l se destruye, si est\xE1 trabajando) sin cambiarlo; cada hilo conserva su conversaci\xF3n"],
       ["--toolsets LIST", "set: grupos de tools de gs que recibe (crm, sales\u2026): una lista reemplaza; +x / -x agrega o quita"],
       ["--prompt-base ID", "set: el prompt de este agente = el prompt de ese agente + --prompt-overlay; se regenera cuando cambia la base. none = desliga (conserva el prompt de hoy)"],
-      ["--prompt-overlay FILE", 'set: JSON {"edits":[{"what","find","replace","regex"?,"all"?}]}, aplicados en orden; cada uno debe encontrar su lugar o no cambia nada'],
+      ["--prompt-overlay FILE", 'set: JSON {"edits":[{"what","find","replace","regex"?,"all"?}]}, aplicados en orden; cada uno debe encontrar su lugar o no cambia nada. {"edits":[]} = espejo exacto: un solo prompt y una sola memoria para los dos'],
       ["--prompt-patch FILE", 'set: el mismo formato {"edits":[\u2026]}, aplicado UNA vez sobre el prompt actual del agente en el servidor (no sobre una copia local: nunca pisa el cambio de alguien m\xE1s). Si una edici\xF3n no encuentra su lugar, no cambia nada. --dry-run imprime el diff'],
       ["--prompt-append FILE", "set: agrega ese texto al final del prompt (con --prompt-patch tambi\xE9n: primero las ediciones, luego el texto)"],
       ["--voice E:ID", "set: voz de las notas de voz: elevenlabs:<voiceId> o kokoro:em_santa|em_alex|ef_dora"],
@@ -12092,7 +12147,7 @@ var HELPS_ES = {
       ["--out FILE.tsx|.jsx [--force]", "embed: escribe en tu proyecto un componente de React COMPLETO y editable (sin depender de ning\xFAn paquete) con tu token y tu tema horneados arriba; no pisa un archivo que ya existe sin --force"],
       ["--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 (nunca a media respuesta); pool: la nueva nace en el siguiente turno; ACP (goose, lite): su caja se recrea ya con la imagen actual"],
+      ["--recycle", "box: reemplaza sus m\xE1quinas (nunca a media respuesta); pool: la nueva nace en el siguiente turno; ACP (goose, lite) igual, con el historial del \xFAltimo respaldo"],
       ["--reenv / --force", "box --recycle en ACP: --reenv s\xF3lo re-hornea el env en la misma caja; --force la recrea aunque est\xE9 ocupada (due\xF1o o staff)"],
       ["--unset-env K1,K2", "set: borra esas variables del env (--env K= tambi\xE9n borra K)"],
       ["--tool [ch:]tool=on|off", "set: prende/apaga una tool en un canal (wa:actualizar_identidad=off) o en todos (crm_buscar=off); separadas por comas"],
@@ -12208,7 +12263,7 @@ var HELPS_ES = {
     flags: [
       ["--media FILE", "chat: adjunta un archivo local (se repite)"],
       ["--file ID", "chat: adjunta de tus archivos (ghosty me files ls --q \u2026), separados por comas"],
-      ["--kind K", "archive|rm: test (pruebas) o channel (clientes: s\xF3lo archivar, su memoria los sigue atendiendo)"],
+      ["--kind K", "archive|rm: test (pruebas), channel (clientes: s\xF3lo archivar, su memoria los sigue atendiendo) o personal (s\xF3lo TUS chats con ese agente; tambi\xE9n se van de tus apps)"],
       ["--before T", "archive|rm: s\xF3lo conversaciones sin mensajes desde T (7d, 12h o ISO)"],
       ["--user EMAIL", "ls/show (staff de Ghosty): las conversaciones de esa persona en cualquier agente; queda en bit\xE1cora"],
       ["--why", "show (staff de Ghosty): clase, de qui\xE9n es, qu\xE9 turno la fij\xF3, y si el due\xF1o / su usuario la ven en su lista o por liga"],
@@ -12268,6 +12323,7 @@ var HELPS_ES = {
       ["--text T / --sender N", "groups inject (staff): un mensaje que se perdi\xF3 (grupo apagado, deploy) entra como si N lo hubiera escrito ah\xED, y el agente contesta en el grupo"],
       ["--cached", "groups ls: no le pide a WhatsApp la lista en vivo (m\xE1s r\xE1pido; puede faltar alg\xFAn grupo nuevo)"],
       ["--ads-only on|off", "link: s\xF3lo las conversaciones que vienen de un anuncio abren tarjeta (tambi\xE9n solo, para cambiarlo en un n\xFAmero ya ligado)"],
+      ["--board NAME|agent", "link: este n\xFAmero llena su propio tablero de ventas (nombre, id o main) en vez del del agente; las tools del CRM del agente trabajan ese tablero en los turnos de este n\xFAmero. agent = vuelve al del agente. Tambi\xE9n solo, en un n\xFAmero ya ligado"],
       ["--list", "history --dry-run: CU\xC1LES conversaciones (tel\xE9fono, nombre, primer mensaje, mensajes, si vino de anuncio)"],
       ["--only-ads / --phones a,b", "history: importa (o lista) s\xF3lo las de anuncio y/o esos tel\xE9fonos"],
       ["--column NAME", "history: las tarjetas nuevas nacen en esa columna en vez de la primera"],
@@ -12587,7 +12643,7 @@ var HELPS = {
       ["--engine E --dry-run", "set: what changing the engine does (sessions forgotten, machine started and which one is destroyed, whether it is busy) without changing it; each conversation keeps its history"],
       ["--toolsets LIST", "set: gs tool groups it gets (crm, sales\u2026): a list replaces; +x / -x add or remove"],
       ["--prompt-base ID", "set: this agent's prompt = that agent's prompt + --prompt-overlay; regenerates when the base changes. none = unlink (keeps today's prompt)"],
-      ["--prompt-overlay FILE", 'set: JSON {"edits":[{"what","find","replace","regex"?,"all"?}]}, applied in order; each must find its place or nothing changes'],
+      ["--prompt-overlay FILE", 'set: JSON {"edits":[{"what","find","replace","regex"?,"all"?}]}, applied in order; each must find its place or nothing changes. {"edits":[]} = an exact mirror: one prompt and one memory for both agents'],
       ["--prompt-patch FILE", `set: the same {"edits":[\u2026]} format, applied ONCE on the agent's current prompt on the server (not a local copy: it never overwrites someone else's change). If one edit doesn't find its place, nothing changes. --dry-run prints the diff`],
       ["--prompt-append FILE", "set: add that text at the end of the prompt (with --prompt-patch too: edits first, then the text)"],
       ["--voice E:ID", "set: voice for voice notes: elevenlabs:<voiceId> or kokoro:em_santa|em_alex|ef_dora"],
@@ -12638,7 +12694,7 @@ var HELPS = {
       ["--out FILE.tsx|.jsx [--force]", "embed: write a COMPLETE, editable React component into your project (no package needed) with your token and theme baked in at the top; won't overwrite an existing file without --force"],
       ["--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); pool: the new one starts on the next turn; ACP (goose, lite): its box is recreated now with the current image"],
+      ["--recycle", "box: replace its machines (not mid-turn); pool: the new one starts on the next turn; ACP (goose, lite) too, history from its last backup"],
       ["--reenv / --force", "box --recycle on ACP: --reenv only re-bakes the env in the same box; --force recreates it even if busy (owner or staff)"],
       ["--unset-env K1,K2", "set: delete these env variables (--env K= also deletes K)"],
       ["--tool [ch:]tool=on|off", "set: one tool on/off in one channel (wa:actualizar_identidad=off) or everywhere (crm_buscar=off); comma-separated"],
@@ -12841,7 +12897,7 @@ var HELPS = {
       'ghosty chat <agent-id> ["message"] [--conversation ID] [--media FILE]\u2026 [--file ID[,ID\u2026]]',
       "ghosty conversations ls <agent-id>",
       "ghosty conversations show <agent-id> <conversation-id> [--limit 20]",
-      "ghosty conversations archive|rm <agent-id> --kind test|channel [--before 7d] [--dry-run] [--yes]",
+      "ghosty conversations archive|rm <agent-id> --kind test|channel|personal [--before 7d] [--dry-run] [--yes]",
       "ghosty conversations ls --user <email> [--since 30d] [--surface android]   # staff",
       "ghosty conversations show <agent-id> <conversation-id> --why   # staff: who sees it and why",
       "ghosty conversations show <agent-id> <conversation-id> --tools   # staff: what it ran and where it went"
@@ -12849,13 +12905,13 @@ var HELPS = {
     flags: [
       ["--media FILE", "chat: attach a local file (repeatable)"],
       ["--file ID", "chat: attach from your files (ghosty me files ls --q \u2026), comma-separated"],
-      ["--kind K", "archive|rm: test (test chats) or channel (customers: archive only, their memory keeps serving them)"],
+      ["--kind K", "archive|rm: test (test chats), channel (customers: archive only, their memory keeps serving them) or personal (only YOUR own chats with that agent; also gone from your apps)"],
       ["--before T", "archive|rm: only conversations with no message since T (7d, 12h or ISO)"],
       ["--user EMAIL", "ls/show (Ghosty staff): that person's conversations in any agent; logged"],
       ["--why", "show (Ghosty staff): kind, whose it is, which turn set it, and whether the owner / its user see it in their list or by link"],
       ["--tools", "show (Ghosty staff): every tool the agent ran with its command/args (secrets masked) and the external domains it named; never while a turn runs in that thread"]
     ],
-    examples: ['ghosty chat <id> "hola"', "ghosty chat <id>", 'ghosty chat <id> "p\xE1salo a PDF" --media foto.jpg', "ghosty conversations rm <id> --kind test --before 7d --dry-run", "ghosty conversations archive <id> --kind channel --before 30d", "ghosty conversations ls --user david@empresa.com --since 7d"],
+    examples: ['ghosty chat <id> "hola"', "ghosty chat <id>", 'ghosty chat <id> "p\xE1salo a PDF" --media foto.jpg', "ghosty conversations rm <id> --kind test --before 7d --dry-run", "ghosty conversations archive <id> --kind channel --before 30d", "ghosty conversations rm <id> --kind personal --dry-run", "ghosty conversations ls --user david@empresa.com --since 7d"],
     learn: `${REF}#conversaciones`
   },
   schedule: {
@@ -12951,6 +13007,7 @@ HELPS.channels = {
     ["--text T / --sender N", "groups inject (staff): a message that got lost (group off, deploy) enters as if N wrote it there, and the agent answers in the group"],
     ["--cached", "groups ls: don't ask WhatsApp for the live list (faster; may miss new groups)"],
     ["--ads-only on|off", "link: only conversations that come from an ad open a card (also alone, to change it on a linked number)"],
+    ["--board NAME|agent", "link: this number fills its own sales board (name, id or main) instead of the agent's; the agent's CRM tools work that board on this number's turns. agent = back to the agent's board. Also alone, on a linked number"],
     ["--list", "history --dry-run: WHICH conversations (phone, name, first message, messages, from an ad)"],
     ["--only-ads / --phones a,b", "history: import (or list) only the ones from an ad and/or those phones"],
     ["--column NAME", "history: new cards are born in that column instead of the first one"],
@@ -14394,9 +14451,10 @@ async function supportThread(agent, sid, v) {
   });
 }
 async function cleanupConversations(action, agent, v) {
-  const ex = `ghosty conversations ${action} <agent> --kind ${action === "rm" ? "test" : "test|channel"} [--before 7d] [--dry-run]`;
+  const ex = `ghosty conversations ${action} <agent> --kind ${action === "rm" ? "test|personal" : "test|channel|personal"} [--before 7d] [--dry-run]`;
   if (!agent) throw usage(t("Missing agent.", "Falta el agente."), ex);
-  if (v.kind !== "test" && v.kind !== "channel") throw usage(t("--kind takes test or channel.", "--kind acepta test o channel."), ex);
+  if (v.kind !== "test" && v.kind !== "channel" && v.kind !== "personal") throw usage(t("--kind takes test, channel or personal.", "--kind acepta test, channel o personal."), ex);
+  if (action === "rm" && v.kind === "channel") throw usage(t("Customer conversations (channel) are archived, never deleted: their memory keeps serving them.", "Los hilos de clientes (channel) se archivan, nunca se borran: su memoria los sigue atendiendo."), ex);
   const path = `/api/v2/agents/${enc13(agent)}/conversations/cleanup`;
   const body = { kind: v.kind, action, ...v.before ? { before: v.before } : {} };
   const plan = await api(path, { method: "POST", body: { ...body, dryRun: true } });
@@ -14648,7 +14706,7 @@ ${bold("Configure an agent")}
   channels whatsapp ls|enable|disable <id> [number]   Which WhatsApp Business numbers it answers   [--dry-run]
   channels whatsapp integrations <id>    Its owner's WhatsApp Business numbers in Formmy (number, who answers today, who answered last, Integration id)   [--orphans: answered by nobody but with turns]
   channels messenger ls <id>             The workspace's Messenger pages: who answers now and who answered last   [--orphans]
-  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] [--ads-only on|off] [--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] [--ads-only on|off] [--board NAME|agent] [--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 [--list]] [--only-ads] [--phones a,b] [--column NAME]
   channels wa import <id> --from easybits:ID | --from-file F | --from-dir DIR --own-number yes|no   Move a personal WhatsApp session here, no QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Pair a personal WhatsApp by code (no QR)
@@ -14688,7 +14746,7 @@ ${bold("Talk to an agent")}
   chat <id> ["message"]     Stream a conversation (no message = interactive)   [--conversation ID] [--media FILE] [--file ID: from your files]
   conversations ls <id>     List conversations
   conversations show <id> <conversation>   What was said   [--limit 20] (0 = all)
-  conversations archive|rm <id> --kind test|channel   Clean its history (rm: tests only)   [--before 7d] [--dry-run]
+  conversations archive|rm <id> --kind test|channel|personal   Clean its history (rm: never customers)   [--before 7d] [--dry-run]
   turns ls <id>             Recent turns and why they failed   [--errors] [--skipped] [--since 1h] [--limit N]
   turns ls --workspace SLUG --quota-hits   Messages that got no turn because the balance ran out   [--days 14]
   turns show <id> [turn]    What came in, what it answered, and where the time went (default: last)   [--full]
@@ -14815,7 +14873,7 @@ ${bold("Configurar un agente")}
   channels whatsapp ls|enable|disable <id> [n\xFAmero]   Qu\xE9 n\xFAmeros de WhatsApp Business contesta   [--dry-run]
   channels whatsapp integrations <id>    Los n\xFAmeros de WhatsApp Business de su due\xF1o en Formmy (n\xFAmero, qui\xE9n contesta hoy, qui\xE9n contest\xF3 al \xFAltimo, id de la Integration)   [--orphans: sin qui\xE9n conteste pero con turnos]
   channels messenger ls <id>             Las p\xE1ginas de Messenger del espacio: qui\xE9n contesta hoy y qui\xE9n contest\xF3 al \xFAltimo   [--orphans]
-  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] [--ads-only on|off] [--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] [--ads-only on|off] [--board NOMBRE|agent] [--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 [--list]] [--only-ads] [--phones a,b] [--column NOMBRE]
   channels wa import <id> --from easybits:ID | --from-file F | --from-dir DIR --own-number yes|no   Mueve aqu\xED una sesi\xF3n de WhatsApp personal, sin QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Vincula un WhatsApp personal con c\xF3digo (sin QR)
@@ -14855,7 +14913,7 @@ ${bold("Hablar con un agente")}
   chat <id> ["mensaje"]     Conversaci\xF3n en streaming (sin mensaje = interactivo)   [--conversation ID] [--media ARCHIVO] [--file ID: de tus archivos]
   conversations ls <id>     Lista conversaciones
   conversations show <id> <conversaci\xF3n>   Qu\xE9 se dijo   [--limit 20] (0 = todo)
-  conversations archive|rm <id> --kind test|channel   Limpia su historial (rm: s\xF3lo pruebas)   [--before 7d] [--dry-run]
+  conversations archive|rm <id> --kind test|channel|personal   Limpia su historial (rm: nunca clientes)   [--before 7d] [--dry-run]
   turns ls <id>             Turnos recientes y por qu\xE9 fallaron   [--errors] [--skipped] [--since 1h] [--limit N]
   turns ls --workspace SLUG --quota-hits   Mensajes que no abrieron turno porque se acab\xF3 el saldo   [--days 14]
   turns show <id> [turno]   Qu\xE9 lleg\xF3, qu\xE9 contest\xF3 y en qu\xE9 se fue el tiempo (default: el \xFAltimo)   [--full]
@@ -15163,7 +15221,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.58.0" }, () => "0.58.0");
+  if (v.version) return out({ version: "0.58.1" }, () => "0.58.1");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -15329,7 +15387,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.58.0").catch(() => null);
+var notice = updateNotice("0.58.1").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.58.0",
+  "version": "0.58.1",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
   "scripts": {
     "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --outfile=dist/index.js --banner:js='#!/usr/bin/env node\nimport { createRequire as __cr } from \"node:module\"; const require = __cr(import.meta.url);' --define:__VERSION__=\\\"$npm_package_version\\\"",
     "prepack": "npm run build",
-    "test": "for t in flags prompt api rows wa-auth resolve aliases i18n help completion photos channels-retry spaces sites diff cards; do esbuild src/$t.test.ts --bundle --platform=node --format=esm --outfile=/tmp/ghosty-cli-$t.test.mjs --log-level=error || exit 1; done && node --test /tmp/ghosty-cli-*.test.mjs"
+    "test": "for t in flags prompt api rows wa-auth resolve aliases i18n help completion photos channels-retry spaces sites diff cards env; 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",