@ghostystudio/cli 0.26.0 → 0.27.0

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,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.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.0"}`, "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.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9227,7 +9239,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 +9424,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.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10533,6 +10578,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 +10694,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 +10878,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 +10909,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 +10937,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 +11106,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 +11931,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 +11978,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 +12039,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 +12086,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 +12279,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 +12288,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.0" }, () => "0.27.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -12357,7 +12417,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.26.0").catch(() => null);
+var notice = updateNotice("0.27.0").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.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": {