@ghostystudio/cli 0.25.0 → 0.27.0

package/README.md

@@ -15,6 +15,11 @@ npm i -g @ghostystudio/cli && ghosty login
 ```bash
 ghosty whoami
 ghosty usage                                          # plan and usage this week / month (also: ghosty me usage)
+ghosty usage --workspace SLUG [--by agent,day] [--days 14]   # a workspace's turns and tokens per agent/day (owner or staff)
+ghosty engines ls [--models]                          # valid --engine / --model values and what each model costs
+ghosty bags ls|create|set|rm <workspace> ["bag"]      [--tokens 20M] [--recurring on|off] [--hard-cap on|off] [--note]   # token bags (changing: staff)
+ghosty spaces renew <workspace> --until YYYY-MM-DD   [--note] [--dry-run]   # staff
+ghosty spaces rename <old> <new>                     [--dry-run]            # staff, slug only
 ghosty agents ls
 ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,…] [--workspace SLUG] [--channels teams=off]
 ghosty agents get <id> [--fields name,model,prompt] [--prompt-out FILE]
@@ -23,7 +28,8 @@ ghosty apply <file|dir> [--agent X] [--create] [--prune] [--dry-run]   # make an
 ghosty agents set <id> [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,…] [--connect ID,…] [--disconnect ID,…] [--toolsets +crm]
 ghosty agents set <id> --prompt-base <base-id> --prompt-overlay overlay.json [--dry-run]   # prompt = another agent's + edits, kept in sync
 ghosty agents share|unshare <id> <email> [--role editor|admin]   # share without handing it over · agents shares <id> lists them
-ghosty agents rm <id> [--yes]
+ghosty agents rm <id> [--from-workspace] [--yes]   # --from-workspace: turn it off in Teams first
+ghosty agents set <id> [--tool wa:tool=off,…] [--bag NAME|none] [--avatar URL|FILE]
 ghosty agents restart <id>
 ghosty agents box <id> [--check PATH]… [--contains PATH=TEXT]… [--recycle]   # is its machine on the new image?
 ghosty agents demo enable|disable <id>
@@ -40,6 +46,7 @@ ghosty skills enable|disable <id> <slug> # turn one of its skills (or one of Gho
 ghosty skills templates <id>             # pdf-doc templates: its own and Ghosty's, and which folder wins
 ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--arg V]… [--external-write t1,t2] [--external-rows t:col+col] [--from easybits:ID --tables a,b --append --dry-run]
 ghosty turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
+ghosty turns ls --workspace SLUG --quota-hits [--days 14]   # messages that got no turn because the balance ran out
 ghosty turns show <id> [turn-id|last]    # what came in, what it answered, where the time went   [--full]
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
 ghosty channels whatsapp link|unlink <id> --integration ID --answer on|off   [--forward] [--dry-run]   # bring a WABA number from Formmy
@@ -63,6 +70,7 @@ ghosty conversations show <id> <conversation-id> [--limit 20]   # what was said
 ghosty schedule add <id> "what to do"    --in 30m | --at ISO  [--every 12h --until ISO] [--conversation ID] [--title T]
 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 credentials ls|set|rm [provider]  [--from-env VAR]   # never as an argument
@@ -79,6 +87,19 @@ 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.27.0
+
+- `schedule add <id> "…" --teams <workspace>#<room>[/<thread-id>] --at ISO | --in 30m`: at that time the agent answers in that Teams room or thread as if mentioned (with the room's memory). `schedule ls|rm <id> --teams <workspace>`.
+
+### Changes in 0.26.0
+
+- `ghosty engines ls [--models]`: engines and models valid for `--engine`/`--model`; an unknown model is rejected with the valid list (also without `--engine`).
+- `ghosty bags ls|create|set|rm <workspace>`: token bags, monthly or one-time (`--recurring off`); `agents set --bag NAME|none` hangs an agent on one. Changing them is Ghosty staff only.
+- `ghosty spaces renew <workspace> --until DATE` and `spaces rename <old> <new>` (staff, logged in the workspace's audit).
+- `ghosty usage --workspace SLUG --by agent,day`: turns, failed, billable tokens and «no balance» per agent and day; `turns ls --workspace SLUG --quota-hits` lists those messages (WhatsApp Business and Teams).
+- `agents set --tool [channel:]tool=on|off`, `--avatar URL|FILE` (its face in Teams); `agents rm --from-workspace` turns it off in Teams before deleting it.
+- `dbs import` asks you to type the database name when a replace leaves a table empty or loses more than half its rows.
+
 ### Changes in 0.9.1
 
 - `ghosty agents --help` describes every `agents demo` flag; `ghosty usage --help` has its own page.

package/dist/index.js

@@ -7476,6 +7476,9 @@ var SERVER_MESSAGES = [
   ["falta email", "missing email"],
   ["no est\xE1 compartido con {}", "it isn't shared with {}"],
   // — Motor, modelo y máquina del agente (updateFleetAgentConfig, createFleetAgentRecord)
+  ["motor desconocido: {}; v\xE1lidos: {} (ghosty engines ls)", "unknown engine: {}; valid: {} (ghosty engines ls)"],
+  ["el modelo {} no es del motor {}; v\xE1lidos: {} (ghosty engines ls)", "model {} doesn't belong to engine {}; valid: {} (ghosty engines ls)"],
+  ["modelo {} inv\xE1lido para {}; v\xE1lidos: {} (ghosty engines ls)", "invalid model {} for {}; valid: {} (ghosty engines ls)"],
   ["motor desconocido: {}", "unknown engine: {}"],
   ["el modelo {} no es del motor {}", "model {} doesn't belong to engine {}"],
   ["modelo {} inv\xE1lido para {}", "invalid model {} for {}"],
@@ -7967,6 +7970,50 @@ var SERVER_MESSAGES = [
   ["no tienes tablero de ventas asignado: p\xEDdele al due\xF1o que te asigne uno (ghosty.studio \u2192 Ventas)", "you have no sales board assigned: ask the owner to assign you one (ghosty.studio \u2192 Sales)"],
   ["no tienes tablero de ventas asignado", "you have no sales board assigned"],
   ["tu identidad se cambia desde el equipo, no en una conversaci\xF3n con clientes", "your identity is changed from the team, not in a conversation with customers"],
+  // — Espacios, bolsas, avatar y bajas (CLI 0.26)
+  ["las bolsas son topes pactados: s\xF3lo el staff de Ghosty", "bags are agreed caps: Ghosty staff only"],
+  ["renovar un espacio: s\xF3lo el staff de Ghosty", "renewing a workspace: Ghosty staff only"],
+  ["renombrar un espacio: s\xF3lo el staff de Ghosty", "renaming a workspace: Ghosty staff only"],
+  ["s\xF3lo el due\xF1o de \xAB{}\xBB o el staff de Ghosty", "only the owner of \xAB{}\xBB or Ghosty staff"],
+  ["la bolsa de un agente s\xF3lo la cambia el staff de Ghosty", "only Ghosty staff changes an agent's bag"],
+  ["este agente no tiene espacio: no puede tener bolsa", "this agent has no workspace: it can't have a bag"],
+  ["no hay bolsa \xAB{}\xBB en su espacio; hay: {}", "no bag \xAB{}\xBB in its workspace; there are: {}"],
+  ["no hay bolsa \xAB{}\xBB en su espacio (no tiene bolsas: ghosty bags create)", "no bag \xAB{}\xBB in its workspace (it has none: ghosty bags create)"],
+  ["no hay bolsa \xAB{}\xBB en {}", "no bag \xAB{}\xBB in {}"],
+  ["ya hay una bolsa \xAB{}\xBB en {}", "there's already a bag \xAB{}\xBB in {}"],
+  ["falta name: el cliente lo ve en Ajustes \u2192 Uso", "missing name: the customer sees it in Settings \u2192 Usage"],
+  ["falta tokens", "missing tokens"],
+  ["tokens: un n\xFAmero \u2265 0 (facturables)", "tokens: a number \u2265 0 (billable)"],
+  ["{} agente{} usa{} \xAB{}\xBB: mu\xE9velos a otra bolsa primero", "{} agent{} use{} \xAB{}\xBB: move them to another bag first"],
+  ["esa bolsa no es de este espacio", "that bag isn't from this workspace"],
+  ["esa bolsa no es del espacio de este agente", "that bag isn't from this agent's workspace"],
+  ["la bolsa necesita un nombre: el cliente lo ve en Ajustes \u2192 Uso", "the bag needs a name: the customer sees it in Settings \u2192 Usage"],
+  ["fecha inv\xE1lida: \xAB{}\xBB (AAAA-MM-DD)", "invalid date: \xAB{}\xBB (YYYY-MM-DD)"],
+  ["{} paga con Stripe: \xABpagado hasta\xBB lo mueve la factura pagada, no se toca a mano", "{} pays with Stripe: the paid invoice moves \xABpaid until\xBB, it isn't changed by hand"],
+  ["slug inv\xE1lido: \xAB{}\xBB (2 a 40 letras min\xFAsculas, n\xFAmeros o guiones; no reservado)", "invalid slug: \xAB{}\xBB (2 to 40 lowercase letters, digits or dashes; not reserved)"],
+  ["el slug {} ya es de otro espacio", "slug {} already belongs to another workspace"],
+  ["el slug {} lo tiene un tablero de prueba (vence {})", "slug {} is taken by a trial board (expires {})"],
+  ["quedan con el nombre viejo: https://{}.sales\u2026 (404) y https://{}.teams\u2026 (vivo hasta reiniciar Teams)", "these keep the old name: https://{}.sales\u2026 (404) and https://{}.teams\u2026 (alive until Teams restarts)"],
+  ["tiene cajas de CI: los runners usan la etiqueta ws-{}; hay que re-registrarlos y cambiar runs-on", "it has CI boxes: the runners use the label ws-{}; re-register them and change runs-on"],
+  ["\xA1cambiaron campos que no deb\xEDan! {}", "fields that shouldn't change did! {}"],
+  ["el token del agente no cambia su avatar: usa tu sesi\xF3n", "the agent's token doesn't change its avatar: use your session"],
+  ["manda la imagen (image/png|jpeg|webp) o {url: https://\u2026}", "send the image (image/png|jpeg|webp) or {url: https://\u2026}"],
+  ["no est\xE1 activado en ning\xFAn Teams todav\xEDa: se le pone al activarlo", "not active in any Teams yet: it gets it when activated"],
+  ["s\xF3lo el due\xF1o (o staff) puede borrar el agente", "only the owner (or staff) can delete the agent"],
+  ["ghosty agents rm <agente> --from-workspace lo quita de Teams y lo borra", "ghosty agents rm <agent> --from-workspace takes it out of Teams and deletes it"],
+  ["Se acab\xF3 el saldo de este agente ({}). Era una carga \xFAnica y no se recarga. Los dem\xE1s agentes del espacio siguen con el suyo.", "This agent ran out of balance ({}). It was a one-time load and doesn't refill. The other agents in the workspace keep theirs."],
+  ["el token del agente no programa turnos en Teams: usa tu sesi\xF3n", "the agent's token doesn't schedule turns in Teams: use your session"],
+  ["falta workspace (el espacio de Teams)", "missing workspace (the Teams workspace)"],
+  ["no eres miembro de \xAB{}\xBB", "you're not a member of \xAB{}\xBB"],
+  ["el agente no est\xE1 activo en el Teams de {}", "the agent isn't active in {}'s Teams"],
+  ["faltan channel, text o dueAt (ISO)", "missing channel, text or dueAt (ISO)"],
+  ["no pude hablar con Teams de {}: {}", "couldn't reach {}'s Teams: {}"],
+  ["@{} no est\xE1 activo en este espacio", "@{} isn't active in this workspace"],
+  ["no hay un room \xAB{}\xBB en este espacio", "there's no room \xAB{}\xBB in this workspace"],
+  ["el mensaje {} no es de #{}", "message {} isn't from #{}"],
+  ["el mensaje {} es una respuesta; usa el del inicio del hilo ({})", "message {} is a reply; use the one that starts the thread ({})"],
+  ["dueAt tiene que ser una fecha futura (epoch en segundos)", "dueAt must be a future date (epoch seconds)"],
+  ["no hay un turno pendiente con ese id (\xBFya corri\xF3?)", "no pending turn with that id (did it already run?)"],
   // — 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"],
@@ -8268,7 +8315,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.25.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.27.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8310,7 +8357,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.25.0"}`,
+      "user-agent": `ghosty-cli/${"0.27.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -8591,6 +8638,15 @@ async function agentsGet(id, fields, promptOut) {
 }
 async function agentsSet(id, v) {
   id = need(id, "agent id", "ghosty agents set <agent-id> --prompt-file PROMPT.md");
+  const done = [];
+  if (v.bag) {
+    const r2 = await api(agentPath(id), { method: "PATCH", body: { bag: v.bag === "none" ? null : v.bag } });
+    done.push(r2.bag ? t(`bag \xAB${r2.bag}\xBB`, `bolsa \xAB${r2.bag}\xBB`) : t("workspace balance (no bag)", "saldo del espacio (sin bolsa)"));
+  }
+  if (v.avatar) {
+    const r2 = await setAvatar(id, v.avatar);
+    done.push(`avatar ${r2.avatar}${r2.workspaces.length ? dim(t(` (Teams: ${r2.workspaces.join(", ")})`, ` (Teams: ${r2.workspaces.join(", ")})`)) : r2.note ? dim(` (${serverText(r2.note)})`) : ""}`);
+  }
   if (v["prompt-base"]) {
     const unlink = v["prompt-base"] === "none";
     if (!unlink && !v["prompt-overlay"]) throw usage(t("Missing --prompt-overlay FILE.", "Falta --prompt-overlay FILE."), t("Its format", "Su formato") + ': {"edits":[{"what":"name","find":"Tania","replace":"Pia","all":true}]} (regex: true ' + t("for patterns", "para patrones") + ")");
@@ -8628,6 +8684,22 @@ ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
     next.delete("core");
     body.tools = { toolsets: [...next] };
   }
+  if (v.tool) {
+    const cur = await api(agentPath(id, "?fields=tools"));
+    const canales = cur.tools?.canales ?? {};
+    const known = new Set(Object.values(canales).flatMap((m) => Object.keys(m)));
+    const tools = { gs: {}, canales: {} };
+    for (const item of v.tool.split(",").map((x) => x.trim()).filter(Boolean)) {
+      const m = /^(?:([a-z]+):)?([a-z0-9_-]+)=(on|off)$/i.exec(item);
+      if (!m) throw usage(t(`Bad --tool entry: ${item}.`, `Entrada de --tool inv\xE1lida: ${item}.`), t("Use [channel:]tool=on|off, e.g. wa:actualizar_identidad=off", "Usa [canal:]tool=on|off, p. ej. wa:actualizar_identidad=off"));
+      const [, ch, tool, onOff] = m;
+      if (!known.has(tool)) throw usage(t(`Unknown tool: ${tool}.`, `Tool desconocida: ${tool}.`), t(`List them: ghosty agents get ${id} --fields tools`, `L\xEDstalas: ghosty agents get ${id} --fields tools`));
+      if (ch && !(ch in canales)) throw usage(t(`Unknown channel: ${ch}.`, `Canal desconocido: ${ch}.`), `${t("Channels", "Canales")}: ${Object.keys(canales).join(", ")}`);
+      if (ch) (tools.canales[ch] ??= {})[tool] = onOff === "on";
+      else tools.gs[tool] = onOff === "on";
+    }
+    body.tools = { ...body.tools ?? {}, ...tools };
+  }
   const env = parseEnv(v.env);
   const unset = (v["unset-env"] ?? "").split(",").map((k) => k.trim()).filter(Boolean);
   if (env || unset.length) body.env = { ...env ?? {}, ...Object.fromEntries(unset.map((k) => [k, ""])) };
@@ -8651,18 +8723,32 @@ ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
     if (v["auto-stage"] !== "on" && v["auto-stage"] !== "off") throw usage(t("--auto-stage takes on or off.", "--auto-stage acepta on u off."));
     body.autoStage = v["auto-stage"] === "on";
   }
-  if (!Object.keys(body).length) throw usage(t("Nothing to change.", "Nada que cambiar."), t("Use", "Usa") + " --name, --engine, --model, --prompt, --prompt-file, --env, --unset-env, --channels, --toolsets, --connect, --disconnect, --voice, --voice-replies " + t("or", "o") + " --auto-stage.");
+  if (!Object.keys(body).length && done.length) return out({ id, updated: done }, () => `${lavender("\u2713")} ${t("Updated", "Actualizado")}: ${done.join(" \xB7 ")}`);
+  if (!Object.keys(body).length) throw usage(t("Nothing to change.", "Nada que cambiar."), t("Use", "Usa") + " --name, --engine, --model, --prompt, --prompt-file, --env, --unset-env, --channels, --toolsets, --tool, --connect, --disconnect, --voice, --voice-replies, --auto-stage, --bag " + t("or", "o") + " --avatar.");
   const r = await api(agentPath(id), { method: "PATCH", body });
-  out(r, () => `${lavender("\u2713")} ${t("Updated", "Actualizado")}: ${Object.keys(body).join(", ")}.`);
+  out(r, () => `${lavender("\u2713")} ${t("Updated", "Actualizado")}: ${[...Object.keys(body), ...done].join(", ")}.`);
 }
 async function agentsRm(id, v = {}) {
-  id = need(id, "agent id", "ghosty agents rm <agent-id>");
-  requireYesIfHeadless(v.yes, `ghosty agents rm ${id}`);
+  id = need(id, "agent id", "ghosty agents rm <agent-id> [--from-workspace]");
+  const from = v["from-workspace"];
+  const retry = `ghosty agents rm ${id}${from ? " --from-workspace" : ""}`;
+  requireYesIfHeadless(v.yes, retry);
   if (!v.yes) {
     const a = await api(agentPath(id, "?fields=name"));
-    await confirm(t(`Delete agent ${a.name ?? id}? Its machine, memory and files go too. This can't be undone.`, `\xBFBorrar el agente ${a.name ?? id}? Se van tambi\xE9n su m\xE1quina, memoria y archivos. No se puede deshacer.`), { expect: a.name || id, retry: `ghosty agents rm ${id}` });
+    const teams = from ? t(" It's turned off in every Teams where it's active first.", " Antes se desactiva en cada Teams donde est\xE9 activo.") : "";
+    await confirm(t(`Delete agent ${a.name ?? id}? Its machine, memory and files go too. This can't be undone.${teams}`, `\xBFBorrar el agente ${a.name ?? id}? Se van tambi\xE9n su m\xE1quina, memoria y archivos. No se puede deshacer.${teams}`), { expect: a.name || id, retry });
   }
-  out(await api(agentPath(id), { method: "DELETE" }), () => `${lavender("\u2713")} ${t("Deleted", "Borrado")} ${id}.`);
+  const r = await api(agentPath(id, from ? "?fromWorkspace=1" : ""), { method: "DELETE" });
+  out(r, () => `${lavender("\u2713")} ${t("Deleted", "Borrado")} ${id}.${r?.unbound?.length ? dim(t(` Turned off in Teams: ${r.unbound.join(", ")}.`, ` Desactivado en Teams: ${r.unbound.join(", ")}.`)) : ""}`);
+}
+async function setAvatar(id, src) {
+  if (/^https:\/\//.test(src)) return api(agentPath(id, "/avatar"), { method: "PUT", body: { url: src } });
+  const bytes = await readFile3(src).catch(() => {
+    throw usage(t(`Can't read ${src}.`, `No puedo leer ${src}.`), t("--avatar takes an https:// link or a local JPEG/PNG/WebP file.", "--avatar acepta una liga https:// o un archivo JPEG/PNG/WebP local."));
+  });
+  const ext = src.toLowerCase().split(".").pop();
+  const type = ext === "png" ? "image/png" : ext === "webp" ? "image/webp" : "image/jpeg";
+  return api(agentPath(id, "/avatar"), { method: "PUT", raw: new Uint8Array(bytes), headers: { "content-type": type } });
 }
 async function agentsShare(sub, id, email, v) {
   id = need(id, "agent id", "ghosty agents share <agent-id> <email> [--role admin|editor]");
@@ -9153,7 +9239,40 @@ var short = (s, n = 60) => s.length > n ? s.slice(0, n - 1) + "\u2026" : s;
 async function agentSchedule(agent) {
   return api(`/api/v2/me/agents/${enc4(agent)}/schedule`);
 }
+function parseTeamsTarget(raw) {
+  const m = /^([a-z0-9-]+)(?:#([^/\s]+)(?:\/(\d+))?)?$/i.exec(raw.trim());
+  if (!m) throw usage(t(`Bad --teams: ${raw}.`, `--teams inv\xE1lido: ${raw}.`), t("Use workspace#room or workspace#room/<thread message id>, e.g. descti#general/4812", "Usa espacio#room o espacio#room/<id del mensaje del hilo>, p. ej. descti#general/4812"));
+  return { workspace: m[1], ...m[2] ? { channel: m[2] } : {}, ...m[3] ? { parentId: Number(m[3]) } : {} };
+}
+async function teamsSchedule(sub, agent, arg, v) {
+  const target = parseTeamsTarget(v.teams);
+  const path = `/api/v2/agents/${enc4(agent)}/teams-schedule`;
+  const when = (epoch) => new Date(epoch * 1e3).toLocaleString("es-MX", { timeZone: "America/Mexico_City", dateStyle: "medium", timeStyle: "short" });
+  if (sub === "ls" || sub === "list") {
+    const r2 = await api(`${path}?workspace=${enc4(target.workspace)}`);
+    const rows = r2.scheduled.map((x) => ({ id: x.id, due: when(x.dueAt), where: `#${x.channel}${x.parentId ? `/${x.parentId}` : ""}`, by: x.by, text: short(x.text) }));
+    return out(r2, () => rows.length ? table(rows, ["id", "due", "where", "by", "text"]) : dim(t("No scheduled turns in Teams.", "No hay turnos programados en Teams.")));
+  }
+  if (sub === "rm" || sub === "cancel") {
+    if (!arg) throw usage(t("Missing schedule id.", "Falta el id del turno."), `ghosty schedule rm <agent-id> <id> --teams ${target.workspace}`);
+    const r2 = await api(path, { method: "DELETE", body: { workspace: target.workspace, id: arg } });
+    return out(r2, () => `${lavender("\u2713")} ${t("Canceled.", "Cancelado.")}`);
+  }
+  if (sub !== "add") throw usage(t(`Unknown schedule subcommand: ${sub ?? "(none)"}.`, `Subcomando de schedule desconocido: ${sub ?? "(ninguno)"}.`), "ghosty schedule add|ls|rm <agent-id> \u2026 --teams workspace#room[/thread]");
+  if (!arg) throw usage(t("Missing what to do.", "Falta qu\xE9 hacer."), `ghosty schedule add <agent-id> "\u2026" --teams ${v.teams} --at 2026-10-01T09:00`);
+  if (!target.channel) throw usage(t("Missing the room.", "Falta el room."), t("Use --teams workspace#room or workspace#room/<thread id>", "Usa --teams espacio#room o espacio#room/<id del hilo>"));
+  if (!v.at && !v.in) throw usage(t("Say when.", "Di cu\xE1ndo."), t("Use --in 30m or --at 2026-10-01T09:00-06:00", "Usa --in 30m o --at 2026-10-01T09:00-06:00"));
+  if (v.at && v.in) throw usage(t("Use --at or --in, not both.", "Usa --at o --in, no ambos."));
+  if (v.every) throw usage(t("--every is not supported with --teams yet.", "--every todav\xEDa no va con --teams."));
+  const dueAt = v.in ? new Date(Date.now() + minutesOf(v.in, "--in") * 6e4).toISOString() : isoOf(v.at, "--at");
+  const r = await api(path, { method: "POST", body: { workspace: target.workspace, channel: target.channel, ...target.parentId ? { parentId: target.parentId } : {}, text: arg, dueAt } });
+  out(r, () => `${lavender("\u2713")} ${t(`@${r.handle} will answer in #${r.channel}${r.parentId ? ` (thread ${r.parentId})` : ""} on ${when(r.dueAt)}.`, `@${r.handle} contestar\xE1 en #${r.channel}${r.parentId ? ` (hilo ${r.parentId})` : ""} el ${when(r.dueAt)}.`)} ${dim(`id ${r.id} \xB7 ${t("cancel", "cancelar")}: ghosty schedule rm ${agent} ${r.id} --teams ${target.workspace}`)}`);
+}
 async function scheduleCmd(sub, agent, arg, v) {
+  if (v.teams) {
+    if (!agent) throw usage(t("Missing agent id.", "Falta el id del agente."), 'ghosty schedule add <agent-id> "\u2026" --teams workspace#room/thread --at ISO');
+    return teamsSchedule(sub, agent, arg, v);
+  }
   if (sub === "ls" || sub === "list") {
     if (!agent) throw usage(t("Missing agent id.", "Falta el id del agente."), t("Example", "Ejemplo") + ": ghosty schedule ls <agent-id>");
     const r = await agentSchedule(agent);
@@ -9305,7 +9424,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.25.0"}`
+        "user-agent": `ghosty-cli/${"0.27.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -9526,6 +9645,19 @@ function gsOnlyWarnings(gs) {
 ${lines.join("\n")}
 ${dim(t("Other agents may be writing there already: leave those tables out (--tables) or use --append.", "Puede que otros agentes ya escriban ah\xED: deja fuera esas tablas (--tables) o usa --append."))}`;
 }
+function shrinking(plan) {
+  return plan.filter((p) => p.action === "replace" && p.targetRows > 0 && (p.resultRows === 0 || p.resultRows < p.targetRows / 2));
+}
+function shrinkWarnings(plan) {
+  const s = shrinking(plan);
+  if (!s.length) return "";
+  const lines = s.map(
+    (p) => red(p.resultRows === 0 ? t(`  ! ${p.table}: would be left EMPTY (${p.targetRows} \u2192 0)`, `  ! ${p.table}: quedar\xEDa VAC\xCDA (${p.targetRows} \u2192 0)`) : t(`  ! ${p.table}: loses ${p.targetRows - p.resultRows} of ${p.targetRows} rows`, `  ! ${p.table}: pierde ${p.targetRows - p.resultRows} de ${p.targetRows} filas`))
+  );
+  return `
+${lines.join("\n")}
+${dim(t("Is the source the right database? Leave those tables out with --tables.", "\xBFLa base de origen es la correcta? D\xE9jalas fuera con --tables."))}`;
+}
 function planText(plan) {
   return plan.map((p) => p.action === "create" ? t(`  + ${p.table}  create, ${p.sourceRows} row(s)`, `  + ${p.table}  crear, ${p.sourceRows} fila(s)`) : t(`  ~ ${p.table}  ${p.action} ${p.targetRows} \u2192 ${p.resultRows} row(s)`, `  ~ ${p.table}  ${p.action === "replace" ? "reemplazar" : "agregar"} ${p.targetRows} \u2192 ${p.resultRows} fila(s)`)).join("\n");
 }
@@ -9538,12 +9670,12 @@ async function dbsImport(id, db, v) {
   const body = { from: "easybits", sourceDb: m[1], easybitsKey, mode: v.append ? "append" : "replace", ...v.tables ? { tables: csv(v.tables) } : {}, ...v["rehost-images"] ? { rehost: csv(v["rehost-images"]) } : {} };
   const path = agentPath2(id, `/dbs/${enc6(db)}/import`);
   const dry = await api(path, { body: { ...body, dryRun: true } });
-  if (v["dry-run"]) return out(dry, () => `${dry.db} \u2190 easybits:${m[1]}
-${planText(dry.plan)}${importWarnings(dry.warnings)}${gsOnlyWarnings(dry.gsOnly)}
+  if (v["dry-run"]) return out({ ...dry, shrinking: shrinking(dry.plan).map((p) => p.table) }, () => `${dry.db} \u2190 easybits:${m[1]}
+${planText(dry.plan)}${shrinkWarnings(dry.plan)}${importWarnings(dry.warnings)}${gsOnlyWarnings(dry.gsOnly)}
 ${dim(t("Dry run: nothing changed.", "Simulaci\xF3n: no cambi\xF3 nada."))}`);
   const destructive = dry.plan.some((p) => p.action === "replace" && p.targetRows > 0);
-  if (destructive) await confirm(`${planText(dry.plan)}${importWarnings(dry.warnings)}${gsOnlyWarnings(dry.gsOnly)}
-${t(`Replace the rows above in ${dry.db}?`, `\xBFReemplazar las filas de arriba en ${dry.db}?`)}`, { yes: v.yes, retry: `ghosty dbs import ${id} ${db} --from ${v.from}${v.tables ? ` --tables ${v.tables}` : ""}` });
+  if (destructive) await confirm(`${planText(dry.plan)}${shrinkWarnings(dry.plan)}${importWarnings(dry.warnings)}${gsOnlyWarnings(dry.gsOnly)}
+${t(`Replace the rows above in ${dry.db}?`, `\xBFReemplazar las filas de arriba en ${dry.db}?`)}`, { yes: v.yes, ...shrinking(dry.plan).length ? { expect: dry.db } : {}, retry: `ghosty dbs import ${id} ${db} --from ${v.from}${v.tables ? ` --tables ${v.tables}` : ""}` });
   const r = await api(path, { body });
   const img = r.rehosted ? `
 ${t(`${r.rehosted.copied} image link(s) now permanent`, `${r.rehosted.copied} liga(s) de imagen ya permanentes`)}${r.rehosted.failed.length ? `, ${red(String(r.rehosted.failed.length))} ${t("kept as they were", "se quedaron como estaban")}:
@@ -9751,8 +9883,37 @@ async function agentDocsCmd(sub, id, docs, v) {
       const r = await api(agentPath2(id, `/documents/${enc6(doc)}`), { method: "DELETE" });
       return out(r, () => `${lavender("\u2713")} ${r.name} ${t("revoked.", "revocado.")} ${dim(`${t("Undo", "Deshacer")}: ghosty agents docs grant ${id} "${r.name}"`)}`);
     }
+    case "replace": {
+      const ex = 'ghosty agents docs replace <agent-id> "Cat\xE1logo.pdf" --file nuevo.pdf   (o --url URL)';
+      doc = need2(doc, t("document (id or exact name)", "el documento (id o nombre exacto)"), ex);
+      if (!v.url === !v.file) throw usage(t("Use --url URL or --file PATH (one of them).", "Usa --url URL o --file RUTA (uno de los dos)."), t("Example", "Ejemplo") + ": " + ex);
+      const body = {
+        ...v.url ? { url: v.url } : { contentBase64: (await readFile6(v.file)).toString("base64") },
+        ...v.note ? { note: v.note } : {}
+      };
+      const r = await api(agentPath2(id, `/documents/${enc6(doc)}/versions`), { method: "POST", body });
+      return out(r, () => `${lavender("\u2713")} ${r.name}: ${t("version", "versi\xF3n")} ${r.version?.n ?? "?"} ${dim(`(${r.size} bytes)`)}. ${dim(`${t("Undo", "Deshacer")}: ghosty agents docs restore ${id} "${r.name}" ${(r.version?.n ?? 2) - 1}`)}`);
+    }
+    case "history":
+    case "versions": {
+      doc = need2(doc, t("document (id or exact name)", "el documento (id o nombre exacto)"), 'ghosty agents docs history <agent-id> "Cat\xE1logo.pdf"');
+      const r = await api(agentPath2(id, `/documents/${enc6(doc)}/versions`));
+      const rows = r.versions.map((x) => ({ v: `${x.n}${x.current ? "*" : ""}`, when: x.createdAt.slice(0, 16).replace("T", " "), by: x.agent ?? x.via ?? x.source, size: String(x.size), note: x.note ?? "" }));
+      const used = r.usedBy.map((u) => `${u.agent} (${u.mode === "write" ? t("updates it", "lo actualiza") + (u.writableFrom.length ? `: ${u.writableFrom.join(", ")}` : "") : t("reads it", "lo lee")})`).join(" \xB7 ");
+      return out(r, () => `${r.document.name}
+${table(rows, ["v", "when", "by", "size", "note"])}${used ? `
+${dim(t("Used by", "Lo usan"))}: ${used}` : ""}`);
+    }
+    case "restore": {
+      const ex = 'ghosty agents docs restore <agent-id> "Cat\xE1logo.pdf" <n>';
+      doc = need2(doc, t("document (id or exact name)", "el documento (id o nombre exacto)"), ex);
+      const n = Number(need2(docs[1], t("version number", "el n\xFAmero de versi\xF3n"), ex));
+      if (!Number.isInteger(n) || n < 1) throw usage(t("The version is a whole number (see docs history).", "La versi\xF3n es un n\xFAmero entero (mira docs history)."), ex);
+      const r = await api(agentPath2(id, `/documents/${enc6(doc)}/versions/${n}/restore`), { method: "POST", body: v.note ? { note: v.note } : {} });
+      return out(r, () => `${lavender("\u2713")} ${r.name}: ${t(`restored from v${n} as version`, `restaurado de la v${n} como versi\xF3n`)} ${r.version?.n ?? "?"}.`);
+    }
     default:
-      throw usage(t(`Unknown agents docs subcommand: ${sub}.`, `Subcomando de agents docs desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty agents docs ls | add | grant | revoke");
+      throw usage(t(`Unknown agents docs subcommand: ${sub}.`, `Subcomando de agents docs desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty agents docs ls | add | grant | replace | history | restore | revoke");
   }
 }
 function skipReason(r) {
@@ -10417,6 +10578,7 @@ var HELPS_ES = {
       ["--no-deliver", "docs grant/add: puede leerlo pero nunca mand\xE1rselo a quien escribe"],
       ["--url URL | --file PATH", "docs add: de d\xF3nde sale el documento (URL p\xFAblica, hasta 25 MB, o un archivo local)"],
       ["--grant read|write|no", "docs add: acceso de este agente (default read; no = s\xF3lo subirlo a la cuenta)"],
+      ["--note TEXT", "docs replace/restore: por qu\xE9 cambi\xF3 (sale en docs history)"],
       ["--role R", "share: editor (lo configura y lo usa) o admin (adem\xE1s lo comparte); repetirlo sobre un correo ya compartido cambia el rol"],
       ["--yes", "rm: se salta la confirmaci\xF3n (obligatorio sin terminal)"],
       ["--slug NAME", "demo: nombre de la liga; se le agrega un c\xF3digo de 6 caracteres (/p/NAME-CODE)"],
@@ -10431,7 +10593,11 @@ var HELPS_ES = {
       ["--check PATH", "box: este archivo debe existir en la m\xE1quina (repetible), p. ej. un archivo que trae la imagen nueva"],
       ["--contains PATH=TEXT", "box: ese archivo debe contener TEXT (un cambio que no agrega archivos)"],
       ["--recycle", "box: reemplaza sus m\xE1quinas (no a media respuesta); la nueva arranca en el siguiente turno. ACP: usa restart"],
-      ["--unset-env K1,K2", "set: borra esas variables del env (--env K= tambi\xE9n borra K)"]
+      ["--unset-env K1,K2", "set: borra esas variables del env (--env K= tambi\xE9n borra K)"],
+      ["--tool [ch:]tool=on|off", "set: prende/apaga una tool en un canal (wa:actualizar_identidad=off) o en todos (crm_buscar=off); separadas por comas"],
+      ["--bag NAME|none", "set: de qu\xE9 bolsa de tokens de su espacio gasta; none = el saldo del espacio (s\xF3lo staff)"],
+      ["--avatar URL|FILE", "set: su cara en Teams: una liga https o un JPEG/PNG/WebP local (se guarda en img.ghosty.studio)"],
+      ["--from-workspace", "rm: lo desactiva en cada Teams donde est\xE9 y luego lo borra (due\xF1o o staff)"]
     ],
     notes: [
       "doctor sale con 1 cuando encuentra un problema, as\xED puede frenar un script o un CI.",
@@ -10492,7 +10658,8 @@ var HELPS_ES = {
       ["--status S", "running | done | stopped | error"],
       ["--since T", "30m, 1h, 2d o una fecha ISO"],
       ["--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)"]
+      ["--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"]
     ],
     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)."]
   },
@@ -10527,7 +10694,8 @@ var HELPS_ES = {
   },
   schedule: {
     summary: "Turnos que corren despu\xE9s, con el reloj propio del agente.",
-    replace: [['"what to do"', '"qu\xE9 hacer"']]
+    replace: [['"what to do"', '"qu\xE9 hacer"'], ["# answers in that thread as if mentioned", "# contesta en ese hilo como si lo mencionaran"]],
+    notes: ["--teams: el agente tiene que estar activo en el Teams de ese espacio y t\xFA ser miembro. El id del hilo es el del mensaje con que empieza."]
   },
   me: { summary: "Tu cuenta: archivos y uso." },
   credentials: {
@@ -10656,8 +10824,40 @@ var HELPS_ES = {
     ]
   },
   usage: {
-    summary: "Tu plan y cu\xE1nto llevas usado esta semana y este mes. Con --boxes: las cajas y la capacidad de un espacio, por agente.",
-    flags: [["--boxes", "por agente: conversaciones por caja, cajas encendidas, turnos corriendo ahora; y lo que da el plan (paralelo, cajas, hosting)"], ["--workspace SLUG", "--boxes: qu\xE9 espacio (default: el de ghosty use)"]]
+    summary: "Tu plan y cu\xE1nto llevas usado esta semana y este mes. Con --workspace: turnos y tokens facturables de un espacio por agente y/o por d\xEDa. Con --boxes: sus cajas contra el tope.",
+    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"],
+      ["--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)."]
+  },
+  engines: {
+    summary: "Motores y modelos que puede usar un agente: los valores v\xE1lidos de --engine y --model, el default y cu\xE1nto cuesta cada modelo contra el saldo.",
+    flags: [["--models", "cada modelo de cada motor con su nombre, multiplicador de costo y si necesita tu propia llave"]]
+  },
+  bags: {
+    summary: "Las bolsas de tokens de un espacio: un tope con nombre del que gastan uno o varios agentes. Mensual (se recarga cada periodo) o de carga \xFAnica (cuenta desde que se cre\xF3 y no se recarga). Leer: due\xF1o o staff; cambiar: staff de Ghosty.",
+    flags: [
+      ["--tokens N", "tokens facturables: 20M, 500k o un n\xFAmero"],
+      ["--recurring on|off", "on = se recarga cada periodo (default); off = carga \xFAnica, cuenta desde hoy"],
+      ["--hard-cap on|off", "on = al 100% los turnos se frenan con \xABse acab\xF3 el saldo\xBB (default); off = s\xF3lo cuenta"],
+      ["--note TEXT", "qu\xE9 se pact\xF3 y qui\xE9n lo autoriz\xF3"],
+      ["--name NEW", "set: renombra la bolsa (el cliente la ve en Ajustes \u2192 Uso)"],
+      ["--yes", "rm: s\xE1ltate la confirmaci\xF3n (obligatorio sin terminal)"]
+    ],
+    notes: ["Un agente sin bolsa gasta del saldo del espacio. rm s\xF3lo borra una bolsa que ning\xFAn agente usa: mu\xE9velos primero (agents set --bag)."]
+  },
+  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: [
+      ["--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"],
+      ["--yes", "s\xE1ltate la confirmaci\xF3n (obligatorio sin terminal)"]
+    ],
+    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" };
@@ -10673,11 +10873,13 @@ var HELPS = {
       "ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,\u2026] [--workspace SLUG] [--channels teams=off,\u2026] [--like AGENT [--copy-dbs] [--board same|main|new|NAME] [--no-notify] [--dry-run]]",
       "ghosty agents get <agent-id> [--fields name,model,prompt] [--prompt-out FILE]",
       "ghosty agents export <agent-id> [--out DIR]   # the agent as a file; see ghosty apply --help",
-      "ghosty agents set <agent-id> [--name] [--engine] [--model] [--prompt | --prompt-file] [--env K=V,\u2026] [--unset-env K1,K2] [--connect ID,\u2026] [--disconnect ID,\u2026] [--voice E:ID] [--voice-replies auto|off] [--auto-stage on|off] [--toolsets crm,sales | +crm,-sales]",
+      "ghosty agents set <agent-id> [--name] [--engine] [--model] [--prompt | --prompt-file] [--env K=V,\u2026] [--unset-env K1,K2] [--connect ID,\u2026] [--disconnect ID,\u2026] [--voice E:ID] [--voice-replies auto|off] [--auto-stage on|off] [--toolsets crm,sales | +crm,-sales] [--tool [channel:]tool=on|off,\u2026] [--bag NAME|none] [--avatar URL|FILE]",
       "ghosty agents set <agent-id> --prompt-base <base-agent-id> --prompt-overlay overlay.json [--dry-run [--out FILE]]   |   --prompt-base none",
       "ghosty agents doctor <agent-id> [--verbose]",
       "ghosty agents docs ls|grant|revoke <agent-id> [doc\u2026] [--write] [--no-deliver] [--like AGENT]",
       "ghosty agents docs add <agent-id> --url URL | --file PATH [--name N] [--description TEXT] [--grant read|write|no] [--no-deliver]",
+      "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]",
       "ghosty agents unshare <agent-id> <email> [--yes]",
       "ghosty agents shares <agent-id>",
@@ -10685,7 +10887,7 @@ var HELPS = {
       "ghosty agents box <agent-id> [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle]",
       "ghosty agents demo enable|disable <agent-id>",
       'ghosty agents demo <agent-id> [--slug NAME] [--expires "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXT] [--starter TEXT] [--chips "a|b|c"] [--sponsor on|off] [--rotate]',
-      "ghosty agents rm <agent-id> [--yes]"
+      "ghosty agents rm <agent-id> [--from-workspace] [--yes]"
     ],
     flags: [
       ["--fields a,b", "get: return only these fields"],
@@ -10707,6 +10909,7 @@ var HELPS = {
       ["--no-deliver", "docs grant/add: it can read it but never send it to whoever writes"],
       ["--url URL | --file PATH", "docs add: where the document comes from (public URL, up to 25 MB, or a local file)"],
       ["--grant read|write|no", "docs add: access for this agent (default read; no = only upload to the account)"],
+      ["--note TEXT", "docs replace/restore: why it changed (shown in docs history)"],
       ["--role R", "share: editor (configures and uses it) or admin (also shares it); again on a shared email changes the role"],
       ["--yes", "rm: skip the confirmation (required without a terminal)"],
       ["--slug NAME", "demo: link name; a 6-char code is appended (/p/NAME-CODE)"],
@@ -10721,7 +10924,11 @@ var HELPS = {
       ["--check PATH", "box: this file must exist in the machine (repeatable), e.g. a file the new image brings"],
       ["--contains PATH=TEXT", "box: that file must contain TEXT (a change that adds no files)"],
       ["--recycle", "box: replace its machines (not mid-turn); the new one starts on the next turn. ACP: use restart"],
-      ["--unset-env K1,K2", "set: delete these env variables (--env K= also deletes K)"]
+      ["--unset-env K1,K2", "set: delete these env variables (--env K= also deletes K)"],
+      ["--tool [ch:]tool=on|off", "set: one tool on/off in one channel (wa:actualizar_identidad=off) or everywhere (crm_buscar=off); comma-separated"],
+      ["--bag NAME|none", "set: the token bag of its workspace it spends from; none = the workspace balance (staff only)"],
+      ["--avatar URL|FILE", "set: its face in Teams: an https link or a local JPEG/PNG/WebP (stored at img.ghosty.studio)"],
+      ["--from-workspace", "rm: turn it off in every Teams where it's active, then delete it (owner or staff)"]
     ],
     examples: [
       "ghosty agents doctor cmu7pgbyr0001gee3ruk172mm",
@@ -10730,6 +10937,8 @@ var HELPS = {
       'ghosty agents docs grant <id> "Cat\xE1logo 2026.pdf"',
       "ghosty agents docs grant <id> precios.xlsx --write --no-deliver",
       'ghosty agents docs add <id> --url https://example.com/lista.pdf --description "Precios 2026"',
+      'ghosty agents docs replace <id> "Cat\xE1logo.pdf" --file catalogo-oct.pdf --note "precios de octubre"',
+      'ghosty agents docs history <id> "Cat\xE1logo.pdf"   \xB7   ghosty agents docs restore <id> "Cat\xE1logo.pdf" 3',
       "ghosty agents create --name Pia --engine claude --workspace ventas --channels teams=off",
       "ghosty agents set <id> --toolsets +crm",
       "ghosty agents share <id> ana@empresa.com --role admin",
@@ -10740,7 +10949,10 @@ var HELPS = {
       "ghosty agents set <pia-id> --prompt-base <tania-id> --prompt-overlay capa.json --dry-run --out /tmp/pia.md",
       "ghosty agents demo enable <id>",
       'ghosty agents demo <id> --slug guardias --expires "2026-10-15T20:00" --starter "Ens\xE9\xF1ame c\xF3mo empezar"',
-      "ghosty agents box <id> --contains /opt/claude-worker/skills/pdf-doc/render-doc.mjs=pdf-templates"
+      "ghosty agents box <id> --contains /opt/claude-worker/skills/pdf-doc/render-doc.mjs=pdf-templates",
+      "ghosty agents set <id> --tool wa:actualizar_identidad=off,teams:actualizar_identidad=on",
+      'ghosty agents set minighosty --bag "MiniGhosty" --avatar https://www.ghosty.studio/avatars/minighosty.png',
+      "ghosty agents rm fable --from-workspace"
     ],
     notes: ["doctor exits 1 when it finds a problem, so it can gate a script or CI.", "A derived prompt can't be edited directly (409): change the base or the overlay, or unlink it with --prompt-base none.", "demo with no flags only prints its status: link, expiry, caps and numbers."],
     learn: `${REF}#agentes`
@@ -10826,16 +11038,17 @@ 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 show <agent-id> [turn-id | last] [--full]"],
+    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]"],
     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)"],
       ["--status S", "running | done | stopped | error"],
       ["--since T", "30m, 1h, 2d or an ISO date"],
       ["--limit N", "max rows (default 20, max 500)"],
-      ["--full", "show: the whole message that came in and the whole answer (default: first 600 chars)"]
+      ["--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"]
     ],
-    examples: ["ghosty turns ls <id> --errors --since 1h", "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"],
+    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"],
     notes: ["--skipped keeps 30 days and only sees what Formmy forwarded: if Formmy doesn't forward (ghosty channels whatsapp ls, \xABformmy forwards\xBB), gs never gets the message.", "show prints what came in and what went out on any engine or channel (WhatsApp groups too); the timeline reads the worker's transcript, so pool engines only (not ACP/goose)."],
     learn: `${REF}#turnos`
   },
@@ -10893,8 +11106,9 @@ var HELPS = {
   },
   schedule: {
     summary: "Turns that run later, on the agent's own clock.",
-    usage: ['ghosty schedule add <agent-id> "what to do" --in 30m | --at ISO [--every 12h --until ISO] [--conversation ID] [--title T]', "ghosty schedule ls <agent-id>", "ghosty schedule rm <agent-id> <schedule-id>"],
-    examples: ['ghosty schedule add <id> "revisa pedidos pendientes" --every 12h --in 1h'],
+    usage: ['ghosty schedule add <agent-id> "what to do" --in 30m | --at ISO [--every 12h --until ISO] [--conversation ID] [--title T]', "ghosty schedule ls <agent-id>", "ghosty schedule rm <agent-id> <schedule-id>", 'ghosty schedule add <agent-id> "what to do" --teams <workspace>#<room>[/<thread-id>] --in 30m | --at ISO', "ghosty schedule ls|rm <agent-id> [id] --teams <workspace>"],
+    examples: ['ghosty schedule add <id> "revisa pedidos pendientes" --every 12h --in 1h', 'ghosty schedule add minighosty "Pres\xE9ntate al equipo" --teams descti#general/4812 --at 2026-10-01T09:00   # answers in that thread as if mentioned'],
+    notes: ["--teams: the agent must be active in that workspace's Teams and you must be a member. The thread id is the id of the message that starts it."],
     learn: `${REF}#programar-turnos`
   },
   me: {
@@ -11084,12 +11298,58 @@ HELPS.board = HELPS.cards;
 HELPS.conversations = HELPS.chat;
 HELPS.usage = {
   ...HELPS.me,
-  summary: "Your plan and how much you've used this week and month. With --boxes: a workspace's boxes against its limit, and per agent.",
-  usage: ["ghosty usage", "ghosty me usage", "ghosty usage --boxes [--workspace SLUG]"],
-  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", "--boxes: which workspace (default: the one from ghosty use)"]],
-  examples: ["ghosty usage", "ghosty usage --json", "ghosty usage --boxes --workspace siiqtec"],
+  summary: "Your plan and how much you've used this week and month. With --workspace: a workspace's turns and billable tokens per agent and/or day. With --boxes: its boxes against its limit.",
+  usage: ["ghosty usage", "ghosty me usage", "ghosty usage --workspace SLUG [--by agent|day|agent,day] [--days 14]", "ghosty usage --boxes [--workspace SLUG]"],
+  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"],
+    ["--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"],
+  notes: ["failed = turns that ended in error or were stopped. \xABno balance\xBB = messages that got no turn because the bag ran out (ghosty turns ls --workspace X --quota-hits lists them)."],
   learn: `${REF}#uso`
 };
+HELPS.engines = {
+  summary: "Engines and models an agent can use: the valid values of --engine and --model, the default, and what each model costs against the balance.",
+  usage: ["ghosty engines ls [--models]"],
+  flags: [["--models", "every model of each engine with its label, cost multiplier and whether it needs your own key"]],
+  examples: ["ghosty engines ls", "ghosty engines ls --models", "ghosty engines ls --json"],
+  learn: `${REF}#agentes`
+};
+HELPS.bags = {
+  summary: "A workspace's token bags: a named top that one or more agents spend from. Monthly (refills every period) or one-time (counts from when it was created and never refills). Reading: owner or staff; changing: Ghosty staff.",
+  usage: [
+    "ghosty bags ls <workspace>",
+    'ghosty bags create <workspace> "<bag>" --tokens 20M [--recurring on|off] [--hard-cap on|off] [--note TEXT]',
+    'ghosty bags set <workspace> "<bag>" [--tokens 30M] [--recurring on|off] [--hard-cap on|off] [--note TEXT] [--name NEW]',
+    'ghosty bags rm <workspace> "<bag>" [--yes]'
+  ],
+  flags: [
+    ["--tokens N", "billable tokens: 20M, 500k or a plain number"],
+    ["--recurring on|off", "on = refills every period (default); off = one-time, counts from today"],
+    ["--hard-cap on|off", "on = at 100% turns stop with \xABout of balance\xBB (default); off = only counts"],
+    ["--note TEXT", "what was agreed and who approved it"],
+    ["--name NEW", "set: rename the bag (customers see it in Settings \u2192 Usage)"],
+    ["--yes", "rm: skip the confirmation (required without a terminal)"]
+  ],
+  examples: ["ghosty bags ls descti", 'ghosty bags create descti "MiniGhosty" --tokens 20M --note "pactado 30-sep"', 'ghosty bags set descti "Astra" --recurring off', 'ghosty agents set minighosty --bag "MiniGhosty"'],
+  notes: ["An agent with no bag spends from the workspace balance. rm only deletes a bag no agent uses: move them first (agents set --bag)."],
+  learn: `${REF}#espacios`
+};
+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]"],
+  flags: [
+    ["--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"],
+  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`
+};
 function helpText(cmd) {
   const base = HELPS[cmd];
   if (!base) return void 0;
@@ -11467,6 +11727,171 @@ ${table(rows, ["agent", "engine", "per box", "boxes", "on", "spares", "running n
 ${dim(t(`${r.totals.activeTurns} turn(s) running`, `${r.totals.activeTurns} turno(s) corriendo`))}`);
 }
 
+// src/commands/spaces.ts
+var enc10 = encodeURIComponent;
+var wsPath = (slug, rest = "") => `/api/v2/workspaces/${enc10(slug)}${rest}`;
+var needSpace = (slug, example) => {
+  if (!slug) throw usage(t("Which workspace?", "\xBFQu\xE9 espacio?"), `${t("Example", "Ejemplo")}: ${example}   ${t("(or ghosty use <workspace>)", "(o ghosty use <espacio>)")}`);
+  return slug;
+};
+function parseTokens(raw) {
+  const m = /^\s*(\d+(?:\.\d+)?)\s*([kKmM]?)\s*$/.exec(raw);
+  if (!m) throw usage(t(`Bad token amount: ${raw}.`, `Cantidad de tokens inv\xE1lida: ${raw}.`), t("Use 20M, 500k or a plain number.", "Usa 20M, 500k o un n\xFAmero."));
+  const n = Number(m[1]) * (m[2].toLowerCase() === "m" ? 1e6 : m[2].toLowerCase() === "k" ? 1e3 : 1);
+  return Math.round(n);
+}
+function fmtTokens(n) {
+  if (n >= 1e6) return `${+(n / 1e6).toFixed(n % 1e6 === 0 ? 0 : 1)}M`;
+  if (n >= 1e3) return `${Math.round(n / 1e3)}k`;
+  return String(n);
+}
+function parseSwitch(flag, raw) {
+  if (raw === void 0) return void 0;
+  if (/^(on|true|yes|s[ií])$/i.test(raw)) return true;
+  if (/^(off|false|no)$/i.test(raw)) return false;
+  throw usage(t(`${flag} takes on or off.`, `${flag} acepta on u off.`));
+}
+async function enginesCmd(sub, v) {
+  if (sub && sub !== "ls" && sub !== "list") throw usage(t(`Unknown engines subcommand: ${sub}.`, `Subcomando de engines desconocido: ${sub}.`), "ghosty engines ls [--models]");
+  const r = await api("/api/v2/engines");
+  out(r, () => {
+    if (!v.models) {
+      const rows = r.engines.map((e) => ({ engine: e.id, provider: e.provider, default: e.defaultModel ?? "", models: e.models.map((m) => m.id).join(", ") }));
+      return `${table(rows, ["engine", "provider", "default"])}
+${dim(t("Models per engine: ghosty engines ls --models", "Modelos de cada motor: ghosty engines ls --models"))}`;
+    }
+    return r.engines.map((e) => {
+      const rows = e.models.map((m) => ({ model: m.id + (m.id === e.defaultModel ? " *" : ""), label: m.label, cost: `${m.multiplier}\xD7`, note: m.ownKeyOnly ? t("your own key only", "s\xF3lo con llave propia") : "" }));
+      return `${bold(e.id)} ${dim(`${e.provider} \xB7 ${e.protocol}${e.vision ? t(" \xB7 sees images", " \xB7 ve im\xE1genes") : ""}`)}
+${table(rows, ["model", "label", "cost", "note"])}`;
+    }).join("\n\n") + `
+${dim(t("* default \xB7 cost = balance multiplier per turn", "* por default \xB7 costo = multiplicador de saldo por turno"))}`;
+  });
+}
+function bagsText(r) {
+  const rows = r.bags.map((b) => ({
+    bag: b.name,
+    tokens: fmtTokens(b.tokens),
+    used: `${fmtTokens(b.used)} (${Math.round(b.ratio * 100)}%)`,
+    kind: b.recurring ? t("monthly", "mensual") : t(`one-time since ${b.since?.slice(0, 10)}`, `carga \xFAnica desde ${b.since?.slice(0, 10)}`),
+    cap: b.hardCap ? t("cuts", "corta") : t("warns", "avisa"),
+    agents: b.agents.map((a) => a.name ?? a.id).join(", ") || "\u2014"
+  }));
+  const free = r.unbagged.length ? `
+${dim(t(`Workspace balance (no bag): ${r.unbagged.map((a) => a.name ?? a.id).join(", ")}`, `Saldo del espacio (sin bolsa): ${r.unbagged.map((a) => a.name ?? a.id).join(", ")}`))}` : "";
+  return `${bold(r.workspace)}
+${r.bags.length ? table(rows, ["bag", "tokens", "used", "kind", "cap", "agents"]) : dim(t("No bags: every agent uses the workspace balance.", "Sin bolsas: todos los agentes usan el saldo del espacio."))}${free}`;
+}
+async function bagsCmd(sub, slug, name, v, context) {
+  const ex = 'ghosty bags ls <workspace> \xB7 create <workspace> "<bag>" --tokens 20M [--recurring off] \xB7 set <workspace> "<bag>" --tokens 30M \xB7 rm <workspace> "<bag>"';
+  if (sub && !["ls", "list", "create", "new", "set", "rm", "delete"].includes(sub)) {
+    name = slug;
+    slug = sub;
+    sub = "ls";
+  }
+  slug = needSpace(slug ?? context, ex);
+  const recurring = parseSwitch("--recurring", v.recurring);
+  const hardCap = parseSwitch("--hard-cap", v["hard-cap"]);
+  switch (sub ?? "ls") {
+    case "ls":
+    case "list": {
+      const r = await api(wsPath(slug, "/bags"));
+      return out(r, () => bagsText(r));
+    }
+    case "create":
+    case "new": {
+      if (!name) throw usage(t("Missing the bag's name.", "Falta el nombre de la bolsa."), ex);
+      if (!v.tokens) throw usage(t("Missing --tokens.", "Falta --tokens."), `ghosty bags create ${slug} "${name}" --tokens 20M`);
+      const r = await api(wsPath(slug, "/bags"), { method: "POST", body: { name, tokens: parseTokens(v.tokens), ...recurring !== void 0 ? { recurring } : {}, ...hardCap !== void 0 ? { hardCap } : {}, ...v.note ? { note: v.note } : {} } });
+      return out(r, () => `${lavender("\u2713")} ${t(`Bag \xAB${name}\xBB created.`, `Bolsa \xAB${name}\xBB creada.`)} ${dim(t(`Give it agents: ghosty agents set <agent> --bag "${name}"`, `Cu\xE9lgale agentes: ghosty agents set <agente> --bag "${name}"`))}
+${bagsText(r)}`);
+    }
+    case "set": {
+      if (!name) throw usage(t("Missing the bag's name.", "Falta el nombre de la bolsa."), ex);
+      const body = { ...v.tokens ? { tokens: parseTokens(v.tokens) } : {}, ...recurring !== void 0 ? { recurring } : {}, ...hardCap !== void 0 ? { hardCap } : {}, ...v.note !== void 0 ? { note: v.note } : {}, ...v.name ? { name: v.name } : {} };
+      if (!Object.keys(body).length) throw usage(t("Nothing to change.", "Nada que cambiar."), "--tokens 30M | --recurring on|off | --hard-cap on|off | --note TEXT | --name NEW");
+      const r = await api(wsPath(slug, `/bags/${enc10(name)}`), { method: "PATCH", body });
+      return out(r, () => `${lavender("\u2713")} ${t(`Bag \xAB${r.updated}\xBB updated.`, `Bolsa \xAB${r.updated}\xBB actualizada.`)}
+${bagsText(r)}`);
+    }
+    case "rm":
+    case "delete": {
+      if (!name) throw usage(t("Missing the bag's name.", "Falta el nombre de la bolsa."), ex);
+      requireYesIfHeadless(v.yes, `ghosty bags rm ${slug} "${name}"`);
+      await confirm(t(`Delete bag \xAB${name}\xBB from ${slug}? (only if no agent uses it)`, `\xBFBorrar la bolsa \xAB${name}\xBB de ${slug}? (s\xF3lo si ning\xFAn agente la usa)`), { yes: v.yes, retry: `ghosty bags rm ${slug} "${name}"` });
+      const r = await api(wsPath(slug, `/bags/${enc10(name)}`), { method: "DELETE" });
+      return out(r, () => `${lavender("\u2713")} ${t(`Bag \xAB${r.deleted}\xBB deleted.`, `Bolsa \xAB${r.deleted}\xBB borrada.`)}
+${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]";
+  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`);
+    const path = wsPath(slug, "/renew");
+    const plan = await api(path, { method: "POST", body: { until: v.until, dryRun: true } });
+    const line2 = t(`${plan.workspace} (${plan.plan}): paid until ${plan.from ?? "\u2014"} \u2192 ${plan.to}`, `${plan.workspace} (${plan.plan}): pagado hasta ${plan.from ?? "\u2014"} \u2192 ${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 renew ${slug} --until ${v.until}`);
+    await confirm(`${line2}
+${t("Renew?", "\xBFRenovar?")}`, { yes: v.yes, retry: `ghosty spaces renew ${slug} --until ${v.until}` });
+    const r = await api(path, { method: "POST", body: { until: v.until, ...v.note ? { note: v.note } : {} } });
+    return out(r, () => `${lavender("\u2713")} ${line2} ${dim(t("(logged in the workspace's audit)", "(queda en la bit\xE1cora del espacio)"))}`);
+  }
+  if (sub === "rename") {
+    slug = needSpace(slug, ex);
+    if (!arg) throw usage(t("Missing the new name.", "Falta el nombre nuevo."), `ghosty spaces rename ${slug} <new> --dry-run`);
+    const path = wsPath(slug, "/rename");
+    const plan = await api(path, { method: "POST", body: { to: arg, dryRun: true } });
+    const text = `${plan.from} \u2192 ${bold(plan.to)}
+${plan.warnings.map((w) => dim(`  \xB7 ${serverText(w)}`)).join("\n")}`;
+    if (v["dry-run"]) return out(plan, () => `${text}
+${dim(t("Dry run: nothing changed.", "Simulaci\xF3n: no cambi\xF3 nada."))}`);
+    requireYesIfHeadless(v.yes, `ghosty spaces rename ${slug} ${arg}`);
+    await confirm(`${text}
+${t("Rename?", "\xBFRenombrar?")}`, { yes: v.yes, expect: plan.from, retry: `ghosty spaces rename ${slug} ${arg}` });
+    const r = await api(path, { method: "POST", body: { to: arg } });
+    return out(r, () => `${lavender("\u2713")} ${t(`Renamed: ${r.from} \u2192 ${r.to}. Undo: ghosty spaces rename ${r.to} ${r.from}`, `Renombrado: ${r.from} \u2192 ${r.to}. Deshacer: ghosty spaces rename ${r.to} ${r.from}`)}`);
+  }
+  throw usage(t(`Unknown spaces subcommand: ${sub ?? "(none)"}.`, `Subcomando de spaces desconocido: ${sub ?? "(ninguno)"}.`), ex);
+}
+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", " ");
+  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 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).`)));
+  }
+  const by = new Set((v.by ?? "agent").split(",").map((x) => x.trim()));
+  if ([...by].some((b) => b !== "agent" && b !== "day")) throw usage(t("--by takes agent, day or agent,day.", "--by acepta agent, day o agent,day."));
+  let rows;
+  const fmt2 = (x) => ({ turns: x.turns, failed: x.failed ? red(String(x.failed)) : 0, tokens: fmtTokens(x.billable), "no balance": x.noQuota || "" });
+  if (by.has("day") && by.has("agent")) rows = r.rows.map((x) => ({ day: x.day, agent: x.agent, ...fmt2(x) }));
+  else if (by.has("day")) {
+    const days = /* @__PURE__ */ new Map();
+    for (const x of r.rows) {
+      const d = days.get(x.day) ?? { agentId: "", agent: "", turns: 0, failed: 0, billable: 0, outputTokens: 0, cacheRead: 0, noQuota: 0 };
+      d.turns += x.turns;
+      d.failed += x.failed;
+      d.billable += x.billable;
+      d.noQuota += x.noQuota;
+      days.set(x.day, d);
+    }
+    rows = [...days].map(([day, x]) => ({ day, ...fmt2(x) }));
+  } else rows = r.agents.map((x) => ({ agent: x.agent, ...fmt2(x) }));
+  const cols = [...by.has("day") ? ["day"] : [], ...by.has("agent") ? ["agent"] : [], "turns", "failed", "tokens", "no balance"];
+  const total = r.agents.reduce((n, a) => n + a.billable, 0);
+  out(r, () => `${bold(r.workspace)} ${dim(t(`last ${r.days} day(s), CDMX days`, `\xFAltimos ${r.days} d\xEDa(s), d\xEDas en hora CDMX`))}
+${table(rows, cols)}
+${dim(t(`${fmtTokens(total)} billable tokens \xB7 failed = error or stopped \xB7 no balance: ghosty turns ls --workspace ${r.workspace} --quota-hits`, `${fmtTokens(total)} tokens facturables \xB7 failed = error o detenido \xB7 sin saldo: ghosty turns ls --workspace ${r.workspace} --quota-hits`))}`);
+}
+
 // src/index.ts
 var HELP_EN = `${bold("Usage:")} ghosty <command> [options]
 
@@ -11478,7 +11903,14 @@ ${bold("Session")}
   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 --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 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
@@ -11494,12 +11926,15 @@ ${bold("Agents")}
                             [--voice elevenlabs:ID | kokoro:em_santa] [--voice-replies auto|off] [--auto-stage on|off]
                             [--toolsets crm,sales | +crm,-sales]  gs tool groups it gets
                             [--prompt-base AGENT|none --prompt-overlay FILE [--dry-run]]  prompt = another agent's + edits, kept in sync
+                            [--tool wa:tool=off,\u2026] [--bag NAME|none] [--avatar URL|FILE]  a tool per channel \xB7 its token bag (staff) \xB7 its face in Teams
   agents doctor <id>        Check the config: overlapping skills, tools the prompt names, broken grants, failing turns
   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 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
-  agents rm <id>            Delete an agent (owner only; asks you to type its name, or --yes)
+  agents rm <id>            Delete an agent (owner only; asks you to type its name, or --yes)   [--from-workspace: turn it off in Teams first]
   agents restart <id>       Restart an ACP agent (needsRestart) so it loads new skills
   agents box <id>           The machine serving it: is it on the new image?   [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle]
   agents demo enable|disable <id>   Turn its public demo link on or off
@@ -11536,12 +11971,14 @@ ${bold("Talk to an agent")}
   conversations ls <id>     List conversations
   conversations show <id> <conversation>   What was said   [--limit 20] (0 = all)
   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]
 
 ${bold("Schedule turns")}  ${dim("(each run lands in a conversation and notifies your phone; an answer of exactly OK stays silent)")}
   schedule ls <id>                   Pending turns and recent runs
   schedule add <id> "what to do"     Schedule a turn   --in 30m | --at ISO   [--every 12h --until ISO] [--conversation ID] [--title T]
   schedule rm <id> <schedule-id>     Cancel a pending turn
+  schedule add|ls|rm <id> \u2026 --teams WS#room[/thread]   The same in a Teams room or thread: it answers there as if mentioned
 
 ${bold("Partners")}  ${dim("(give an agent to each of YOUR customers \u2014 see: ghosty partner --help)")}
   partner ls | enable | credentials | agent | tenants | audit | try
@@ -11574,7 +12011,14 @@ ${bold("Sesi\xF3n")}
   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 --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 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
@@ -11590,12 +12034,15 @@ ${bold("Agentes")}
                             [--voice elevenlabs:ID | kokoro:em_santa] [--voice-replies auto|off] [--auto-stage on|off]
                             [--toolsets crm,sales | +crm,-sales]  grupos de tools de gs que recibe
                             [--prompt-base AGENTE|none --prompt-overlay ARCHIVO [--dry-run]]  prompt = el de otro agente + ediciones, sincronizado
+                            [--tool wa:tool=off,\u2026] [--bag NOMBRE|none] [--avatar URL|ARCHIVO]  una tool por canal \xB7 su bolsa de tokens (staff) \xB7 su cara en Teams
   agents doctor <id>        Revisa la configuraci\xF3n: skills encimadas, tools que nombra el prompt, permisos rotos, turnos que fallan
   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 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
-  agents rm <id>            Borra un agente (s\xF3lo el due\xF1o; te pide escribir su nombre, o --yes)
+  agents rm <id>            Borra un agente (s\xF3lo el due\xF1o; te pide escribir su nombre, o --yes)   [--from-workspace: antes lo desactiva en Teams]
   agents restart <id>       Reinicia un agente ACP (needsRestart) para que cargue skills nuevas
   agents box <id>           La m\xE1quina que lo atiende: \xBFya trae la imagen nueva?   [--check RUTA]\u2026 [--contains RUTA=TEXTO]\u2026 [--recycle]
   agents demo enable|disable <id>   Prende o apaga su liga p\xFAblica de demo
@@ -11632,12 +12079,14 @@ ${bold("Hablar con un agente")}
   conversations ls <id>     Lista conversaciones
   conversations show <id> <conversaci\xF3n>   Qu\xE9 se dijo   [--limit 20] (0 = todo)
   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]
 
 ${bold("Turnos programados")}  ${dim("(cada corrida cae en una conversaci\xF3n y avisa a tu tel\xE9fono; una respuesta de exactamente OK no avisa)")}
   schedule ls <id>                   Turnos pendientes y corridas recientes
   schedule add <id> "qu\xE9 hacer"      Programa un turno   --in 30m | --at ISO   [--every 12h --until ISO] [--conversation ID] [--title T]
   schedule rm <id> <schedule-id>     Cancela un turno pendiente
+  schedule add|ls|rm <id> \u2026 --teams ESP#room[/hilo]   Lo mismo en un room o hilo de Teams: contesta ah\xED como si lo mencionaran
 
 ${bold("Partners")}  ${dim("(dale un agente a cada uno de TUS clientes \u2014 ver: ghosty partner --help)")}
   partner ls | enable | credentials | agent | tenants | audit | try
@@ -11660,7 +12109,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", "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", "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);
@@ -11819,7 +12268,19 @@ async function main() {
       "no-connect": { type: "boolean" },
       cached: { type: "boolean" },
       check: { type: "string", multiple: true },
-      contains: { type: "string", multiple: true }
+      contains: { type: "string", multiple: true },
+      tokens: { type: "string" },
+      recurring: { type: "string" },
+      "hard-cap": { type: "string" },
+      note: { type: "string" },
+      bag: { type: "string" },
+      avatar: { type: "string" },
+      tool: { type: "string" },
+      "from-workspace": { type: "boolean" },
+      "quota-hits": { type: "boolean" },
+      by: { type: "string" },
+      models: { type: "boolean" },
+      teams: { type: "string" }
     }
   });
   globals.json = Boolean(v.json);
@@ -11827,7 +12288,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.25.0" }, () => "0.25.0");
+  if (v.version) return out({ version: "0.27.0" }, () => "0.27.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -11904,6 +12365,7 @@ async function main() {
       if (sub === "photos") return dbsPhotosCmd(a1, a2, pos[4], v);
       return dbsCmd(sub, a1, a2, pos.slice(4).filter((x) => x !== void 0), v);
     case "turns":
+      if (v["quota-hits"]) return workspaceUsage(v.workspace ?? context, v);
       return turnsCmd(sub, a1, a2, v);
     case "board":
       return boardCmd(sub, a1, v, a2);
@@ -11929,7 +12391,16 @@ async function main() {
       return partnerCmd(sub, a1, a2, { ...v, token: tokens.turn });
     case "usage":
       if (v.boxes) return boxesUsage(v.workspace ?? context);
+      if (v.workspace || v.by || v.days) return workspaceUsage(v.workspace ?? context, v);
       return meUsage();
+    case "engines":
+      return enginesCmd(sub, v);
+    case "bags":
+    case "bag":
+      return bagsCmd(sub, a1, a2, v, context);
+    case "spaces":
+    case "space":
+      return spacesCmd(sub, a1, a2, v, context);
     case "plan":
       return planCmd(sub, a1, v, context);
     case "me":
@@ -11946,7 +12417,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.25.0").catch(() => null);
+var notice = updateNotice("0.27.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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