@ghostystudio/cli 0.29.0 → 0.30.0

package/README.md

@@ -72,7 +72,13 @@ ghosty schedule ls <id>
 ghosty schedule rm <id> <schedule-id>
 ghosty schedule add|ls|rm <id> … --teams <workspace>#<room>[/<thread-id>]   # in a Teams room/thread: it answers there as if mentioned
 
-ghosty me files ls|upload|rm             [--kind image|video|audio|document|other]
+ghosty me files ls|get|upload|rm         [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]
+ghosty conversations archive|rm <id> --kind test|channel [--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
+ghosty turns stats [--since 14d] [--all] · push log --user EMAIL [--since 2d]
+ghosty novedades ls|create|set|test|send|rm   [--title] [--body] [--image FILE] [--link] [--to] [--publish] [--at]
 ghosty credentials ls|set|rm [provider]  [--from-env VAR]   # never as an argument
 ghosty docs
 
@@ -89,6 +95,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.30.0
+
+- Support (Ghosty staff): `conversations ls --user EMAIL`, `conversations show <agent> <conv> --why` (who sees it and why), `turns stats` (real failure rate), `push log --user EMAIL`, `novedades ls|create|set|test|send|rm` (Android app announcements, `--image FILE`).
+- `conversations archive|rm <agent> --kind test|channel [--before 7d]`: clean an agent's history (rm: tests only). Deleting an agent now also deletes its chat copy.
+- `agents docs dedupe`: merge your documents with the same content (keeps every agent's access); `dedupe <keep> <drop>` for two by hand.
+- `me files ls --q TEXT [--cursor]`, `me files get <id> [--out]`, `chat --file <id>` (attach from your files).
+- `channels wa groups set <agent> <group> --name "…"`.
+
 ### Changes in 0.29.0
 
 - `agents ls --engine E --ids` (ids only, for `xargs`); staff: `agents ls --sponsor EMAIL | --owner EMAIL` lists any account's agents, and `agents get|set|box` work on them by id (logged).

package/dist/index.js

@@ -8020,6 +8020,30 @@ var SERVER_MESSAGES = [
   ["pon al menos un filtro: sponsor, owner, workspace o engine", "add at least one filter: sponsor, owner, workspace or engine"],
   ["no hay una cuenta con ese correo", "there's no account with that email"],
   ["files: [{ name, mimeType, data (base64) }], hasta 8 de 10 MB", "files: [{ name, mimeType, data (base64) }], up to 8 of 10 MB"],
+  ["leer los hilos de otra persona: s\xF3lo el staff de Ghosty", "reading another person's conversations: Ghosty staff only"],
+  ["leer un hilo ajeno: s\xF3lo el staff de Ghosty", "reading someone else's conversation: Ghosty staff only"],
+  ["la salud de los turnos: s\xF3lo el staff de Ghosty", "turn health: Ghosty staff only"],
+  ["la bit\xE1cora de push: s\xF3lo el staff de Ghosty", "the push log: Ghosty staff only"],
+  ["las novedades de la app: s\xF3lo el staff de Ghosty", "app announcements: Ghosty staff only"],
+  ["falta user (correo)", "missing user (email)"],
+  ["no hay una cuenta con el correo {}", "there's no account with the email {}"],
+  ["limpiar el historial: due\xF1o, admin del agente o staff", "cleaning the history: the agent's owner, admin or staff"],
+  ["los hilos de cliente (channel) se archivan, no se borran: su memoria es la que los sigue atendiendo", "customer threads (channel) are archived, not deleted: their memory is what keeps serving them"],
+  ["kind: test | channel", "kind: test | channel"],
+  ["action: archive | rm", "action: archive | rm"],
+  ["before: 7d, 12h o una fecha ISO", "before: 7d, 12h or an ISO date"],
+  ["keep y drop van juntos", "keep and drop go together"],
+  ["los dos documentos tienen que ser tuyos y existir", "both documents must exist and be yours"],
+  ["es el mismo documento", "it's the same document"],
+  ["no se pudo borrar el duplicado", "couldn't delete the duplicate"],
+  ["t\xEDtulo y cuerpo son obligatorios", "title and body are required"],
+  ["Esa imagen ya la usa \xAB{}\xBB. Cada novedad lleva la suya.", "That image is already used by \xAB{}\xBB. Each announcement needs its own."],
+  ["Elige una hora futura.", "Pick a future time."],
+  ["S\xF3lo de 9 a 21 h (CDMX).", "Only from 9 to 21 h (CDMX)."],
+  ["Publ\xEDcala primero.", "Publish it first."],
+  ["Esta novedad ya se mand\xF3.", "This announcement was already sent."],
+  ["no hay novedad {}", "no announcement {}"],
+  ["lista, b\xFAsqueda y push: s\xF3lo kind=personal de quien lo abri\xF3; por liga: el suyo, y el due\xF1o/admin lee los de canal y prueba", "list, search and push: only kind=personal of whoever opened it; by link: their own, and the owner/admin reads channel and test threads"],
   // — Infra interna (casi nunca llega al CLI, pero por si acaso)
   ["SESSION_SECRET ausente en producci\xF3n \u2014 las cookies quedar\xEDan firmadas con un valor p\xFAblico. Inyectarlo con ./scripts/set_gs_secret.sh SESSION_SECRET (openssl rand -hex 32).", "SESSION_SECRET missing in production \u2014 cookies would be signed with a public value. Inject it with ./scripts/set_gs_secret.sh SESSION_SECRET (openssl rand -hex 32)."],
   ["sqld: fetch sin namespace", "sqld: fetch without namespace"],
@@ -8322,7 +8346,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.29.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.30.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8364,7 +8388,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.29.0"}`,
+      "user-agent": `ghosty-cli/${"0.30.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -8443,12 +8467,12 @@ var enc = encodeURIComponent;
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 var MIME = { jpg: "image/jpeg", jpeg: "image/jpeg", png: "image/png", webp: "image/webp", gif: "image/gif", pdf: "application/pdf", ogg: "audio/ogg", opus: "audio/ogg", mp3: "audio/mpeg", m4a: "audio/mp4", wav: "audio/wav", mp4: "video/mp4" };
 async function localFiles(paths) {
-  const { readFile: readFile13 } = await import("node:fs/promises");
+  const { readFile: readFile14 } = await import("node:fs/promises");
   const { basename: basename4 } = await import("node:path");
   return Promise.all(
     paths.map(async (p) => {
       const ext = p.toLowerCase().split(".").pop() ?? "";
-      return { name: basename4(p), mimeType: MIME[ext] ?? "application/octet-stream", data: (await readFile13(p)).toString("base64") };
+      return { name: basename4(p), mimeType: MIME[ext] ?? "application/octet-stream", data: (await readFile14(p)).toString("base64") };
     })
   );
 }
@@ -9067,7 +9091,7 @@ function capacityLine(c) {
 // src/commands/chat.ts
 import { randomUUID } from "node:crypto";
 import { createInterface as createInterface2 } from "node:readline/promises";
-import { readFile as readFile4 } from "node:fs/promises";
+import { readFile as readFile4, writeFile as writeFile4 } from "node:fs/promises";
 import { basename as basename2 } from "node:path";
 
 // src/sse.ts
@@ -9177,7 +9201,10 @@ async function chat(agent, message, v) {
     first = true;
     if (!globals.json) info(dim(t(`conversation ${sid}  (continue it with --conversation ${sid})`, `conversaci\xF3n ${sid}  (s\xEDguela con --conversation ${sid})`)));
   }
-  const images = v.media?.length ? await localFiles(v.media) : [];
+  const images = [
+    ...v.media?.length ? await localFiles(v.media) : [],
+    ...(v.file ?? "").split(",").map((x) => x.trim()).filter(Boolean).map((fileId) => ({ fileId }))
+  ];
   if (message || images.length) {
     await turn(agent, sid, message ?? "", first, images);
     return;
@@ -9211,9 +9238,20 @@ async function readAll() {
   return s;
 }
 async function meFiles(sub, arg, v) {
-  const ex = "ghosty me files ls [--kind image|video|audio|document|other] | upload <file> | rm <file-id>";
+  const ex = "ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] | get <file-id> [--out FILE] | upload <file> | rm <file-id>";
   switch (sub) {
     case "ls": {
+      if (v.q !== void 0 || v.cursor) {
+        const q = new URLSearchParams({ q: v.q ?? "", ...v.kind ? { kind: v.kind } : {}, ...v.cursor ? { cursor: v.cursor } : {}, ...v.limit ? { limit: v.limit } : {} });
+        const r2 = await api(`/api/v2/me/files?${q}`);
+        out(r2, () => {
+          const rows = r2.files.map((f) => ({ id: f.id, name: f.name, kind: f.kind, size: f.size, created: f.createdAt.slice(0, 10) }));
+          return `${table(rows, ["id", "name", "kind", "size", "created"])}${r2.nextCursor ? `
+${dim(t(`More: ghosty me files ls --q "${v.q ?? ""}" --cursor ${r2.nextCursor}`, `M\xE1s: ghosty me files ls --q "${v.q ?? ""}" --cursor ${r2.nextCursor}`))}` : ""}
+${dim(t('Attach one in a chat: ghosty chat <agent> "\u2026" --file <id>', 'Adj\xFAntalo en un chat: ghosty chat <agente> "\u2026" --file <id>'))}`;
+        });
+        return;
+      }
       const r = await api(
         `/api/v2/me/files${v.kind ? `?kind=${enc3(v.kind)}` : ""}`
       );
@@ -9224,6 +9262,18 @@ ${dim(t(`${(r.storage.usedBytes / 1e9).toFixed(2)} GB of ${r.storage.limitGb} GB
       });
       return;
     }
+    case "get": {
+      if (!arg) throw usage(t("Missing file id.", "Falta el id del archivo."), ex);
+      const r = await api(`/api/v2/me/files/${enc3(arg)}`);
+      if (v.out) {
+        const res = await fetch(r.url);
+        if (!res.ok) throw new CliError(`${res.status} ${t("downloading the file", "al bajar el archivo")}`, EXIT.API);
+        const bytes = Buffer.from(await res.arrayBuffer());
+        await writeFile4(v.out, bytes);
+        return out({ id: arg, saved: v.out, bytes: bytes.length }, () => `${lavender("\u2713")} ${v.out} (${bytes.length} bytes)`);
+      }
+      return out(r, () => r.url);
+    }
     case "upload": {
       if (!arg) throw usage(t("Missing file.", "Falta el archivo."), ex);
       const bytes = await readFile4(arg);
@@ -9378,7 +9428,7 @@ ${dim(`${t("conversation", "conversaci\xF3n")} ${p.sessionId}`)}`
 
 // src/commands/partner.ts
 import { createHmac } from "node:crypto";
-import { readFile as readFile5, writeFile as writeFile4 } from "node:fs/promises";
+import { readFile as readFile5, writeFile as writeFile5 } from "node:fs/promises";
 var partnerHelp = () => t(
   `${bold("Usage:")} ghosty partner <command> [options]
 
@@ -9465,7 +9515,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.29.0"}`
+        "user-agent": `ghosty-cli/${"0.30.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -9489,7 +9539,7 @@ GHOSTY_PARTNER_KEY_SECRET=${r.secret}
 `;
 async function showSecret(r, v) {
   if (v["env-file"]) {
-    await writeFile4(v["env-file"], envLines(r), { mode: 384 });
+    await writeFile5(v["env-file"], envLines(r), { mode: 384 });
     return out({ keyId: r.keyId, envFile: v["env-file"] }, () => `${lavender("\u2713")} ${r.keyId} ${t(`\u2192 ${v["env-file"]} (mode 600; the secret was not printed)`, `\u2192 ${v["env-file"]} (modo 600; el secreto no se imprimi\xF3)`)}`);
   }
   if (v.format === "env") return void process.stdout.write(envLines(r));
@@ -9892,8 +9942,29 @@ ${dim(`${t(`${rows.length} row(s)`, `${rows.length} fila(s)`)} \xB7 ${Math.round
       throw usage(t(`Unknown dbs subcommand: ${sub}.`, `Subcomando de dbs desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty dbs ls | tables | query | import | rehost | grant | revoke | rename | rm   (ghosty dbs --help)");
   }
 }
+async function docsDedupe(v) {
+  const path = "/api/v2/me/documents/dedupe";
+  const pair = v.keep || v.drop ? { keep: v.keep, drop: v.drop } : {};
+  const plan = await api(path, { method: "POST", body: { ...pair, dryRun: true } });
+  const name = (d) => typeof d === "string" ? d : `\xAB${d.name}\xBB ${dim(`${d.id.slice(0, 10)} \xB7 ${d.agents} ${t("agent(s)", "agente(s)")}`)}`;
+  const text = [
+    ...plan.merges.map((m) => `${t("keep", "queda")} ${name(m.keep)}
+${m.drop.map((d) => `  - ${name(d)}`).join("\n")}`),
+    ...plan.sameName?.length ? ["", dim(t("Same name, different content (not merged; if they're the same: ghosty agents docs dedupe <keep-id> <drop-id>):", "Mismo nombre, otro contenido (no se unen; si s\xED son el mismo: ghosty agents docs dedupe <id-que-queda> <id-que-se-va>):")), ...plan.sameName.map((g) => `  ${g.map(name).join("  \xB7  ")}`)] : []
+  ].join("\n");
+  if (!plan.merges.length) return out(plan, () => text.trim() ? text : dim(t("No duplicate documents.", "Sin documentos duplicados.")));
+  if (v["dry-run"]) return out(plan, () => `${text}
+${dim(t("Dry run: nothing changed.", "Simulaci\xF3n: no cambi\xF3 nada."))}`);
+  const retry = `ghosty agents docs dedupe${v.keep ? ` ${v.keep} ${v.drop ?? ""}` : ""}`;
+  requireYesIfHeadless(v.yes, retry);
+  await confirm(`${text}
+${t("Merge? The extra copies are deleted and their agents keep access through the one that stays.", "\xBFUnir? Las copias sobrantes se borran y sus agentes siguen leyendo por la que queda.")}`, { yes: v.yes, retry });
+  const r = await api(path, { method: "POST", body: pair });
+  out(r, () => `${lavender("\u2713")} ${t(`${r.merged} duplicate(s) merged \xB7 ${r.grantsMoved} permission(s) moved.`, `${r.merged} duplicado(s) unido(s) \xB7 ${r.grantsMoved} permiso(s) movido(s).`)}`);
+}
 async function agentDocsCmd(sub, id, docs, v) {
   let doc = docs[0];
+  if (sub === "dedupe") return docsDedupe(v);
   id = need2(id, t("agent id", "el id del agente"), "ghosty agents docs ls <agent-id>");
   switch (sub ?? "ls") {
     case "ls":
@@ -10290,7 +10361,7 @@ function findGroup(groups, ref) {
 }
 async function groupsCmd(args, v) {
   const [sub, id, ...rest] = args;
-  const ex = 'ghosty channels wa groups ls <agent-id> | set <agent-id> <group> [--role equipo|cliente] [--on|--off] | create <agent-id> "Name"';
+  const ex = 'ghosty channels wa groups ls <agent-id> | set <agent-id> <group> [--role equipo|cliente] [--on|--off] [--name "New name"] | create <agent-id> "Name"';
   if (!id) throw usage(t("Missing agent id.", "Falta el id del agente."), `${t("Example", "Ejemplo")}: ${ex}`);
   const path = `/api/v2/agents/${enc7(id)}/wa/groups`;
   if (v.role !== void 0 && v.role !== "equipo" && v.role !== "cliente") throw usage(t("--role takes equipo or cliente.", "--role acepta equipo o cliente."));
@@ -10300,10 +10371,10 @@ async function groupsCmd(args, v) {
     return out(r2, () => rows.length ? table(rows, ["name", "on", "role", "jid"]) : dim(t('No groups. Pair its personal WhatsApp in the web, or: ghosty channels wa groups create <agent-id> "Name"', 'Sin grupos. Parea su WhatsApp personal en la web, o: ghosty channels wa groups create <agent-id> "Nombre"')));
   }
   if (sub === "create") {
-    const name = rest.join(" ").trim();
-    if (!name) throw usage(t("Missing group name.", "Falta el nombre del grupo."), t("Example", "Ejemplo") + `: ghosty channels wa groups create ${id} "Equipo ventas" --role equipo`);
-    const r2 = await api(path, { method: "POST", body: { create: name, role: v.role ?? "equipo" } });
-    return out(r2, () => `${lavender("\u2713")} ${t("Created", "Creado")} ${bold(name)} (${v.role ?? "equipo"}, on)
+    const name2 = rest.join(" ").trim();
+    if (!name2) throw usage(t("Missing group name.", "Falta el nombre del grupo."), t("Example", "Ejemplo") + `: ghosty channels wa groups create ${id} "Equipo ventas" --role equipo`);
+    const r2 = await api(path, { method: "POST", body: { create: name2, role: v.role ?? "equipo" } });
+    return out(r2, () => `${lavender("\u2713")} ${t("Created", "Creado")} ${bold(name2)} (${v.role ?? "equipo"}, on)
   ${t("invite", "invitaci\xF3n")}: ${r2.inviteUrl}`);
   }
   if (sub !== "set") throw usage(t(`Unknown groups subcommand: ${sub}.`, `Subcomando de groups desconocido: ${sub}.`), ex);
@@ -10314,16 +10385,17 @@ async function groupsCmd(args, v) {
   const g = findGroup(cur.groups, ref);
   const enabled = v.on ? true : v.off ? false : g.enabled;
   const role = v.role ?? g.role;
-  const changes = [...enabled !== g.enabled ? [`${g.enabled ? "on" : "off"}\u2192${enabled ? "on" : "off"}`] : [], ...role !== g.role ? [`${g.role}\u2192${role}`] : []];
+  const name = v.name?.trim() || void 0;
+  const changes = [...enabled !== g.enabled ? [`${g.enabled ? "on" : "off"}\u2192${enabled ? "on" : "off"}`] : [], ...role !== g.role ? [`${g.role}\u2192${role}`] : [], ...name && name !== g.name ? [`\xAB${g.name}\xBB\u2192\xAB${name}\xBB`] : []];
   if (!changes.length) return out({ changed: 0, group: g }, () => dim(t(`Nothing to do: ${g.name} is already ${g.enabled ? "on" : "off"} as ${g.role}.`, `Nada que hacer: ${g.name} ya est\xE1 ${g.enabled ? "encendido" : "apagado"} como ${g.role}.`)));
   const plan = `~ ${g.name}: ${changes.join(", ")}`;
   if (v["dry-run"]) return out({ dryRun: true, plan: [plan] }, () => `${plan}
 ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
   if (enabled && !g.enabled) await confirm(`${bold(plan)}
 ${t(`The agent will start answering in this group as ${role}.`, `El agente empezar\xE1 a contestar en este grupo como ${role}.`)}`, { yes: v.yes, retry: `ghosty channels wa groups set ${id} "${ref}"${v.role ? ` --role ${v.role}` : ""} --on` });
-  const r = await api(path, { method: "POST", body: { jid: g.jid, enabled, role } });
+  const r = await api(path, { method: "POST", body: { jid: g.jid, enabled, role, ...name ? { name } : {} } });
   const now = r.groups.find((x) => x.jid === g.jid);
-  return out({ group: now ?? null, plan: [plan] }, () => `${lavender("\u2713")} ${g.name}: ${now?.enabled ? "on" : "off"} ${t("as", "como")} ${now?.role ?? role}`);
+  return out({ group: now ?? null, plan: [plan] }, () => `${lavender("\u2713")} ${now?.name ?? g.name}: ${now?.enabled ? "on" : "off"} ${t("as", "como")} ${now?.role ?? role}`);
 }
 var EB_EXPORT = (agentId) => `${(process.env.EASYBITS_URL ?? "https://www.easybits.cloud").replace(/\/+$/, "")}/api/v2/fleet-agents/${enc7(agentId)}/baileys/export`;
 async function easybitsSession(agentId, keys) {
@@ -10633,6 +10705,7 @@ var HELPS_ES = {
     summary: "Crea, revisa, cambia, diagnostica y borra agentes.",
     replace: [
       ["# the agent as a file; see ghosty apply --help", "# el agente como archivo; ver ghosty apply --help"],
+      ["# your account: merge copies with the same content", "# tu cuenta: une las copias con el mismo contenido"],
       ["# what it really has: effective toolsets, connectors connected + granted", "# lo que de verdad tiene: toolsets efectivos, conectores conectados + concedidos"]
     ],
     flags: [
@@ -10733,7 +10806,7 @@ var HELPS_ES = {
   },
   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.",
-    replace: [["# last turn: each tool, its seconds, output tokens", "# \xFAltimo turno: cada tool, sus segundos, tokens de salida"], ["# stop the turn AND its background jobs", "# detiene el turno Y sus encargos en fondo"]],
+    replace: [["# last turn: each tool, its seconds, output tokens", "# \xFAltimo turno: cada tool, sus segundos, tokens de salida"], ["# stop the turn AND its background jobs", "# detiene el turno Y sus encargos en fondo"], ["# staff: real failure rate by engine and error", "# staff: tasa real de fallos por motor y por error"]],
     flags: [
       ["--errors", "s\xF3lo turnos fallidos (igual que --status error)"],
       ["--skipped", "ls: mensajes de clientes de WhatsApp Business que NO abrieron turno, y por qu\xE9 (operador activo, s\xF3lo registra, pausa, reacci\xF3n, canal apagado, sin saldo)"],
@@ -10742,6 +10815,7 @@ var HELPS_ES = {
       ["--limit N", "m\xE1ximo de filas (default 20, m\xE1x. 500)"],
       ["--full", "show: el mensaje que entr\xF3 y la respuesta completos (default: primeros 600 caracteres)"],
       ["--quota-hits", "ls --workspace: mensajes (WhatsApp Business y Teams) que no abrieron turno porque se acab\xF3 el saldo"],
+      ["--all", "stats (staff): cuenta tambi\xE9n staff, canal prueba y agentes borrados"],
       ["--session S", "ls: s\xF3lo los turnos de esa conversaci\xF3n. Los de Claude dicen \xABresumed\xBB: \u2713 = retom\xF3 la sesi\xF3n del SDK, \u26A0 desde cero (orphan|stale|replaced) = perdi\xF3 la memoria"]
     ],
     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)."]
@@ -10773,7 +10847,15 @@ var HELPS_ES = {
   },
   chat: {
     summary: "Conversa en streaming; sin mensaje es interactivo.",
-    replace: [['["message"]', '["mensaje"]']]
+    replace: [['["message"]', '["mensaje"]'], ["# staff: who sees it and why", "# staff: qui\xE9n lo ve y por qu\xE9"]],
+    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)"],
+      ["--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"]
+    ]
   },
   schedule: {
     summary: "Turnos que corren despu\xE9s, con el reloj propio del agente.",
@@ -10798,6 +10880,7 @@ var HELPS_ES = {
       ["--yes", "enable / groups enable: se salta la confirmaci\xF3n (obligatorio sin terminal)"],
       ["--role R", "groups: equipo (el equipo: escribe en bases de datos, tools de admin) o cliente (como cualquier cliente)"],
       ["--cached", "groups ls: no le pide a WhatsApp la lista en vivo (m\xE1s r\xE1pido; puede faltar alg\xFAn grupo nuevo)"],
+      ["--name N", "groups set: el nombre con que lo ve gs (p. ej. un grupo guardado con su jid de nombre); el asunto en WhatsApp no cambia"],
       ["--integration ID", "link/unlink/history: el id de la Integration del n\xFAmero de WhatsApp Business en Formmy"],
       ["--email E", "integrations (staff): lista los n\xFAmeros de otra cuenta de Formmy"],
       ["--days N", "history: conversaciones activas en los \xFAltimos N d\xEDas (1-30, default 7)"],
@@ -10945,6 +11028,14 @@ var HELPS_ES = {
     ],
     notes: ["try cuenta contra los topes del demo (mensajes por visitante, por IP al d\xEDa) y sale en sus n\xFAmeros y en el CRM.", "history es s\xF3lo para staff de Ghosty: los chats de los visitantes no se le ense\xF1an al due\xF1o."]
   },
+  push: {
+    summary: "Staff de Ghosty: qu\xE9 avisos (push) se le mandaron a alguien (fin de turno, permiso, escalar, documento\u2026), a qu\xE9 dispositivo y qu\xE9 contest\xF3 Apple/Google. Se registran desde el 1-oct y se guardan 30 d\xEDas.",
+    notes: ["thread ense\xF1a la clase de la conversaci\xF3n: un \xABchannel\xBB ah\xED es que le lleg\xF3 el aviso de un cliente."]
+  },
+  novedades: {
+    summary: "Staff de Ghosty: las novedades de la app Android. Cada una con su ilustraci\xF3n; mismos frenos que el admin: pru\xE9bala en tu tel\xE9fono primero, push de 9 a 21 h CDMX, 72 h entre env\xEDos a todos.",
+    notes: ["--image se publica en img.ghosty.studio (WebP 1200 px). --to vac\xEDo = todos. send sin --at la manda ya (pregunta); --at '' quita la programaci\xF3n."]
+  },
   spaces: {
     summary: "Operaciones del staff de Ghosty sobre un espacio: mover \xABpagado hasta\xBB y renombrar su slug. Cada una queda en la bit\xE1cora del espacio.",
     flags: [
@@ -10975,6 +11066,7 @@ var HELPS = {
       "ghosty agents doctor <agent-id> [--verbose]",
       "ghosty agents docs ls|grant|revoke <agent-id> [doc\u2026] [--write] [--no-deliver] [--like AGENT]",
       "ghosty agents docs add <agent-id> --url URL | --file PATH [--name N] [--description TEXT] [--grant read|write|no] [--no-deliver]",
+      "ghosty agents docs dedupe [<keep-id> <drop-id>] [--dry-run]   # your account: merge copies with the same content",
       "ghosty agents docs replace <agent-id> <doc> --url URL | --file PATH [--note TEXT]   # new version: keeps name, access and the agents that use it",
       "ghosty agents docs history|restore <agent-id> <doc> [n]",
       "ghosty agents share <agent-id> <email> [--role editor|admin]",
@@ -11141,7 +11233,7 @@ var HELPS = {
   },
   turns: {
     summary: "An agent's recent turns: what answered, what failed and why, and where one turn's time went.",
-    usage: ["ghosty turns ls <agent-id> [--errors | --status STATE | --skipped] [--since 1h] [--limit N]", "ghosty turns ls --workspace <slug> --quota-hits [--days 14]", "ghosty turns show <agent-id> [turn-id | last] [--full]", "ghosty turns cancel <agent-id> <conversation-id>   # stop the turn AND its background jobs"],
+    usage: ["ghosty turns ls <agent-id> [--errors | --status STATE | --skipped] [--since 1h] [--limit N]", "ghosty turns ls --workspace <slug> --quota-hits [--days 14]", "ghosty turns show <agent-id> [turn-id | last] [--full]", "ghosty turns cancel <agent-id> <conversation-id>   # stop the turn AND its background jobs", "ghosty turns stats [--since 14d] [--all]   # staff: real failure rate by engine and error"],
     flags: [
       ["--errors", "only failed turns (same as --status error)"],
       ["--skipped", "ls: WhatsApp Business customer messages that did NOT open a turn, and why (operator active, records only, paused, reaction, channel off, no balance)"],
@@ -11150,6 +11242,7 @@ var HELPS = {
       ["--limit N", "max rows (default 20, max 500)"],
       ["--full", "show: the whole message that came in and the whole answer (default: first 600 chars)"],
       ["--quota-hits", "ls --workspace: messages (WhatsApp Business and Teams) that got no turn because the balance ran out"],
+      ["--all", "stats (staff): also count staff users, the test channel and deleted agents"],
       ["--session S", "ls: only this conversation's turns. Claude turns show \xABresumed\xBB: \u2713 = it kept the SDK session, \u26A0 from scratch (orphan|stale|replaced) = it lost its memory"]
     ],
     examples: ["ghosty turns ls <id> --errors --since 1h", "ghosty turns ls --workspace descti --quota-hits --days 30", "ghosty turns ls <id> --skipped --since 1d", "ghosty turns ls <id> --json --limit 100", "ghosty turns show <id>            # last turn: each tool, its seconds, output tokens"],
@@ -11204,8 +11297,23 @@ var HELPS = {
   },
   chat: {
     summary: "Stream a conversation; with no message it is interactive.",
-    usage: ['ghosty chat <agent-id> ["message"] [--conversation ID] [--media FILE]\u2026', "ghosty conversations ls <agent-id>", "ghosty conversations show <agent-id> <conversation-id> [--limit 20]"],
-    examples: ['ghosty chat <id> "hola"', "ghosty chat <id>", 'ghosty chat <id> "p\xE1salo a PDF" --media foto.jpg'],
+    usage: [
+      '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 ls --user <email> [--since 30d] [--surface android]   # staff",
+      "ghosty conversations show <agent-id> <conversation-id> --why   # staff: who sees it and why"
+    ],
+    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)"],
+      ["--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"]
+    ],
+    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"],
     learn: `${REF}#conversaciones`
   },
   schedule: {
@@ -11217,8 +11325,8 @@ var HELPS = {
   },
   me: {
     summary: "Your account: files and usage.",
-    usage: ["ghosty me files ls|upload|rm [--kind image|video|audio|document|other]", "ghosty usage"],
-    examples: ["ghosty me files ls --kind document"],
+    usage: ["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 upload <file> | rm <file-id>", "ghosty usage"],
+    examples: ["ghosty me files ls --kind document", "ghosty me files ls --q contrato", "ghosty me files get <id> --out contrato.pdf", 'ghosty chat <agent> "res\xFAmelo" --file <id>'],
     learn: `${REF}#tu-cuenta`
   }
 };
@@ -11253,7 +11361,7 @@ HELPS.channels = {
     "ghosty channels wa status|pause <agent-id>",
     "ghosty channels wa groups ls <agent-id> [--cached]",
     "ghosty channels wa groups enable|disable <agent-id> <group> [--role equipo|cliente] [--dry-run] [--yes]",
-    "ghosty channels wa groups set <agent-id> <group> --role equipo|cliente [--dry-run]",
+    'ghosty channels wa groups set <agent-id> <group> [--role equipo|cliente] [--name "New name"] [--dry-run]',
     'ghosty channels wa groups create <agent-id> "Name" [--role equipo|cliente]'
   ],
   flags: [
@@ -11261,6 +11369,7 @@ HELPS.channels = {
     ["--yes", "enable / groups enable: skip the confirmation (required without a terminal)"],
     ["--role R", "groups: equipo (the team: writes to databases, admin tools) or cliente (like any customer)"],
     ["--cached", "groups ls: don't ask WhatsApp for the live list (faster; may miss new groups)"],
+    ["--name N", "groups set: the name gs shows (e.g. a group saved with its jid as name); WhatsApp's subject doesn't change"],
     ["--integration ID", "link/unlink/history: the WhatsApp Business number's Integration id in Formmy"],
     ["--email E", "integrations (staff): list the numbers of another Formmy account"],
     ["--days N", "history: conversations active in the last N days (1-30, default 7)"],
@@ -11460,6 +11569,27 @@ HELPS.demos = {
   notes: ["try counts against the demo's caps (messages per visitor, per IP per day) and shows up in its numbers and CRM.", "history is Ghosty staff only: visitors' chats are not shown to the owner."],
   learn: `${REF}#demo-publico-agents-demo`
 };
+HELPS.push = {
+  summary: "Ghosty staff: which pushes were sent to someone (turn end, permission, escalate, document\u2026), to which device and what Apple/Google answered. Logged since 2026-10-01, kept 30 days.",
+  usage: ["ghosty push log --user <email> [--since 2d] [--limit 100]"],
+  examples: ["ghosty push log --user brenda@siiqtec.com --since 1d"],
+  notes: ["thread shows the conversation's kind: a \xABchannel\xBB there means a customer's push reached them."],
+  learn: `${REF}#soporte`
+};
+HELPS.novedades = {
+  summary: "Ghosty staff: the Android app's announcements (what's new). Each one needs its own illustration; same brakes as the admin: test on your phone first, push 9\u201321 h CDMX, 72 h between pushes to everyone.",
+  usage: [
+    "ghosty novedades ls",
+    'ghosty novedades create --title T --body B --image hero.png [--link ruta] [--button "Abrir"] [--to a@x.com,b@y.com] [--publish]',
+    "ghosty novedades set <id> [--title] [--body] [--image FILE] [--link] [--button] [--to] [--publish|--draft]",
+    "ghosty novedades test <id>",
+    'ghosty novedades send <id> [--at "2026-10-02T12:00"]',
+    "ghosty novedades rm <id>"
+  ],
+  examples: ['ghosty novedades create --title "PDF y audio" --body "Ahora\u2026" --image hero.png --link chats --publish', "ghosty novedades test <id>", 'ghosty novedades send <id> --at "2026-10-02T12:00"'],
+  notes: ["--image is published to img.ghosty.studio (WebP 1200 px). --to empty = everyone. send without --at pushes now (asks); --at '' removes the schedule."],
+  learn: `${REF}#soporte`
+};
 HELPS.spaces = {
   summary: "Ghosty staff operations on a workspace: move \xABpaid until\xBB and rename its slug. Each one is logged in the workspace's audit.",
   usage: ["ghosty spaces renew <workspace> --until YYYY-MM-DD [--note TEXT] [--dry-run] [--yes]", "ghosty spaces rename <old> <new> [--dry-run] [--yes]"],
@@ -11496,7 +11626,7 @@ function helpText(cmd) {
 }
 
 // src/update.ts
-import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile5 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile6 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
 import { dirname as dirname3, join as join6 } from "node:path";
 var FILE = join6(process.env.XDG_CONFIG_HOME || join6(homedir3(), ".config"), "ghosty", "update.json");
@@ -11521,7 +11651,7 @@ async function latestVersion() {
       const latest = (await r.json()).version;
       if (latest) cache2 = { latest, checkedAt: Date.now() };
       await mkdir4(dirname3(FILE), { recursive: true });
-      await writeFile5(FILE, JSON.stringify(cache2));
+      await writeFile6(FILE, JSON.stringify(cache2));
     } catch {
     }
   }
@@ -11575,6 +11705,7 @@ function agentArgIndex(pos) {
     case "db":
       return sub === "photos" ? 3 : 2;
     case "turns":
+      return pos[1] === "stats" ? null : 2;
     case "board":
     case "conversations":
     case "schedule":
@@ -11595,7 +11726,7 @@ function agentArgIndex(pos) {
 }
 
 // src/completion.ts
-import { mkdir as mkdir5, readFile as readFile10, writeFile as writeFile6 } from "node:fs/promises";
+import { mkdir as mkdir5, readFile as readFile10, writeFile as writeFile7 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
 import { join as join7 } from "node:path";
 var GLOBAL_FLAGS = ["--json", "--token", "--profile", "--yes", "--help", "--version", "--lang", "--dry-run"];
@@ -11647,7 +11778,7 @@ async function names() {
   const workspaces = [...new Set(list.map((a) => a.espacio?.tipo === "workspace" ? a.espacio.nombre : void 0).filter((x) => !!x))];
   await mkdir5(join7(cacheFile(), ".."), { recursive: true }).catch(() => {
   });
-  await writeFile6(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
+  await writeFile7(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
   });
   return { agents, workspaces };
 }
@@ -11725,7 +11856,7 @@ function normalizeArgs(pos, v) {
 
 // src/commands/spec.ts
 var import_yaml = __toESM(require_dist(), 1);
-import { mkdir as mkdir6, readdir as readdir4, readFile as readFile11, stat, writeFile as writeFile7 } from "node:fs/promises";
+import { mkdir as mkdir6, readdir as readdir4, readFile as readFile11, stat, writeFile as writeFile8 } from "node:fs/promises";
 import { join as join8, resolve as resolve2 } from "node:path";
 var enc9 = encodeURIComponent;
 async function agentsExport(id, v) {
@@ -11737,7 +11868,7 @@ async function agentsExport(id, v) {
   }
   const dir = resolve2(v.out);
   await mkdir6(dir, { recursive: true });
-  await writeFile7(join8(dir, "agent.yaml"), yaml);
+  await writeFile8(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)}`);
@@ -11987,9 +12118,9 @@ ${t("Rename?", "\xBFRenombrar?")}`, { yes: v.yes, expect: plan.from, retry: `gho
 async function workspaceUsage(slug, v) {
   slug = needSpace(slug, "ghosty usage --workspace <slug> --by agent,day --days 14");
   const r = await api(wsPath(slug, `/usage?days=${enc10(v.days ?? "14")}`));
-  const cdmx = (iso) => new Date(Date.parse(iso) - 6 * 36e5).toISOString().slice(5, 16).replace("T", " ");
+  const cdmx2 = (iso) => new Date(Date.parse(iso) - 6 * 36e5).toISOString().slice(5, 16).replace("T", " ");
   if (v["quota-hits"]) {
-    const rows2 = r.quotaHits.map((q) => ({ at: cdmx(q.at), agent: q.agent, channel: q.channel, from: q.phone ?? q.conversationId.slice(0, 24), message: (q.preview ?? "").slice(0, 60) }));
+    const rows2 = r.quotaHits.map((q) => ({ at: cdmx2(q.at), agent: q.agent, channel: q.channel, from: q.phone ?? q.conversationId.slice(0, 24), message: (q.preview ?? "").slice(0, 60) }));
     const total2 = r.agents.reduce((n, a) => n + a.noQuota, 0);
     return out(r.quotaHits, () => rows2.length ? `${table(rows2, ["at", "agent", "channel", "from", "message"])}
 ${dim(t(`${total2} message(s) unanswered for lack of balance in ${r.days} day(s) (CDMX time)`, `${total2} mensaje(s) sin atender por saldo en ${r.days} d\xEDa(s) (hora CDMX)`))}` : dim(t(`No message ran out of balance in ${r.days} day(s).`, `Ning\xFAn mensaje se qued\xF3 sin saldo en ${r.days} d\xEDa(s).`)));
@@ -12020,7 +12151,7 @@ ${dim(t(`${fmtTokens(total)} billable tokens \xB7 failed = error or stopped \xB7
 
 // src/commands/demos.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir7, readFile as readFile12, writeFile as writeFile8 } from "node:fs/promises";
+import { mkdir as mkdir7, readFile as readFile12, writeFile as writeFile9 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
 import { dirname as dirname4, join as join9 } from "node:path";
 var enc11 = encodeURIComponent;
@@ -12063,7 +12194,7 @@ async function visitorCookie(base, slug, fresh) {
   if (!cookie) throw new CliError(t("The demo didn't hand out a visitor cookie.", "El demo no entreg\xF3 cookie de visitante."), EXIT.API);
   jar[slug] = cookie;
   await mkdir7(dirname4(jarPath()), { recursive: true });
-  await writeFile8(jarPath(), JSON.stringify(jar, null, 2), { mode: 384 });
+  await writeFile9(jarPath(), JSON.stringify(jar, null, 2), { mode: 384 });
   return cookie;
 }
 async function visitorTurn(base, slug, cookie, text) {
@@ -12134,6 +12265,146 @@ async function demosCmd(sub, a1, rest, v) {
   throw usage(t(`Unknown demos subcommand: ${sub ?? "(none)"}.`, `Subcomando de demos desconocido: ${sub ?? "(ninguno)"}.`), 'ghosty demos history <agent> \xB7 ghosty demos try <slug> "message"');
 }
 
+// src/commands/support.ts
+import { readFile as readFile13 } from "node:fs/promises";
+var enc12 = encodeURIComponent;
+var cdmx = (iso) => new Date(Date.parse(iso) - 6 * 36e5).toISOString().slice(5, 16).replace("T", " ");
+async function supportThreads(email, v) {
+  const q = new URLSearchParams({ user: email, since: v.since ?? "30d", ...v.surface ? { surface: v.surface } : {} });
+  const r = await api(`/api/v2/support/threads?${q}`);
+  const rows = r.threads.map((x) => ({
+    last: cdmx(x.lastTurn),
+    agent: x.deletedAgent ? dim(t("(deleted)", "(borrado)")) : x.agent ?? x.agentId.slice(0, 8),
+    conversation: x.sessionId,
+    title: (x.title ?? "").slice(0, 40),
+    kind: x.kind ?? "?",
+    listed: x.listed ? t("yes", "s\xED") : "",
+    turns: x.failed ? `${x.turns} (${red(String(x.failed))})` : x.turns,
+    from: x.surfaces.join(",")
+  }));
+  out(r, () => `${bold(r.user)}
+${table(rows, ["last", "agent", "conversation", "title", "kind", "listed", "turns", "from"])}
+${dim(t("Read one: ghosty conversations show <agent> <conversation> --why \xB7 times in CDMX \xB7 listed = in their app list", "Leer uno: ghosty conversations show <agente> <conversaci\xF3n> --why \xB7 horas CDMX \xB7 listed = sale en su lista de la app"))}`);
+}
+async function supportThread(agent, sid, v) {
+  const r = await api(`/api/v2/support/threads/${enc12(agent)}/${enc12(sid)}?tail=${enc12(v.limit ?? "40")}`);
+  out(r, () => {
+    const w = r.why;
+    const who2 = (x, label) => x ? `  ${label} ${x.email}: ${x.listed ? lavender(t("in their list/search/push", "en su lista/b\xFAsqueda/push")) : dim(t("not listed", "no sale en su lista"))} \xB7 ${t("by link", "por liga")}: ${x.open || t("no", "no")}` : "";
+    const why = [
+      `${bold(r.agent.name ?? r.agent.id)}${r.agent.deleted ? red(t(" (deleted)", " (borrado)")) : ""} \xB7 ${r.title ?? ""}`,
+      `  kind ${bold(w.kind ?? "?")} \xB7 ${t("thread of", "hilo de")} ${w.user ?? "\u2014"}${w.archived ? dim(` \xB7 ${t("archived", "archivado")} ${cdmx(w.archived)}`) : ""}`,
+      w.lastTurn ? dim(`  ${t("last turn", "\xFAltimo turno")}: canal ${w.lastTurn.canal ?? "?"} \xB7 origen ${w.lastTurn.origen ?? "?"} \xB7 ${w.lastTurn.surface ?? "?"} \xB7 ${w.lastTurn.userId ?? "?"}`) : "",
+      who2(w.owner, t("agent owner", "due\xF1o del agente")),
+      who2(w.threadUser, t("thread user", "usuario del hilo")),
+      dim(`  ${serverText(w.rule)}`)
+    ].filter(Boolean);
+    if (v.why) return why.join("\n");
+    const msgs = r.messages.map((m) => `${dim(cdmx(m.at))} ${bold(m.role.padEnd(9))} ${m.text.replace(/\s+/g, " ").slice(0, 400)}`);
+    return [...why, "", ...msgs].join("\n");
+  });
+}
+async function cleanupConversations(action, agent, v) {
+  const ex = `ghosty conversations ${action} <agent> --kind ${action === "rm" ? "test" : "test|channel"} [--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);
+  const path = `/api/v2/agents/${enc12(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 } });
+  const verb = action === "rm" ? t("delete (rows + agent memory)", "borrar (filas + memoria del agente)") : t("archive (hidden; memory stays)", "archivar (se ocultan; la memoria se queda)");
+  const line2 = t(`${plan.threads} ${v.kind} conversation(s), ${plan.messages} message(s) to ${verb}`, `${plan.threads} conversaci\xF3n(es) ${v.kind}, ${plan.messages} mensaje(s) para ${verb}`);
+  if (v["dry-run"] || !plan.threads) return out(plan, () => `${line2}${plan.sample.length ? `
+${dim(plan.sample.join("\n"))}` : ""}
+${dim(t("Dry run: nothing changed.", "Simulaci\xF3n: no cambi\xF3 nada."))}`);
+  requireYesIfHeadless(v.yes, `ghosty conversations ${action} ${agent} --kind ${v.kind}${v.before ? ` --before ${v.before}` : ""}`);
+  await confirm(`${line2}
+${t("Go ahead?", "\xBFSigo?")}`, { yes: v.yes, retry: `ghosty conversations ${action} ${agent} --kind ${v.kind}` });
+  const r = await api(path, { method: "POST", body });
+  out(r, () => `${lavender("\u2713")} ${t(`${r.threads} conversation(s) ${action === "rm" ? "deleted" : "archived"}.`, `${r.threads} conversaci\xF3n(es) ${action === "rm" ? "borradas" : "archivadas"}.`)}`);
+}
+async function turnStats(v) {
+  const r = await api(`/api/v2/support/turn-stats?since=${enc12(v.since ?? "14d")}${v.all ? "&all=1" : ""}`);
+  out(
+    r,
+    () => [
+      `${bold(`${r.failRate}%`)} ${t("of turns failed", "de los turnos fallaron")} ${dim(`(${r.failed}/${r.total}, ${v.since ?? "14d"}${r.filtered ? t(" \xB7 without staff, test channel or deleted agents (--all to include)", " \xB7 sin staff, canal prueba ni agentes borrados (--all los incluye)") : ""})`)}`,
+      dim(Object.entries(r.byState).map(([k, n]) => `${k} ${n}`).join(" \xB7 ")),
+      "",
+      table(r.byEngine.map((e) => ({ engine: e.engine, turns: e.turns, failed: e.failed, rate: `${e.failRate}%` })), ["engine", "turns", "failed", "rate"]),
+      ...r.topErrors.length ? ["", table(r.topErrors.map((e) => ({ n: e.n, error: e.error })), ["n", "error"])] : []
+    ].join("\n")
+  );
+}
+async function pushLog(email, v) {
+  if (!email) throw usage(t("Missing --user.", "Falta --user."), "ghosty push log --user ana@empresa.com [--since 2d]");
+  const r = await api(`/api/v2/support/push-log?user=${enc12(email)}&since=${enc12(v.since ?? "2d")}${v.limit ? `&limit=${enc12(v.limit)}` : ""}`);
+  const rows = r.pushes.map((p) => ({ at: cdmx(p.at), kind: p.kind, to: p.platform, status: p.status === "sent" ? p.status : red(p.status), thread: p.threadKind ? `${p.threadId?.slice(0, 18)} (${p.threadKind})` : (p.threadId ?? "").slice(0, 24), title: (p.title ?? "").slice(0, 40), detail: p.detail ?? "" }));
+  out(r, () => rows.length ? `${bold(r.user)}
+${table(rows, ["at", "kind", "to", "status", "thread", "title", "detail"])}` : dim(t(`No pushes for ${r.user} in that range (logged since 2026-10-01).`, `Sin avisos para ${r.user} en ese rango (se registran desde el 1-oct).`)));
+}
+async function novedadesCmd(sub, id, v) {
+  const base = "/api/v2/support/announcements";
+  const ex = 'ghosty novedades ls \xB7 create --title T --body B --image hero.png [--link ruta] [--button "Abrir"] [--to a@x.com,b@y.com] [--publish] \xB7 set <id> \u2026 \xB7 test <id> \xB7 send <id> [--at "2026-10-02T12:00"] \xB7 rm <id>';
+  const fields = async () => ({
+    ...v.title !== void 0 ? { title: v.title } : {},
+    ...v.body !== void 0 ? { body: v.body } : {},
+    ...v.image ? { image: (await readFile13(v.image)).toString("base64") } : {},
+    ...v.link !== void 0 ? { enlace: v.link || null } : {},
+    ...v.button !== void 0 ? { boton: v.button || null } : {},
+    ...v.to !== void 0 ? { destinatarios: v.to || null } : {},
+    ...v.publish ? { published: true } : v.draft ? { published: false } : {}
+  });
+  const line2 = (a) => `${bold(a.title)} ${dim(a.id)}
+  ${a.published ? lavender(t("published", "publicada")) : dim(t("draft", "borrador"))} \xB7 ${a.pushedAt ? t(`pushed ${cdmx(a.pushedAt)} (${a.pushCount})`, `enviada ${cdmx(a.pushedAt)} (${a.pushCount})`) : a.schedule ? t(`push scheduled ${cdmx(a.schedule)} CDMX`, `push programado ${cdmx(a.schedule)} CDMX`) : t("not pushed", "sin enviar")} \xB7 ${a.destinatarios ? t(`to ${a.destinatarios.split(",").length}`, `para ${a.destinatarios.split(",").length}`) : t("everyone", "todos")}`;
+  switch (sub ?? "ls") {
+    case "ls":
+    case "list": {
+      const r = await api(base);
+      return out(r, () => r.announcements.map(line2).join("\n") || dim(t("No announcements.", "Sin novedades.")));
+    }
+    case "create":
+    case "new": {
+      if (!v.title || !v.body) throw usage(t("Missing --title and --body.", "Faltan --title y --body."), ex);
+      const r = await api(base, { method: "POST", body: await fields() });
+      return out(r, () => `${lavender("\u2713")} ${line2(r)}
+${dim(t(`Try it on your phone: ghosty novedades test ${r.id}`, `Pru\xE9bala en tu tel\xE9fono: ghosty novedades test ${r.id}`))}`);
+    }
+    case "set": {
+      if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
+      const b = await fields();
+      if (!Object.keys(b).length) throw usage(t("Nothing to change.", "Nada que cambiar."), ex);
+      const r = await api(`${base}/${enc12(id)}`, { method: "PATCH", body: b });
+      return out(r, () => `${lavender("\u2713")} ${line2(r)}`);
+    }
+    case "test": {
+      if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
+      const r = await api(`${base}/${enc12(id)}`, { method: "POST", body: { push: "test" } });
+      return out(r, () => `${lavender("\u2713")} ${t(`Sent to your phone (${r.enviados} device(s)).`, `Enviada a tu tel\xE9fono (${r.enviados} dispositivo(s)).`)}`);
+    }
+    case "send":
+    case "schedule": {
+      if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
+      if (v.at !== void 0) {
+        const r2 = await api(`${base}/${enc12(id)}`, { method: "PATCH", body: { schedule: v.at || null } });
+        return out(r2, () => `${lavender("\u2713")} ${line2(r2)}`);
+      }
+      requireYesIfHeadless(v.yes, `ghosty novedades send ${id}`);
+      await confirm(t("Push this announcement to every recipient now?", "\xBFMandar ya el push de esta novedad a todos sus destinatarios?"), { yes: v.yes, retry: `ghosty novedades send ${id}` });
+      const r = await api(`${base}/${enc12(id)}`, { method: "POST", body: { push: "all" } });
+      return out(r, () => `${lavender("\u2713")} ${t(`Pushed to ${r.enviados} device(s).`, `Enviada a ${r.enviados} dispositivo(s).`)}`);
+    }
+    case "rm":
+    case "delete": {
+      if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
+      requireYesIfHeadless(v.yes, `ghosty novedades rm ${id}`);
+      await confirm(t(`Delete announcement ${id}?`, `\xBFBorrar la novedad ${id}?`), { yes: v.yes, retry: `ghosty novedades rm ${id}` });
+      return out(await api(`${base}/${enc12(id)}`, { method: "DELETE" }), () => `${lavender("\u2713")} ${t("Deleted.", "Borrada.")}`);
+    }
+    default:
+      throw usage(t(`Unknown novedades subcommand: ${sub}.`, `Subcomando de novedades desconocido: ${sub}.`), ex);
+  }
+}
+
 // src/index.ts
 var HELP_EN = `${bold("Usage:")} ghosty <command> [options]
 
@@ -12175,6 +12446,7 @@ ${bold("Agents")}
   agents docs ls|grant|revoke <id> [doc]   Documents it reads and may send   [--write] [--no-deliver]
   agents docs grant <id> A B\u2026   Grant several documents at once   [--like AGENT] copies another agent's
   agents docs add <id>      Upload a document and grant it   --url URL | --file PATH  [--description] [--grant read|write|no]
+  agents docs dedupe        Your account: merge documents with the same content (keeps every agent's access)   [--dry-run] \xB7 dedupe <keep> <drop>
   agents docs replace <id> <doc>   New version (keeps name and access)   --url URL | --file PATH  [--note]
   agents docs history|restore <id> <doc> [n]   Its versions; restore n as a new version
   agents share|unshare <id> <email>   Share it without handing it over   [--role editor|admin] \xB7 agents shares <id> lists them
@@ -12201,12 +12473,19 @@ ${bold("Configure an agent")}
   channels wa import <id> --from easybits:ID | --from-file F | --from-dir DIR --own-number yes|no   Move a personal WhatsApp session here, no QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Pair a personal WhatsApp by code (no QR)
   channels wa status|pause <id>           Personal WhatsApp: how it is / pause it (keeps the session)
-  channels wa groups ls|enable|disable|set|create <id> [group]   Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--dry-run]
+  channels wa groups ls|enable|disable|set|create <id> [group]   Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--name "New name"] [--dry-run]
   boards ls|create|assign|move-cards|rm   A workspace's boards: create (--columns-from), where an agent sends cards, move cards
   cards ls <id>             Recent cards on its sales board   [--q TEXT] [--paused] [--limit 20]
   cards show <id> <card>    A card's thread: who wrote, text, attachments and whether gs kept a copy   (folio, phone or id)
   cards archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
+${bold("Support")}  ${dim("(Ghosty staff)")}
+  conversations ls --user EMAIL           Someone's conversations in any agent   [--since 30d] [--surface android]
+  conversations show <id> <conv> --why    A conversation: who sees it in their list / by link, and why
+  turns stats                             Real failure rate by engine and error   [--since 14d] [--all]
+  push log --user EMAIL                   Pushes sent to someone and what Apple/Google answered   [--since 2d]
+  novedades ls|create|set|test|send|rm    Android app announcements   [--title] [--body] [--image FILE] [--link] [--to] [--publish] [--at]
+
 ${bold("Demos")}
   demos try <slug> "msg" ["msg2"\u2026]   Try a public demo as a visitor (same thread across runs)   [--new] [--recycle-between --agent X]
   demos history <id>                 What visitors did: turns, messages, files (Ghosty staff)   [--since 2d] [--session web:\u2026] [--timeline] [--full]
@@ -12215,9 +12494,10 @@ ${bold("Talk to an agent")}
   try <id> "message"        One test turn, prints the full answer   [--session] [--reset] [--media FILE: attach, as from the app]
     --waba --session PHONE  \u2026through the real WhatsApp path, nothing sent; lists what it would send (tools too)   [--media FILE [--as-formmy]] [--history FILE]
     --replay FILE --out DIR Replay real conversations; report written locally   [--max 15] [--concurrency 8] [--resume]
-  chat <id> ["message"]     Stream a conversation (no message = interactive)   [--conversation ID] [--media FILE]
+  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]
   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]
@@ -12233,7 +12513,7 @@ ${bold("Partners")}  ${dim("(give an agent to each of YOUR customers \u2014 see:
   partner ls | enable | credentials | agent | tenants | audit | try
 
 ${bold("Your account")}
-  me files ls|upload|rm     Files in your account        [--kind image|video|audio|document|other]
+  me files ls|get|upload|rm Files in your account        [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out FILE]
   credentials ls|set|rm [provider]   Provider keys in your vault (hidden prompt, stdin or --from-env VAR; never as an argument)
   docs [topic]              Open the docs
 
@@ -12290,6 +12570,7 @@ ${bold("Agentes")}
   agents docs ls|grant|revoke <id> [doc]   Documentos que lee y puede enviar   [--write] [--no-deliver]
   agents docs grant <id> A B\u2026   Da varios documentos a la vez   [--like AGENTE] copia los de otro agente
   agents docs add <id>      Sube un documento y d\xE1selo   --url URL | --file RUTA  [--description] [--grant read|write|no]
+  agents docs dedupe        Tu cuenta: une los documentos con el mismo contenido (conserva el acceso de cada agente)   [--dry-run] \xB7 dedupe <queda> <se-va>
   agents docs replace <id> <doc>   Versi\xF3n nueva (conserva nombre y accesos)   --url URL | --file RUTA  [--note]
   agents docs history|restore <id> <doc> [n]   Sus versiones; restaura la n como versi\xF3n nueva
   agents share|unshare <id> <correo>   Comp\xE1rtelo sin cederlo   [--role editor|admin] \xB7 agents shares <id> los lista
@@ -12316,12 +12597,19 @@ ${bold("Configurar un agente")}
   channels wa import <id> --from easybits:ID | --from-file F | --from-dir DIR --own-number yes|no   Mueve aqu\xED una sesi\xF3n de WhatsApp personal, sin QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Vincula un WhatsApp personal con c\xF3digo (sin QR)
   channels wa status|pause <id>           WhatsApp personal: c\xF3mo est\xE1 / pausarlo (conserva la sesi\xF3n)
-  channels wa groups ls|enable|disable|set|create <id> [grupo]   Grupos de WhatsApp personal que contesta, y como qui\xE9n   [--role equipo|cliente] [--dry-run]
+  channels wa groups ls|enable|disable|set|create <id> [grupo]   Grupos de WhatsApp personal que contesta, y como qui\xE9n   [--role equipo|cliente] [--name "Nombre nuevo"] [--dry-run]
   boards ls|create|assign|move-cards|rm   Los tableros de un espacio: crear (--columns-from), a d\xF3nde manda tarjetas un agente, mover tarjetas
   cards ls <id>             Tarjetas recientes de su tablero de ventas   [--q TEXTO] [--paused] [--limit 20]
   cards show <id> <tarjeta> El hilo de una tarjeta: qui\xE9n escribi\xF3, texto, adjuntos y si gs guard\xF3 copia   (folio, tel\xE9fono o id)
   cards archive <id>        Archiva tarjetas en bloque (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
+${bold("Soporte")}  ${dim("(staff de Ghosty)")}
+  conversations ls --user CORREO          Las conversaciones de alguien en cualquier agente   [--since 30d] [--surface android]
+  conversations show <id> <conv> --why    Una conversaci\xF3n: qui\xE9n la ve en su lista / por liga, y por qu\xE9
+  turns stats                             Tasa real de fallos por motor y por error   [--since 14d] [--all]
+  push log --user CORREO                  Avisos que se le mandaron a alguien y qu\xE9 contest\xF3 Apple/Google   [--since 2d]
+  novedades ls|create|set|test|send|rm    Novedades de la app Android   [--title] [--body] [--image ARCHIVO] [--link] [--to] [--publish] [--at]
+
 ${bold("Demos")}
   demos try <slug> "msg" ["msg2"\u2026]   Prueba un demo p\xFAblico como visitante (mismo hilo entre corridas)   [--new] [--recycle-between --agent X]
   demos history <id>                 Qu\xE9 hicieron los visitantes: turnos, mensajes, archivos (staff de Ghosty)   [--since 2d] [--session web:\u2026] [--timeline] [--full]
@@ -12330,9 +12618,10 @@ ${bold("Hablar con un agente")}
   try <id> "mensaje"        Un turno de prueba; imprime la respuesta completa   [--session] [--reset] [--media ARCHIVO: adjunto, como desde la app]
     --waba --session TEL    \u2026por el camino real de WhatsApp, sin enviar nada; lista lo que mandar\xEDa (tools tambi\xE9n)   [--media ARCHIVO [--as-formmy]] [--history ARCHIVO]
     --replay ARCHIVO --out DIR   Repite conversaciones reales; el reporte se escribe local   [--max 15] [--concurrency 8] [--resume]
-  chat <id> ["mensaje"]     Conversaci\xF3n en streaming (sin mensaje = interactivo)   [--conversation ID] [--media ARCHIVO]
+  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]
   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]
@@ -12348,7 +12637,7 @@ ${bold("Partners")}  ${dim("(dale un agente a cada uno de TUS clientes \u2014 ve
   partner ls | enable | credentials | agent | tenants | audit | try
 
 ${bold("Tu cuenta")}
-  me files ls|upload|rm     Archivos de tu cuenta         [--kind image|video|audio|document|other]
+  me files ls|get|upload|rm Archivos de tu cuenta         [--q TEXTO] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out ARCHIVO]
   credentials ls|set|rm [proveedor]   Llaves de proveedor en tu b\xF3veda (prompt oculto, stdin o --from-env VAR; nunca como argumento)
   docs [tema]               Abre la documentaci\xF3n
 
@@ -12365,7 +12654,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", "plan", "engines", "bags", "spaces", "demos", "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", "engines", "bags", "spaces", "demos", "push", "novedades", "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);
@@ -12538,6 +12827,15 @@ async function main() {
       models: { type: "boolean" },
       teams: { type: "string" },
       owner: { type: "string" },
+      cursor: { type: "string" },
+      user: { type: "string" },
+      why: { type: "boolean" },
+      surface: { type: "string" },
+      image: { type: "string" },
+      link: { type: "string" },
+      button: { type: "string" },
+      publish: { type: "boolean" },
+      draft: { type: "boolean" },
       ids: { type: "boolean" },
       force: { type: "boolean" },
       reenv: { type: "boolean" },
@@ -12554,7 +12852,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.29.0" }, () => "0.29.0");
+  if (v.version) return out({ version: "0.30.0" }, () => "0.30.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -12632,7 +12930,14 @@ async function main() {
       return dbsCmd(sub, a1, a2, pos.slice(4).filter((x) => x !== void 0), v);
     case "turns":
       if (v["quota-hits"]) return workspaceUsage(v.workspace ?? context, v);
+      if (sub === "stats") return turnStats(v);
       return turnsCmd(sub, a1, a2, v);
+    case "push":
+      if (sub !== "log") throw usage(t("Unknown push subcommand.", "Subcomando de push desconocido."), "ghosty push log --user <email> [--since 2d]");
+      return pushLog(v.user, v);
+    case "novedades":
+    case "announcements":
+      return novedadesCmd(sub, a1, v);
     case "board":
       return boardCmd(sub, a1, v, a2);
     case "boards":
@@ -12648,8 +12953,11 @@ async function main() {
     case "chat":
       return chat(sub, a1, v);
     case "conversations":
+      if ((sub === "ls" || sub === "list") && v.user) return supportThreads(v.user, v);
       if (sub === "ls" || sub === "list") return conversationsLs(a1);
+      if (sub === "show" && (v.why || v.user)) return supportThread(a1, a2, v);
       if (sub === "show") return conversationsShow(a1, a2, v);
+      if (sub === "archive" || sub === "rm") return cleanupConversations(sub, a1, v);
       throw usage(t(`Unknown conversations subcommand: ${sub ?? "(none)"}.`, `Subcomando de conversations desconocido: ${sub ?? "(ninguno)"}.`), t("Try: ghosty conversations ls <agent-id> \xB7 ghosty conversations show <agent-id> <conversation-id>", "Prueba: ghosty conversations ls <agent-id> \xB7 ghosty conversations show <agent-id> <conversation-id>"));
     case "schedule":
       return scheduleCmd(sub, a1, a2, v);
@@ -12686,7 +12994,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.29.0").catch(() => null);
+var notice = updateNotice("0.30.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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