@ghostystudio/cli 0.1.0 → 0.2.1

package/README.md

@@ -27,6 +27,10 @@ ghosty try <id> "message"                [--session] [--reset] [--whatsapp]
 ghosty chat <id> ["message"]             [--conversation ID]
 ghosty conversations ls <id>
 
+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 me files ls|upload|rm             [--kind image|video|audio|document|other]
 ghosty docs
 ```

package/dist/index.js

@@ -275,7 +275,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.1.0"}`,
+      "user-agent": `ghosty-cli/${"0.2.1"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -296,7 +296,7 @@ async function toError(res) {
     body = JSON.parse(text);
   } catch {
   }
-  const detail = body.message || body.error_description || body.error || text.slice(0, 300) || res.statusText;
+  const detail = body.message || body.error_description || (body.detalle && body.error ? `${body.error}: ${body.detalle}` : body.error) || text.slice(0, 300) || res.statusText;
   if (res.status === 401) return new CliError("Your session is not valid anymore.", EXIT.AUTH, "Run: ghosty login");
   if (res.status === 403) return new CliError(`Not allowed: ${detail}`, EXIT.API, "Run: ghosty login   (to refresh your permissions)");
   if (res.status === 404) return new CliError("Not found.", EXIT.API, "Check the agent id (ghosty agents ls) or that your token belongs to that agent.");
@@ -604,6 +604,90 @@ ${dim(`${(r.storage.usedBytes / 1e9).toFixed(2)} GB of ${r.storage.limitGb} GB u
   }
 }
 
+// src/commands/schedule.ts
+var enc3 = encodeURIComponent;
+function minutesOf(s, flag) {
+  const m = /^(\d+(?:\.\d+)?)\s*(m|min|h|d)?$/i.exec(s.trim());
+  if (!m) throw usage(`Invalid ${flag}: ${s}.`, "Use minutes, hours or days: 30m, 12h, 1d");
+  const n = Number(m[1]);
+  const unit = (m[2] ?? "m").toLowerCase();
+  return Math.round(unit === "d" ? n * 1440 : unit === "h" ? n * 60 : n);
+}
+function isoOf(s, flag) {
+  const d = new Date(s);
+  if (Number.isNaN(d.getTime())) throw usage(`Invalid ${flag}: ${s}.`, "Use an ISO date, e.g. 2026-10-01T09:00-06:00");
+  return d.toISOString();
+}
+var every = (min) => min == null ? "once" : min % 1440 === 0 ? `${min / 1440}d` : min % 60 === 0 ? `${min / 60}h` : `${min}m`;
+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/${enc3(agent)}/schedule`);
+}
+async function scheduleCmd(sub, agent, arg, v) {
+  if (sub === "ls" || sub === "list") {
+    if (!agent) throw usage("Missing agent id.", "Example: ghosty schedule ls <agent-id>");
+    const r = await agentSchedule(agent);
+    if (globals.json) return out({ pending: r.pendientes, runs: r.corridas });
+    const pending = r.pendientes.map((p) => ({
+      id: p.id,
+      due: p.dueAt,
+      every: every(p.repeatMin),
+      until: p.until ?? "",
+      conversation: p.sessionId,
+      prompt: short(p.prompt)
+    }));
+    const runs = r.corridas.slice(0, 10).map((p) => ({ fired: p.firedAt ?? "", conversation: p.sessionId, answer: short(p.answer ?? "", 70) }));
+    return out(
+      null,
+      () => [
+        pending.length ? table(pending, ["id", "due", "every", "until", "conversation", "prompt"]) : dim("No scheduled turns."),
+        ...runs.length ? ["", lavender("Recent runs"), table(runs, ["fired", "conversation", "answer"])] : []
+      ].join("\n")
+    );
+  }
+  if (sub === "add") {
+    if (!agent || !arg) throw usage("Missing agent id or prompt.", 'Example: ghosty schedule add <agent-id> "Check the campaign" --in 30m');
+    if (!v.at && !v.in) throw usage("Say when.", "Use --in 30m or --at 2026-10-01T09:00-06:00");
+    if (v.at && v.in) throw usage("Use --at or --in, not both.");
+    const body = {
+      prompt: arg,
+      ...v.in ? { inMinutes: minutesOf(v.in, "--in") } : { dueAt: isoOf(v.at, "--at") },
+      repeatMin: v.every ? minutesOf(v.every, "--every") : null,
+      until: v.until ? isoOf(v.until, "--until") : null
+    };
+    if (body.repeatMin && !body.until) throw usage("A repeating turn needs --until.", "Example: --every 12h --until 2026-10-25");
+    let sid = v.conversation;
+    const created = !sid;
+    if (!sid) {
+      sid = (await api(convPath(agent), { method: "POST", body: {} })).id;
+      if (!globals.json) info(dim(`new conversation ${sid}`));
+    }
+    let r;
+    try {
+      r = await api(convPath(agent, `/${enc3(sid)}/schedule`), { body });
+    } catch (e) {
+      if (created) await api(convPath(agent, `/${enc3(sid)}`), { method: "DELETE" }).catch(() => {
+      });
+      throw e;
+    }
+    if (v.title && created) await api(convPath(agent, `/${enc3(sid)}`), { method: "PATCH", body: { title: v.title } });
+    const p = r.programado;
+    return out(
+      { scheduled: p },
+      () => `${lavender("\u2713")} Scheduled ${p.id} \xB7 ${p.dueAt}${p.repeatMin ? ` \xB7 every ${every(p.repeatMin)} until ${p.until}` : ""}
+${dim(`conversation ${p.sessionId}`)}`
+    );
+  }
+  if (sub === "rm" || sub === "cancel") {
+    if (!agent || !arg) throw usage("Missing agent id or schedule id.", "Example: ghosty schedule rm <agent-id> <schedule-id>   (ids: ghosty schedule ls <agent-id>)");
+    const row = (await agentSchedule(agent)).pendientes.find((p) => p.id === arg);
+    if (!row) throw usage(`No pending scheduled turn ${arg}.`, "See them with: ghosty schedule ls <agent-id>");
+    await api(convPath(agent, `/${enc3(row.sessionId)}/schedule/${enc3(arg)}`), { method: "DELETE" });
+    return out({ canceled: arg }, () => `${lavender("\u2713")} Canceled ${arg}`);
+  }
+  throw usage(`Unknown schedule subcommand: ${sub ?? "(none)"}.`, "Try: ghosty schedule ls | add | rm");
+}
+
 // src/index.ts
 var HELP = `${bold("Usage:")} ghosty <command> [options]
 
@@ -629,6 +713,11 @@ ${bold("Talk to an agent")}
   chat <id> ["message"]     Stream a conversation (no message = interactive)   [--conversation ID]
   conversations ls <id>     List conversations
 
+${bold("Schedule turns")}  ${dim("(each run lands in a conversation and notifies your phone; an answer of exactly OK stays silent)")}
+  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
+
 ${bold("Your account")}
   me files ls|upload|rm     Files in your account        [--kind image|video|audio|document|other]
   docs [topic]              Open the docs
@@ -666,12 +755,17 @@ async function main() {
       reset: { type: "boolean" },
       whatsapp: { type: "boolean" },
       conversation: { type: "string" },
-      kind: { type: "string" }
+      kind: { type: "string" },
+      at: { type: "string" },
+      in: { type: "string" },
+      every: { type: "string" },
+      until: { type: "string" },
+      title: { type: "string" }
     }
   });
   globals.json = Boolean(v.json);
   globals.token = v.token;
-  if (v.version) return out({ version: "0.1.0" }, () => "0.1.0");
+  if (v.version) return out({ version: "0.2.1" }, () => "0.2.1");
   const [cmd, sub, a1, a2] = pos;
   if (!cmd || v.help || cmd === "help") return showHelp();
   switch (cmd) {
@@ -712,6 +806,8 @@ async function main() {
     case "conversations":
       if (sub === "ls" || sub === "list") return conversationsLs(a1);
       throw usage(`Unknown conversations subcommand: ${sub ?? "(none)"}.`, "Try: ghosty conversations ls <agent-id>");
+    case "schedule":
+      return scheduleCmd(sub, a1, a2, v);
     case "me":
       if (sub === "files") return meFiles(a1, a2, v);
       throw usage(`Unknown me subcommand: ${sub ?? "(none)"}.`, "Try: ghosty me files ls");

package/package.json

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