@ghostystudio/cli 0.30.0 → 0.31.0

package/README.md

@@ -95,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.31.0
+
+- `spaces ls [--user EMAIL]`; staff: `spaces join|leave <workspace>` and `spaces set <workspace> --combo sales` (`workspaces` is an alias). `boards create` warns when the workspace has no Sales (nobody would see the board).
+- `channels whatsapp history --dry-run --list` (which conversations, whether from an ad), `--only-ads`, `--phones a,b`, `--column NAME`; `channels whatsapp link --ads-only on|off` (also alone, on a linked number) and `whatsapp ls` shows it.
+- After a `--dry-run`, the suggested command already carries `--yes` when there's no terminal. A 404 says it may be missing access.
+- Staff: `agents ls --user EMAIL --app all|android|ios|desktop` (their list as their app gets it), `usage --boxes --by template` (whole fleet).
+- The «new version» notice checks npm every hour (it was once a day).
+
 ### 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`).

package/dist/index.js

@@ -8044,6 +8044,17 @@ var SERVER_MESSAGES = [
   ["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"],
+  ["los espacios de otra persona: s\xF3lo el staff de Ghosty", "someone else's workspaces: Ghosty staff only"],
+  ["entrar al espacio de un cliente: s\xF3lo el staff de Ghosty", "entering a client's workspace: Ghosty staff only"],
+  ["cambiar el combo de un espacio: s\xF3lo el staff de Ghosty", "changing a workspace's combo: Ghosty staff only"],
+  ["ver la app de otra persona: s\xF3lo el staff de Ghosty", "seeing someone else's app: Ghosty staff only"],
+  ["las cajas de la flota: s\xF3lo el staff de Ghosty", "the fleet's boxes: Ghosty staff only"],
+  ["combo: {}", "combo: {}"],
+  ["{} no trae Ventas (combo {}): nadie va a ver este tablero; staff: ghosty spaces set {} --combo sales", "{} has no Sales (combo {}): nobody will see this board; staff: ghosty spaces set {} --combo sales"],
+  ["no hay columna \xAB{}\xBB en ese tablero; hay: {}", "no column \xAB{}\xBB on that board; there are: {}"],
+  ["~ WabaLink {}: s\xF3lo anuncios {} \u2192 {}", "~ WabaLink {}: ads only {} \u2192 {}"],
+  ["  s\xF3lo anuncios: on (s\xF3lo abre tarjeta lo que viene de un anuncio)", "  ads only: on (only what comes from an ad opens a card)"],
+  ["  s\xF3lo anuncios: off", "  ads only: off"],
   // — 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"],
@@ -8346,7 +8357,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.30.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.31.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8388,7 +8399,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.30.0"}`,
+      "user-agent": `ghosty-cli/${"0.31.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -8415,7 +8426,7 @@ async function toError(res) {
   if (res.status === 401) return new CliError(t("Your session is not valid anymore.", "Tu sesi\xF3n ya no es v\xE1lida."), EXIT.AUTH, t("Run: ghosty login", "Corre: ghosty login"));
   if (res.status === 403) return new CliError(t(`Not allowed: ${detail}`, `No permitido: ${detail}`), EXIT.API, t("If the agent was shared with you, its workspace (board, channels, numbers) stays with the owner: ask them to add you to that workspace. Otherwise run: ghosty login", "Si el agente se comparti\xF3 contigo, su espacio (tablero, canales, n\xFAmeros) sigue siendo del due\xF1o: p\xEDdele que te agregue a ese espacio. Si no, corre: ghosty login"));
   if (res.status === 404 && (body.message || body.error)) return new CliError(detail, EXIT.API);
-  if (res.status === 404) return new CliError(t("Not found.", "No se encontr\xF3."), EXIT.API, t("Check the agent id (ghosty agents ls) or that your token belongs to that agent.", "Revisa el id del agente (ghosty agents ls) o que tu token sea de ese agente."));
+  if (res.status === 404) return new CliError(t("Not found \u2014 or you don't have access to it.", "No se encontr\xF3, o no tienes acceso."), EXIT.API, t("Check the agent id (ghosty agents ls) or that your token belongs to that agent. Ghosty staff on a client's workspace: ghosty spaces join <workspace>", "Revisa el id del agente (ghosty agents ls) o que tu token sea de ese agente. Staff de Ghosty en el espacio de un cliente: ghosty spaces join <espacio>"));
   if (body.error === "restart_no_aplica" || body.error === "agente_sin_maquina") {
     return new CliError(t("This agent doesn't need a restart: new files, skills and MCP load on its next turn.", "Este agente no necesita reinicio: los archivos, skills y MCP nuevos se cargan en su siguiente turno."), EXIT.API);
   }
@@ -8430,6 +8441,9 @@ import { dirname as dirname2, join as join3, relative, resolve } from "node:path
 // src/prompt.ts
 import { createInterface } from "node:readline/promises";
 var canPrompt = () => Boolean(process.stdin.isTTY && process.stderr.isTTY);
+function applyHint(cmd) {
+  return t(`Apply: ${cmd}${canPrompt() ? "" : " --yes"}`, `Para aplicarlo: ${cmd}${canPrompt() ? "" : " --yes"}`);
+}
 function requireYesIfHeadless(yes, retry) {
   if (!yes && !canPrompt()) throw usage(t("--yes required when not running interactively.", "Hace falta --yes cuando no corre en una terminal."), t(`Run: ${retry} --yes`, `Corre: ${retry} --yes`));
 }
@@ -9515,7 +9529,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.30.0"}`
+        "user-agent": `ghosty-cli/${"0.31.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10333,9 +10347,10 @@ async function channelsCmd(kind, sub, id, ref, v) {
       number: n2.phoneNumber ? `+${n2.phoneNumber}${n2.label !== n2.phoneNumber && n2.label !== n2.id ? ` ${n2.label}` : ""}` : n2.label,
       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")) : "",
       id: n2.id
     }));
-    return out(cur, () => rows.length ? table(rows, ["number", "answers", "formmy forwards", "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", "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`);
@@ -10479,17 +10494,27 @@ ${dim(eb ? t(`Next: ghosty channels wa groups ls ${id}`, `Sigue: ghosty channels
 }
 async function linkCmd(sub, id, v) {
   if (!id || !v.integration) throw usage(t("Missing agent id or --integration.", "Falta el id del agente o --integration."), t("Example", "Ejemplo") + `: ghosty channels whatsapp ${sub} <agent-id> --integration <formmy-integration-id> --answer off --dry-run`);
+  if (v["ads-only"] !== void 0 && v["ads-only"] !== "on" && v["ads-only"] !== "off") throw usage(t("--ads-only takes on or off.", "--ads-only acepta on u off."));
+  const adsOnly = v["ads-only"] === void 0 ? void 0 : v["ads-only"] === "on";
+  if (sub === "link" && adsOnly !== void 0 && v.answer === void 0) {
+    const path2 = `/api/v2/agents/${enc7(id)}/whatsapp/link`;
+    const r2 = await api(path2, { method: "POST", body: { integrationId: v.integration, adsOnly, ...v["dry-run"] ? { dryRun: true } : {} } });
+    return out(r2, () => `${r2.plan.map((x) => serverText(x)).join("\n")}${v["dry-run"] ? `
+${dim(applyHint(`ghosty channels whatsapp link ${id} --integration ${v.integration} --ads-only ${v["ads-only"]}`))}` : ""}`);
+  }
   if (sub === "link" && v.answer !== "on" && v.answer !== "off") throw usage(t("Missing --answer on|off.", "Falta --answer on|off."), t("on = this agent answers real customers \xB7 off = it only records (add --forward so gs still sees the conversations)", "on = este agente contesta a clientes reales \xB7 off = s\xF3lo registra (agrega --forward para que gs siga viendo las conversaciones)"));
   const path = `/api/v2/agents/${enc7(id)}/whatsapp/link`;
-  const body = { integrationId: v.integration, ...sub === "unlink" ? { unlink: true } : { answer: v.answer === "on", ...v.forward ? { forward: true } : {} } };
+  const body = { integrationId: v.integration, ...sub === "unlink" ? { unlink: true } : { answer: v.answer === "on", ...v.forward ? { forward: true } : {}, ...adsOnly !== void 0 ? { adsOnly } : {} } };
+  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"]}` : ""}` : ""}`;
   const plan = await api(path, { method: "POST", body: { ...body, dryRun: true } });
   const text = `${plan.plan.map((x) => serverText(x)).join("\n")}
 ${dim(`Formmy: ${plan.formmy.before.url ?? "null"} \u2192 ${plan.formmy.after.url ?? "null"} (${t("as", "como")} ${plan.formmy.by})`)}`;
   if (v["dry-run"]) return out(plan, () => `${text}
-${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
+${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}
+${dim(applyHint(cmd))}`);
   const digits4 = (plan.number.phoneNumberId ?? v.integration).slice(-4);
   await confirm(`${bold(text)}
-${sub === "link" ? t("From now on this number's messages reach this agent in gs.", "Desde ahora los mensajes de este n\xFAmero le llegan a este agente en gs.") : t("This number goes back to where it was before.", "Este n\xFAmero regresa a donde estaba antes.")}`, { yes: v.yes, expect: digits4, retry: `ghosty channels whatsapp ${sub} ${id} --integration ${v.integration}${sub === "link" ? ` --answer ${v.answer}${v.forward ? " --forward" : ""}` : ""}` });
+${sub === "link" ? t("From now on this number's messages reach this agent in gs.", "Desde ahora los mensajes de este n\xFAmero le llegan a este agente en gs.") : t("This number goes back to where it was before.", "Este n\xFAmero regresa a donde estaba antes.")}`, { yes: v.yes, expect: digits4, retry: cmd });
   const r = await api(path, { method: "POST", body });
   return out(r, () => `${lavender("\u2713")} ${sub === "link" ? t(`Linked (link ${r.linkId}). Check: ghosty channels whatsapp ls ${id} \xB7 ghosty turns ls ${id} --since 10m`, `Enlazado (enlace ${r.linkId}). Revisa: ghosty channels whatsapp ls ${id} \xB7 ghosty turns ls ${id} --since 10m`) : t("Unlinked: Formmy points where it did before.", "Desenlazado: Formmy apunta a donde apuntaba antes.")}`);
 }
@@ -10543,7 +10568,9 @@ async function historyCmd(id, v) {
   if (!Number.isInteger(days) || days < 1 || days > 30) throw usage(t("--days takes 1 to 30.", "--days acepta de 1 a 30."));
   const path = `/api/v2/agents/${enc7(id)}/whatsapp/history`;
   const media = v.media !== void 0;
-  const c = await api(path, { method: "POST", body: { integrationId: v.integration, days, dryRun: true, media } });
+  const filters = { ...v["only-ads"] ? { onlyAds: true } : {}, ...v.phones ? { phones: v.phones.split(",").map((x) => x.trim()).filter(Boolean) } : {}, ...v.column ? { column: v.column } : {} };
+  const cmd = `ghosty channels whatsapp history ${id} --integration ${v.integration} --days ${days}${v["only-ads"] ? " --only-ads" : ""}${v.phones ? ` --phones ${v.phones}` : ""}${v.column ? ` --column "${v.column}"` : ""}`;
+  const c = await api(path, { method: "POST", body: { integrationId: v.integration, days, dryRun: true, media, ...v.list ? { list: true } : {}, ...filters } });
   const files = (p) => (p.mediaCopied ?? 0) + (p.mediaFailed ?? 0) ? ` \xB7 ${t(`${p.mediaCopied ?? 0} file(s) copied`, `${p.mediaCopied ?? 0} archivo(s) copiado(s)`)}${p.mediaFailed ? lavender(t(`, ${p.mediaFailed} failed (retry: --media)`, `, ${p.mediaFailed} fallaron (reintenta: --media)`)) : ""}` : "";
   if (media) {
     const missing = c.mediaMissing ?? 0;
@@ -10574,17 +10601,23 @@ ${dim(v["dry-run"] ? t("Dry run: nothing copied.", "Simulacro: no se copi\xF3 na
   );
   const missingHint = c.mediaMissing ? `
 ${lavender(t(`${c.mediaMissing} file(s) already imported have no copy in gs: add --media to copy them (Formmy keeps them 7 days).`, `${c.mediaMissing} archivo(s) ya importado(s) no tienen copia en gs: agrega --media para copiarlos (Formmy los guarda 7 d\xEDas).`))}` : "";
-  if (v["dry-run"]) return out(c, () => `${plan}${missingHint}
-${dim(t("Dry run: nothing imported. Re-running later never duplicates.", "Simulacro: no se import\xF3 nada. Correrlo otra vez nunca duplica."))}`);
-  if (!c.conversations) return out({ ...c, imported: 0 }, () => dim(t(`Nothing to import: ${plan}.`, `Nada que importar: ${plan}.`)));
-  await confirm(`${bold(plan)}
-${t(`Cards appear on the team's board (no "new lead" alerts).`, "Las tarjetas aparecen en el tablero del equipo (sin avisos de \xABlead nuevo\xBB).")}`, { yes: v.yes, retry: `ghosty channels whatsapp history ${id} --integration ${v.integration} --days ${days}` });
+  const listText = c.list ? `
+${table(c.list.map((x) => ({ phone: x.phone, name: (x.name ?? "").slice(0, 20), ad: x.fromAd ? lavender(t("ad", "anuncio")) : "", msgs: x.messages, first: x.firstMessage.slice(0, 60) })), ["phone", "name", "ad", "msgs", "first"])}
+${dim(t(`${c.matching} match the filters`, `${c.matching} pasan los filtros`))}` : "";
+  const filtered = Boolean(v["only-ads"] || v.phones);
+  if (v["dry-run"]) return out(c, () => `${plan}${listText}${missingHint}
+${dim(t("Dry run: nothing imported. Re-running later never duplicates.", "Simulacro: no se import\xF3 nada. Correrlo otra vez nunca duplica."))}
+${dim(applyHint(cmd))}`);
+  if (!c.conversations || filtered && c.matching === 0) return out({ ...c, imported: 0 }, () => dim(t(`Nothing to import: ${plan}.`, `Nada que importar: ${plan}.`)));
+  await confirm(`${bold(plan)}${filtered ? `
+${t(`only the ${c.matching} that match the filters`, `s\xF3lo las ${c.matching} que pasan los filtros`)}` : ""}
+${t(`Cards appear on the team's board (no "new lead" alerts).`, "Las tarjetas aparecen en el tablero del equipo (sin avisos de \xABlead nuevo\xBB).")}`, { yes: v.yes, retry: cmd });
   const sum = { newCards: 0, updatedCards: 0, messages: 0, orders: 0, suppressed: 0, mediaCopied: 0, mediaFailed: 0, paused: 0, pausedForever: 0, manual: 0 };
   let cursor = 0;
   let done = 0;
   while (cursor !== null) {
     const at = cursor;
-    const p = await pageWithRetry(() => api(path, { method: "POST", body: { integrationId: v.integration, days, cursor: at } }), `${done}/${c.conversations}`);
+    const p = await pageWithRetry(() => api(path, { method: "POST", body: { integrationId: v.integration, days, cursor: at, ...filters } }), `${done}/${c.conversations}`);
     for (const k of Object.keys(sum)) sum[k] += p[k] ?? 0;
     done += p.page;
     if (!globals.json) info(dim(`  ${done}/${p.total} ${t("conversations", "conversaciones")}`));
@@ -10662,7 +10695,8 @@ async function boardsCmd(sub, a1, a2, v, context) {
     case "create": {
       if (!a1 || !a2) throw usage(t("Missing workspace or name.", "Falta el espacio o el nombre."), t("Example", "Ejemplo") + ': ghosty boards create <workspace> "Siiqtec - Ixmiquilpan" --columns-from main');
       const r = await api(`/api/v2/workspaces/${enc8(a1)}/boards`, { method: "POST", body: { name: a2, ...v["columns-from"] ? { columnsFrom: v["columns-from"] } : {} } });
-      return out(r, () => `${lavender("\u2713")} ${t(`Board \xAB${r.name}\xBB created${r.columnsFrom ? ` with the ${r.columns} column(s) of \xAB${r.columnsFrom}\xBB` : ""}.`, `Tablero \xAB${r.name}\xBB creado${r.columnsFrom ? ` con las ${r.columns} columna(s) de \xAB${r.columnsFrom}\xBB` : ""}.`)} ${dim(`${t("Send an agent's cards there", "Manda ah\xED las tarjetas de un agente")}: ghosty boards assign <agent-id> "${r.name}"`)}`);
+      return out(r, () => `${lavender("\u2713")} ${t(`Board \xAB${r.name}\xBB created${r.columnsFrom ? ` with the ${r.columns} column(s) of \xAB${r.columnsFrom}\xBB` : ""}.`, `Tablero \xAB${r.name}\xBB creado${r.columnsFrom ? ` con las ${r.columns} columna(s) de \xAB${r.columnsFrom}\xBB` : ""}.`)} ${dim(`${t("Send an agent's cards there", "Manda ah\xED las tarjetas de un agente")}: ghosty boards assign <agent-id> "${r.name}"`)}${r.warning ? `
+${lavender(`\u26A0\uFE0F ${serverText(r.warning)}`)}` : ""}`);
     }
     case "rm": {
       if (!a1 || !a2) throw usage(t("Missing workspace or board.", "Falta el espacio o el tablero."), t("Example", "Ejemplo") + ': ghosty boards rm <workspace> "Prueba"');
@@ -10752,7 +10786,8 @@ var HELPS_ES = {
       ["--from-workspace", "rm: lo desactiva en cada Teams donde est\xE9 y luego lo borra (due\xF1o o staff)"],
       ["--prompt-mode M", "set: append (default: su prompt + la persona de Ghosty) o replace (s\xF3lo su prompt)"],
       ["--sponsor/--owner EMAIL", "ls: agentes de CUALQUIER cuenta que paga / de quien es ese correo (staff de Ghosty); luego se operan por id"],
-      ["--ids", "ls: s\xF3lo los ids, uno por rengl\xF3n (para xargs)"]
+      ["--ids", "ls: s\xF3lo los ids, uno por rengl\xF3n (para xargs)"],
+      ["--user EMAIL --app A", "ls (staff de Ghosty): la lista de esa persona tal como la recibe su app (tono, espacio, \xFAltimo uso); A = all|android|ios|desktop"]
     ],
     notes: [
       "doctor sale con 1 cuando encuentra un problema, as\xED puede frenar un script o un CI.",
@@ -10880,6 +10915,10 @@ 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)"],
+      ["--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)"],
+      ["--list", "history --dry-run: CU\xC1LES conversaciones (tel\xE9fono, nombre, primer mensaje, mensajes, si vino de anuncio)"],
+      ["--only-ads / --phones a,b", "history: importa (o lista) s\xF3lo las de anuncio y/o esos tel\xE9fonos"],
+      ["--column NAME", "history: las tarjetas nuevas nacen en esa columna en vez de la primera"],
       ["--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"],
@@ -10994,7 +11033,7 @@ var HELPS_ES = {
     flags: [
       ["--boxes", "las cajas del espacio contra su tope (spares, dormidas) y, por agente: conversaciones por caja, cajas, despiertas, spares, turnos corriendo ahora"],
       ["--workspace SLUG", "qu\xE9 espacio (due\xF1o o staff); con --boxes el default es el de ghosty use"],
-      ["--by agent|day|agent,day", "--workspace: filas por agente (default), por d\xEDa (CDMX) o las dos"],
+      ["--by agent|day|agent,day", "--workspace: filas por agente (default), por d\xEDa (CDMX) o las dos \xB7 con --boxes: template = toda la flota por template (staff)"],
       ["--days N", "--workspace: cu\xE1ntos d\xEDas hacia atr\xE1s (default 14, m\xE1x. 92)"]
     ],
     notes: ["failed = turnos que terminaron en error o se detuvieron. \xABno balance\xBB = mensajes que no abrieron turno porque se acab\xF3 la bolsa (ghosty turns ls --workspace X --quota-hits los lista)."]
@@ -11037,8 +11076,10 @@ var HELPS_ES = {
     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.",
+    summary: "Espacios: lista los tuyos (o, staff, los de cualquiera) y operaciones del staff de Ghosty \u2014 entrar/salir del espacio de un cliente, cambiar su combo, mover \xABpagado hasta\xBB, renombrar su slug. Cada cambio queda en la bit\xE1cora del espacio.",
     flags: [
+      ["--user EMAIL", "ls (staff): los espacios de esa persona"],
+      ["--combo C", "set (staff): teams | sales | both \u2014 sin Ventas sus tableros existen pero nadie los ve"],
       ["--until DATE", "renew: el nuevo \xABpagado hasta\xBB (AAAA-MM-DD)"],
       ["--note TEXT", "renew: por qu\xE9 (va a la bit\xE1cora)"],
       ["-n, --dry-run", "ense\xF1a qu\xE9 cambia, no cambia nada"],
@@ -11047,7 +11088,7 @@ var HELPS_ES = {
     notes: ["Con suscripci\xF3n de Stripe renew se niega: la fecha la mueve la factura pagada.", "rename cambia s\xF3lo el slug (id y namespace se quedan, as\xED que tablero, Stripe y WhatsApp siguen funcionando); las ligas viejas <slug>.sales dejan de servir."]
   }
 };
-var HELP_ALIASES = { creds: "credentials", board: "cards", conversations: "chat" };
+var HELP_ALIASES = { creds: "credentials", board: "cards", conversations: "chat", workspaces: "spaces" };
 
 // src/help.ts
 var DOCS = "https://www.ghosty.studio/docs/cli";
@@ -11122,7 +11163,8 @@ var HELPS = {
       ["--from-workspace", "rm: turn it off in every Teams where it's active, then delete it (owner or staff)"],
       ["--prompt-mode M", "set: append (default: its prompt + Ghosty's persona) or replace (its prompt only)"],
       ["--sponsor/--owner EMAIL", "ls: agents of ANY account paid by / owned by that email (Ghosty staff); then operate them by id"],
-      ["--ids", "ls: only the ids, one per line (for xargs)"]
+      ["--ids", "ls: only the ids, one per line (for xargs)"],
+      ["--user EMAIL --app A", "ls (Ghosty staff): that person's list exactly as their app gets it (tone, space, last use); A = all|android|ios|desktop"]
     ],
     examples: [
       "ghosty agents doctor cmu7pgbyr0001gee3ruk172mm",
@@ -11369,6 +11411,10 @@ 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)"],
+    ["--ads-only on|off", "link: only conversations that come from an ad open a card (also alone, to change it on a linked number)"],
+    ["--list", "history --dry-run: WHICH conversations (phone, name, first message, messages, from an ad)"],
+    ["--only-ads / --phones a,b", "history: import (or list) only the ones from an ad and/or those phones"],
+    ["--column NAME", "history: new cards are born in that column instead of the first one"],
     ["--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"],
@@ -11516,7 +11562,7 @@ HELPS.usage = {
   flags: [
     ["--boxes", "the workspace's boxes against its limit (spares, asleep) and, per agent: conversations per box, boxes, awake, spares, turns running now"],
     ["--workspace SLUG", "which workspace (owner or staff); with --boxes the default is the one from ghosty use"],
-    ["--by agent|day|agent,day", "--workspace: rows per agent (default), per day (CDMX) or both"],
+    ["--by agent|day|agent,day", "--workspace: rows per agent (default), per day (CDMX) or both \xB7 with --boxes: template = the whole fleet by template (staff)"],
     ["--days N", "--workspace: how far back (default 14, max 92)"]
   ],
   examples: ["ghosty usage", "ghosty usage --json", "ghosty usage --workspace descti --by agent,day --days 14", "ghosty usage --boxes --workspace siiqtec"],
@@ -11591,18 +11637,21 @@ HELPS.novedades = {
   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]"],
+  summary: "Workspaces: list yours (or, staff, anyone's), and Ghosty staff operations \u2014 join/leave a client's workspace, change its combo, move \xABpaid until\xBB, rename its slug. Each change is logged in the workspace's audit.",
+  usage: ["ghosty spaces ls [--user EMAIL]", "ghosty spaces join|leave <workspace>", "ghosty spaces set <workspace> --combo teams|sales|both [--dry-run]", "ghosty spaces renew <workspace> --until YYYY-MM-DD [--note TEXT] [--dry-run] [--yes]", "ghosty spaces rename <old> <new> [--dry-run] [--yes]"],
   flags: [
+    ["--user EMAIL", "ls (staff): that person's workspaces"],
+    ["--combo C", "set (staff): teams | sales | both \u2014 without Sales its boards exist but nobody sees them"],
     ["--until DATE", "renew: the new \xABpaid until\xBB (YYYY-MM-DD)"],
     ["--note TEXT", "renew: why (goes into the audit)"],
     ["-n, --dry-run", "show what changes, change nothing"],
     ["--yes", "skip the confirmation (required without a terminal)"]
   ],
-  examples: ['ghosty spaces renew descti --until 2026-11-01 --note "pag\xF3 octubre"', "ghosty spaces rename totequim siiqtec --dry-run"],
+  examples: ["ghosty spaces ls", "ghosty spaces ls --user brenda@siiqtec.com", "ghosty spaces join denik", "ghosty spaces set denik --combo sales --dry-run", 'ghosty spaces renew descti --until 2026-11-01 --note "pag\xF3 octubre"', "ghosty spaces rename totequim siiqtec --dry-run"],
   notes: ["With a Stripe subscription renew refuses: the paid invoice moves the date.", "rename changes only the slug (id and namespace stay, so board, Stripe and WhatsApp keep working); old <slug>.sales links stop working."],
   learn: `${REF}#espacios`
 };
+HELPS.workspaces = HELPS.spaces;
 function helpText(cmd) {
   const base = HELPS[cmd];
   if (!base) return void 0;
@@ -11630,7 +11679,7 @@ import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile6 } from
 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");
-var DAY = 24 * 60 * 60 * 1e3;
+var TTL = 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @ghostystudio/cli@latest";
 function newer(a, b) {
   const pa = a.split(".").map(Number);
@@ -11638,14 +11687,15 @@ function newer(a, b) {
   for (let i = 0; i < 3; i++) if ((pa[i] ?? 0) !== (pb[i] ?? 0)) return (pa[i] ?? 0) > (pb[i] ?? 0);
   return false;
 }
-async function latestVersion() {
+async function latestVersion(current2) {
   if (process.env.GHOSTY_NO_UPDATE_CHECK || process.env.CI) return null;
   let cache2 = {};
   try {
     cache2 = JSON.parse(await readFile9(FILE, "utf8"));
   } catch {
   }
-  if (!cache2.checkedAt || Date.now() - cache2.checkedAt > DAY) {
+  if (current2 && cache2.latest && newer(current2, cache2.latest)) cache2.checkedAt = 0;
+  if (!cache2.checkedAt || Date.now() - cache2.checkedAt > TTL) {
     try {
       const r = await fetch("https://registry.npmjs.org/@ghostystudio/cli/latest", { signal: AbortSignal.timeout(1500) });
       const latest = (await r.json()).version;
@@ -11658,7 +11708,7 @@ async function latestVersion() {
   return cache2.latest ?? null;
 }
 async function updateNotice(current2) {
-  const latest = await latestVersion();
+  const latest = await latestVersion(current2);
   return latest && newer(latest, current2) ? t(`Update available: ${current2} \u2192 ${latest}. Run: ${UPGRADE}`, `Hay versi\xF3n nueva: ${current2} \u2192 ${latest}. Corre: ${UPGRADE}`) : null;
 }
 
@@ -12083,7 +12133,33 @@ ${bagsText(r)}`);
   }
 }
 async function spacesCmd(sub, slug, arg, v, context) {
-  const ex = "ghosty spaces renew <workspace> --until 2026-11-01 [--note TEXT] \xB7 rename <old> <new> [--dry-run]";
+  const ex = "ghosty spaces ls [--user EMAIL] \xB7 join|leave <workspace> \xB7 set <workspace> --combo teams|sales|both \xB7 renew <workspace> --until 2026-11-01 [--note TEXT] \xB7 rename <old> <new> [--dry-run]";
+  if (!sub || sub === "ls" || sub === "list") {
+    const r = await api(`/api/v2/workspaces${v.user ? `?user=${enc10(v.user)}` : ""}`);
+    const rows = r.workspaces.map((w) => ({ workspace: w.slug, role: w.role ?? "", plan: w.plan, combo: w.combo, owner: w.owner ?? "", paid: w.paidUntil ?? "" }));
+    return out(r, () => rows.length ? `${bold(r.user)}
+${table(rows, ["workspace", "role", "plan", "combo", "owner", "paid"])}` : dim(t(`${r.user} has no workspaces.`, `${r.user} no tiene espacios.`)));
+  }
+  if (sub === "join" || sub === "leave") {
+    slug = needSpace(slug, `ghosty spaces ${sub} <workspace>`);
+    const r = await api(wsPath(slug, "/staff"), { method: "POST", body: { join: sub === "join" } });
+    return out(r, () => `${lavender("\u2713")} ${r.joined ? t(`You're in ${r.workspace} as staff (no seat; logged). Leave: ghosty spaces leave ${r.workspace}`, `Entraste a ${r.workspace} como staff (sin asiento; queda en bit\xE1cora). Salir: ghosty spaces leave ${r.workspace}`) : t(`You left ${r.workspace}.`, `Saliste de ${r.workspace}.`)}`);
+  }
+  if (sub === "set") {
+    slug = needSpace(slug ?? context, "ghosty spaces set <workspace> --combo sales");
+    if (!v.combo) throw usage(t("Nothing to change.", "Nada que cambiar."), "--combo teams|sales|both");
+    const path = wsPath(slug, "/combo");
+    const plan = await api(path, { method: "POST", body: { combo: v.combo, dryRun: true } });
+    const line2 = `${plan.workspace}: combo ${plan.from} \u2192 ${plan.to}`;
+    if (!plan.changed) return out(plan, () => dim(t(`Nothing to do: ${plan.workspace} is already ${plan.to}.`, `Nada que hacer: ${plan.workspace} ya es ${plan.to}.`)));
+    if (v["dry-run"]) return out(plan, () => `${line2}
+${dim(t("Dry run: nothing changed.", "Simulaci\xF3n: no cambi\xF3 nada."))}`);
+    requireYesIfHeadless(v.yes, `ghosty spaces set ${slug} --combo ${v.combo}`);
+    await confirm(`${line2}
+${t("Change it?", "\xBFCambiarlo?")}`, { yes: v.yes, retry: `ghosty spaces set ${slug} --combo ${v.combo}` });
+    const r = await api(path, { method: "POST", body: { combo: v.combo } });
+    return out(r, () => `${lavender("\u2713")} ${r.workspace}: combo ${r.to}`);
+  }
   if (sub === "renew") {
     slug = needSpace(slug ?? context, ex);
     if (!v.until) throw usage(t("Missing --until YYYY-MM-DD.", "Falta --until AAAA-MM-DD."), `ghosty spaces renew ${slug} --until 2026-11-01`);
@@ -12335,6 +12411,18 @@ async function turnStats(v) {
     ].join("\n")
   );
 }
+async function fleetBoxes() {
+  const r = await api("/api/v2/support/boxes?by=template");
+  const rows = r.templates.map((x) => ({ template: x.template, boxes: x.boxes, on: x.on, asleep: x.asleep, ram: x.memMb.map((m) => `${m / 1024} GB`).join(", "), vcpu: x.vcpus.join(", "), "ram on": `${(x.ramOnMb / 1024).toFixed(1)} GB` }));
+  out(r, () => `${bold(t(`${r.total} box(es), ${r.on} awake`, `${r.total} caja(s), ${r.on} despiertas`))}
+${table(rows, ["template", "boxes", "on", "asleep", "ram", "vcpu", "ram on"])}`);
+}
+async function appAgentsOf(email, client) {
+  const r = await api(`/api/v2/support/app-agents?user=${enc12(email)}${client && client !== "all" ? `&client=${enc12(client)}` : ""}`);
+  const rows = r.agentes.map((a) => ({ id: a.id, name: a.nombre, engine: a.motor ?? "", model: a.modelo ?? "", tone: a.tono ?? t("(by position)", "(por posici\xF3n)"), space: a.espacio?.tipo === "workspace" ? a.espacio.nombre : a.espacio?.tipo ?? "", last: a.ultimaActividad ? cdmx(a.ultimaActividad) : "" }));
+  out(r, () => `${bold(r.user)} ${dim(r.client ? t(`as the ${r.client} app sees it`, `como lo ve la app de ${r.client}`) : t("all apps", "todas las apps"))}
+${table(rows, ["id", "name", "engine", "model", "tone", "space", "last"])}`);
+}
 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)}` : ""}`);
@@ -12415,18 +12503,21 @@ ${bold("Session")}
   whoami                    Show who you are signed in as
   use [workspace]           Default workspace for boards, agents create and agents ls   [--clear]
   completion zsh|bash|fish  Tab completion for commands, flags, agents and workspaces
-  usage                     Your plan and how much you've used this week and month   [--boxes: boxes vs the workspace limit]
+  usage                     Your plan and how much you've used this week and month   [--boxes: boxes vs the workspace limit \xB7 --boxes --by template: the whole fleet (staff)]
   usage --workspace SLUG    A workspace's turns and tokens per agent/day   [--by agent,day] [--days 14]
   plan apply [workspace]    Apply a scheduled plan now, showing what changes   [--dry-run]
   engines ls                Engines and models valid for --engine/--model   [--models]
 
 ${bold("Workspaces")}  ${dim("(changing them: Ghosty staff)")}
   bags ls|create|set|rm <workspace> ["bag"]   Token bags its agents spend from   [--tokens 20M] [--recurring on|off] [--hard-cap on|off] [--note]
+  spaces ls                                   Your workspaces (role, plan, combo)   [--user EMAIL: someone else's]
+  spaces join|leave <workspace>               Enter or leave a client's workspace as staff (no seat; logged)
+  spaces set <workspace> --combo sales        teams | sales | both (without Sales its boards are invisible)
   spaces renew <workspace> --until DATE       Move \xABpaid until\xBB (logged)   [--note] [--dry-run]
   spaces rename <old> <new>                   Change its slug only   [--dry-run]
 
 ${bold("Agents")}
-  agents ls                 List your agents   [--engine E] [--ids: only ids, for xargs]
+  agents ls                 List your agents   [--engine E] [--ids: only ids, for xargs] \xB7 --user EMAIL --app all|android|ios|desktop: as their app sees it (staff)
                             [--sponsor EMAIL | --owner EMAIL]  any account's agents (Ghosty staff)
   agents create             Create an agent                   --name [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,\u2026]
                             [--workspace SLUG] [--channels teams=off,\u2026]  born in a workspace, active in its Teams
@@ -12468,8 +12559,8 @@ ${bold("Configure an agent")}
   mcp get|set <id>                   MCP servers                    [--file servers.json]
   channels whatsapp ls|enable|disable <id> [number]   Which WhatsApp Business numbers it answers   [--dry-run]
   channels whatsapp integrations <id>    Its owner's WhatsApp Business numbers in Formmy (number, who answers today, Integration id)
-  channels whatsapp link|unlink <id> --integration ID --answer on|off   Bring a WhatsApp Business number from Formmy/EasyBits to this agent, or send it back   [--forward] [--dry-run]
-  channels whatsapp history <id> --integration ID [--days 7]   Bring its recent cards, messages, orders and files from Formmy (no duplicates; Formmy keeps files 7 days)   [--media] [--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] [--dry-run]
+  channels whatsapp history <id> --integration ID [--days 7]   Bring its recent cards, messages, orders and files from Formmy (no duplicates; Formmy keeps files 7 days)   [--media] [--dry-run [--list]] [--only-ads] [--phones a,b] [--column NAME]
   channels wa import <id> --from easybits:ID | --from-file F | --from-dir DIR --own-number yes|no   Move a personal WhatsApp session here, no QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Pair a personal WhatsApp by code (no QR)
   channels wa status|pause <id>           Personal WhatsApp: how it is / pause it (keeps the session)
@@ -12539,18 +12630,21 @@ ${bold("Sesi\xF3n")}
   whoami                    Muestra con qu\xE9 cuenta entraste
   use [espacio]             Espacio por default para boards, agents create y agents ls   [--clear]
   completion zsh|bash|fish  Autocompletado con TAB: comandos, opciones, agentes y espacios
-  usage                     Tu plan y cu\xE1nto llevas usado esta semana y este mes   [--boxes: cajas contra el tope del espacio]
+  usage                     Tu plan y cu\xE1nto llevas usado esta semana y este mes   [--boxes: cajas contra el tope del espacio \xB7 --boxes --by template: toda la flota (staff)]
   usage --workspace SLUG    Turnos y tokens de un espacio por agente/d\xEDa   [--by agent,day] [--days 14]
   plan apply [espacio]      Aplica ya un plan programado, ense\xF1ando qu\xE9 cambia   [--dry-run]
   engines ls                Motores y modelos v\xE1lidos para --engine/--model   [--models]
 
 ${bold("Espacios")}  ${dim("(cambiarlos: staff de Ghosty)")}
   bags ls|create|set|rm <espacio> ["bolsa"]   Bolsas de tokens de las que gastan sus agentes   [--tokens 20M] [--recurring on|off] [--hard-cap on|off] [--note]
+  spaces ls                                   Tus espacios (rol, plan, combo)   [--user CORREO: los de alguien m\xE1s]
+  spaces join|leave <espacio>                 Entra o sal del espacio de un cliente como staff (sin asiento; queda en bit\xE1cora)
+  spaces set <espacio> --combo sales          teams | sales | both (sin Ventas sus tableros no se ven)
   spaces renew <espacio> --until FECHA        Mueve \xABpagado hasta\xBB (queda en bit\xE1cora)   [--note] [--dry-run]
   spaces rename <viejo> <nuevo>               Cambia s\xF3lo su slug   [--dry-run]
 
 ${bold("Agentes")}
-  agents ls                 Lista tus agentes   [--engine E] [--ids: s\xF3lo ids, para xargs]
+  agents ls                 Lista tus agentes   [--engine E] [--ids: s\xF3lo ids, para xargs] \xB7 --user CORREO --app all|android|ios|desktop: como lo ve su app (staff)
                             [--sponsor CORREO | --owner CORREO]  agentes de cualquier cuenta (staff de Ghosty)
   agents create             Crea un agente                    --name [--engine] [--model] [--prompt | --prompt-file ARCHIVO] [--env K=V,\u2026]
                             [--workspace SLUG] [--channels teams=off,\u2026]  nace en un espacio, activo en su Teams
@@ -12592,8 +12686,8 @@ ${bold("Configurar un agente")}
   mcp get|set <id>                   Servidores MCP                 [--file servers.json]
   channels whatsapp ls|enable|disable <id> [n\xFAmero]   Qu\xE9 n\xFAmeros de WhatsApp Business contesta   [--dry-run]
   channels whatsapp integrations <id>    Los n\xFAmeros de WhatsApp Business de su due\xF1o en Formmy (n\xFAmero, qui\xE9n contesta hoy, id de la Integration)
-  channels whatsapp link|unlink <id> --integration ID --answer on|off   Trae un n\xFAmero de WhatsApp Business de Formmy/EasyBits a este agente, o devu\xE9lvelo   [--forward] [--dry-run]
-  channels whatsapp history <id> --integration ID [--days 7]   Trae de Formmy sus tarjetas, mensajes, pedidos y archivos recientes (sin duplicar; Formmy guarda los archivos 7 d\xEDas)   [--media] [--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] [--dry-run]
+  channels whatsapp history <id> --integration ID [--days 7]   Trae de Formmy sus tarjetas, mensajes, pedidos y archivos recientes (sin duplicar; Formmy guarda los archivos 7 d\xEDas)   [--media] [--dry-run [--list]] [--only-ads] [--phones a,b] [--column NOMBRE]
   channels wa import <id> --from easybits:ID | --from-file F | --from-dir DIR --own-number yes|no   Mueve aqu\xED una sesi\xF3n de WhatsApp personal, sin QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Vincula un WhatsApp personal con c\xF3digo (sin QR)
   channels wa status|pause <id>           WhatsApp personal: c\xF3mo est\xE1 / pausarlo (conserva la sesi\xF3n)
@@ -12654,7 +12748,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", "push", "novedades", "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", "workspaces", "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);
@@ -12836,6 +12930,12 @@ async function main() {
       button: { type: "string" },
       publish: { type: "boolean" },
       draft: { type: "boolean" },
+      "ads-only": { type: "string" },
+      list: { type: "boolean" },
+      "only-ads": { type: "boolean" },
+      phones: { type: "string" },
+      combo: { type: "string" },
+      app: { type: "string" },
       ids: { type: "boolean" },
       force: { type: "boolean" },
       reenv: { type: "boolean" },
@@ -12852,7 +12952,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.30.0" }, () => "0.30.0");
+  if (v.version) return out({ version: "0.31.0" }, () => "0.31.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -12898,6 +12998,7 @@ async function main() {
     case "apply":
       return applyCmd(sub, v);
     case "agents":
+      if ((sub === "ls" || sub === "list" || !sub) && v.user && v.app !== void 0) return appAgentsOf(v.user, v.app);
       if (sub === "ls" || sub === "list" || !sub) return agentsLs(v.all ? void 0 : v.workspace ?? context, { sponsor: v.sponsor, owner: v.owner, engine: v.engine, ids: v.ids, all: v.all });
       if (sub === "create" || sub === "new") {
         if (v.workspace === "none") delete v.workspace;
@@ -12964,6 +13065,7 @@ async function main() {
     case "partner":
       return partnerCmd(sub, a1, a2, { ...v, token: tokens.turn });
     case "usage":
+      if (v.boxes && v.by === "template") return fleetBoxes();
       if (v.boxes) return boxesUsage(v.workspace ?? context);
       if (v.workspace || v.by || v.days) return workspaceUsage(v.workspace ?? context, v);
       return meUsage();
@@ -12977,6 +13079,7 @@ async function main() {
       return bagsCmd(sub, a1, a2, v, context);
     case "spaces":
     case "space":
+    case "workspaces":
       return spacesCmd(sub, a1, a2, v, context);
     case "plan":
       return planCmd(sub, a1, v, context);
@@ -12994,7 +13097,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.30.0").catch(() => null);
+var notice = updateNotice("0.31.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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