@ghostystudio/cli 0.85.0 → 0.86.0

package/README.md

@@ -105,6 +105,7 @@ ghosty watch add <id> <url>   [--every 24h] [--focus "heading"] [--instruction "
 ghosty watch ls <id>
 ghosty watch check <id> <watch-id> [--dry-run]
 ghosty watch rm|resume <id> <watch-id>
+ghosty tts "Hola, te aviso por WhatsApp."   [--voice em_santa|em_alex|ef_dora] [--out voz.wav]   # the house voice (Mexican Spanish + pronunciation lexicon)
 ghosty teams post <workspace>#<room>[/<thread-id>] "msg" [--wait]   # write there as you; any @agent it mentions answers
 
 ghosty me files ls|get|export|upload|rm  [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]
@@ -150,6 +151,10 @@ 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.86.0
+
+- `ghosty tts "text" [--voice em_santa|em_alex|ef_dora] [--out FILE]`: hear the house voice (Kokoro, Mexican Spanish, with Ghosty's pronunciation lexicon) say a text, saved as a .wav. Up to 400 characters.
+
 ### Changes in 0.84.0
 
 - `coupons create|set` take `--from` (the lent plan starts then), `--redeem-by` (last moment to redeem) and `--convert-promo` (Stripe promotion code offered in /c/uso when the lent plan is about to end). New `coupons show <CODE>` (staff): who redeemed it, their plan window and who converted to a paid plan. Codes are accent- and case-insensitive.

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.85.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.86.0"}`, "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.85.0"}`,
+      "user-agent": `ghosty-cli/${"0.86.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -1264,7 +1264,7 @@ var mteams_exports = {};
 __export(mteams_exports, {
   mteamsCmd: () => mteamsCmd
 });
-import { writeFile as writeFile8 } from "node:fs/promises";
+import { writeFile as writeFile9 } from "node:fs/promises";
 function list(bots) {
   return bots.length ? table(
     bots.map((b) => ({
@@ -1306,7 +1306,7 @@ ${dim(`${t("Next", "Sigue")}: ghosty channels mteams zip ${id} ${b?.id ?? "<bot-
       const res = await request(`${path2}/${enc10(botId)}/zip`);
       const bytes = Buffer.from(await res.arrayBuffer());
       const file = v.out ?? "ghosty-teams.zip";
-      await writeFile8(file, bytes);
+      await writeFile9(file, bytes);
       return out({ saved: file, bytes: bytes.length }, () => `${lavender("\u2713")} ${t(`Saved ${file}: upload it in Teams admin \u2192 Manage apps.`, `Se guard\xF3 ${file}: s\xFAbelo en Teams admin \u2192 Administrar apps.`)}`);
     }
     case "on":
@@ -11237,7 +11237,7 @@ async function call(path2, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.85.0"}`
+        "user-agent": `ghosty-cli/${"0.86.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -11571,6 +11571,28 @@ async function imageCmd(sub, a1, a2, v) {
   );
 }
 
+// src/commands/tts.ts
+init_api();
+init_util();
+init_i18n();
+import { writeFile as writeFile7 } from "node:fs/promises";
+var MAX_CHARS = 400;
+var VOICES = ["em_santa", "em_alex", "ef_dora"];
+async function ttsCmd(text, v) {
+  const ex = 'ghosty tts "Hola, gracias por escribir." [--voice em_santa|em_alex|ef_dora] [--out voz.wav]';
+  const said = text?.trim();
+  if (!said) throw usage(t("Missing the text to say.", "Falta el texto a decir."), ex);
+  if (said.length > MAX_CHARS) throw usage(t(`Too long: ${said.length} characters (max ${MAX_CHARS}). Split it into sentences.`, `Demasiado largo: ${said.length} caracteres (m\xE1x. ${MAX_CHARS}). P\xE1rtelo en frases.`), ex);
+  const voice = v.voice ?? "em_santa";
+  if (!VOICES.includes(voice)) throw usage(t(`Unknown voice: ${voice}.`, `Voz desconocida: ${voice}.`), `${t("Voices", "Voces")}: ${VOICES.join(", ")}`);
+  const res = await request("/api/v2/me/tts", { body: { text: said, voice } });
+  const bytes = Buffer.from(await res.arrayBuffer());
+  const file = v.out ?? "voz.wav";
+  await writeFile7(file, bytes);
+  const durationMs = Number(res.headers.get("x-duration-ms") ?? 0);
+  return out({ saved: file, voice, bytes: bytes.length, durationMs }, () => `${lavender("\u2713")} ${file} (${(durationMs / 1e3).toFixed(1)} s) ${dim(t(`\xB7 play it: afplay ${file}`, `\xB7 esc\xFAchalo: afplay ${file}`))}`);
+}
+
 // src/commands/watch.ts
 init_api();
 init_util();
@@ -11652,7 +11674,7 @@ ${dim(`id ${w.id} \xB7 ${t("conversation", "conversaci\xF3n")} ${w.sessionId} \x
 
 // src/commands/data.ts
 init_api();
-import { readdir as readdir2, readFile as readFile6, writeFile as writeFile7 } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile6, writeFile as writeFile8 } from "node:fs/promises";
 import { basename as basename3, join as join5 } from "node:path";
 
 // src/rows.ts
@@ -11821,7 +11843,7 @@ async function dbsExport(id, db, v) {
   const suggested = /filename="([^"]+)"/.exec(res.headers.get("content-disposition") ?? "")?.[1] ?? (format === "csv" ? `${db}-${v.table}.csv` : `${db}.sqlite`);
   const file = v.out ?? suggested;
   const bytes = Buffer.from(await res.arrayBuffer());
-  await writeFile7(file, bytes);
+  await writeFile8(file, bytes);
   const countsHeader = res.headers.get("x-gs-row-counts");
   const counts = countsHeader ? JSON.parse(Buffer.from(countsHeader, "base64").toString("utf8")) : {};
   const rows = Object.entries(counts).map(([tb, n]) => ({ table: tb, rows: n }));
@@ -13432,6 +13454,16 @@ var HELPS_ES = {
     summary: "Ghosty para Chrome: cerrar la sesi\xF3n del navegador.",
     notes: ["Revoca todos los tokens de Ghosty para Chrome que tengan tus agentes de terminal (Claude Code, CLI, @ghostystudio/browser-mcp) y desconecta la extensi\xF3n. Para volver, copia un comando nuevo del panel de la extensi\xF3n."]
   },
+  tts: {
+    summary: "Oye la voz de la casa decir un texto (Kokoro, espa\xF1ol de M\xE9xico, con el l\xE9xico de pronunciaci\xF3n de Ghosty): la misma de las notas de voz. Guarda un .wav.",
+    usage: ['ghosty tts "texto" [--voice em_santa|em_alex|ef_dora] [--out ARCHIVO]'],
+    flags: [
+      ["--voice V", "em_santa (hombre, la de la casa, default), em_alex (hombre) o ef_dora (mujer)"],
+      ["--out FILE", "d\xF3nde guardar el .wav (default voz.wav)"]
+    ],
+    examples: ['ghosty tts "Hola, gracias por escribir. Te aviso por WhatsApp."', 'ghosty tts "Tu cita qued\xF3 el jueves a las cinco." --voice ef_dora --out cita.wav && afplay cita.wav'],
+    notes: ["Hasta 400 caracteres y 60 frases por minuto. Las marcas (WhatsApp, Claude, GitHub, ghosty.studio\u2026) se escriben normal: el l\xE9xico corrige c\xF3mo suenan."]
+  },
   image: {
     summary: "Im\xE1genes con IA (Gemini \xABNano Banana Pro\xBB) para los negocios de tu espacio de partner: generar, editar una que ya existe o componer con referencias; cobradas del saldo del espacio.",
     replace: [
@@ -14261,6 +14293,16 @@ var HELPS = {
     notes: ["Revokes every Ghosty for Chrome token your terminal agents hold (Claude Code, CLI, @ghostystudio/browser-mcp) and disconnects the extension. Copy a new command from the extension panel to reconnect."],
     learn: `${REF}#navegador`
   },
+  tts: {
+    summary: "Hear the house voice say a text (Kokoro, Mexican Spanish, with Ghosty's pronunciation lexicon): the same voice as the voice notes. Saves a .wav.",
+    usage: ['ghosty tts "text" [--voice em_santa|em_alex|ef_dora] [--out FILE]'],
+    flags: [
+      ["--voice V", "em_santa (man, the house voice, default), em_alex (man) or ef_dora (woman)"],
+      ["--out FILE", "where to save the .wav (default voz.wav)"]
+    ],
+    examples: ['ghosty tts "Hola, gracias por escribir. Te aviso por WhatsApp."', 'ghosty tts "Tu cita qued\xF3 el jueves a las cinco." --voice ef_dora --out cita.wav && afplay cita.wav'],
+    notes: ["Up to 400 characters and 60 sentences per minute. Brand names (WhatsApp, Claude, GitHub, ghosty.studio\u2026) are written normally: the lexicon fixes how they sound."]
+  },
   image: {
     summary: "AI images (Gemini \xABNano Banana Pro\xBB) for your partner businesses: generate, edit an existing one, or compose from references; charged to the space's balance.",
     usage: [
@@ -14860,7 +14902,7 @@ function helpText(cmd) {
 
 // src/update.ts
 init_i18n();
-import { mkdir as mkdir5, readFile as readFile9, writeFile as writeFile9 } from "node:fs/promises";
+import { mkdir as mkdir5, readFile as readFile9, writeFile as writeFile10 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
 import { dirname as dirname3, join as join7 } from "node:path";
 var FILE = join7(process.env.XDG_CONFIG_HOME || join7(homedir3(), ".config"), "ghosty", "update.json");
@@ -14886,7 +14928,7 @@ async function latestVersion(current2) {
       const latest = (await r.json()).version;
       if (latest) cache2 = { latest, checkedAt: Date.now() };
       await mkdir5(dirname3(FILE), { recursive: true });
-      await writeFile9(FILE, JSON.stringify(cache2));
+      await writeFile10(FILE, JSON.stringify(cache2));
     } catch {
     }
   }
@@ -14967,7 +15009,7 @@ function agentArgIndex(pos) {
 }
 
 // src/completion.ts
-import { mkdir as mkdir6, readFile as readFile10, writeFile as writeFile10 } from "node:fs/promises";
+import { mkdir as mkdir6, readFile as readFile10, writeFile as writeFile11 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
 import { join as join8 } from "node:path";
 var GLOBAL_FLAGS = ["--json", "--token", "--profile", "--yes", "--help", "--version", "--lang", "--dry-run"];
@@ -15019,7 +15061,7 @@ async function names() {
   const workspaces = [...new Set(list2.map((a) => a.espacio?.tipo === "workspace" ? a.espacio.nombre : void 0).filter((x) => !!x))];
   await mkdir6(join8(cacheFile(), ".."), { recursive: true }).catch(() => {
   });
-  await writeFile10(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
+  await writeFile11(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
   });
   return { agents, workspaces };
 }
@@ -15106,7 +15148,7 @@ init_i18n();
 // src/commands/spec.ts
 var import_yaml = __toESM(require_dist(), 1);
 init_api();
-import { mkdir as mkdir7, readdir as readdir4, readFile as readFile11, stat as stat2, writeFile as writeFile11 } from "node:fs/promises";
+import { mkdir as mkdir7, readdir as readdir4, readFile as readFile11, stat as stat2, writeFile as writeFile12 } from "node:fs/promises";
 import { join as join9, resolve as resolve2 } from "node:path";
 init_util();
 init_i18n();
@@ -15120,7 +15162,7 @@ async function agentsExport(id, v) {
   }
   const dir = resolve2(v.out);
   await mkdir7(dir, { recursive: true });
-  await writeFile11(join9(dir, "agent.yaml"), yaml);
+  await writeFile12(join9(dir, "agent.yaml"), yaml);
   const own = (0, import_yaml.parse)(yaml)["x-ghosty"]?.skills?.own ?? [];
   for (const slug of own) {
     const sk = await api(`/api/v2/agents/${enc13(id)}/skills/${enc13(slug)}`);
@@ -15243,7 +15285,7 @@ ${dim(t(`${r.totals.activeTurns} turn(s) running`, `${r.totals.activeTurns} turn
 init_api();
 init_auth();
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir8, readFile as readFile12, writeFile as writeFile12 } from "node:fs/promises";
+import { mkdir as mkdir8, readFile as readFile12, writeFile as writeFile13 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
 import { dirname as dirname4, join as join10 } from "node:path";
 init_i18n();
@@ -15288,7 +15330,7 @@ async function visitorCookie(base, slug, fresh) {
   if (!cookie) throw new CliError(t("The demo didn't hand out a visitor cookie.", "El demo no entreg\xF3 cookie de visitante."), EXIT.API);
   jar[slug] = cookie;
   await mkdir8(dirname4(jarPath()), { recursive: true });
-  await writeFile12(jarPath(), JSON.stringify(jar, null, 2), { mode: 384 });
+  await writeFile13(jarPath(), JSON.stringify(jar, null, 2), { mode: 384 });
   return cookie;
 }
 async function visitorTurn(base, slug, cookie, text) {
@@ -15528,7 +15570,7 @@ ${domainLine(r, t("en", "es") === "es" ? "es" : "en").replace("<slug>", slug)}`)
 
 // src/commands/docs.ts
 init_api();
-import { writeFile as writeFile13 } from "node:fs/promises";
+import { writeFile as writeFile14 } from "node:fs/promises";
 
 // ../docs/src/core/doc-blocks.ts
 var DOC_ENVELOPE_VERSION = 1;
@@ -15691,7 +15733,7 @@ ${t("Ids: ghosty me docs ls", "Ids: ghosty me docs ls")}`);
       }
       const named = /filename\*=UTF-8''([^;]+)/i.exec(res.headers.get("content-disposition") ?? "")?.[1];
       const file = v.out ?? (named ? decodeURIComponent(named) : fileName(id, format));
-      await writeFile13(file, bytes);
+      await writeFile14(file, bytes);
       return out({ id, format, saved: file, bytes: bytes.length }, () => `${lavender("\u2713")} ${file} (${bytes.length} bytes)`);
     }
     case "check": {
@@ -15717,7 +15759,7 @@ ${t("Ids: ghosty me docs ls", "Ids: ghosty me docs ls")}`);
       if (res.status === 204) return out({ id, block, segment, segments, saved: null }, () => dim(t("That block has no text to read.", "Ese bloque no tiene texto que leer.")));
       const bytes = Buffer.from(await res.arrayBuffer());
       const file = v.out ?? `${id}-${block}${segment !== null ? `-${segment}` : ""}.${audioExt(res.headers.get("content-type"))}`;
-      await writeFile13(file, bytes);
+      await writeFile14(file, bytes);
       return out({ id, block, segment, segments, saved: file, bytes: bytes.length }, () => `${lavender("\u2713")} ${file} (${bytes.length} bytes) ${dim(t(`\xB7 the block has ${segments} sentence(s): --segment 0\u2026${Math.max(segments - 1, 0)}`, `\xB7 el bloque tiene ${segments} frase(s): --segment 0\u2026${Math.max(segments - 1, 0)}`))}`);
     }
     case "restore": {
@@ -16945,6 +16987,7 @@ ${bold("Partners")}  ${dim("(give an agent to each of YOUR customers \u2014 see:
   partner ls | enable | credentials | agent | tenants | audit | try
   image generate "prompt"   An AI image for your businesses, charged to the space's balance   [--ref URL (repeat, keeps the character)] [--style-ref URL] [--scene URL] [--text "-50 %"] [--direction D]\u2026 [--variants N] [--size 1K|2K|4K] [--aspect 16:9] [--tenant ID] [--out FILE]
   image edit URL "change"   Edit an existing image: only that change, the rest stays   [--ref URL] [--text T] [--variants N] [--size] [--aspect] [--tenant ID] [--out FILE]
+  tts "text"                Hear the house voice (Mexican Spanish, em_santa) say it, to a .wav   [--voice em_santa|em_alex|ef_dora] [--out FILE]
 
 ${bold("Your account")}
   me files ls|get|export|upload|rm Files in your account [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out FILE]
@@ -17159,6 +17202,7 @@ ${bold("Partners")}  ${dim("(dale un agente a cada uno de TUS clientes \u2014 ve
   partner ls | enable | credentials | agent | tenants | audit | try
   image generate "prompt"   Una imagen con IA para tus negocios, cobrada del saldo del espacio   [--ref URL (se repite, conserva al personaje)] [--style-ref URL] [--scene URL] [--text "-50 %"] [--direction D]\u2026 [--variants N] [--size 1K|2K|4K] [--aspect 16:9] [--tenant ID] [--out ARCHIVO]
   image edit URL "cambio"   Edita una imagen que ya existe: s\xF3lo ese cambio, lo dem\xE1s se queda   [--ref URL] [--text T] [--variants N] [--size] [--aspect] [--tenant ID] [--out ARCHIVO]
+  tts "texto"               Oye la voz de la casa (espa\xF1ol de M\xE9xico, em_santa) decirlo, en un .wav   [--voice em_santa|em_alex|ef_dora] [--out ARCHIVO]
 
 ${bold("Tu cuenta")}
   me files ls|get|export|upload|rm Archivos de tu cuenta [--q TEXTO] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out ARCHIVO]
@@ -17184,7 +17228,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", "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", "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);
@@ -17501,7 +17545,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.85.0" }, () => "0.85.0");
+  if (v.version) return out({ version: "0.86.0" }, () => "0.86.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -17646,6 +17690,8 @@ async function main() {
       return partnerCmd(sub, a1, a2, { ...v, token: tokens.turn }, pos[4]);
     case "image":
       return imageCmd(sub, a1, a2, v);
+    case "tts":
+      return ttsCmd(sub, v);
     case "usage":
       if (v.images) return imageUsage(v);
       if (v.boxes && v.by === "template") return fleetBoxes();
@@ -17702,7 +17748,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.85.0").catch(() => null);
+var notice = updateNotice("0.86.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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