@ghostystudio/cli 0.92.0 → 0.93.1

package/README.md

@@ -153,6 +153,14 @@ Every command has its own help with examples: `ghosty <command> --help` or `ghos
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.93.1
+
+- `factory runs choose` also offers `fix_main`: a separate run fixes the main branch (CI permission, workflow) and the escalated run waits for it — it no longer counts as «your turn» — then updates itself and goes back to @check when the fix merges.
+
+### Changes in 0.93.0
+
+- `factory runs choose <run> [a|b|c]`: when @check escalates a decision it leaves 2–3 concrete paths (build, recheck, replan, close, merge_as_is). Without a letter it lists them; with one it applies it and the choice reaches the next role word for word. `merge_as_is` merges with CI as it is (red checks the PR didn't cause), asks for confirmation and is logged. `runs show` lists the options of an escalated run.
+
 ### Changes in 0.88.0
 
 - `me files rm` takes several ids (`a,b` or `a b`) and `--q TEXT`, lists what it will delete, asks first (without a terminal it needs `--yes`; before, it deleted without asking) and `--dry-run` only shows the list.

package/dist/index.js

@@ -1175,7 +1175,7 @@ async function postLong(path2, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path2}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.92.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.93.1"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -1217,7 +1217,7 @@ async function request(path2, opts = {}, retried = false) {
     method: opts.method ?? (opts.body !== void 0 || opts.raw !== void 0 ? "POST" : "GET"),
     headers: {
       authorization: `Bearer ${token}`,
-      "user-agent": `ghosty-cli/${"0.92.0"}`,
+      "user-agent": `ghosty-cli/${"0.93.1"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -11278,7 +11278,7 @@ async function call(path2, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.92.0"}`
+        "user-agent": `ghosty-cli/${"0.93.1"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -14028,7 +14028,8 @@ var HELPS_ES = {
       "--timing lee la transcripci\xF3n de cada rol: los motores sin una (ACP) salen con minutos y costo, pero sin comandos. Tambi\xE9n lista los atascos: un comando abierto 8+ min, el mismo comando 4 veces, el mismo error 3 veces, ir y venir entre dos acciones, o apt install dentro de una caja.",
       "advise: con un pedido ESCALADO, qu\xE9 hacer \u2014que @build lo arregle o rehacer el plan\u2014 con la nota para @build punto por punto (cada uno cita el hallazgo o el paso del plan que lo justifica) y qu\xE9 debe revisar @check. Compara los hallazgos de @check contra el plan firmado. No aplica nada: imprime el comando exacto de approve/changes. show dice por qu\xE9 se escal\xF3.",
       "why: si el pedido no fue sano (atascos, @build de m\xE1s de 30 min, vueltas, CI rojo, escalado), una categor\xEDa (missing_service, unresolved_build_or_tests, fixed_strategy\u2026), el paso cr\xEDtico con su evidencia y qu\xE9 cambiar la pr\xF3xima vez. Primero cruza los criterios del plan aprobado con la evidencia: aprobado sin la preview que ped\xEDa un criterio, mezclado sin preview, smoke rojo sobre el commit mezclado o criterio de CI con CI none \u2192 approved_unmet_criterion, arriba de cualquier atasco. Un pedido sano no llama al modelo. Cuando un pedido cierra sin ser sano, el room recibe este resumen en su hilo.",
-      "Mientras un rol trabaja, si se atora el room recibe un \u23F3 en el hilo y al rol se le dice qu\xE9 revisar; desde la segunda vez en el mismo pedido, quien lo pidi\xF3 recibe un push."
+      "Mientras un rol trabaja, si se atora el room recibe un \u23F3 en el hilo y al rol se le dice qu\xE9 revisar; desde la segunda vez en el mismo pedido, quien lo pidi\xF3 recibe un push.",
+      "choose: cuando @check escala una decisi\xF3n deja 2\u20133 caminos concretos (a, b, c), cada uno con su acci\xF3n: build (@build lo hace en la rama), recheck, replan, close, merge_as_is o fix_main (abre un pedido aparte que arregla la rama principal; \xE9ste espera sin contar como \xABte toca\xBB y, al mergearse el arreglo, se pone al d\xEDa y se revisa solo). Sin letra los lista; con letra lo aplica y la elecci\xF3n le llega literal al siguiente rol. merge_as_is hace merge con el CI como est\xE1 (con checks en rojo): \xFAsalo cuando lo rojo no lo causa el PR; pide confirmaci\xF3n y queda en bit\xE1cora (merge_override). show tambi\xE9n lista las opciones."
     ]
   }
 };
@@ -15002,6 +15003,7 @@ HELPS.factory = {
     "ghosty factory env ls [OWNER/REPO] [--workspace SLUG]",
     "ghosty factory env push [OWNER/REPO] [FILE] [--gen KEY,KEY] [--replace] [--yes] [--workspace SLUG]",
     "ghosty factory runs recheck <run> [--yes] [--workspace SLUG]",
+    "ghosty factory runs choose <run> [a|b|c] [--yes] [--workspace SLUG]",
     `ghosty factory run "What, why and how we know it's done" --repo OWNER/REPO [--room R] [--wait] [--timeout 1800] [--workspace SLUG]`,
     "ghosty factory runs watch <run> | --thread <id> [--timeout 1800] [--workspace SLUG]",
     'ghosty factory runs approve <run> --plan-version N [--note "\u2026"] [--check-scope "\u2026"] [--yes]',
@@ -15041,7 +15043,7 @@ HELPS.factory = {
     ["--yes", "rename, approve, changes, merge: skip the confirmation (required without a terminal)"]
   ],
   examples: ["ghosty factory rooms connect blissito/ghosty-studio --room studio --create --workspace business", 'ghosty factory run "Add a COLLABORATOR role: invited by room, lands in the room, no personal agent. Done when an invite to #factory logs in straight there" --repo blissito/ghosty-studio --wait --workspace business', "ghosty factory runs approve 31 --plan-version 2 --workspace business", "ghosty factory runs watch 31 --workspace business", "ghosty factory runs merge 31 --workspace business", "ghosty factory runs ls --workspace business --room mailmask", "ghosty factory runs show 15 --workspace business", "ghosty factory runs show 13 --timing --workspace mercadito-verde", "ghosty factory runs why 13 --workspace mercadito-verde", "ghosty factory runs advise 115 --workspace business", "ghosty factory runs stats --since 7d --workspace mercadito-verde", 'ghosty factory runs rename 15 "Docs del CLI al d\xEDa" --workspace business --dry-run'],
-  notes: ["env: the preview's environment variables live on your computer, so your terminal agent pushes them. ls lists saved and missing names (from .env.example and from runs escalated because the preview won't start); push adds them (only the workspace owner). Use disposable values, never production: the preview runs the repo's code. Values never come back. Then runs recheck <run>: @check reviews the same PR again without another @build loop. Logged as factory.env_set and factory.run_recheck.", "sprints: when the goal is too big for one run, @plan proposes a sprint (3\u20138 tickets in order, with dependencies) as a draft. approve signs every included ticket at once; they start one at a time as their dependencies merge. Only the owner or whoever asked can approve. Logged as factory.sprint_approve.", "rooms repos lists the repos your GitHub App sees (most recent first) and which rooms each one is already in.", "rooms connect checks that YOUR GitHub App installation sees the repo (if not, it gives you the link to grant access) and tells you how ready the repo is for agents (levels 1\u20133 and what's missing). Any member can connect; only whoever connected it, or the owner, can disconnect. Logged as factory.room_connect / factory.room_disconnect.", "run posts \xAB@plan <your text>\xBB in the room under YOUR name, like typing it in Teams: the same plan, approvals and card. Write it like a ticket: the goal, why, and how you'll know it's done. Any member can run, approve, ask for changes and merge; each one is logged (factory.run, factory.run_approve\u2026).", "card brings the run's live card down to the bottom of its thread; the old one stays as a still footprint linking to the live one. The roles can do it too (factory_card).", "Reading needs membership in the workspace; rename needs owner, admin or Ghosty staff, and is logged (factory.run_rename). The room's card picks the new title up on its next refresh.", "Who is @plan or @build: ghosty agents ls --handle plan --workspace SLUG.", "stats: runs, % merged, median minutes to PR and to merge, @check\u2192@build loops and red CI per run, and cost per run and per merged PR. The cost counts @plan's first turn in the thread, before the run existed.", "--timing reads each role's transcript: engines without one (ACP) show minutes and cost but no commands. It also lists stuck patterns: a command open 8+ min, the same command 4 times, the same error 3 times, going back and forth, or apt install inside a box.", "why: if the run wasn't healthy (stuck patterns, @build over 30 min, loops, red CI, escalated), a category (missing_service, unresolved_build_or_tests, fixed_strategy\u2026), the critical step with its evidence and what to change next time. First it checks the approved plan's criteria against the evidence: approved without the preview a criterion asked for, merged without preview, smoke failed on the merged commit, or a CI criterion with CI none \u2192 approved_unmet_criterion, above any stuck pattern. A healthy run doesn't call the model. When a run closes unhealthy, the room gets this summary in its thread.", "advise: for an ESCALATED run, what to do \u2014 let @build fix it or redo the plan \u2014 with the note for @build point by point (each one cites the finding or plan step behind it) and what @check should review. It compares @check's findings against the signed plan. Nothing is applied: it prints the exact approve/changes command. show tells you why it was escalated.", "While a role works, if it gets stuck the room gets a \u23F3 message in the thread and the role is told what to check; from the second time in the same run, whoever asked gets a push."],
+  notes: ["env: the preview's environment variables live on your computer, so your terminal agent pushes them. ls lists saved and missing names (from .env.example and from runs escalated because the preview won't start); push adds them (only the workspace owner). Use disposable values, never production: the preview runs the repo's code. Values never come back. Then runs recheck <run>: @check reviews the same PR again without another @build loop. Logged as factory.env_set and factory.run_recheck.", "sprints: when the goal is too big for one run, @plan proposes a sprint (3\u20138 tickets in order, with dependencies) as a draft. approve signs every included ticket at once; they start one at a time as their dependencies merge. Only the owner or whoever asked can approve. Logged as factory.sprint_approve.", "rooms repos lists the repos your GitHub App sees (most recent first) and which rooms each one is already in.", "rooms connect checks that YOUR GitHub App installation sees the repo (if not, it gives you the link to grant access) and tells you how ready the repo is for agents (levels 1\u20133 and what's missing). Any member can connect; only whoever connected it, or the owner, can disconnect. Logged as factory.room_connect / factory.room_disconnect.", "run posts \xAB@plan <your text>\xBB in the room under YOUR name, like typing it in Teams: the same plan, approvals and card. Write it like a ticket: the goal, why, and how you'll know it's done. Any member can run, approve, ask for changes and merge; each one is logged (factory.run, factory.run_approve\u2026).", "card brings the run's live card down to the bottom of its thread; the old one stays as a still footprint linking to the live one. The roles can do it too (factory_card).", "Reading needs membership in the workspace; rename needs owner, admin or Ghosty staff, and is logged (factory.run_rename). The room's card picks the new title up on its next refresh.", "Who is @plan or @build: ghosty agents ls --handle plan --workspace SLUG.", "stats: runs, % merged, median minutes to PR and to merge, @check\u2192@build loops and red CI per run, and cost per run and per merged PR. The cost counts @plan's first turn in the thread, before the run existed.", "--timing reads each role's transcript: engines without one (ACP) show minutes and cost but no commands. It also lists stuck patterns: a command open 8+ min, the same command 4 times, the same error 3 times, going back and forth, or apt install inside a box.", "why: if the run wasn't healthy (stuck patterns, @build over 30 min, loops, red CI, escalated), a category (missing_service, unresolved_build_or_tests, fixed_strategy\u2026), the critical step with its evidence and what to change next time. First it checks the approved plan's criteria against the evidence: approved without the preview a criterion asked for, merged without preview, smoke failed on the merged commit, or a CI criterion with CI none \u2192 approved_unmet_criterion, above any stuck pattern. A healthy run doesn't call the model. When a run closes unhealthy, the room gets this summary in its thread.", "advise: for an ESCALATED run, what to do \u2014 let @build fix it or redo the plan \u2014 with the note for @build point by point (each one cites the finding or plan step behind it) and what @check should review. It compares @check's findings against the signed plan. Nothing is applied: it prints the exact approve/changes command. show tells you why it was escalated.", "While a role works, if it gets stuck the room gets a \u23F3 message in the thread and the role is told what to check; from the second time in the same run, whoever asked gets a push.", "choose: when @check escalates a decision it leaves 2\u20133 concrete paths (a, b, c), each one an action: build (@build does it on the branch), recheck, replan, close, merge_as_is or fix_main (opens a separate run that fixes the main branch; this run waits without counting as \xAByour turn\xBB and is updated and re-reviewed on its own when the fix merges). Without a letter it lists them; with one it applies it and the choice reaches the next role word for word. merge_as_is merges with CI as it is (red checks included): use it when what's red isn't caused by the PR; it asks for confirmation and is logged (merge_override). show lists the options too."],
   learn: `${REF}#fabrica`
 };
 function helpText(cmd) {
@@ -16275,6 +16277,8 @@ Or ask for changes: ghosty factory runs changes ${r.id} --note "\u2026" ${w}`,
 Firma: ghosty factory runs approve ${r.id} --plan-version ${r.planVersion} ${w}
 O pide cambios: ghosty factory runs changes ${r.id} --note "\u2026" ${w}`
     );
+  if (r.status === "escalated" && "escalation" in r && r.escalation?.options?.length)
+    return r.escalation.options.map((o) => `${o.id}) ${o.label}: ghosty factory runs choose ${r.id} ${o.id} ${w}`).join("\n");
   if (r.status === "escalated" && "escalation" in r && r.escalation?.blocked)
     return t(
       `@check is blocked by something @build can't provide (e.g. preview variables). Resolve it, then:
@@ -16473,7 +16477,12 @@ ${dim(`${t("Detail", "Detalle")}: ghosty factory runs show <run> --workspace ${r
       ...r.escalation ? [
         bold(red(r.escalation.blocked ? t("@check stopped it: needs something @build can't do", "@check lo fren\xF3: falta algo que @build no puede dar") : t(`@check stopped it after ${r.escalation.loops} loops`, `@check lo fren\xF3 tras ${r.escalation.loops} vueltas`))),
         r.escalation.findings,
-        dim(t(`What to do: ghosty factory runs advise ${r.id} --workspace ${ws}`, `Qu\xE9 hacer: ghosty factory runs advise ${r.id} --workspace ${ws}`))
+        ...r.escalation.options?.length ? [
+          bold(t("Choose one", "Elige una")),
+          ...r.escalation.options.map((o) => `  ${bold(`${o.id})`)} ${o.label} ${dim(`(${o.action})`)}
+     ${dim(o.brief)}`),
+          dim(t(`ghosty factory runs choose ${r.id} <letter> --workspace ${ws}`, `ghosty factory runs choose ${r.id} <letra> --workspace ${ws}`))
+        ] : [dim(t(`What to do: ghosty factory runs advise ${r.id} --workspace ${ws}`, `Qu\xE9 hacer: ghosty factory runs advise ${r.id} --workspace ${ws}`))]
       ] : [],
       bold(t("Latest events", "\xDAltimos eventos")),
       ...r.events.map((e) => `  ${dim(short4(e.at))} ${e.type}${e.actor ? ` ${dim(e.actor)}` : ""}`),
@@ -16518,7 +16527,31 @@ ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
     return out(r, () => `${lavender("\u2713")} ${msg}${verb === "approve" || verb === "changes" || verb === "recheck" ? `
 ${dim(t(`Follow it: ghosty factory runs watch ${id} --workspace ${ws}`, `S\xEDguelo: ghosty factory runs watch ${id} --workspace ${ws}`))}` : ""}`);
   }
-  throw usage(t(`Unknown runs subcommand: ${verb}.`, `Subcomando de runs desconocido: ${verb}.`), 'ghosty factory runs ls | show <run> [--timing] | why <run> [--refresh] | advise <run> | stats [--since 30d] | rename <run> "title" | watch <run> | approve <run> --plan-version N [--note "\u2026"] [--check-scope "\u2026"] | changes <run> --note "\u2026" | recheck <run> | merge <run> | card <run>');
+  if (verb === "choose") {
+    const id = Number(ref.replace(/^#/, ""));
+    const letter = title?.trim().toLowerCase();
+    const listed = await api(`${base}/${id}/act`, { body: { action: "choose" } });
+    const opt = letter ? listed.options.find((o) => o.id === letter) : null;
+    if (!letter || !opt) {
+      const lines = listed.options.length ? listed.options.map((o) => `  ${bold(`${o.id})`)} ${o.label} ${dim(`(${o.action})`)}
+     ${dim(o.brief)}`) : [dim(t("This escalation has no options: use approve --note, changes or advise.", "Este escalado no trae opciones: usa approve --note, changes o advise."))];
+      if (letter) throw usage(t(`#${id} has no option \xAB${letter}\xBB.`, `El #${id} no tiene la opci\xF3n \xAB${letter}\xBB.`), lines.join("\n"));
+      return out(listed, () => lines.join("\n"));
+    }
+    const retry = `ghosty factory runs choose ${id} ${opt.id} --yes --workspace ${ws}`;
+    requireYesIfHeadless(v.yes, retry);
+    await confirm(
+      opt.action === "merge_as_is" ? t(`Merge #${id} with CI as it is (red checks included): \xAB${opt.label}\xBB?`, `\xBFHacer merge del #${id} con el CI como est\xE1 (con checks en rojo): \xAB${opt.label}\xBB?`) : t(`Choose \xAB${opt.id}) ${opt.label}\xBB on #${id}?`, `\xBFElegir \xAB${opt.id}) ${opt.label}\xBB en el #${id}?`),
+      { yes: v.yes, retry }
+    );
+    const r = await api(`${base}/${id}/act`, { body: { action: "choose", option: opt.id, confirmMerge: opt.action === "merge_as_is" } });
+    return out(
+      r,
+      () => `${lavender("\u2713")} ${r.merged ? t(`#${id} merged.`, `#${id} mergeado.`) : t(`#${id}: chose \xAB${opt.label}\xBB \u2192 ${stage(r.status)}.`, `#${id}: elegiste \xAB${opt.label}\xBB \u2192 ${stage(r.status)}.`)}` + (r.merged ? "" : `
+${dim(t(`Follow it: ghosty factory runs watch ${id} --workspace ${ws}`, `S\xEDguelo: ghosty factory runs watch ${id} --workspace ${ws}`))}`)
+    );
+  }
+  throw usage(t(`Unknown runs subcommand: ${verb}.`, `Subcomando de runs desconocido: ${verb}.`), 'ghosty factory runs ls | show <run> [--timing] | why <run> [--refresh] | advise <run> | stats [--since 30d] | rename <run> "title" | watch <run> | approve <run> --plan-version N [--note "\u2026"] [--check-scope "\u2026"] | changes <run> --note "\u2026" | recheck <run> | choose <run> [a|b|c] | merge <run> | card <run>');
 }
 async function agentsByHandle(handle, workspace) {
   const qs = new URLSearchParams({ handle, ...workspace ? { workspace } : {} });
@@ -16528,6 +16561,84 @@ async function agentsByHandle(handle, workspace) {
 ${dim(t(`Couldn't read: ${r.unreadable.join(", ")}`, `No se pudieron leer: ${r.unreadable.join(", ")}`))}` : ""}`);
 }
 
+// src/commands/events.ts
+init_api();
+init_util();
+init_i18n();
+var EX2 = 'ghosty events live ls | connect youtube|facebook | prepare --title "\u2026" [--privacy unlisted|public|private] [--at 2026-11-12T19:00] [--only youtube] | check | unlink youtube|facebook   [--workspace SLUG]';
+var enc18 = encodeURIComponent;
+var NAME = { youtube: "YouTube", facebook: "Facebook" };
+async function eventsCmd(sub, verb, arg, v, context) {
+  if (sub !== "live") throw usage(t(`Unknown events subcommand: ${sub ?? "(none)"}.`, `Subcomando de events desconocido: ${sub ?? "(ninguno)"}.`), EX2);
+  const ws = v.workspace ?? context;
+  if (!ws) throw usage(t("Which workspace?", "\xBFQu\xE9 espacio?"), t("Add --workspace SLUG (or set one with ghosty use SLUG).", "Agrega --workspace SLUG (o fija uno con ghosty use SLUG)."));
+  const path2 = `/api/v2/workspaces/${enc18(ws)}/live`;
+  const provider = (p) => {
+    if (p !== "youtube" && p !== "facebook") throw usage(t("Which one: youtube or facebook?", "\xBFCu\xE1l: youtube o facebook?"), EX2);
+    return p;
+  };
+  switch (verb ?? "ls") {
+    case "ls":
+    case "check": {
+      const r = await api(`${path2}${verb === "check" ? "?check=1" : ""}`);
+      return out(r, () => {
+        const lines = [];
+        if (!r.destinations.length) lines.push(dim(t(`${r.workspace} has no live destinations. Connect one: ghosty events live connect youtube`, `${r.workspace} no tiene a d\xF3nde transmitir. Conecta uno: ghosty events live connect youtube`)));
+        else
+          lines.push(
+            table(
+              r.destinations.map((d) => ({ where: NAME[d.provider], account: d.account, by: d.connectedBy ?? "", last: d.lastPreparedAt ? `${d.lastPreparedAt.slice(0, 16).replace("T", " ")} ${d.lastWatchUrl ?? ""}` : "" })),
+              ["where", "account", "by", "last"]
+            )
+          );
+        if (r.box !== void 0) {
+          if (!r.box) lines.push(red(t("The events box didn't answer.", "La caja de eventos no contest\xF3.")));
+          else lines.push(r.box.ready ? `${lavender("\u2713")} ${t("The events box will stream to", "La caja de eventos transmitir\xE1 a")}: ${bold(r.box.targets.join(" + "))}` : dim(t("The events box has no live destinations loaded: run ghosty events live prepare.", "La caja de eventos no tiene destinos cargados: corre ghosty events live prepare.")));
+        }
+        return lines.join("\n");
+      });
+    }
+    case "connect": {
+      const p = provider(arg);
+      const r = await api(path2, { method: "POST", body: { action: "connect", provider: p, ...v.lang ? { locale: v.lang } : {} } });
+      if (!v["no-open"]) await openUrl(r.url);
+      return out(
+        r,
+        () => [
+          `${lavender("\u2192")} ${t(`Finish connecting ${NAME[p]} in your browser (the link lasts 15 min):`, `Termina de conectar ${NAME[p]} en tu navegador (la liga dura 15 min):`)}`,
+          `  ${r.url}`,
+          dim(t("Then check it with: ghosty events live ls", "Luego rev\xEDsalo con: ghosty events live ls"))
+        ].join("\n")
+      );
+    }
+    case "unlink": {
+      const p = provider(arg);
+      await confirm(t(`Disconnect ${NAME[p]} from ${ws}? Its events won't stream there anymore.`, `\xBFDesconectar ${NAME[p]} de ${ws}? Sus eventos ya no se transmitir\xE1n ah\xED.`), { yes: v.yes, retry: `ghosty events live unlink ${p} --workspace ${ws} --yes` });
+      const r = await api(path2, { method: "POST", body: { action: "unlink", provider: p } });
+      return out(r, () => r.removed ? `${lavender("\u2713")} ${NAME[p]} ${t("disconnected.", "desconectado.")}` : dim(t(`${NAME[p]} wasn't connected.`, `${NAME[p]} no estaba conectado.`)));
+    }
+    case "prepare": {
+      if (!v.title) throw usage(t("Missing --title (what people will see on YouTube/Facebook).", "Falta --title (lo que ver\xE1 la gente en YouTube/Facebook)."), EX2);
+      if (v.privacy && !["unlisted", "public", "private"].includes(v.privacy)) throw usage("--privacy unlisted|public|private", EX2);
+      const only = v.only ? v.only.split(",").map((x) => provider(x.trim())) : void 0;
+      if (v.force) await confirm(t("--force restarts the events room even with people inside (they get kicked out). Continue?", "--force reinicia la sala de eventos aunque haya gente dentro (los saca). \xBFSeguir?"), { yes: v.yes, retry: `ghosty events live prepare --title "${v.title}" --force --yes` });
+      const r = await api(path2, {
+        method: "POST",
+        body: { action: "prepare", title: v.title, ...v.description ? { description: v.description } : {}, ...v.privacy ? { privacy: v.privacy } : {}, ...v.at ? { startsAt: v.at } : {}, ...only ? { only } : {}, ...v.force ? { force: true } : {} }
+      });
+      return out(r, () => {
+        const lines = r.prepared.map((p) => `${lavender("\u2713")} ${NAME[p.provider]} \xB7 ${p.account}: ${p.watchUrl}`);
+        for (const f of r.failed) lines.push(`${red("\u2717")} ${NAME[f.provider]} \xB7 ${f.account}: ${f.error}`);
+        if (r.box) lines.push(r.box.ready ? `${lavender("\u2713")} ${t("Events box ready to stream to", "Caja de eventos lista para transmitir a")}: ${bold(r.box.targets.join(" + "))}` : red(t("The events box restarted but didn't confirm the destinations: run ghosty events live check.", "La caja de eventos se reinici\xF3 pero no confirm\xF3 los destinos: corre ghosty events live check.")));
+        lines.push(dim(t("In the room, the host presses Record with \xABEn vivo\xBB checked.", "En el room, el anfitri\xF3n aprieta Grabar con \xABEn vivo\xBB marcado.")));
+        return lines.join("\n");
+      });
+    }
+    default:
+      throw usage(t(`Unknown live action: ${verb}.`, `Acci\xF3n desconocida: ${verb}.`), EX2);
+  }
+}
+
 // src/commands/staff.ts
 init_api();
 init_i18n();
@@ -16692,7 +16803,7 @@ init_api();
 import { readFile as readFile14 } from "node:fs/promises";
 init_i18n();
 init_util();
-var enc18 = encodeURIComponent;
+var enc19 = encodeURIComponent;
 var cdmx = (iso) => new Date(Date.parse(iso) - 6 * 36e5).toISOString().slice(5, 16).replace("T", " ");
 async function supportThreads(email, v) {
   const q = new URLSearchParams({ user: email, since: v.since ?? "30d", ...v.surface ? { surface: v.surface } : {} });
@@ -16712,7 +16823,7 @@ ${table(rows, ["last", "agent", "conversation", "title", "kind", "listed", "turn
 ${dim(t("Read one: ghosty conversations show <agent> <conversation> --why \xB7 times in CDMX \xB7 listed = in their app list", "Leer uno: ghosty conversations show <agente> <conversaci\xF3n> --why \xB7 horas CDMX \xB7 listed = sale en su lista de la app"))}`);
 }
 async function supportThread(agent, sid, v) {
-  const r = await api(`/api/v2/support/threads/${enc18(agent)}/${enc18(sid)}?tail=${enc18(v.limit ?? "40")}${v.tools ? "&tools=1" : ""}`);
+  const r = await api(`/api/v2/support/threads/${enc19(agent)}/${enc19(sid)}?tail=${enc19(v.limit ?? "40")}${v.tools ? "&tools=1" : ""}`);
   out(r, () => {
     if (v.tools && r.tools) {
       const x = r.tools;
@@ -16745,7 +16856,7 @@ async function cleanupConversations(action, agent, v) {
   if (!agent) throw usage(t("Missing agent.", "Falta el agente."), ex);
   if (v.kind !== "test" && v.kind !== "channel" && v.kind !== "personal") throw usage(t("--kind takes test, channel or personal.", "--kind acepta test, channel o personal."), ex);
   if (action === "rm" && v.kind === "channel") throw usage(t("Customer conversations (channel) are archived, never deleted: their memory keeps serving them.", "Los hilos de clientes (channel) se archivan, nunca se borran: su memoria los sigue atendiendo."), ex);
-  const path2 = `/api/v2/agents/${enc18(agent)}/conversations/cleanup`;
+  const path2 = `/api/v2/agents/${enc19(agent)}/conversations/cleanup`;
   const body = { kind: v.kind, action, ...v.before ? { before: v.before } : {} };
   const plan = await api(path2, { method: "POST", body: { ...body, dryRun: true } });
   const verb = action === "rm" ? t("delete (rows + agent memory)", "borrar (filas + memoria del agente)") : t("archive (hidden; memory stays)", "archivar (se ocultan; la memoria se queda)");
@@ -16760,7 +16871,7 @@ ${t("Go ahead?", "\xBFSigo?")}`, { yes: v.yes, retry: `ghosty conversations ${ac
   out(r, () => `${lavender("\u2713")} ${t(`${r.threads} conversation(s) ${action === "rm" ? "deleted" : "archived"}.`, `${r.threads} conversaci\xF3n(es) ${action === "rm" ? "borradas" : "archivadas"}.`)}`);
 }
 async function turnStats(v) {
-  const r = await api(`/api/v2/support/turn-stats?since=${enc18(v.since ?? "14d")}${v.all ? "&all=1" : ""}`);
+  const r = await api(`/api/v2/support/turn-stats?since=${enc19(v.since ?? "14d")}${v.all ? "&all=1" : ""}`);
   out(
     r,
     () => [
@@ -16780,7 +16891,7 @@ async function fleetBoxes() {
 ${table(rows, ["template", "boxes", "on", "asleep", "ram", "vcpu", "ram on"])}`);
 }
 async function appAgentsOf(email, client) {
-  const r = await api(`/api/v2/support/app-agents?user=${enc18(email)}${client && client !== "all" ? `&client=${enc18(client)}` : ""}`);
+  const r = await api(`/api/v2/support/app-agents?user=${enc19(email)}${client && client !== "all" ? `&client=${enc19(client)}` : ""}`);
   const rows = r.agentes.map((a) => ({ id: a.id, name: a.nombre, engine: a.motor ?? "", model: a.modelo ?? "", tone: a.tono ?? t("(by position)", "(por posici\xF3n)"), space: a.espacio?.tipo === "workspace" ? a.espacio.nombre : a.espacio?.tipo ?? "", last: a.ultimaActividad ? cdmx(a.ultimaActividad) : "" }));
   const phones = (r.devices ?? []).map((d) => `${d.platform} ${d.appVersion ?? ""}${d.appBuild ? ` (build ${d.appBuild})` : " (build ?)"} \xB7 ${t("seen", "visto")} ${cdmx(d.lastSeenAt)}`.replace(/\s+/g, " "));
   out(r, () => `${bold(r.user)} ${dim(r.client ? t(`as the ${r.client} app sees it`, `como lo ve la app de ${r.client}`) : t("all apps", "todas las apps"))}
@@ -16791,7 +16902,7 @@ ${dim(t("No phones registered for push.", "Sin tel\xE9fonos registrados para avi
 }
 async function pushLog(email, v) {
   if (!email) throw usage(t("Missing --user.", "Falta --user."), "ghosty push log --user ana@empresa.com [--since 2d]");
-  const r = await api(`/api/v2/support/push-log?user=${enc18(email)}&since=${enc18(v.since ?? "2d")}${v.limit ? `&limit=${enc18(v.limit)}` : ""}`);
+  const r = await api(`/api/v2/support/push-log?user=${enc19(email)}&since=${enc19(v.since ?? "2d")}${v.limit ? `&limit=${enc19(v.limit)}` : ""}`);
   const rows = r.pushes.map((p) => ({ at: cdmx(p.at), kind: p.kind, to: p.platform, status: p.status === "sent" ? p.status : red(p.status), thread: p.threadKind ? `${p.threadId?.slice(0, 18)} (${p.threadKind})` : (p.threadId ?? "").slice(0, 24), title: (p.title ?? "").slice(0, 40), detail: p.detail ?? "" }));
   out(r, () => rows.length ? `${bold(r.user)}
 ${table(rows, ["at", "kind", "to", "status", "thread", "title", "detail"])}` : dim(t(`No pushes for ${r.user} in that range (logged since 2026-10-01).`, `Sin avisos para ${r.user} en ese rango (se registran desde el 1-oct).`)));
@@ -16829,24 +16940,24 @@ ${dim(t(`Try it on your phone: ghosty novedades test ${r.id}`, `Pru\xE9bala en t
       if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
       const b = await fields();
       if (!Object.keys(b).length) throw usage(t("Nothing to change.", "Nada que cambiar."), ex);
-      const r = await api(`${base}/${enc18(id)}`, { method: "PATCH", body: b });
+      const r = await api(`${base}/${enc19(id)}`, { method: "PATCH", body: b });
       return out(r, () => `${lavender("\u2713")} ${line2(r)}`);
     }
     case "test": {
       if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
-      const r = await api(`${base}/${enc18(id)}`, { method: "POST", body: { push: "test" } });
+      const r = await api(`${base}/${enc19(id)}`, { method: "POST", body: { push: "test" } });
       return out(r, () => `${lavender("\u2713")} ${t(`Sent to your phone (${r.enviados} device(s)).`, `Enviada a tu tel\xE9fono (${r.enviados} dispositivo(s)).`)}`);
     }
     case "send":
     case "schedule": {
       if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
       if (v.at !== void 0) {
-        const r2 = await api(`${base}/${enc18(id)}`, { method: "PATCH", body: { schedule: v.at || null } });
+        const r2 = await api(`${base}/${enc19(id)}`, { method: "PATCH", body: { schedule: v.at || null } });
         return out(r2, () => `${lavender("\u2713")} ${line2(r2)}`);
       }
       requireYesIfHeadless(v.yes, `ghosty novedades send ${id}`);
       await confirm(t("Push this announcement to every recipient now?", "\xBFMandar ya el push de esta novedad a todos sus destinatarios?"), { yes: v.yes, retry: `ghosty novedades send ${id}` });
-      const r = await api(`${base}/${enc18(id)}`, { method: "POST", body: { push: "all" } });
+      const r = await api(`${base}/${enc19(id)}`, { method: "POST", body: { push: "all" } });
       return out(r, () => `${lavender("\u2713")} ${t(`Pushed to ${r.enviados} device(s).`, `Enviada a ${r.enviados} dispositivo(s).`)}`);
     }
     case "rm":
@@ -16854,7 +16965,7 @@ ${dim(t(`Try it on your phone: ghosty novedades test ${r.id}`, `Pru\xE9bala en t
       if (!id) throw usage(t("Missing id.", "Falta el id."), ex);
       requireYesIfHeadless(v.yes, `ghosty novedades rm ${id}`);
       await confirm(t(`Delete announcement ${id}?`, `\xBFBorrar la novedad ${id}?`), { yes: v.yes, retry: `ghosty novedades rm ${id}` });
-      return out(await api(`${base}/${enc18(id)}`, { method: "DELETE" }), () => `${lavender("\u2713")} ${t("Deleted.", "Borrada.")}`);
+      return out(await api(`${base}/${enc19(id)}`, { method: "DELETE" }), () => `${lavender("\u2713")} ${t("Deleted.", "Borrada.")}`);
     }
     default:
       throw usage(t(`Unknown novedades subcommand: ${sub}.`, `Subcomando de novedades desconocido: ${sub}.`), ex);
@@ -16923,7 +17034,7 @@ ${dim(r.case.id)}`);
   }
   if (!id) throw usage(t("Missing the case id.", "Falta el id del caso."), "ghosty support ls");
   if (sub === "show") {
-    const r = v.all ? await api(`/api/v2/support/cases/${enc18(id)}`) : await api(`/api/v2/me/support/${enc18(id)}`);
+    const r = v.all ? await api(`/api/v2/support/cases/${enc19(id)}`) : await api(`/api/v2/me/support/${enc19(id)}`);
     const c = r.case;
     return out(r, () => {
       const who2 = (a) => a === "staff" ? "Ghosty" : a === "agent" ? t("agent", "agente") : a === "customer" ? t("customer", "cliente") : a;
@@ -16944,18 +17055,18 @@ ${m.body}${m.attachments.length ? dim(`
   }
   if (sub === "reply") {
     if (!v.body && !v.resolve) throw usage(t("Missing --body.", "Falta --body."), 'ghosty support reply <id> --body "\u2026" [--resolve]');
-    const r = v.all || v.resolve ? await api(`/api/v2/support/cases/${enc18(id)}`, { method: "POST", body: { intent: "reply", body: v.body ?? "", resolve: Boolean(v.resolve) } }) : await api(`/api/v2/me/support/${enc18(id)}`, { method: "POST", body: { body: v.body } });
+    const r = v.all || v.resolve ? await api(`/api/v2/support/cases/${enc19(id)}`, { method: "POST", body: { intent: "reply", body: v.body ?? "", resolve: Boolean(v.resolve) } }) : await api(`/api/v2/me/support/${enc19(id)}`, { method: "POST", body: { body: v.body } });
     return out(r, () => `${lavender("\u2713")} ${r.case.code} \xB7 ${STATUS(r.case.status)}`);
   }
   if (sub === "link") {
     const ref = v.ref;
     if (!ref) throw usage(t("Missing the issue or PR.", "Falta el issue o PR."), "ghosty support link <id> owner/repo#12   (or the issue/PR URL)");
-    const r = await api(`/api/v2/support/cases/${enc18(id)}`, { method: "POST", body: { intent: "link", ref } });
+    const r = await api(`/api/v2/support/cases/${enc19(id)}`, { method: "POST", body: { intent: "link", ref } });
     return out(r, () => `${lavender("\u2713")} ${r.case.code} \u2192 ${bold(r.ref)} ${dim(`(${r.github.title})`)}${r.alsoWaiting ? `
 ${dim(t(`${r.alsoWaiting} more cases wait for the same fix: all get "fixed" when it closes.`, `Otros ${r.alsoWaiting} casos esperan el mismo arreglo: a todos les llega \xABya qued\xF3\xBB al cerrarse.`))}` : ""}`);
   }
   if (sub === "resolve" || sub === "reopen") {
-    const r = await api(`/api/v2/support/cases/${enc18(id)}`, { method: "POST", body: { intent: sub } });
+    const r = await api(`/api/v2/support/cases/${enc19(id)}`, { method: "POST", body: { intent: sub } });
     return out(r, () => `${lavender("\u2713")} ${r.case.code} \xB7 ${STATUS(r.case.status)}`);
   }
   throw usage(t(`Unknown support subcommand: ${sub}.`, `Subcomando de support desconocido: ${sub}.`), "ghosty support ls | open | show | reply | resolve | reopen | link");
@@ -17001,6 +17112,7 @@ ${bold("Workspaces")}  ${dim("(changing them: Ghosty staff)")}
   coupons redeem <CODE>                       Redeem a coupon for your account (also /canjear?codigo=CODE)
   ads watch [ls|run]                          Campaign watch (staff): Meta campaigns that stop delivering and ads-only WhatsApp numbers with no leads for 24 h   [run --dry-run: what it would alert]
   audit ls                                    The audit log: who changed what (agent page, channels, pauses, replies, transfers, "log in as")   [--workspace SLUG] [--agent ID] [--actor EMAIL] [--action A] [--since 24h] [--limit N]
+  events live ls|connect|prepare|check|unlink  Stream a workspace's events to YouTube and a Facebook Page: connect them (OAuth), then "prepare" creates the live event on each and loads the keys in the events room (empty room only)   [connect youtube|facebook] [prepare --title "\u2026" --privacy unlisted|public|private --at DATE --only youtube]
   factory rooms ls|repos|connect|disconnect   Set up the factory for a repo without opening Teams: create a room and connect the repo to it   [connect owner/repo --room R --create]
   factory run "\u2026" --repo o/n [--wait]          Hand a request to the Software Factory from the terminal (@plan plans, @build builds, @check reviews); --wait returns when you have to decide   [runs watch|approve|changes|merge|card <run>]
   factory sprints ls|show|approve             The sprints @plan proposes for a bigger goal (3\u20138 tickets in order): list, read, approve with one signature   [approve <id> --yes]
@@ -17220,6 +17332,7 @@ ${bold("Espacios")}  ${dim("(cambiarlos: staff de Ghosty)")}
   coupons redeem <C\xD3DIGO>                     Canjea un cup\xF3n para tu cuenta (tambi\xE9n /canjear?codigo=C\xD3DIGO)
   ads watch [ls|run]                          Vig\xEDa de campa\xF1as (staff): campa\xF1as de Meta que dejan de entregar y n\xFAmeros \xABs\xF3lo anuncios\xBB sin leads en 24 h   [run --dry-run: lo que avisar\xEDa]
   audit ls                                    La bit\xE1cora: qui\xE9n cambi\xF3 qu\xE9 (ficha, canales, pausas, respuestas, traspasos, \xABentrar como\xBB)   [--workspace SLUG] [--agent ID] [--actor CORREO] [--action A] [--since 24h] [--limit N]
+  events live ls|connect|prepare|check|unlink  Transmite los eventos de un espacio a YouTube y a una p\xE1gina de Facebook: con\xE9ctalos (OAuth) y \xABprepare\xBB crea el evento en cada uno y carga las llaves en la sala de eventos (s\xF3lo con la sala vac\xEDa)   [connect youtube|facebook] [prepare --title "\u2026" --privacy unlisted|public|private --at FECHA --only youtube]
   factory rooms ls|repos|connect|disconnect   Deja lista la f\xE1brica de un repo sin abrir Teams: crea un room y con\xE9ctale el repo   [connect due\xF1o/repo --room R --create]
   factory run "\u2026" --repo o/n [--wait]          P\xEDdele algo a la Software Factory desde la terminal (@plan planea, @build construye, @check revisa); --wait regresa cuando te toca decidir   [runs watch|approve|changes|merge|card <pedido>]
   factory sprints ls|show|approve             Los sprints que propone @plan para un objetivo grande (3\u20138 tickets en orden): lista, l\xE9elo, apru\xE9balo con una sola firma   [approve <id> --yes]
@@ -17400,7 +17513,7 @@ ${bold("Opciones globales")}
 ${bold("C\xF3digos de salida")}  0 bien \xB7 1 error de la API \xB7 2 uso incorrecto \xB7 3 sin sesi\xF3n
 ${dim("Nota: `ghosty` puede chocar con otro binario en tu PATH (p. ej. la TUI de Ghosty). Rev\xEDsalo con `which -a ghosty`; corre `npx @ghostystudio/cli` para ir a la segura.")}
 ${dim("Documentaci\xF3n: https://www.ghosty.studio/docs/cli")}`;
-var COMMANDS = ["login", "logout", "whoami", "usage", "use", "apply", "plan", "engines", "bags", "spaces", "workspaces", "staff", "settings", "coupons", "ads", "audit", "factory", "demos", "sites", "push", "novedades", "completion", "cards", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "watch", "teams", "partner", "image", "tts", "me", "channels", "board", "boards", "access", "credentials", "connectors", "browser", "support", "docs", "help"];
+var COMMANDS = ["login", "logout", "whoami", "usage", "use", "apply", "plan", "engines", "bags", "spaces", "workspaces", "staff", "settings", "coupons", "ads", "audit", "factory", "events", "demos", "sites", "push", "novedades", "completion", "cards", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "watch", "teams", "partner", "image", "tts", "me", "channels", "board", "boards", "access", "credentials", "connectors", "browser", "support", "docs", "help"];
 var AGENTS_SUBS = ["ls", "create", "get", "show", "set", "export", "doctor", "docs", "share", "unshare", "shares", "teams", "rm", "restart", "demo", "embed", "box", "token", "memory", "transfer"];
 function unknown(what, input, known, helpCmd) {
   const s2 = suggest(input, known);
@@ -17590,6 +17703,7 @@ async function main() {
       cap: { type: "string" },
       url: { type: "string" },
       description: { type: "string" },
+      privacy: { type: "string" },
       grant: { type: "string" },
       days: { type: "string" },
       voice: { type: "string" },
@@ -17726,7 +17840,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.92.0" }, () => "0.92.0");
+  if (v.version) return out({ version: "0.93.1" }, () => "0.93.1");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -17907,6 +18021,8 @@ async function main() {
       return auditCmd(sub, v, context);
     case "factory":
       return factoryCmd(sub, a1, a2, pos[4], v, context);
+    case "events":
+      return eventsCmd(sub, a1, a2, v, context);
     case "plan":
       if (sub === "open") {
         const slug = a1 ?? context;
@@ -17929,7 +18045,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.92.0").catch(() => null);
+var notice = updateNotice("0.93.1").catch(() => null);
 main().then(
   async () => {
     const n = process.stderr.isTTY ? await notice : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.92.0",
+  "version": "0.93.1",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {