@ghostystudio/cli 0.28.0 → 0.29.0

package/README.md

@@ -20,7 +20,7 @@ ghosty engines ls [--models]                          # valid --engine / --model
 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 ls [--engine E] [--ids] [--sponsor EMAIL | --owner EMAIL]   # --sponsor/--owner: any account (Ghosty staff)
 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]
 ghosty agents export <id> [--out DIR]    # the agent as a YAML file (+ its skills with --out)
@@ -89,6 +89,13 @@ 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.29.0
+
+- `agents ls --engine E --ids` (ids only, for `xargs`); staff: `agents ls --sponsor EMAIL | --owner EMAIL` lists any account's agents, and `agents get|set|box` work on them by id (logged).
+- `try --media FILE` and `chat --media FILE` attach files as from the app (no `--waba` needed).
+- `turns cancel <agent> <conversation>`: stops the turn AND that conversation's background jobs (video, subagents, pending wake-ups).
+- `agents box --recycle` on Ghosty · Lite / Goose recreates its box with the current image (`--reenv`, `--force`); `agents set --prompt-mode append|replace`.
+
 ### Changes in 0.28.0
 
 - `ghosty demos try <slug> "…"`: try a public demo as a visitor from the terminal (keeps the thread; `--new`; `--recycle-between --agent X` checks memory across boxes). `ghosty demos history <agent>` (Ghosty staff): visitors' turns, messages, files and clones, `--timeline`.

package/dist/index.js

@@ -8016,6 +8016,10 @@ var SERVER_MESSAGES = [
   ["no hay un turno pendiente con ese id (\xBFya corri\xF3?)", "no pending turn with that id (did it already run?)"],
   ["los chats de los visitantes de un demo: s\xF3lo el staff de Ghosty", "a demo's visitor chats: Ghosty staff only"],
   ["since inv\xE1lido: \xAB{}\xBB (7d, 12h o una fecha ISO)", "invalid since: \xAB{}\xBB (7d, 12h or an ISO date)"],
+  ["buscar agentes de otras cuentas: s\xF3lo el staff de Ghosty", "searching other accounts' agents: Ghosty staff only"],
+  ["pon al menos un filtro: sponsor, owner, workspace o engine", "add at least one filter: sponsor, owner, workspace or engine"],
+  ["no hay una cuenta con ese correo", "there's no account with that email"],
+  ["files: [{ name, mimeType, data (base64) }], hasta 8 de 10 MB", "files: [{ name, mimeType, data (base64) }], up to 8 of 10 MB"],
   // — 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"],
@@ -8318,7 +8322,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.28.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.29.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8360,7 +8364,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.28.0"}`,
+      "user-agent": `ghosty-cli/${"0.29.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -8438,6 +8442,16 @@ import { basename, join as join2 } from "node:path";
 var enc = encodeURIComponent;
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 var MIME = { jpg: "image/jpeg", jpeg: "image/jpeg", png: "image/png", webp: "image/webp", gif: "image/gif", pdf: "application/pdf", ogg: "audio/ogg", opus: "audio/ogg", mp3: "audio/mpeg", m4a: "audio/mp4", wav: "audio/wav", mp4: "video/mp4" };
+async function localFiles(paths) {
+  const { readFile: readFile13 } = await import("node:fs/promises");
+  const { basename: basename4 } = await import("node:path");
+  return Promise.all(
+    paths.map(async (p) => {
+      const ext = p.toLowerCase().split(".").pop() ?? "";
+      return { name: basename4(p), mimeType: MIME[ext] ?? "application/octet-stream", data: (await readFile13(p)).toString("base64") };
+    })
+  );
+}
 async function tryPost(id, body) {
   for (let attempt = 0; ; attempt++) {
     const r = await postLong(`/api/v2/agents/${enc(id)}/try`, body);
@@ -8563,9 +8577,16 @@ var need = (v, what, example) => {
   if (!v) throw usage(t(`Missing ${what}.`, `Falta ${WHAT_ES[what] ?? what}.`), `${t("Example", "Ejemplo")}: ${example}`);
   return v;
 };
-async function agentsLs(workspace) {
+async function agentsLs(workspace, f = {}) {
+  if (f.sponsor || f.owner) {
+    const q = new URLSearchParams({ ...f.sponsor ? { sponsor: f.sponsor } : {}, ...f.owner ? { owner: f.owner } : {}, ...f.engine ? { engine: f.engine } : {}, ...workspace && !f.all ? { workspace } : {} });
+    const s = await api(`/api/v2/agents?${q}`);
+    if (f.ids) return void process.stdout.write(s.agents.map((a) => a.id).join("\n") + (s.agents.length ? "\n" : ""));
+    return out(s.agents, () => table(s.agents.map((a) => ({ id: a.id, name: a.name, engine: a.engine, model: a.model, owner: a.owner, sponsored: a.sponsored ? t("yes", "s\xED") : "" })), ["id", "name", "engine", "model", "owner", "sponsored"]));
+  }
   const r = await api("/api/v2/me/agents?client=cli");
-  const list = workspace ? r.agentes.filter((a) => a.espacio?.nombre === workspace) : r.agentes;
+  const list = (workspace ? r.agentes.filter((a) => a.espacio?.nombre === workspace) : r.agentes).filter((a) => !f.engine || (a.motor ?? a.origen) === f.engine);
+  if (f.ids) return void process.stdout.write(list.map((a) => a.id).join("\n") + (list.length ? "\n" : ""));
   const spaceOf = (a) => a.espacio?.tipo === "workspace" ? a.espacio.nombre : a.espacio?.tipo ?? "";
   const rows = list.map((a) => ({
     id: a.id,
@@ -8664,12 +8685,24 @@ ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
     }
     return out(r2, () => r2.unlinked ? `${lavender("\u2713")} ${t("Unlinked: the prompt stays as it is and is edited by hand again.", "Desenlazado: el prompt se queda como est\xE1 y se vuelve a editar a mano.")}` : `${lavender("\u2713")} Prompt = ${v["prompt-base"]} + ${v["prompt-overlay"]} ${t(`(${r2.chars} chars). It regenerates when the base changes; ghosty agents doctor ${id} tells if the overlay stops applying.`, `(${r2.chars} caracteres). Se regenera cuando cambia la base; ghosty agents doctor ${id} avisa si la capa deja de aplicar.`)}`);
   }
+  if (v.engine && v["dry-run"]) {
+    const p = await api(agentPath(id), { method: "PATCH", body: { engine: v.engine, ...v.model ? { model: v.model } : {}, dryRun: true } });
+    return out(p, () => [
+      `${p.from.engine}/${p.from.model ?? "?"} \u2192 ${p.to ? `${p.to.engine}/${p.to.model ?? "?"}` : v.engine}`,
+      ...(p.steps ?? []).map((x) => `  \xB7 ${serverText(x)}`),
+      p.ok ? dim(t("Dry run: nothing changed. Run it again without --dry-run to apply.", "Simulacro: no se cambi\xF3 nada. Repite sin --dry-run para aplicarlo.")) : `\u2717 ${serverText(p.error ?? "")}`
+    ].join("\n"));
+  }
   const body = {};
   if (v.name) body.name = v.name;
   if (v.engine) body.engine = v.engine;
   if (v.model) body.model = v.model;
   if (v.prompt) body.prompt = v.prompt;
   if (v["prompt-file"]) body.prompt = await readFile3(v["prompt-file"], "utf8");
+  if (v["prompt-mode"]) {
+    if (v["prompt-mode"] !== "append" && v["prompt-mode"] !== "replace") throw usage(t("--prompt-mode takes append or replace.", "--prompt-mode acepta append o replace."));
+    body.promptMode = v["prompt-mode"];
+  }
   const channels = parseChannels(v.channels);
   if (channels) body.channels = channels;
   if (v.toolsets) {
@@ -8781,11 +8814,12 @@ async function tryTurn(id, text, v) {
   id = need(id, "agent id", 'ghosty try <agent-id> "hello"');
   if (v.replay) return tryReplay(id, v);
   if (v.whatsapp && !v.waba) info(dim(t("Note: --whatsapp is now --waba (the real WhatsApp path).", "Nota: --whatsapp ahora es --waba (el camino real de WhatsApp).")));
-  if (v.waba || v.whatsapp || v.media?.length || v.history) return tryWaba(id, text, v);
-  if (!text && !v.reset) throw usage(t("Missing message.", "Falta el mensaje."), t("Example", "Ejemplo") + ': ghosty try <agent-id> "hello"');
+  if (v.waba || v.whatsapp || v.history) return tryWaba(id, text, v);
+  const files = v.media?.length ? await localFiles(v.media) : [];
+  if (!text && !v.reset && !files.length) throw usage(t("Missing message.", "Falta el mensaje."), t("Example", "Ejemplo") + ': ghosty try <agent-id> "hello"');
   if (process.stderr.isTTY && text && !globals.json) info(dim(t("Thinking\u2026 (a test turn can take up to 3 minutes)", "Pensando\u2026 (un turno de prueba puede tardar hasta 3 minutos)")));
   const r = await api(agentPath(id, "/try"), {
-    body: { text, session: v.session, reset: v.reset }
+    body: { text, session: v.session, reset: v.reset, ...files.length ? { files } : {} }
   });
   out(r, () => (r.text ?? "") + (r.error ? `
 ${dim(`(${t("warning", "aviso")}: ${serverText(r.error)})`)}` : ""));
@@ -9005,7 +9039,7 @@ async function agentsDemo(id, v) {
 async function agentsBox(id, v) {
   id = need(id, "agent id", "ghosty agents box <agent-id> [--check PATH] [--contains PATH=TEXT] [--recycle]");
   if (v.recycle) {
-    const r2 = await api(agentPath(id, "/box"), { method: "POST", body: { recycle: true } });
+    const r2 = await api(agentPath(id, "/box"), { method: "POST", body: { recycle: true, ...v.force ? { force: true } : {}, ...v.reenv ? { reenv: true } : {} } });
     out(r2, () => `${lavender("\u2713")} ${t("Recycled.", "Reciclada.")} ${dim(serverText(r2?.note ?? ""))}
 ${dim(`${t("Verify after one turn", "Verifica despu\xE9s de un turno")}: ghosty agents box ${id} --check <path>`)}`);
     return;
@@ -9088,7 +9122,7 @@ async function conversationsShow(agent, sid, v) {
     return [...head, ...lines, ...tailNote].join("\n\n") || dim(t("(empty)", "(vac\xEDa)"));
   });
 }
-async function turn(agent, sid, text, first) {
+async function turn(agent, sid, text, first, images = []) {
   const turnId = randomUUID();
   const ctrl = new AbortController();
   const res = await request(convPath(agent, `/${enc3(sid)}/events`), { signal: ctrl.signal, headers: { accept: "text/event-stream" } });
@@ -9101,7 +9135,7 @@ async function turn(agent, sid, text, first) {
     });
   };
   process.on("SIGINT", onSigint);
-  const sent = api(convPath(agent, `/${enc3(sid)}/messages`), { body: { content: text, turnId, primerTurno: first } });
+  const sent = api(convPath(agent, `/${enc3(sid)}/messages`), { body: { content: text, turnId, primerTurno: first, ...images.length ? { images } : {} } });
   let answer = "";
   let usageData;
   let ours = false;
@@ -9143,8 +9177,9 @@ async function chat(agent, message, v) {
     first = true;
     if (!globals.json) info(dim(t(`conversation ${sid}  (continue it with --conversation ${sid})`, `conversaci\xF3n ${sid}  (s\xEDguela con --conversation ${sid})`)));
   }
-  if (message) {
-    await turn(agent, sid, message, first);
+  const images = v.media?.length ? await localFiles(v.media) : [];
+  if (message || images.length) {
+    await turn(agent, sid, message ?? "", first, images);
     return;
   }
   if (!process.stdin.isTTY) {
@@ -9430,7 +9465,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.28.0"}`
+        "user-agent": `ghosty-cli/${"0.29.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -9963,9 +9998,22 @@ async function turnsSkipped(id, v) {
   out(r, () => rows.length ? `${table(rows, ["at", "reason", "phone", "message"])}
 ${dim(tally)}` : dim(t(`Every customer message${v.since ? ` since ${v.since}` : ""} opened a turn (or none arrived: check ghosty channels whatsapp ls ${id}, "formmy forwards").`, `Todo mensaje de cliente${v.since ? ` desde ${v.since}` : ""} abri\xF3 turno (o no lleg\xF3 ninguno: revisa ghosty channels whatsapp ls ${id}, \xABformmy forwards\xBB).`)));
 }
+async function turnsCancel(id, sid) {
+  const ex = "ghosty turns cancel <agent-id> <conversation-id>";
+  id = need2(id, t("agent id", "el id del agente"), ex);
+  sid = need2(sid, t("conversation id", "el id de la conversaci\xF3n"), ex);
+  const r = await api(`/api/v2/me/agents/${enc6(id)}/conversations/${enc6(sid)}/cancel`, { method: "POST", body: {} });
+  const b = r.background ?? { videos: 0, subagents: 0, wakes: 0 };
+  const bg = b.videos + b.subagents + b.wakes;
+  out(
+    r,
+    () => !r.detenido && !bg ? dim(t("Nothing running in that conversation.", "No hab\xEDa nada corriendo en esa conversaci\xF3n.")) : `${lavender("\u2713")} ${[r.detenido ? t("turn stopped", "turno detenido") : "", b.videos ? t(`${b.videos} video job(s)`, `${b.videos} encargo(s) de video`) : "", b.subagents ? t(`${b.subagents} subagent(s)`, `${b.subagents} subagente(s)`) : "", b.wakes ? t(`${b.wakes} pending wake-up(s)`, `${b.wakes} despertador(es) pendiente(s)`) : ""].filter(Boolean).join(" \xB7 ")}${bg ? dim(t(" \u2014 work already running in its box finishes on its own, but nothing is delivered and the agent isn't woken.", " \u2014 lo que ya corre en su caja termina solo, pero no se entrega ni despierta al agente.")) : ""}`
+  );
+}
 async function turnsCmd(sub, id, turnId, v) {
   if (sub === "show") return turnShow(id, turnId, !!v.full);
-  if (sub && sub !== "ls" && sub !== "list") throw usage(t(`Unknown turns subcommand: ${sub}.`, `Subcomando de turns desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty turns ls <agent-id> --errors --since 1h \xB7 ghosty turns show <agent-id> [turn-id|last]");
+  if (sub === "cancel" || sub === "stop") return turnsCancel(id, turnId);
+  if (sub && sub !== "ls" && sub !== "list") throw usage(t(`Unknown turns subcommand: ${sub}.`, `Subcomando de turns desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty turns ls <agent-id> --errors --since 1h \xB7 ghosty turns show <agent-id> [turn-id|last] \xB7 ghosty turns cancel <agent-id> <conversation>");
   id = need2(id, t("agent id", "el id del agente"), "ghosty turns ls <agent-id> --errors --since 1h");
   if (v.skipped) return turnsSkipped(id, v);
   const q = new URLSearchParams();
@@ -10596,6 +10644,7 @@ var HELPS_ES = {
       ["--no-notify", "create --like: lo comparte con las mismas personas SIN mandarles correo"],
       ["--workspace SLUG", "create: nace en ese espacio (del que eres due\xF1o o admin), a nombre de su due\xF1o y activo en su Teams"],
       ["--channels k=on|off,\u2026", "create/set: prende/apaga canales: teams, web, whatsapp, messenger, wa (WhatsApp personal)"],
+      ["--engine E --dry-run", "set: qu\xE9 hace cambiar de motor (sesiones que se olvidan, caja que se levanta y cu\xE1l se destruye, si est\xE1 trabajando) sin cambiarlo; cada hilo conserva su conversaci\xF3n"],
       ["--toolsets LIST", "set: grupos de tools de gs que recibe (crm, sales\u2026): una lista reemplaza; +x / -x agrega o quita"],
       ["--prompt-base ID", "set: el prompt de este agente = el prompt de ese agente + --prompt-overlay; se regenera cuando cambia la base. none = desliga (conserva el prompt de hoy)"],
       ["--prompt-overlay FILE", 'set: JSON {"edits":[{"what","find","replace","regex"?,"all"?}]}, aplicados en orden; cada uno debe encontrar su lugar o no cambia nada'],
@@ -10621,12 +10670,16 @@ var HELPS_ES = {
       ["--rotate", "demo: c\xF3digo nuevo; la liga vieja deja de servir"],
       ["--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"],
+      ["--recycle", "box: reemplaza sus m\xE1quinas (nunca a media respuesta); pool: la nueva nace en el siguiente turno; ACP (goose, lite): su caja se recrea ya con la imagen actual"],
+      ["--reenv / --force", "box --recycle en ACP: --reenv s\xF3lo re-hornea el env en la misma caja; --force la recrea aunque est\xE9 ocupada (due\xF1o o staff)"],
       ["--unset-env K1,K2", "set: borra esas variables del env (--env K= tambi\xE9n borra K)"],
       ["--tool [ch:]tool=on|off", "set: prende/apaga una tool en un canal (wa:actualizar_identidad=off) o en todos (crm_buscar=off); separadas por comas"],
       ["--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)"]
+      ["--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)"]
     ],
     notes: [
       "doctor sale con 1 cuando encuentra un problema, as\xED puede frenar un script o un CI.",
@@ -10680,7 +10733,7 @@ var HELPS_ES = {
   },
   turns: {
     summary: "Los turnos recientes de un agente: qu\xE9 contest\xF3, qu\xE9 fall\xF3 y por qu\xE9, y en qu\xE9 se fue el tiempo de un turno.",
-    replace: [["# last turn: each tool, its seconds, output tokens", "# \xFAltimo turno: cada tool, sus segundos, tokens de salida"]],
+    replace: [["# last turn: each tool, its seconds, output tokens", "# \xFAltimo turno: cada tool, sus segundos, tokens de salida"], ["# stop the turn AND its background jobs", "# detiene el turno Y sus encargos en fondo"]],
     flags: [
       ["--errors", "s\xF3lo turnos fallidos (igual que --status error)"],
       ["--skipped", "ls: mensajes de clientes de WhatsApp Business que NO abrieron turno, y por qu\xE9 (operador activo, s\xF3lo registra, pausa, reacci\xF3n, canal apagado, sin saldo)"],
@@ -10701,7 +10754,7 @@ var HELPS_ES = {
     flags: [
       ["--waba", "el camino real de WhatsApp Business: contexto heredado, regla de precios, tablero, voz. Muestra lo que MANDAR\xCDA"],
       ["--session PHONE", "con --waba: un tel\xE9fono de cliente inventado (10-15 d\xEDgitos); cada tel\xE9fono es su propia conversaci\xF3n"],
-      ["--media FILE", "con --waba: el cliente manda esta foto/audio/PDF (uno por turno)"],
+      ["--media FILE", "adjunta esta foto/PDF/audio. Solo: como desde la app (se repite, hasta 8). Con --waba: la manda el cliente (una por turno)"],
       ["--as-formmy", "con --media: llega como un reenv\xEDo real de Formmy (proxy con credencial, copia a gs, transcripci\xF3n) y dice si la copia funcion\xF3"],
       ["--keep", "con --waba: deja la tarjeta de prueba en el tablero (por default se archiva al terminar, y el tablero autom\xE1tico nunca corre en pruebas)"],
       ["--history FILE", "con --waba: lo que se dijo antes, como [{role: user|agent, text, at?}]; cuenta en el primer turno (--reset)"],
@@ -10912,11 +10965,12 @@ var HELPS = {
   agents: {
     summary: "Create, inspect, change, check and delete agents.",
     usage: [
-      "ghosty agents ls",
+      "ghosty agents ls [--engine E] [--ids] [--sponsor EMAIL | --owner EMAIL]",
       "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] [--tool [channel:]tool=on|off,\u2026] [--bag NAME|none] [--avatar URL|FILE]",
+      "ghosty agents set <agent-id> --engine E [--model M] --dry-run   # what changing the engine does (sessions, machines, memory), without changing it",
       "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]",
@@ -10941,6 +10995,7 @@ var HELPS = {
       ["--no-notify", "create --like: share it with the same people WITHOUT emailing them"],
       ["--workspace SLUG", "create: born in that workspace (you own or administer it), owned by its owner and active in its Teams"],
       ["--channels k=on|off,\u2026", "create/set: turn channels on/off: teams, web, whatsapp, messenger, wa (personal WhatsApp)"],
+      ["--engine E --dry-run", "set: what changing the engine does (sessions forgotten, machine started and which one is destroyed, whether it is busy) without changing it; each conversation keeps its history"],
       ["--toolsets LIST", "set: gs tool groups it gets (crm, sales\u2026): a list replaces; +x / -x add or remove"],
       ["--prompt-base ID", "set: this agent's prompt = that agent's prompt + --prompt-overlay; regenerates when the base changes. none = unlink (keeps today's prompt)"],
       ["--prompt-overlay FILE", 'set: JSON {"edits":[{"what","find","replace","regex"?,"all"?}]}, applied in order; each must find its place or nothing changes'],
@@ -10966,12 +11021,16 @@ var HELPS = {
       ["--rotate", "demo: new code; the old link stops working"],
       ["--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"],
+      ["--recycle", "box: replace its machines (not mid-turn); pool: the new one starts on the next turn; ACP (goose, lite): its box is recreated now with the current image"],
+      ["--reenv / --force", "box --recycle on ACP: --reenv only re-bakes the env in the same box; --force recreates it even if busy (owner or staff)"],
       ["--unset-env K1,K2", "set: delete these env variables (--env K= also deletes K)"],
       ["--tool [ch:]tool=on|off", "set: one tool on/off in one channel (wa:actualizar_identidad=off) or everywhere (crm_buscar=off); comma-separated"],
       ["--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)"]
+      ["--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)"]
     ],
     examples: [
       "ghosty agents doctor cmu7pgbyr0001gee3ruk172mm",
@@ -10995,7 +11054,8 @@ var HELPS = {
       "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"
+      "ghosty agents rm fable --from-workspace",
+      "ghosty agents ls --sponsor testers@ghosty.studio --engine ghosty-lite --ids | xargs -I{} ghosty agents set {} --engine claude --dry-run"
     ],
     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`
@@ -11081,7 +11141,7 @@ var HELPS = {
   },
   turns: {
     summary: "An agent's recent turns: what answered, what failed and why, and where one turn's time went.",
-    usage: ["ghosty turns ls <agent-id> [--errors | --status STATE | --skipped] [--since 1h] [--limit N]", "ghosty turns ls --workspace <slug> --quota-hits [--days 14]", "ghosty turns show <agent-id> [turn-id | last] [--full]"],
+    usage: ["ghosty turns ls <agent-id> [--errors | --status STATE | --skipped] [--since 1h] [--limit N]", "ghosty turns ls --workspace <slug> --quota-hits [--days 14]", "ghosty turns show <agent-id> [turn-id | last] [--full]", "ghosty turns cancel <agent-id> <conversation-id>   # stop the turn AND its background jobs"],
     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)"],
@@ -11118,7 +11178,7 @@ var HELPS = {
     flags: [
       ["--waba", "the real WhatsApp Business path: inherited context, price rule, board, voice. Shows what it WOULD send"],
       ["--session PHONE", "with --waba: a made-up customer phone (10-15 digits); each phone is its own conversation"],
-      ["--media FILE", "with --waba: the customer sends this photo/audio/PDF (one per turn)"],
+      ["--media FILE", "attach this photo/PDF/audio. Alone: as from the app (repeatable, up to 8). With --waba: the customer sends it (one per turn)"],
       ["--as-formmy", "with --media: it arrives like a real Formmy forward (proxy with credential, copy to gs, transcription) and says if the copy worked"],
       ["--keep", "with --waba: leave the test card on the board (by default it's archived when the test ends, and auto-stage never runs on tests)"],
       ["--history FILE", "with --waba: what was said before, as [{role: user|agent, text, at?}]; counts on the first turn (--reset)"],
@@ -11144,8 +11204,8 @@ var HELPS = {
   },
   chat: {
     summary: "Stream a conversation; with no message it is interactive.",
-    usage: ['ghosty chat <agent-id> ["message"] [--conversation ID]', "ghosty conversations ls <agent-id>", "ghosty conversations show <agent-id> <conversation-id> [--limit 20]"],
-    examples: ['ghosty chat <id> "hola"', "ghosty chat <id>"],
+    usage: ['ghosty chat <agent-id> ["message"] [--conversation ID] [--media FILE]\u2026', "ghosty conversations ls <agent-id>", "ghosty conversations show <agent-id> <conversation-id> [--limit 20]"],
+    examples: ['ghosty chat <id> "hola"', "ghosty chat <id>", 'ghosty chat <id> "p\xE1salo a PDF" --media foto.jpg'],
     learn: `${REF}#conversaciones`
   },
   schedule: {
@@ -12095,7 +12155,8 @@ ${bold("Workspaces")}  ${dim("(changing them: Ghosty staff)")}
   spaces rename <old> <new>                   Change its slug only   [--dry-run]
 
 ${bold("Agents")}
-  agents ls                 List your agents
+  agents ls                 List your agents   [--engine E] [--ids: only ids, for xargs]
+                            [--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
                             [--like AGENT [--copy-dbs] [--board same|main|new|NAME] [--no-notify] [--dry-run]]  with another agent's setup (not its prompt, env or channels)
@@ -12109,6 +12170,7 @@ ${bold("Agents")}
                             [--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
+                            [--prompt-mode append|replace]  replace = its prompt WITHOUT Ghosty's house persona
   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
@@ -12118,7 +12180,7 @@ ${bold("Agents")}
   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)   [--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 box <id>           The machine serving it: is it on the new image?   [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle [--reenv] [--force]]
   agents demo enable|disable <id>   Turn its public demo link on or off
   agents demo <id>          Public demo link /p/<slug>: anyone tries it without an account, "Keep it" clones it to theirs
                             [--slug NAME] [--expires "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXT] [--chips "a|b|c"] [--starter TEXT] [--sponsor on|off] [--rotate]
@@ -12150,15 +12212,16 @@ ${bold("Demos")}
   demos history <id>                 What visitors did: turns, messages, files (Ghosty staff)   [--since 2d] [--session web:\u2026] [--timeline] [--full]
 
 ${bold("Talk to an agent")}
-  try <id> "message"        One test turn, prints the full answer   [--session] [--reset]
+  try <id> "message"        One test turn, prints the full answer   [--session] [--reset] [--media FILE: attach, as from the app]
     --waba --session PHONE  \u2026through the real WhatsApp path, nothing sent; lists what it would send (tools too)   [--media FILE [--as-formmy]] [--history FILE]
     --replay FILE --out DIR Replay real conversations; report written locally   [--max 15] [--concurrency 8] [--resume]
-  chat <id> ["message"]     Stream a conversation (no message = interactive)   [--conversation ID]
+  chat <id> ["message"]     Stream a conversation (no message = interactive)   [--conversation ID] [--media FILE]
   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]
+  turns cancel <id> <conv>  Stop: the running turn AND that conversation's background jobs (video, subagents, pending wake-ups)
 
 ${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
@@ -12207,7 +12270,8 @@ ${bold("Espacios")}  ${dim("(cambiarlos: staff de Ghosty)")}
   spaces rename <viejo> <nuevo>               Cambia s\xF3lo su slug   [--dry-run]
 
 ${bold("Agentes")}
-  agents ls                 Lista tus agentes
+  agents ls                 Lista tus agentes   [--engine E] [--ids: s\xF3lo ids, para xargs]
+                            [--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
                             [--like AGENTE [--copy-dbs] [--board same|main|new|NOMBRE] [--no-notify] [--dry-run]]  con la configuraci\xF3n de otro agente (no su prompt, env ni canales)
@@ -12221,6 +12285,7 @@ ${bold("Agentes")}
                             [--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
+                            [--prompt-mode append|replace]  replace = su prompt SIN la persona de casa de Ghosty
   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
@@ -12230,7 +12295,7 @@ ${bold("Agentes")}
   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)   [--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 box <id>           La m\xE1quina que lo atiende: \xBFya trae la imagen nueva?   [--check RUTA]\u2026 [--contains RUTA=TEXTO]\u2026 [--recycle [--reenv] [--force]]
   agents demo enable|disable <id>   Prende o apaga su liga p\xFAblica de demo
   agents demo <id>          Liga p\xFAblica de demo /p/<slug>: cualquiera lo prueba sin cuenta y \xABQued\xE1rmelo\xBB lo clona a la suya
                             [--slug NOMBRE] [--expires "AAAA-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXTO] [--chips "a|b|c"] [--starter TEXTO] [--sponsor on|off] [--rotate]
@@ -12262,15 +12327,16 @@ ${bold("Demos")}
   demos history <id>                 Qu\xE9 hicieron los visitantes: turnos, mensajes, archivos (staff de Ghosty)   [--since 2d] [--session web:\u2026] [--timeline] [--full]
 
 ${bold("Hablar con un agente")}
-  try <id> "mensaje"        Un turno de prueba; imprime la respuesta completa   [--session] [--reset]
+  try <id> "mensaje"        Un turno de prueba; imprime la respuesta completa   [--session] [--reset] [--media ARCHIVO: adjunto, como desde la app]
     --waba --session TEL    \u2026por el camino real de WhatsApp, sin enviar nada; lista lo que mandar\xEDa (tools tambi\xE9n)   [--media ARCHIVO [--as-formmy]] [--history ARCHIVO]
     --replay ARCHIVO --out DIR   Repite conversaciones reales; el reporte se escribe local   [--max 15] [--concurrency 8] [--resume]
-  chat <id> ["mensaje"]     Conversaci\xF3n en streaming (sin mensaje = interactivo)   [--conversation ID]
+  chat <id> ["mensaje"]     Conversaci\xF3n en streaming (sin mensaje = interactivo)   [--conversation ID] [--media ARCHIVO]
   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]
+  turns cancel <id> <conv>  Detener: el turno en curso Y los encargos en fondo de esa conversaci\xF3n (video, subagentes, despertadores)
 
 ${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
@@ -12471,6 +12537,11 @@ async function main() {
       by: { type: "string" },
       models: { type: "boolean" },
       teams: { type: "string" },
+      owner: { type: "string" },
+      ids: { type: "boolean" },
+      force: { type: "boolean" },
+      reenv: { type: "boolean" },
+      "prompt-mode": { type: "string" },
       format: { type: "string" },
       timeline: { type: "boolean" },
       new: { type: "boolean" },
@@ -12483,7 +12554,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.28.0" }, () => "0.28.0");
+  if (v.version) return out({ version: "0.29.0" }, () => "0.29.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -12529,7 +12600,7 @@ async function main() {
     case "apply":
       return applyCmd(sub, v);
     case "agents":
-      if (sub === "ls" || sub === "list" || !sub) return agentsLs(v.all ? void 0 : context);
+      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;
         else if (!v.workspace && context) {
@@ -12615,7 +12686,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.28.0").catch(() => null);
+var notice = updateNotice("0.29.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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