@ghostystudio/cli 0.31.0 → 0.32.0

package/README.md

@@ -73,6 +73,7 @@ ghosty schedule rm <id> <schedule-id>
 ghosty schedule add|ls|rm <id> … --teams <workspace>#<room>[/<thread-id>]   # in a Teams room/thread: it answers there as if mentioned
 
 ghosty me files ls|get|upload|rm         [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]
+ghosty me memories ls|add|edit|rm        [--agent A]
 ghosty conversations archive|rm <id> --kind test|channel [--before 7d] [--dry-run]
 ghosty agents docs dedupe [--dry-run]    # your account: merge documents with the same content
 # Ghosty staff

package/dist/index.js

@@ -8055,6 +8055,16 @@ var SERVER_MESSAGES = [
   ["~ WabaLink {}: s\xF3lo anuncios {} \u2192 {}", "~ WabaLink {}: ads only {} \u2192 {}"],
   ["  s\xF3lo anuncios: on (s\xF3lo abre tarjeta lo que viene de un anuncio)", "  ads only: on (only what comes from an ad opens a card)"],
   ["  s\xF3lo anuncios: off", "  ads only: off"],
+  // — Memorias e hilo largo
+  ["no existe esa memoria (revisa memory_list)", "that memory doesn't exist (check memory_list)"],
+  ["no existe esa memoria", "that memory doesn't exist"],
+  ["la memoria est\xE1 vac\xEDa", "the memory is empty"],
+  ["una memoria cabe en {} caracteres", "a memory fits in {} characters"],
+  ["ya hay {} memorias; borra alguna antes de guardar otra", "there are already {} memories; delete one before saving another"],
+  ["no se pudo guardar la memoria", "couldn't save the memory"],
+  ["las memorias s\xF3lo se tocan en el chat personal de la persona", "memories can only be changed in the person's personal chat"],
+  ["la persona la ve y la edita en Memorias de su app", "the person sees and edits it in Memories in their app"],
+  ["No pude abrir el chat nuevo: {}", "Couldn't open the new chat: {}"],
   // — 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"],
@@ -8357,7 +8367,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.31.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.32.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8399,7 +8409,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.31.0"}`,
+      "user-agent": `ghosty-cli/${"0.32.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9251,6 +9261,36 @@ async function readAll() {
   for await (const c of process.stdin) s += c;
   return s;
 }
+async function meMemories(sub, arg, text, v) {
+  const ex = 'ghosty me memories ls [--agent A] | add "texto" [--agent A] | edit <id> "texto" | rm <id>';
+  switch (sub ?? "ls") {
+    case "ls": {
+      const r = await api(`/api/v2/me/memories${v.agent ? `?agente=${enc3(v.agent)}` : ""}`);
+      out(r, () => {
+        const rows = r.memories.map((m) => ({ id: m.id, memory: m.content, agent: m.agentId ?? t("all", "todos"), from: m.source }));
+        return rows.length ? table(rows, ["id", "memory", "agent", "from"]) : dim(t('Nothing yet. Add one: ghosty me memories add "I prefer short answers"', 'A\xFAn nada. Agrega una: ghosty me memories add "prefiero respuestas cortas"'));
+      });
+      return;
+    }
+    case "add": {
+      if (!arg) throw usage(t("Missing the memory text.", "Falta el texto de la memoria."), ex);
+      const r = await api(`/api/v2/me/memories`, { method: "POST", body: { content: arg, agentId: v.agent ?? null } });
+      return out(r, () => `${lavender("\u2713")} ${t("Saved", "Guardada")} (${r.memory.id})`);
+    }
+    case "edit": {
+      if (!arg || !text) throw usage(t("Missing the id or the new text.", "Falta el id o el texto nuevo."), ex);
+      const r = await api(`/api/v2/me/memories/${enc3(arg)}`, { method: "PATCH", body: { content: text } });
+      return out(r, () => `${lavender("\u2713")} ${t("Updated", "Actualizada")} (${r.memory.id})`);
+    }
+    case "rm": {
+      if (!arg) throw usage(t("Missing the memory id.", "Falta el id de la memoria."), ex);
+      const r = await api(`/api/v2/me/memories/${enc3(arg)}`, { method: "DELETE" });
+      return out(r, () => `${lavender("\u2713")} ${t("Forgotten", "Olvidada")}`);
+    }
+    default:
+      throw usage(t(`Unknown memories subcommand: ${sub}.`, `Subcomando de memories desconocido: ${sub}.`), ex);
+  }
+}
 async function meFiles(sub, arg, v) {
   const ex = "ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] | get <file-id> [--out FILE] | upload <file> | rm <file-id>";
   switch (sub) {
@@ -9529,7 +9569,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.31.0"}`
+        "user-agent": `ghosty-cli/${"0.32.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10841,7 +10881,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"], ["# stop the turn AND its background jobs", "# detiene el turno Y sus encargos en fondo"], ["# staff: real failure rate by engine and error", "# staff: tasa real de fallos por motor y por error"]],
+    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"], ["# staff: real failure rate by engine, channel (Teams/A2A too) and error", "# staff: tasa real de fallos por motor, canal (tambi\xE9n Teams y A2A) y error"]],
     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)"],
@@ -10897,7 +10937,10 @@ var HELPS_ES = {
     replace: [['"what to do"', '"qu\xE9 hacer"'], ["# answers in that thread as if mentioned", "# contesta en ese hilo como si lo mencionaran"]],
     notes: ["--teams: el agente tiene que estar activo en el Teams de ese espacio y t\xFA ser miembro. El id del hilo es el del mensaje con que empieza."]
   },
-  me: { summary: "Tu cuenta: archivos y uso." },
+  me: {
+    summary: "Tu cuenta: archivos, memorias y uso.",
+    notes: ["Las memorias viajan a tus agentes s\xF3lo en tus chats personales (app, /c, notch), nunca a WhatsApp, Messenger ni demos. --agent la limita a ese agente."]
+  },
   credentials: {
     summary: "Llaves de proveedores en la b\xF3veda de tu cuenta (cifradas; s\xF3lo regresan los \xFAltimos 4 caracteres).",
     replace: [["# hidden prompt", "# pregunta oculta"]],
@@ -11073,7 +11116,7 @@ var HELPS_ES = {
   },
   novedades: {
     summary: "Staff de Ghosty: las novedades de la app Android. Cada una con su ilustraci\xF3n; mismos frenos que el admin: pru\xE9bala en tu tel\xE9fono primero, push de 9 a 21 h CDMX, 72 h entre env\xEDos a todos.",
-    notes: ["--image se publica en img.ghosty.studio (WebP 1200 px). --to vac\xEDo = todos. send sin --at la manda ya (pregunta); --at '' quita la programaci\xF3n."]
+    notes: ["--image se publica en img.ghosty.studio (WebP 1200 px). --to vac\xEDo = todos. send sin --at la manda ya (pregunta); --at '' quita la programaci\xF3n.", "--min-version N (versionCode de Android): si la app del tester es m\xE1s vieja, el bot\xF3n dice \xABActualizar\xBB y lanza la actualizaci\xF3n de Play desde la app; '' la quita."]
   },
   spaces: {
     summary: "Espacios: lista los tuyos (o, staff, los de cualquiera) y operaciones del staff de Ghosty \u2014 entrar/salir del espacio de un cliente, cambiar su combo, mover \xABpagado hasta\xBB, renombrar su slug. Cada cambio queda en la bit\xE1cora del espacio.",
@@ -11275,7 +11318,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]", "ghosty turns cancel <agent-id> <conversation-id>   # stop the turn AND its background jobs", "ghosty turns stats [--since 14d] [--all]   # staff: real failure rate by engine and error"],
+    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", "ghosty turns stats [--since 14d] [--all]   # staff: real failure rate by engine, channel (Teams/A2A too) and error"],
     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)"],
@@ -11366,9 +11409,10 @@ var HELPS = {
     learn: `${REF}#programar-turnos`
   },
   me: {
-    summary: "Your account: files and usage.",
-    usage: ["ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]", "ghosty me files get <file-id> [--out FILE]", "ghosty me files upload <file> | rm <file-id>", "ghosty usage"],
-    examples: ["ghosty me files ls --kind document", "ghosty me files ls --q contrato", "ghosty me files get <id> --out contrato.pdf", 'ghosty chat <agent> "res\xFAmelo" --file <id>'],
+    summary: "Your account: files, memories and usage.",
+    usage: ["ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]", "ghosty me files get <file-id> [--out FILE]", "ghosty me files upload <file> | rm <file-id>", 'ghosty me memories ls [--agent A] | add "text" [--agent A] | edit <id> "text" | rm <id>', "ghosty usage"],
+    examples: ["ghosty me files ls --kind document", "ghosty me files ls --q contrato", "ghosty me files get <id> --out contrato.pdf", 'ghosty chat <agent> "res\xFAmelo" --file <id>', 'ghosty me memories add "I prefer short answers"'],
+    notes: ["Memories travel to your agents only in your personal chats (app, /c, notch), never to WhatsApp, Messenger or demo threads. --agent limits one to that agent."],
     learn: `${REF}#tu-cuenta`
   }
 };
@@ -11626,14 +11670,14 @@ HELPS.novedades = {
   summary: "Ghosty staff: the Android app's announcements (what's new). Each one needs its own illustration; same brakes as the admin: test on your phone first, push 9\u201321 h CDMX, 72 h between pushes to everyone.",
   usage: [
     "ghosty novedades ls",
-    'ghosty novedades create --title T --body B --image hero.png [--link ruta] [--button "Abrir"] [--to a@x.com,b@y.com] [--publish]',
-    "ghosty novedades set <id> [--title] [--body] [--image FILE] [--link] [--button] [--to] [--publish|--draft]",
+    'ghosty novedades create --title T --body B --image hero.png [--link ruta] [--button "Abrir"] [--to a@x.com,b@y.com] [--min-version N] [--publish]',
+    "ghosty novedades set <id> [--title] [--body] [--image FILE] [--link] [--button] [--to] [--min-version N] [--publish|--draft]",
     "ghosty novedades test <id>",
     'ghosty novedades send <id> [--at "2026-10-02T12:00"]',
     "ghosty novedades rm <id>"
   ],
   examples: ['ghosty novedades create --title "PDF y audio" --body "Ahora\u2026" --image hero.png --link chats --publish', "ghosty novedades test <id>", 'ghosty novedades send <id> --at "2026-10-02T12:00"'],
-  notes: ["--image is published to img.ghosty.studio (WebP 1200 px). --to empty = everyone. send without --at pushes now (asks); --at '' removes the schedule."],
+  notes: ["--image is published to img.ghosty.studio (WebP 1200 px). --to empty = everyone. send without --at pushes now (asks); --at '' removes the schedule.", "--min-version N (Android versionCode): if the tester's app is older, the button reads \xABActualizar\xBB and starts Play's in-app update; '' removes it."],
   learn: `${REF}#soporte`
 };
 HELPS.spaces = {
@@ -12407,6 +12451,7 @@ async function turnStats(v) {
       dim(Object.entries(r.byState).map(([k, n]) => `${k} ${n}`).join(" \xB7 ")),
       "",
       table(r.byEngine.map((e) => ({ engine: e.engine, turns: e.turns, failed: e.failed, rate: `${e.failRate}%` })), ["engine", "turns", "failed", "rate"]),
+      ...r.byCanal?.length ? ["", table(r.byCanal.map((c) => ({ canal: c.canal, turns: c.turns, failed: c.failed, rate: `${c.failRate}%` })), ["canal", "turns", "failed", "rate"])] : [],
       ...r.topErrors.length ? ["", table(r.topErrors.map((e) => ({ n: e.n, error: e.error })), ["n", "error"])] : []
     ].join("\n")
   );
@@ -12432,7 +12477,7 @@ ${table(rows, ["at", "kind", "to", "status", "thread", "title", "detail"])}` : d
 }
 async function novedadesCmd(sub, id, v) {
   const base = "/api/v2/support/announcements";
-  const ex = 'ghosty novedades ls \xB7 create --title T --body B --image hero.png [--link ruta] [--button "Abrir"] [--to a@x.com,b@y.com] [--publish] \xB7 set <id> \u2026 \xB7 test <id> \xB7 send <id> [--at "2026-10-02T12:00"] \xB7 rm <id>';
+  const ex = 'ghosty novedades ls \xB7 create --title T --body B --image hero.png [--link ruta] [--button "Abrir"] [--to a@x.com,b@y.com] [--min-version 12] [--publish] \xB7 set <id> \u2026 \xB7 test <id> \xB7 send <id> [--at "2026-10-02T12:00"] \xB7 rm <id>';
   const fields = async () => ({
     ...v.title !== void 0 ? { title: v.title } : {},
     ...v.body !== void 0 ? { body: v.body } : {},
@@ -12440,10 +12485,12 @@ async function novedadesCmd(sub, id, v) {
     ...v.link !== void 0 ? { enlace: v.link || null } : {},
     ...v.button !== void 0 ? { boton: v.button || null } : {},
     ...v.to !== void 0 ? { destinatarios: v.to || null } : {},
+    // «Requiere versión ≥ N» (versionCode de Android): el botón dice «Actualizar». Vacío = la quita.
+    ...v["min-version"] !== void 0 ? { minVersionCode: v["min-version"] ? Number(v["min-version"]) : null } : {},
     ...v.publish ? { published: true } : v.draft ? { published: false } : {}
   });
   const line2 = (a) => `${bold(a.title)} ${dim(a.id)}
-  ${a.published ? lavender(t("published", "publicada")) : dim(t("draft", "borrador"))} \xB7 ${a.pushedAt ? t(`pushed ${cdmx(a.pushedAt)} (${a.pushCount})`, `enviada ${cdmx(a.pushedAt)} (${a.pushCount})`) : a.schedule ? t(`push scheduled ${cdmx(a.schedule)} CDMX`, `push programado ${cdmx(a.schedule)} CDMX`) : t("not pushed", "sin enviar")} \xB7 ${a.destinatarios ? t(`to ${a.destinatarios.split(",").length}`, `para ${a.destinatarios.split(",").length}`) : t("everyone", "todos")}`;
+  ${a.published ? lavender(t("published", "publicada")) : dim(t("draft", "borrador"))} \xB7 ${a.pushedAt ? t(`pushed ${cdmx(a.pushedAt)} (${a.pushCount})`, `enviada ${cdmx(a.pushedAt)} (${a.pushCount})`) : a.schedule ? t(`push scheduled ${cdmx(a.schedule)} CDMX`, `push programado ${cdmx(a.schedule)} CDMX`) : t("not pushed", "sin enviar")} \xB7 ${a.destinatarios ? t(`to ${a.destinatarios.split(",").length}`, `para ${a.destinatarios.split(",").length}`) : t("everyone", "todos")}${a.minVersionCode ? t(` \xB7 needs v${a.minVersionCode}+`, ` \xB7 requiere v${a.minVersionCode}+`) : ""}`;
   switch (sub ?? "ls") {
     case "ls":
     case "list": {
@@ -12575,7 +12622,7 @@ ${bold("Support")}  ${dim("(Ghosty staff)")}
   conversations show <id> <conv> --why    A conversation: who sees it in their list / by link, and why
   turns stats                             Real failure rate by engine and error   [--since 14d] [--all]
   push log --user EMAIL                   Pushes sent to someone and what Apple/Google answered   [--since 2d]
-  novedades ls|create|set|test|send|rm    Android app announcements   [--title] [--body] [--image FILE] [--link] [--to] [--publish] [--at]
+  novedades ls|create|set|test|send|rm    Android app announcements   [--title] [--body] [--image FILE] [--link] [--to] [--min-version N] [--publish] [--at]
 
 ${bold("Demos")}
   demos try <slug> "msg" ["msg2"\u2026]   Try a public demo as a visitor (same thread across runs)   [--new] [--recycle-between --agent X]
@@ -12605,6 +12652,7 @@ ${bold("Partners")}  ${dim("(give an agent to each of YOUR customers \u2014 see:
 
 ${bold("Your account")}
   me files ls|get|upload|rm Files in your account        [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out FILE]
+  me memories ls|add|edit|rm What your agents remember about you (personal chats only)   [--agent A] \xB7 add "text" \xB7 edit <id> "text" \xB7 rm <id>
   credentials ls|set|rm [provider]   Provider keys in your vault (hidden prompt, stdin or --from-env VAR; never as an argument)
   docs [topic]              Open the docs
 
@@ -12702,7 +12750,7 @@ ${bold("Soporte")}  ${dim("(staff de Ghosty)")}
   conversations show <id> <conv> --why    Una conversaci\xF3n: qui\xE9n la ve en su lista / por liga, y por qu\xE9
   turns stats                             Tasa real de fallos por motor y por error   [--since 14d] [--all]
   push log --user CORREO                  Avisos que se le mandaron a alguien y qu\xE9 contest\xF3 Apple/Google   [--since 2d]
-  novedades ls|create|set|test|send|rm    Novedades de la app Android   [--title] [--body] [--image ARCHIVO] [--link] [--to] [--publish] [--at]
+  novedades ls|create|set|test|send|rm    Novedades de la app Android   [--title] [--body] [--image ARCHIVO] [--link] [--to] [--min-version N] [--publish] [--at]
 
 ${bold("Demos")}
   demos try <slug> "msg" ["msg2"\u2026]   Prueba un demo p\xFAblico como visitante (mismo hilo entre corridas)   [--new] [--recycle-between --agent X]
@@ -12732,6 +12780,7 @@ ${bold("Partners")}  ${dim("(dale un agente a cada uno de TUS clientes \u2014 ve
 
 ${bold("Tu cuenta")}
   me files ls|get|upload|rm Archivos de tu cuenta         [--q TEXTO] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out ARCHIVO]
+  me memories ls|add|edit|rm Lo que tus agentes recuerdan de ti (s\xF3lo chats personales)   [--agent A] \xB7 add "texto" \xB7 edit <id> "texto" \xB7 rm <id>
   credentials ls|set|rm [proveedor]   Llaves de proveedor en tu b\xF3veda (prompt oculto, stdin o --from-env VAR; nunca como argumento)
   docs [tema]               Abre la documentaci\xF3n
 
@@ -12928,6 +12977,7 @@ async function main() {
       image: { type: "string" },
       link: { type: "string" },
       button: { type: "string" },
+      "min-version": { type: "string" },
       publish: { type: "boolean" },
       draft: { type: "boolean" },
       "ads-only": { type: "string" },
@@ -12952,7 +13002,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.31.0" }, () => "0.31.0");
+  if (v.version) return out({ version: "0.32.0" }, () => "0.32.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -13085,8 +13135,9 @@ async function main() {
       return planCmd(sub, a1, v, context);
     case "me":
       if (sub === "files") return meFiles(a1, a2, v);
+      if (sub === "memories" || sub === "memory") return meMemories(a1, a2, pos[4], v);
       if (sub === "usage") return meUsage();
-      throw usage(t(`Unknown me subcommand: ${sub ?? "(none)"}.`, `Subcomando de me desconocido: ${sub ?? "(ninguno)"}.`), t("Try: ghosty me files ls", "Prueba: ghosty me files ls"));
+      throw usage(t(`Unknown me subcommand: ${sub ?? "(none)"}.`, `Subcomando de me desconocido: ${sub ?? "(ninguno)"}.`), t("Try: ghosty me files ls | ghosty me memories ls", "Prueba: ghosty me files ls | ghosty me memories ls"));
     case "docs": {
       const url = `${await baseUrl()}/docs${sub ? `/${encodeURIComponent(sub)}` : "/cli"}`;
       if (globals.json) return out({ url });
@@ -13097,7 +13148,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.31.0").catch(() => null);
+var notice = updateNotice("0.32.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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