@ghostystudio/cli 0.26.0 → 0.27.1

package/README.md

@@ -70,6 +70,7 @@ ghosty conversations show <id> <conversation-id> [--limit 20]   # what was said
 ghosty schedule add <id> "what to do"    --in 30m | --at ISO  [--every 12h --until ISO] [--conversation ID] [--title T]
 ghosty schedule ls <id>
 ghosty schedule rm <id> <schedule-id>
+ghosty schedule add|ls|rm <id> … --teams <workspace>#<room>[/<thread-id>]   # in a Teams room/thread: it answers there as if mentioned
 
 ghosty me files ls|upload|rm             [--kind image|video|audio|document|other]
 ghosty credentials ls|set|rm [provider]  [--from-env VAR]   # never as an argument
@@ -86,6 +87,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.27.1
+
+- A 404 with a reason (no such bag, room or thread) prints that reason instead of a generic «Not found».
+
+### Changes in 0.27.0
+
+- `schedule add <id> "…" --teams <workspace>#<room>[/<thread-id>] --at ISO | --in 30m`: at that time the agent answers in that Teams room or thread as if mentioned (with the room's memory). `schedule ls|rm <id> --teams <workspace>`.
+
 ### Changes in 0.26.0
 
 - `ghosty engines ls [--models]`: engines and models valid for `--engine`/`--model`; an unknown model is rejected with the valid list (also without `--engine`).

package/dist/index.js

@@ -8002,6 +8002,18 @@ var SERVER_MESSAGES = [
   ["s\xF3lo el due\xF1o (o staff) puede borrar el agente", "only the owner (or staff) can delete the agent"],
   ["ghosty agents rm <agente> --from-workspace lo quita de Teams y lo borra", "ghosty agents rm <agent> --from-workspace takes it out of Teams and deletes it"],
   ["Se acab\xF3 el saldo de este agente ({}). Era una carga \xFAnica y no se recarga. Los dem\xE1s agentes del espacio siguen con el suyo.", "This agent ran out of balance ({}). It was a one-time load and doesn't refill. The other agents in the workspace keep theirs."],
+  ["el token del agente no programa turnos en Teams: usa tu sesi\xF3n", "the agent's token doesn't schedule turns in Teams: use your session"],
+  ["falta workspace (el espacio de Teams)", "missing workspace (the Teams workspace)"],
+  ["no eres miembro de \xAB{}\xBB", "you're not a member of \xAB{}\xBB"],
+  ["el agente no est\xE1 activo en el Teams de {}", "the agent isn't active in {}'s Teams"],
+  ["faltan channel, text o dueAt (ISO)", "missing channel, text or dueAt (ISO)"],
+  ["no pude hablar con Teams de {}: {}", "couldn't reach {}'s Teams: {}"],
+  ["@{} no est\xE1 activo en este espacio", "@{} isn't active in this workspace"],
+  ["no hay un room \xAB{}\xBB en este espacio", "there's no room \xAB{}\xBB in this workspace"],
+  ["el mensaje {} no es de #{}", "message {} isn't from #{}"],
+  ["el mensaje {} es una respuesta; usa el del inicio del hilo ({})", "message {} is a reply; use the one that starts the thread ({})"],
+  ["dueAt tiene que ser una fecha futura (epoch en segundos)", "dueAt must be a future date (epoch seconds)"],
+  ["no hay un turno pendiente con ese id (\xBFya corri\xF3?)", "no pending turn with that id (did it already run?)"],
   // — Infra interna (casi nunca llega al CLI, pero por si acaso)
   ["SESSION_SECRET ausente en producci\xF3n \u2014 las cookies quedar\xEDan firmadas con un valor p\xFAblico. Inyectarlo con ./scripts/set_gs_secret.sh SESSION_SECRET (openssl rand -hex 32).", "SESSION_SECRET missing in production \u2014 cookies would be signed with a public value. Inject it with ./scripts/set_gs_secret.sh SESSION_SECRET (openssl rand -hex 32)."],
   ["sqld: fetch sin namespace", "sqld: fetch without namespace"],
@@ -8303,7 +8315,7 @@ async function postLong(path, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.26.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.27.1"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8345,7 +8357,7 @@ async function request(path, opts = {}, retried = false) {
     method: opts.method ?? (opts.body !== void 0 || opts.raw !== void 0 ? "POST" : "GET"),
     headers: {
       authorization: `Bearer ${token}`,
-      "user-agent": `ghosty-cli/${"0.26.0"}`,
+      "user-agent": `ghosty-cli/${"0.27.1"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -8371,6 +8383,7 @@ async function toError(res) {
   const detail = serverText(raw);
   if (res.status === 401) return new CliError(t("Your session is not valid anymore.", "Tu sesi\xF3n ya no es v\xE1lida."), EXIT.AUTH, t("Run: ghosty login", "Corre: ghosty login"));
   if (res.status === 403) return new CliError(t(`Not allowed: ${detail}`, `No permitido: ${detail}`), EXIT.API, t("If the agent was shared with you, its workspace (board, channels, numbers) stays with the owner: ask them to add you to that workspace. Otherwise run: ghosty login", "Si el agente se comparti\xF3 contigo, su espacio (tablero, canales, n\xFAmeros) sigue siendo del due\xF1o: p\xEDdele que te agregue a ese espacio. Si no, corre: ghosty login"));
+  if (res.status === 404 && (body.message || body.error)) return new CliError(detail, EXIT.API);
   if (res.status === 404) return new CliError(t("Not found.", "No se encontr\xF3."), EXIT.API, t("Check the agent id (ghosty agents ls) or that your token belongs to that agent.", "Revisa el id del agente (ghosty agents ls) o que tu token sea de ese agente."));
   if (body.error === "restart_no_aplica" || body.error === "agente_sin_maquina") {
     return new CliError(t("This agent doesn't need a restart: new files, skills and MCP load on its next turn.", "Este agente no necesita reinicio: los archivos, skills y MCP nuevos se cargan en su siguiente turno."), EXIT.API);
@@ -9227,7 +9240,40 @@ var short = (s, n = 60) => s.length > n ? s.slice(0, n - 1) + "\u2026" : s;
 async function agentSchedule(agent) {
   return api(`/api/v2/me/agents/${enc4(agent)}/schedule`);
 }
+function parseTeamsTarget(raw) {
+  const m = /^([a-z0-9-]+)(?:#([^/\s]+)(?:\/(\d+))?)?$/i.exec(raw.trim());
+  if (!m) throw usage(t(`Bad --teams: ${raw}.`, `--teams inv\xE1lido: ${raw}.`), t("Use workspace#room or workspace#room/<thread message id>, e.g. descti#general/4812", "Usa espacio#room o espacio#room/<id del mensaje del hilo>, p. ej. descti#general/4812"));
+  return { workspace: m[1], ...m[2] ? { channel: m[2] } : {}, ...m[3] ? { parentId: Number(m[3]) } : {} };
+}
+async function teamsSchedule(sub, agent, arg, v) {
+  const target = parseTeamsTarget(v.teams);
+  const path = `/api/v2/agents/${enc4(agent)}/teams-schedule`;
+  const when = (epoch) => new Date(epoch * 1e3).toLocaleString("es-MX", { timeZone: "America/Mexico_City", dateStyle: "medium", timeStyle: "short" });
+  if (sub === "ls" || sub === "list") {
+    const r2 = await api(`${path}?workspace=${enc4(target.workspace)}`);
+    const rows = r2.scheduled.map((x) => ({ id: x.id, due: when(x.dueAt), where: `#${x.channel}${x.parentId ? `/${x.parentId}` : ""}`, by: x.by, text: short(x.text) }));
+    return out(r2, () => rows.length ? table(rows, ["id", "due", "where", "by", "text"]) : dim(t("No scheduled turns in Teams.", "No hay turnos programados en Teams.")));
+  }
+  if (sub === "rm" || sub === "cancel") {
+    if (!arg) throw usage(t("Missing schedule id.", "Falta el id del turno."), `ghosty schedule rm <agent-id> <id> --teams ${target.workspace}`);
+    const r2 = await api(path, { method: "DELETE", body: { workspace: target.workspace, id: arg } });
+    return out(r2, () => `${lavender("\u2713")} ${t("Canceled.", "Cancelado.")}`);
+  }
+  if (sub !== "add") throw usage(t(`Unknown schedule subcommand: ${sub ?? "(none)"}.`, `Subcomando de schedule desconocido: ${sub ?? "(ninguno)"}.`), "ghosty schedule add|ls|rm <agent-id> \u2026 --teams workspace#room[/thread]");
+  if (!arg) throw usage(t("Missing what to do.", "Falta qu\xE9 hacer."), `ghosty schedule add <agent-id> "\u2026" --teams ${v.teams} --at 2026-10-01T09:00`);
+  if (!target.channel) throw usage(t("Missing the room.", "Falta el room."), t("Use --teams workspace#room or workspace#room/<thread id>", "Usa --teams espacio#room o espacio#room/<id del hilo>"));
+  if (!v.at && !v.in) throw usage(t("Say when.", "Di cu\xE1ndo."), t("Use --in 30m or --at 2026-10-01T09:00-06:00", "Usa --in 30m o --at 2026-10-01T09:00-06:00"));
+  if (v.at && v.in) throw usage(t("Use --at or --in, not both.", "Usa --at o --in, no ambos."));
+  if (v.every) throw usage(t("--every is not supported with --teams yet.", "--every todav\xEDa no va con --teams."));
+  const dueAt = v.in ? new Date(Date.now() + minutesOf(v.in, "--in") * 6e4).toISOString() : isoOf(v.at, "--at");
+  const r = await api(path, { method: "POST", body: { workspace: target.workspace, channel: target.channel, ...target.parentId ? { parentId: target.parentId } : {}, text: arg, dueAt } });
+  out(r, () => `${lavender("\u2713")} ${t(`@${r.handle} will answer in #${r.channel}${r.parentId ? ` (thread ${r.parentId})` : ""} on ${when(r.dueAt)}.`, `@${r.handle} contestar\xE1 en #${r.channel}${r.parentId ? ` (hilo ${r.parentId})` : ""} el ${when(r.dueAt)}.`)} ${dim(`id ${r.id} \xB7 ${t("cancel", "cancelar")}: ghosty schedule rm ${agent} ${r.id} --teams ${target.workspace}`)}`);
+}
 async function scheduleCmd(sub, agent, arg, v) {
+  if (v.teams) {
+    if (!agent) throw usage(t("Missing agent id.", "Falta el id del agente."), 'ghosty schedule add <agent-id> "\u2026" --teams workspace#room/thread --at ISO');
+    return teamsSchedule(sub, agent, arg, v);
+  }
   if (sub === "ls" || sub === "list") {
     if (!agent) throw usage(t("Missing agent id.", "Falta el id del agente."), t("Example", "Ejemplo") + ": ghosty schedule ls <agent-id>");
     const r = await agentSchedule(agent);
@@ -9379,7 +9425,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.26.0"}`
+        "user-agent": `ghosty-cli/${"0.27.1"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10533,6 +10579,7 @@ var HELPS_ES = {
       ["--no-deliver", "docs grant/add: puede leerlo pero nunca mand\xE1rselo a quien escribe"],
       ["--url URL | --file PATH", "docs add: de d\xF3nde sale el documento (URL p\xFAblica, hasta 25 MB, o un archivo local)"],
       ["--grant read|write|no", "docs add: acceso de este agente (default read; no = s\xF3lo subirlo a la cuenta)"],
+      ["--note TEXT", "docs replace/restore: por qu\xE9 cambi\xF3 (sale en docs history)"],
       ["--role R", "share: editor (lo configura y lo usa) o admin (adem\xE1s lo comparte); repetirlo sobre un correo ya compartido cambia el rol"],
       ["--yes", "rm: se salta la confirmaci\xF3n (obligatorio sin terminal)"],
       ["--slug NAME", "demo: nombre de la liga; se le agrega un c\xF3digo de 6 caracteres (/p/NAME-CODE)"],
@@ -10648,7 +10695,8 @@ var HELPS_ES = {
   },
   schedule: {
     summary: "Turnos que corren despu\xE9s, con el reloj propio del agente.",
-    replace: [['"what to do"', '"qu\xE9 hacer"']]
+    replace: [['"what to do"', '"qu\xE9 hacer"'], ["# answers in that thread as if mentioned", "# contesta en ese hilo como si lo mencionaran"]],
+    notes: ["--teams: el agente tiene que estar activo en el Teams de ese espacio y t\xFA ser miembro. El id del hilo es el del mensaje con que empieza."]
   },
   me: { summary: "Tu cuenta: archivos y uso." },
   credentials: {
@@ -10831,6 +10879,8 @@ var HELPS = {
       "ghosty agents doctor <agent-id> [--verbose]",
       "ghosty agents docs ls|grant|revoke <agent-id> [doc\u2026] [--write] [--no-deliver] [--like AGENT]",
       "ghosty agents docs add <agent-id> --url URL | --file PATH [--name N] [--description TEXT] [--grant read|write|no] [--no-deliver]",
+      "ghosty agents docs replace <agent-id> <doc> --url URL | --file PATH [--note TEXT]   # new version: keeps name, access and the agents that use it",
+      "ghosty agents docs history|restore <agent-id> <doc> [n]",
       "ghosty agents share <agent-id> <email> [--role editor|admin]",
       "ghosty agents unshare <agent-id> <email> [--yes]",
       "ghosty agents shares <agent-id>",
@@ -10860,6 +10910,7 @@ var HELPS = {
       ["--no-deliver", "docs grant/add: it can read it but never send it to whoever writes"],
       ["--url URL | --file PATH", "docs add: where the document comes from (public URL, up to 25 MB, or a local file)"],
       ["--grant read|write|no", "docs add: access for this agent (default read; no = only upload to the account)"],
+      ["--note TEXT", "docs replace/restore: why it changed (shown in docs history)"],
       ["--role R", "share: editor (configures and uses it) or admin (also shares it); again on a shared email changes the role"],
       ["--yes", "rm: skip the confirmation (required without a terminal)"],
       ["--slug NAME", "demo: link name; a 6-char code is appended (/p/NAME-CODE)"],
@@ -10887,6 +10938,8 @@ var HELPS = {
       'ghosty agents docs grant <id> "Cat\xE1logo 2026.pdf"',
       "ghosty agents docs grant <id> precios.xlsx --write --no-deliver",
       'ghosty agents docs add <id> --url https://example.com/lista.pdf --description "Precios 2026"',
+      'ghosty agents docs replace <id> "Cat\xE1logo.pdf" --file catalogo-oct.pdf --note "precios de octubre"',
+      'ghosty agents docs history <id> "Cat\xE1logo.pdf"   \xB7   ghosty agents docs restore <id> "Cat\xE1logo.pdf" 3',
       "ghosty agents create --name Pia --engine claude --workspace ventas --channels teams=off",
       "ghosty agents set <id> --toolsets +crm",
       "ghosty agents share <id> ana@empresa.com --role admin",
@@ -11054,8 +11107,9 @@ var HELPS = {
   },
   schedule: {
     summary: "Turns that run later, on the agent's own clock.",
-    usage: ['ghosty schedule add <agent-id> "what to do" --in 30m | --at ISO [--every 12h --until ISO] [--conversation ID] [--title T]', "ghosty schedule ls <agent-id>", "ghosty schedule rm <agent-id> <schedule-id>"],
-    examples: ['ghosty schedule add <id> "revisa pedidos pendientes" --every 12h --in 1h'],
+    usage: ['ghosty schedule add <agent-id> "what to do" --in 30m | --at ISO [--every 12h --until ISO] [--conversation ID] [--title T]', "ghosty schedule ls <agent-id>", "ghosty schedule rm <agent-id> <schedule-id>", 'ghosty schedule add <agent-id> "what to do" --teams <workspace>#<room>[/<thread-id>] --in 30m | --at ISO', "ghosty schedule ls|rm <agent-id> [id] --teams <workspace>"],
+    examples: ['ghosty schedule add <id> "revisa pedidos pendientes" --every 12h --in 1h', 'ghosty schedule add minighosty "Pres\xE9ntate al equipo" --teams descti#general/4812 --at 2026-10-01T09:00   # answers in that thread as if mentioned'],
+    notes: ["--teams: the agent must be active in that workspace's Teams and you must be a member. The thread id is the id of the message that starts it."],
     learn: `${REF}#programar-turnos`
   },
   me: {
@@ -11878,6 +11932,8 @@ ${bold("Agents")}
   agents docs ls|grant|revoke <id> [doc]   Documents it reads and may send   [--write] [--no-deliver]
   agents docs grant <id> A B\u2026   Grant several documents at once   [--like AGENT] copies another agent's
   agents docs add <id>      Upload a document and grant it   --url URL | --file PATH  [--description] [--grant read|write|no]
+  agents docs replace <id> <doc>   New version (keeps name and access)   --url URL | --file PATH  [--note]
+  agents docs history|restore <id> <doc> [n]   Its versions; restore n as a new version
   agents share|unshare <id> <email>   Share it without handing it over   [--role editor|admin] \xB7 agents shares <id> lists them
   agents rm <id>            Delete an agent (owner only; asks you to type its name, or --yes)   [--from-workspace: turn it off in Teams first]
   agents restart <id>       Restart an ACP agent (needsRestart) so it loads new skills
@@ -11923,6 +11979,7 @@ ${bold("Schedule turns")}  ${dim("(each run lands in a conversation and notifies
   schedule ls <id>                   Pending turns and recent runs
   schedule add <id> "what to do"     Schedule a turn   --in 30m | --at ISO   [--every 12h --until ISO] [--conversation ID] [--title T]
   schedule rm <id> <schedule-id>     Cancel a pending turn
+  schedule add|ls|rm <id> \u2026 --teams WS#room[/thread]   The same in a Teams room or thread: it answers there as if mentioned
 
 ${bold("Partners")}  ${dim("(give an agent to each of YOUR customers \u2014 see: ghosty partner --help)")}
   partner ls | enable | credentials | agent | tenants | audit | try
@@ -11983,6 +12040,8 @@ ${bold("Agentes")}
   agents docs ls|grant|revoke <id> [doc]   Documentos que lee y puede enviar   [--write] [--no-deliver]
   agents docs grant <id> A B\u2026   Da varios documentos a la vez   [--like AGENTE] copia los de otro agente
   agents docs add <id>      Sube un documento y d\xE1selo   --url URL | --file RUTA  [--description] [--grant read|write|no]
+  agents docs replace <id> <doc>   Versi\xF3n nueva (conserva nombre y accesos)   --url URL | --file RUTA  [--note]
+  agents docs history|restore <id> <doc> [n]   Sus versiones; restaura la n como versi\xF3n nueva
   agents share|unshare <id> <correo>   Comp\xE1rtelo sin cederlo   [--role editor|admin] \xB7 agents shares <id> los lista
   agents rm <id>            Borra un agente (s\xF3lo el due\xF1o; te pide escribir su nombre, o --yes)   [--from-workspace: antes lo desactiva en Teams]
   agents restart <id>       Reinicia un agente ACP (needsRestart) para que cargue skills nuevas
@@ -12028,6 +12087,7 @@ ${bold("Turnos programados")}  ${dim("(cada corrida cae en una conversaci\xF3n y
   schedule ls <id>                   Turnos pendientes y corridas recientes
   schedule add <id> "qu\xE9 hacer"      Programa un turno   --in 30m | --at ISO   [--every 12h --until ISO] [--conversation ID] [--title T]
   schedule rm <id> <schedule-id>     Cancela un turno pendiente
+  schedule add|ls|rm <id> \u2026 --teams ESP#room[/hilo]   Lo mismo en un room o hilo de Teams: contesta ah\xED como si lo mencionaran
 
 ${bold("Partners")}  ${dim("(dale un agente a cada uno de TUS clientes \u2014 ver: ghosty partner --help)")}
   partner ls | enable | credentials | agent | tenants | audit | try
@@ -12220,7 +12280,8 @@ async function main() {
       "from-workspace": { type: "boolean" },
       "quota-hits": { type: "boolean" },
       by: { type: "string" },
-      models: { type: "boolean" }
+      models: { type: "boolean" },
+      teams: { type: "string" }
     }
   });
   globals.json = Boolean(v.json);
@@ -12228,7 +12289,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.26.0" }, () => "0.26.0");
+  if (v.version) return out({ version: "0.27.1" }, () => "0.27.1");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -12357,7 +12418,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.26.0").catch(() => null);
+var notice = updateNotice("0.27.1").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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