@ghostystudio/cli 0.87.0 → 0.89.0

package/README.md

@@ -153,6 +153,14 @@ 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.88.0
+
+- `me files rm` takes several ids (`a,b` or `a b`) and `--q TEXT`, lists what it will delete, asks first (without a terminal it needs `--yes`; before, it deleted without asking) and `--dry-run` only shows the list.
+- `files ls|get|rm <agent> --session <conversation>`: on a pool agent, that conversation's folder in its box (attachments, what it made). Never wakes a paused box.
+- `files` and `me files` point to each other in their help, errors and empty listings.
+- The «Update available» notice only shows to a person at a terminal; agents and scripts see it only in the unknown-option error.
+- gs: a file that looks like a key (cookies.txt, `.env`, private key) is used in the turn but not saved to the library; `POST /api/v2/me/files` answers `422 secret_file`.
+
 ### Changes in 0.86.0
 
 - `ghosty tts "text" [--voice em_santa|em_alex|ef_dora] [--out FILE]`: hear the house voice (Kokoro, Mexican Spanish, with Ghosty's pronunciation lexicon) say a text, saved as a .wav. Up to 400 characters.

package/dist/index.js

@@ -1175,7 +1175,7 @@ async function postLong(path2, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path2}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.87.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.89.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -1217,7 +1217,7 @@ async function request(path2, 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.87.0"}`,
+      "user-agent": `ghosty-cli/${"0.89.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -10047,21 +10047,25 @@ async function tryTurn(id, text, v) {
 ${dim(`(${t("warning", "aviso")}: ${serverText(r.error)})`)}` : ""));
 }
 async function filesCmd(sub, id, path2, v) {
-  const ex = "ghosty files ls <agent-id> | get <agent-id> <path> | put <agent-id> <path> --file <local> | rm <agent-id> <path>";
+  const ex = "ghosty files ls <agent-id> [--session <id>] | get <agent-id> <path> | put <agent-id> <path> --file <local> | rm <agent-id> <path>";
   id = need(id, "agent id", ex);
   const p = (path2 ?? "").replace(/^\/+/, "");
+  const qs = v.session ? `?session=${encodeURIComponent(v.session)}` : "";
+  const en = v.session ? ` --session ${v.session}` : "";
   switch (sub) {
     case "ls": {
-      const r = await api(agentPath(id, `/files/${p}`));
+      const r = await api(agentPath(id, `/files/${p}${qs}`));
       const cols = r.files?.length ? Object.keys(r.files[0]).slice(0, 4) : ["path"];
+      const hint = r.files?.length ? "" : `
+${dim(t("Looking for your account's files? ghosty me files ls", "\xBFBuscas los archivos de tu cuenta? ghosty me files ls"))}`;
       out(r, () => `${dim(r.dir)}
 ${table(r.files ?? [], cols)}${r.note ? `
-${dim(r.note)}` : ""}`);
+${dim(r.note)}` : ""}${hint}`);
       return;
     }
     case "get": {
       need(path2, "path", ex);
-      const res = await request(agentPath(id, `/files/${p}`));
+      const res = await request(agentPath(id, `/files/${p}${qs}`));
       const bytes = Buffer.from(await res.arrayBuffer());
       if (v.out) {
         await writeFile3(v.out, bytes);
@@ -10078,12 +10082,13 @@ ${dim(r.note)}` : ""}`);
     }
     case "rm": {
       need(path2, "path", ex);
-      await confirm(t(`Delete ${p} from the agent's machine?`, `\xBFBorrar ${p} de la m\xE1quina del agente?`), { yes: v.yes, retry: `ghosty files rm ${id} ${p}` });
-      out(await api(agentPath(id, `/files/${p}`), { method: "DELETE" }) ?? { deleted: p }, () => `${lavender("\u2713")} ${t("Deleted", "Borrado")} ${p}`);
+      await confirm(t(`Delete ${p} from the agent's machine?`, `\xBFBorrar ${p} de la m\xE1quina del agente?`), { yes: v.yes, retry: `ghosty files rm ${id} ${p}${en}` });
+      out(await api(agentPath(id, `/files/${p}${qs}`), { method: "DELETE" }) ?? { deleted: p }, () => `${lavender("\u2713")} ${t("Deleted", "Borrado")} ${p}`);
       return;
     }
     default:
-      throw usage(t(`Unknown files subcommand: ${sub ?? "(none)"}.`, `Subcomando de files desconocido: ${sub ?? "(ninguno)"}.`), ex);
+      throw usage(t(`Unknown files subcommand: ${sub ?? "(none)"}.`, `Subcomando de files desconocido: ${sub ?? "(ninguno)"}.`), `${ex}
+${t("Your account's files: ghosty me files ls", "Los archivos de tu cuenta: ghosty me files ls")}`);
   }
 }
 async function readStdin() {
@@ -10858,8 +10863,46 @@ ${red(t(`${failed.length} failed:`, `${failed.length} fallaron:`))}
 ${failed.map((x) => `  ${x.name} ${dim(`${x.id} \xB7 ${x.error}`)}`).join("\n")}` : "")
   );
 }
-async function meFiles(sub, arg, v) {
-  const ex = "ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] | get <file-id> [--out FILE] | export [--out DIR] | upload <file> | rm <file-id>";
+function fileIds(args) {
+  return [...new Set(args.flatMap((a) => (a ?? "").split(",")).map((x) => x.trim()).filter(Boolean))];
+}
+async function meFilesRm(ids, v, ex) {
+  if (!ids.length && !v.q) throw usage(t("Missing file id (or --q TEXT).", "Falta el id del archivo (o --q TEXTO)."), ex);
+  let rows = ids.map((id) => ({ id }));
+  if (v.q) {
+    const q = new URLSearchParams({ q: v.q, limit: "100", ...v.kind ? { kind: v.kind } : {} });
+    const r = await api(`/api/v2/me/files?${q}`);
+    rows = [...rows, ...r.files.filter((f) => !ids.includes(f.id)).map((f) => ({ id: f.id, name: f.name, size: f.size, created: f.createdAt.slice(0, 10) }))];
+  }
+  const retry = `ghosty me files rm ${[...ids, ...v.q ? [`--q "${v.q}"`] : []].join(" ")}`;
+  const lista = table(rows, v.q ? ["id", "name", "size", "created"] : ["id"]);
+  if (!rows.length) return out({ deleted: [], failed: [] }, () => dim(t("Nothing matches.", "No hay nada que coincida.")));
+  if (v["dry-run"]) return out({ wouldDelete: rows }, () => `${lista}
+${dim(t("Dry run: nothing deleted.", "Simulaci\xF3n: no se borr\xF3 nada."))}
+${dim(applyHint(retry))}`);
+  await confirm(`${lista}
+${t(`Delete ${rows.length} file(s)?`, `\xBFBorro ${rows.length} archivo(s)?`)}`, { yes: v.yes, retry });
+  const deleted = [];
+  const failed = [];
+  for (const [i, f] of rows.entries()) {
+    try {
+      await api(`/api/v2/me/files/${enc4(f.id)}`, { method: "DELETE" });
+      deleted.push(f.id);
+      if (rows.length > 1) info(dim(`${i + 1}/${rows.length} ${f.name ?? f.id}`));
+    } catch (e) {
+      failed.push({ id: f.id, error: e instanceof Error ? e.message : String(e) });
+    }
+  }
+  out(
+    { deleted, failed },
+    () => `${lavender("\u2713")} ${t(`Deleted ${deleted.length}`, `Borrados ${deleted.length}`)}` + (failed.length ? `
+${red(t(`${failed.length} failed:`, `${failed.length} fallaron:`))}
+${failed.map((x) => `  ${x.id} ${dim(x.error)}`).join("\n")}` : "")
+  );
+  if (failed.length) throw new CliError(t(`${failed.length} file(s) not deleted.`, `${failed.length} archivo(s) sin borrar.`), EXIT.API);
+}
+async function meFiles(sub, arg, v, rest = []) {
+  const ex = "ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] | get <file-id> [--out FILE] | export [--out DIR] | upload <file> | rm <file-id>[,<file-id>\u2026] [--q TEXT] [--dry-run]";
   switch (sub) {
     case "export":
     case "download":
@@ -10909,13 +10952,11 @@ ${dim(t(`${(r.storage.usedBytes / 1e9).toFixed(2)} GB of ${r.storage.limitGb} GB
       out(r, () => `${lavender("\u2713")} ${t("Uploaded", "Subido")} ${r.name} (${r.id})`);
       return;
     }
-    case "rm": {
-      if (!arg) throw usage(t("Missing file id.", "Falta el id del archivo."), ex);
-      out(await api(`/api/v2/me/files/${enc4(arg)}`, { method: "DELETE" }) ?? { deleted: arg }, () => `${lavender("\u2713")} ${t("Deleted", "Borrado")} ${arg}`);
-      return;
-    }
+    case "rm":
+      return meFilesRm(fileIds([arg, ...rest]), v, ex);
     default:
-      throw usage(t(`Unknown files subcommand: ${sub ?? "(none)"}.`, `Subcomando de files desconocido: ${sub ?? "(ninguno)"}.`), ex);
+      throw usage(t(`Unknown files subcommand: ${sub ?? "(none)"}.`, `Subcomando de files desconocido: ${sub ?? "(ninguno)"}.`), `${ex}
+${t("Files in an agent's machine: ghosty files ls <agent>", "Archivos en la m\xE1quina de un agente: ghosty files ls <agente>")}`);
   }
 }
 async function meUsage() {
@@ -11237,7 +11278,7 @@ async function call(path2, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.87.0"}`
+        "user-agent": `ghosty-cli/${"0.89.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -12085,6 +12126,8 @@ function skipReason(r) {
     channel_off: ["WhatsApp channel off for this agent", "canal de WhatsApp apagado en este agente"],
     no_quota: ["out of balance", "sin saldo"],
     own_number: ["sent by another of our agent numbers (bot loop guard)", "lo mand\xF3 otro n\xFAmero nuestro con agente (guarda de bucle)"],
+    contact_off: ["the agent is turned off for this contact (whatsapp contacts --off)", "el agente est\xE1 apagado para este contacto (whatsapp contacts --off)"],
+    known_contact: ["contact wrote before --new-only was turned on (only new contacts get the agent)", "el contacto ya escrib\xEDa antes de --new-only (el agente s\xF3lo contesta a contactos nuevos)"],
     partner_token: ["partner did not issue a turn token", "el partner no dio token de turno"],
     partner_busy: ["partner at its concurrent-turn limit", "el partner lleg\xF3 a su tope de turnos a la vez"]
   };
@@ -12588,6 +12631,7 @@ async function channelsCmd(kind, sub, id, ref, v) {
   if (!id) throw usage(t("Missing agent id.", "Falta el id del agente."), t("Example", "Ejemplo") + ": ghosty channels whatsapp ls <agent-id>");
   if (sub === "link" || sub === "unlink") return linkCmd(sub, id, v);
   if (sub === "history") return historyCmd(id, v);
+  if (sub === "contacts") return contactsCmd(id, v);
   if (sub === "integrations" && v.orphans) return linksCmd(id, "waba", true);
   if (sub === "integrations") return integrationsCmd(id, v.email);
   if (sub === "import" || sub === "status" || sub === "pause" || sub === "pair") return waCmd2(sub, id, v);
@@ -12602,10 +12646,11 @@ 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")) : "",
+      "new only": n2.newOnly ? 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", "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}`)));
+    return out(cur, () => rows.length ? table(rows, ["number", "answers", "formmy forwards", "ads only", "new 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`);
@@ -12768,21 +12813,24 @@ 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 (v["new-only"] !== void 0 && v["new-only"] !== "on" && v["new-only"] !== "off") throw usage(t("--new-only takes on or off.", "--new-only acepta on u off."));
+  const newOnly = v["new-only"] === void 0 ? void 0 : v["new-only"] === "on";
+  const newOnlyFlag = v["new-only"] ? ` --new-only ${v["new-only"]}` : "";
   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) {
+  if (sub === "link" && (adsOnly !== void 0 || newOnly !== void 0 || board !== void 0) && v.answer === void 0) {
     const path3 = `/api/v2/agents/${enc11(id)}/whatsapp/link`;
-    const r2 = await api(path3, { method: "POST", body: { integrationId: v.integration, ...adsOnly !== void 0 ? { adsOnly } : {}, ...board !== void 0 ? { board } : {}, ...v["dry-run"] ? { dryRun: true } : {} } });
+    const r2 = await api(path3, { method: "POST", body: { integrationId: v.integration, ...adsOnly !== void 0 ? { adsOnly } : {}, ...newOnly !== void 0 ? { newOnly } : {}, ...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}${v["ads-only"] ? ` --ads-only ${v["ads-only"]}` : ""}${boardFlag}`))}` : ""}`);
+${dim(applyHint(`ghosty channels whatsapp link ${id} --integration ${v.integration}${v["ads-only"] ? ` --ads-only ${v["ads-only"]}` : ""}${newOnlyFlag}${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 path2 = `/api/v2/agents/${enc11(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 } : {}, ...board !== void 0 ? { board } : {}, ...partner } };
+  const body = { integrationId: v.integration, ...sub === "unlink" ? { unlink: true } : { answer: v.answer === "on", ...v.forward ? { forward: true } : {}, ...adsOnly !== void 0 ? { adsOnly } : {}, ...newOnly !== void 0 ? { newOnly } : {}, ...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"]}` : ""}${boardFlag}${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"]}` : ""}${newOnlyFlag}${boardFlag}${partnerFlags}` : ""}`;
   const plan = await api(path2, { 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})`)}`;
@@ -12951,6 +12999,23 @@ ${t(`Cards appear on the team's board (no "new lead" alerts).`, "Las tarjetas ap
   }
   out({ ...sum, conversations: done }, () => `${lavender("\u2713")} ${t(`${sum.newCards} new card(s), ${sum.updatedCards} updated, ${sum.messages} message(s), ${sum.orders} order(s)`, `${sum.newCards} tarjeta(s) nueva(s), ${sum.updatedCards} actualizada(s), ${sum.messages} mensaje(s), ${sum.orders} pedido(s)`)}${files(sum)}${sum.suppressed ? dim(t(` \xB7 ${sum.suppressed} bot draft(s) the customer never saw, skipped`, ` \xB7 se omitieron ${sum.suppressed} borrador(es) del bot que el cliente nunca vio`)) : ""}${pausedLine(sum, id)}`);
 }
+async function contactsCmd(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 contacts <agent-id> --integration <id> [--new-only on|off] [--mute PHONE] [--unmute PHONE] [--seed]");
+  if (v["new-only"] !== void 0 && v["new-only"] !== "on" && v["new-only"] !== "off") throw usage(t("--new-only takes on or off.", "--new-only acepta on u off."));
+  if (v.mute && v.unmute) throw usage(t("Use --mute or --unmute, not both.", "Usa --mute o --unmute, no los dos."));
+  const path2 = `/api/v2/agents/${enc11(id)}/whatsapp/contacts`;
+  const contact = v.mute ?? v.unmute;
+  const write = v["new-only"] !== void 0 || contact !== void 0 || v.seed;
+  const r = write ? await api(path2, { method: "POST", body: { number: v.integration, ...v["new-only"] !== void 0 ? { newOnly: v["new-only"] === "on" } : {}, ...contact !== void 0 ? { contact, off: !!v.mute } : {}, ...v.seed ? { seed: true } : {} } }) : await api(`${path2}?number=${enc11(v.integration)}`);
+  return out(r, () => {
+    const lines = [
+      `${t("New contacts only", "S\xF3lo contactos nuevos")}: ${r.newOnly ? lavender(t("on", "encendido")) : t("off", "apagado")}${r.newSince ? dim(` (${t("since", "desde")} ${r.newSince})`) : ""}`,
+      `${t("Known contacts", "Contactos conocidos")}: ${r.known}${r.seededAt ? dim(` (${t("brought from Formmy", "tra\xEDdos de Formmy")} ${r.seededAt})`) : dim(t(" (still waiting for the WhatsApp history)", " (todav\xEDa esperando el historial de WhatsApp)"))}`,
+      `${t("Contacts without the agent", "Contactos sin agente")}: ${r.off.length ? r.off.map((o) => o.name ? `${o.name} ${o.key}` : o.key).join(", ") : dim("\u2014")}`
+    ];
+    return lines.join("\n");
+  });
+}
 
 // src/commands/board.ts
 init_api();
@@ -13443,7 +13508,11 @@ var HELPS_ES = {
     ],
     notes: ["--skipped guarda 30 d\xEDas y s\xF3lo ve lo que Formmy reenvi\xF3: si Formmy no reenv\xEDa (ghosty channels whatsapp ls, \xABformmy forwards\xBB), a gs nunca le llega el mensaje.", "show imprime lo que entr\xF3 y lo que sali\xF3 en cualquier motor o canal (grupos de WhatsApp tambi\xE9n); la l\xEDnea de tiempo lee el transcript del worker, as\xED que s\xF3lo motores del pool (no ACP/goose).", "jobs es s\xF3lo lectura: las \xFAltimas 24 h de encargos en segundo plano de TUS chats personales, y si cada uno ya le lleg\xF3 al agente. Se detienen con turns cancel; lo que se repite a una hora es ghosty schedule add --every."]
   },
-  files: { summary: "Archivos en la m\xE1quina del agente." },
+  files: {
+    summary: "Archivos en la m\xE1quina del agente.",
+    flags: [["--session ID", "agentes de pool: la carpeta de esa conversaci\xF3n en su caja (adjuntos, lo que hizo) en vez de su conocimiento"]],
+    notes: ["Los archivos de TU cuenta (lo que subiste y lo que entregaron los agentes) son ghosty me files, no esto.", "--session nunca despierta una caja dormida; una caja reciclada vuelve vac\xEDa."]
+  },
   mcp: {
     summary: "Servidores MCP de un agente. set REEMPLAZA la lista entera; connect agrega uno remoto con su URL.",
     replace: [["# one remote server, OAuth in the browser if it asks", "# un servidor remoto; OAuth en el navegador si lo pide"]],
@@ -13575,14 +13644,15 @@ var HELPS_ES = {
     flags: [
       ["--out DIR", "export: carpeta destino (default ghosty-archivos); get: archivo donde guardarlo"],
       ["--kind K", "ls, export: s\xF3lo image | video | audio | document | other"],
-      ["-n, --dry-run", "export: cu\xE1ntos archivos y MB por carpeta, sin bajar nada"],
+      ["-n, --dry-run", "export: cu\xE1ntos archivos y MB por carpeta, sin bajar nada; rm: qu\xE9 borrar\xEDa"],
+      ["--q TEXT", "ls, rm: busca por nombre"],
       ["--rev N", "docs: trabaja sobre la versi\xF3n N (default: la \xFAltima; get las lista)"],
       ["--format pdf|md", "docs export: PDF (tama\xF1o carta, default) o Markdown"],
       ["--language L", "docs check: es (default), en-US, pt-BR o fr"],
       ["--block N / --segment S", "docs tts: la posici\xF3n del bloque (desde 0) y, si quieres, la frase dentro de \xE9l; la salida dice cu\xE1ntas frases tiene"]
     ],
     notes: [
-      "<doc> es el id del documento o la liga que da el agente (https://www.ghosty.studio/app/docs/<id>). No es lo mismo que agents docs (archivos que lee un agente) ni que ghosty docs (abre esta documentaci\xF3n).",
+      "<doc> es el id del documento o la liga que da el agente (https://www.ghosty.studio/app/docs/<id>). No es lo mismo que agents docs (archivos que lee un agente) ni que ghosty docs (abre esta documentaci\xF3n). me files es la biblioteca de tu cuenta; los archivos dentro de la m\xE1quina de un agente son ghosty files.",
       "Las memorias viajan a tus agentes s\xF3lo en tus chats personales (app, /c, notch), nunca a WhatsApp, Messenger ni demos.",
       "export baja TODO lo de tu cuenta: documentos, archivos de tus chats y de los canales de tus agentes (lo que mandaron los clientes). Lo ya bajado con el mismo tama\xF1o se salta, as\xED que repetirlo s\xF3lo trae lo nuevo."
     ]
@@ -13618,6 +13688,8 @@ 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)"],
+      ["--new-only on|off", "link: el agente s\xF3lo contesta a contactos que escriben por primera vez desde ahora; los de antes quedan en el hilo para ti (tambi\xE9n solo)"],
+      ["contacts <id> --integration ID", "s\xF3lo contactos nuevos y contactos sin agente: --new-only on|off, --mute TEL (el agente nunca le contesta a ese n\xFAmero), --unmute TEL, --seed (vuelve a traer los contactos conocidos de WhatsApp)"],
       ["--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"],
@@ -14237,8 +14309,10 @@ var HELPS = {
   },
   files: {
     summary: "Files in the agent's machine.",
-    usage: ["ghosty files ls <agent-id> [dir]", "ghosty files get <agent-id> <path> [--out LOCAL]", "ghosty files put <agent-id> <path> [--file LOCAL | < stdin]", "ghosty files rm <agent-id> <path> [--yes]"],
-    examples: ["ghosty files put <id> knowledge/precios.md --file precios.md", "cat notas.md | ghosty files put <id> notas.md"],
+    usage: ["ghosty files ls <agent-id> [dir] [--session <id>]", "ghosty files get <agent-id> <path> [--out LOCAL] [--session <id>]", "ghosty files put <agent-id> <path> [--file LOCAL | < stdin]", "ghosty files rm <agent-id> <path> [--yes] [--session <id>]"],
+    examples: ["ghosty files put <id> knowledge/precios.md --file precios.md", "cat notas.md | ghosty files put <id> notas.md", "ghosty files ls <id> adjuntos --session <conversation-id>"],
+    flags: [["--session ID", "pool agents: that conversation's folder in its box (attachments, what it made) instead of its knowledge files"]],
+    notes: ["The files in YOUR account (what you uploaded and what agents delivered) are ghosty me files, not this.", "--session never wakes a paused box; a recycled box comes back empty."],
     learn: `${REF}#archivos`
   },
   mcp: {
@@ -14411,7 +14485,8 @@ var HELPS = {
       "ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]",
       "ghosty me files get <file-id> [--out FILE]",
       "ghosty me files export [--out DIR] [--kind K] [--dry-run]",
-      "ghosty me files upload <file> | rm <file-id>",
+      "ghosty me files upload <file>",
+      "ghosty me files rm <file-id>[,<file-id>\u2026] [--q TEXT] [--dry-run] [--yes]",
       'ghosty me memories ls | add "text" | edit <id> "text" | rm <id>',
       "ghosty me docs ls [--q TEXT]   # your editable docs (id, title, conversation)",
       "ghosty me docs get <doc> [--rev N]   # an editable doc an agent wrote (/app/docs/<id>): title and versions",
@@ -14421,18 +14496,19 @@ var HELPS = {
       "ghosty me docs restore <doc> <n>   # version n back as a new version",
       "ghosty usage"
     ],
-    examples: ["ghosty me files ls --kind document", "ghosty me files ls --q contrato", "ghosty me files get <id> --out contrato.pdf", "ghosty me files export --dry-run", "ghosty me files export --out respaldo/   # documents/, conversations/, library/", 'ghosty chat <agent> "res\xFAmelo" --file <id>', 'ghosty me memories add "I prefer short answers"', "ghosty me docs export https://www.ghosty.studio/app/docs/<id> --format md > propuesta.md", "ghosty me docs check <id> --json"],
+    examples: ["ghosty me files ls --kind document", "ghosty me files ls --q contrato", "ghosty me files rm --q cookies --dry-run", "ghosty me files get <id> --out contrato.pdf", "ghosty me files export --dry-run", "ghosty me files export --out respaldo/   # documents/, conversations/, library/", 'ghosty chat <agent> "res\xFAmelo" --file <id>', 'ghosty me memories add "I prefer short answers"', "ghosty me docs export https://www.ghosty.studio/app/docs/<id> --format md > propuesta.md", "ghosty me docs check <id> --json"],
     flags: [
       ["--out DIR", "export: destination folder (default ghosty-archivos); get: file to save"],
       ["--kind K", "ls, export: only image | video | audio | document | other"],
-      ["-n, --dry-run", "export: how many files and MB per folder, without downloading"],
+      ["-n, --dry-run", "export: how many files and MB per folder, without downloading; rm: what it would delete"],
+      ["--q TEXT", "ls, rm: search by name"],
       ["--rev N", "docs: work on version N (default: the latest; get lists them)"],
       ["--format pdf|md", "docs export: PDF (letter size, default) or Markdown"],
       ["--language L", "docs check: es (default), en-US, pt-BR or fr"],
       ["--block N / --segment S", "docs tts: the block's position (from 0) and, optionally, the sentence inside it; the output says how many sentences it has"]
     ],
     notes: [
-      "<doc> is the doc's id or the link the agent gives (https://www.ghosty.studio/app/docs/<id>). Not the same as agents docs (files an agent reads) or ghosty docs (opens this documentation).",
+      "<doc> is the doc's id or the link the agent gives (https://www.ghosty.studio/app/docs/<id>). Not the same as agents docs (files an agent reads) or ghosty docs (opens this documentation). me files is your account library; the files inside an agent's machine are ghosty files.",
       "Memories travel to your agents only in your personal chats (app, /c, notch), never to WhatsApp, Messenger or demo threads.",
       "export brings EVERYTHING in your account: documents, files from your chats and from your agents' channels (what customers sent). A file already downloaded with the same size is skipped, so rerunning it only brings what's new."
     ],
@@ -14505,6 +14581,8 @@ 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)"],
+    ["--new-only on|off", "link: the agent answers only contacts writing for the first time from now on; earlier contacts stay in the thread for you (also alone)"],
+    ["contacts <id> --integration ID", "new contacts only and contacts without the agent: --new-only on|off, --mute PHONE (the agent never answers that number), --unmute PHONE, --seed (bring the known contacts from WhatsApp again)"],
     ["--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"],
@@ -16985,7 +17063,8 @@ ${bold("Configure an agent")}
   channels messenger status <id>         Each page: who answers, last webhook and token health (asks Meta now)
   channels messenger on|off <id> <page>  Answer a page with this agent, or stop (off keeps logging to the board)   [--take --dry-run --yes]
   channels mteams ls|connect|zip|on|off|rm <id> [bot]   Microsoft Teams bot (Azure Bot in the client's tenant)   [--app-id --tenant --secret|GHOSTY_MTEAMS_SECRET --name --out]
-  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 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] [--new-only on|off] [--board NAME|agent] [--dry-run]
+  channels whatsapp contacts <id> --integration ID   New contacts only (the agent skips the people you already talk to) and contacts without the agent   [--new-only on|off] [--mute PHONE] [--unmute PHONE] [--seed]
   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)
@@ -17203,7 +17282,8 @@ ${bold("Configurar un agente")}
   channels messenger status <id>         Cada p\xE1gina: qui\xE9n contesta, \xFAltimo webhook y salud del token (le pregunta a Meta en el momento)
   channels messenger on|off <id> <p\xE1gina>   Que este agente conteste una p\xE1gina, o que deje de hacerlo (off sigue registrando en el tablero)   [--take --dry-run --yes]
   channels mteams ls|connect|zip|on|off|rm <id> [bot]   Bot de Microsoft Teams (Azure Bot en el tenant del cliente)   [--app-id --tenant --secret|GHOSTY_MTEAMS_SECRET --name --out]
-  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 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] [--new-only on|off] [--board NOMBRE|agent] [--dry-run]
+  channels whatsapp contacts <id> --integration ID   S\xF3lo contactos nuevos (el agente no le contesta a tu gente de siempre) y contactos sin agente   [--new-only on|off] [--mute TEL] [--unmute TEL] [--seed]
   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)
@@ -17586,6 +17666,10 @@ async function main() {
       publish: { type: "boolean" },
       draft: { type: "boolean" },
       "ads-only": { type: "string" },
+      "new-only": { type: "string" },
+      mute: { type: "string" },
+      unmute: { type: "string" },
+      seed: { type: "boolean" },
       "partner-tenant": { type: "string" },
       ref: { type: "string", multiple: true },
       "style-ref": { type: "string", multiple: true },
@@ -17628,7 +17712,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.87.0" }, () => "0.87.0");
+  if (v.version) return out({ version: "0.89.0" }, () => "0.89.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -17816,7 +17900,7 @@ async function main() {
       }
       return planCmd(sub, a1, v, context);
     case "me":
-      if (sub === "files") return meFiles(a1, a2, v);
+      if (sub === "files") return meFiles(a1, a2, v, pos.slice(4));
       if (sub === "memories" || sub === "memory") return meMemories(a1, a2, pos[4]);
       if (sub === "usage") return meUsage();
       if (sub === "docs") return meDocs(a1, a2, pos[4], v);
@@ -17831,10 +17915,10 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.87.0").catch(() => null);
+var notice = updateNotice("0.89.0").catch(() => null);
 main().then(
   async () => {
-    const n = await notice;
+    const n = process.stderr.isTTY ? await notice : null;
     if (n) info(dim(n));
     return exitAfterFlush(EXIT.OK);
   },

package/package.json

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