@easybits.cloud/cli 0.17.0 → 0.18.0

package/README.md

@@ -123,6 +123,24 @@ easybits secrets set --dotenv .env.production   # KEY=VALUE lines; - reads stdin
 printf '%s' "$TOKEN" | easybits secrets set GITHUB_TOKEN   # one value from stdin
 easybits secrets rm GITHUB_TOKEN --yes
 
+# Your crons: call a public https URL or message one of your agents (at most every 5 min)
+easybits crons create "Study reminder" --cron "30 8 * * *" --url https://www.ghosty.studio/api/v2/me/push \
+  --method POST --body '{"title":"Study time"}' --secret GHOSTY_PUSH_TOKEN
+easybits crons create "Weekly report" --cron "0 9 * * 1" --agent <agentId> --prompt "Send me the sales summary"
+easybits crons ls
+easybits crons update "Study reminder" --cron "0 7 * * 1-5"
+easybits crons run "Study reminder"       # id or exact name
+easybits crons runs "Study reminder"
+easybits crons pause "Study reminder"
+easybits crons rm "Study reminder" --yes
+
+# Platform crons (platform admins only; key with the ADMIN scope)
+easybits crons ls --platform
+easybits crons runs backup-machines
+easybits crons run purge-notifications
+easybits crons pause check-hosting
+easybits crons resume check-hosting
+
 # Databases
 easybits db ls
 easybits db create leads
@@ -275,6 +293,11 @@ Host *.ghosty
 
 Full reference: https://www.easybits.cloud/docs#cli · https://www.easybits.cloud/en/docs/cli.md
 
+## Changes in 0.17.1
+
+- `easybits crons ls|runs|run|pause|resume`: EasyBits' scheduled jobs, the same as the
+  /dash/admin/crons panel (platform admins only; key with the ADMIN scope).
+
 ## Changes in 0.17.0
 
 - `sites create --prompt … [--kind webapp|static] [--stack …] [--template …]` and

package/dist/index.js

@@ -305,7 +305,15 @@ var HEADERS_ES = {
   SCENES: "ESCENAS",
   DURATION: "DURACI\xD3N",
   NARRATION: "NARRACI\xD3N",
-  PROMPT: "PROMPT"
+  PROMPT: "PROMPT",
+  JOB: "TAREA",
+  SCHEDULE: "HORARIO",
+  "LAST RUN": "\xDALTIMA",
+  "NEXT RUN": "PR\xD3XIMA",
+  RESULT: "RESULTADO",
+  TOOK: "TARD\xD3",
+  TRIGGER: "ORIGEN",
+  SUMMARY: "RESUMEN"
 };
 function table(rows, cols, empty = t("Nothing here yet.", "Todav\xEDa no hay nada.")) {
   if (lang() === "es") cols = cols.map(([k, l]) => [k, HEADERS_ES[l] ?? l]);
@@ -4910,7 +4918,7 @@ async function updateNotice(current2) {
 }
 
 // src/commands/doctor.ts
-var VERSION = true ? "0.17.0" : "dev";
+var VERSION = true ? "0.18.0" : "dev";
 var doctor2 = {
   name: "doctor",
   group: "Account",
@@ -5416,6 +5424,272 @@ var secrets = {
   defaultSub: "ls"
 };
 
+// src/commands/crons.ts
+var HEX24 = /^[a-f0-9]{24}$/;
+var isUserCronId = (ref) => HEX24.test(ref);
+function describeCronAction(a) {
+  if (a.type === "http") return `${a.method} ${a.url}${a.secretName ? ` (+${a.secretName})` : ""}`;
+  return `agent ${a.fleetAgentId}: ${a.prompt.length > 40 ? a.prompt.slice(0, 39) + "\u2026" : a.prompt}`;
+}
+async function resolveUserCron(ctx, ref) {
+  const { items } = await api(ctx, "GET", "/crons");
+  const byId = items.find((c) => c.id === ref);
+  if (byId) return byId;
+  const byName = items.filter((c) => c.name.toLowerCase() === ref.trim().toLowerCase());
+  if (byName.length > 1) {
+    throw new CliError(t(`"${ref}" matches ${byName.length} crons. Use the id.`, `"${ref}" coincide con ${byName.length} crons. Usa el id.`), EXIT.USAGE);
+  }
+  return byName[0] ?? null;
+}
+async function userCronOrNull(ctx, ref) {
+  if (isUserCronId(ref)) return await resolveUserCron(ctx, ref) ?? { id: ref };
+  return resolveUserCron(ctx, ref);
+}
+var ACTION_OPTIONS = {
+  url: { type: "string", value: "https-url", description: "Call this public https URL on each run" },
+  method: { type: "string", value: "GET|POST|PUT|PATCH|DELETE", description: "HTTP method (default GET)" },
+  body: { type: "string", value: "json|text", description: "Request body (not with GET)" },
+  secret: { type: "string", value: "NAME", description: "Vault secret sent as a header (default Authorization: Bearer)" },
+  "secret-header": { type: "string", value: "header", description: "Header for --secret" },
+  agent: { type: "string", value: "id", description: "Send a turn to this fleet agent instead of calling a URL" },
+  prompt: { type: "string", value: "text", description: "What the agent is told on each run (with --agent)" }
+};
+function actionFromFlags(f) {
+  if (f.url && f.agent) return { error: "--url and --agent are exclusive" };
+  if (f.url) {
+    return {
+      action: {
+        type: "http",
+        url: f.url,
+        method: (f.method ?? "GET").toUpperCase(),
+        ...f.body ? { body: f.body } : {},
+        ...f.secret ? { secretName: f.secret, ...f.secretHeader ? { secretHeader: f.secretHeader } : {} } : {}
+      }
+    };
+  }
+  if (f.agent) {
+    if (!f.prompt) return { error: "--agent needs --prompt" };
+    return { action: { type: "agent_turn", fleetAgentId: f.agent, prompt: f.prompt } };
+  }
+  return {};
+}
+var flagsOf = (ctx) => ({
+  url: str(ctx, "url"),
+  method: str(ctx, "method"),
+  body: str(ctx, "body"),
+  secret: str(ctx, "secret"),
+  secretHeader: str(ctx, "secret-header"),
+  agent: str(ctx, "agent"),
+  prompt: str(ctx, "prompt")
+});
+var STATUS = {
+  "al-dia": ["up to date", "al d\xEDa"],
+  tarde: ["late", "tarde"],
+  fallo: ["failed", "fall\xF3"],
+  pausado: ["paused", "pausado"],
+  nuevo: ["no runs yet", "sin corridas"]
+};
+function cronStatus(c) {
+  if (c.running) return t("running", "corriendo");
+  const s = STATUS[c.status];
+  return s ? t(s[0], s[1]) : c.status;
+}
+function duration(ms) {
+  if (ms == null) return "\u2014";
+  return ms < 1e3 ? `${ms} ms` : `${(ms / 1e3).toFixed(1)} s`;
+}
+var crons = {
+  name: "crons",
+  aliases: ["cron"],
+  group: "Account",
+  summary: "Your scheduled jobs (call a URL or message an agent) and, for admins, the platform's",
+  synopsis: "crons <ls|create|update|rm|run|runs|pause|resume>",
+  subs: {
+    ls: {
+      aliases: ["list"],
+      summary: "List your crons (or, with --platform, the platform's scheduled jobs)",
+      usage: "easybits crons ls [--platform]",
+      options: { platform: { type: "boolean", description: "Platform jobs (backups, purges\u2026; platform admins only)" } },
+      examples: ["easybits crons ls", "easybits crons ls --json", "easybits crons ls --platform"],
+      async run(ctx) {
+        if (!bool(ctx, "platform")) {
+          const { items: items2 } = await api(ctx, "GET", "/crons");
+          emit(
+            ctx,
+            { items: items2 },
+            () => table(
+              items2.map((c) => ({
+                id: c.id,
+                name: c.name,
+                schedule: c.enabled ? c.schedule : `${c.schedule} (${t("paused", "en pausa")})`,
+                does: describeCronAction(c.action),
+                last: c.lastRunAt ? `${fmtDate(c.lastRunAt)} ${c.lastOk === false ? t("failed", "fall\xF3") : "ok"}` : "\u2014",
+                next: c.enabled ? fmtDate(c.nextRunAt) : "\u2014"
+              })),
+              [["id", "ID"], ["name", "NAME"], ["schedule", "SCHEDULE"], ["does", "DOES"], ["last", "LAST RUN"], ["next", "NEXT RUN"]],
+              t(
+                'No crons. Create one: easybits crons create "Ping" --cron "*/15 * * * *" --url https://example.com/ping',
+                'Sin crons. Crea uno: easybits crons create "Ping" --cron "*/15 * * * *" --url https://ejemplo.com/ping'
+              )
+            )
+          );
+          return;
+        }
+        const { items } = await api(ctx, "GET", "/admin/crons");
+        emit(
+          ctx,
+          { items },
+          () => table(
+            items.map((c) => ({
+              key: c.key,
+              status: cronStatus(c),
+              schedule: c.schedule,
+              last: c.lastRun ? `${fmtDate(c.lastRun.startedAt)} (${duration(c.lastRun.durationMs)})` : "\u2014",
+              next: c.paused ? "\u2014" : fmtDate(c.nextRunAt)
+            })),
+            [["key", "JOB"], ["status", "STATUS"], ["schedule", "SCHEDULE"], ["last", "LAST RUN"], ["next", "NEXT RUN"]]
+          )
+        );
+      }
+    },
+    runs: {
+      summary: "Show the last runs of one of your crons (id or name) or of a platform job, with the full error",
+      usage: "easybits crons runs <id|name|job>",
+      examples: ["easybits crons runs 66f0c2a1b2c3d4e5f6a7b8c9", "easybits crons runs backup-machines --json"],
+      async run(ctx) {
+        const key = need(ctx, 0, "id|name|job", this.usage);
+        const mine = await userCronOrNull(ctx, key);
+        const path = mine ? `/crons/${mine.id}/runs?limit=50` : `/admin/crons/${encodeURIComponent(key)}/runs`;
+        const { items } = await api(ctx, "GET", path);
+        emit(ctx, { items }, () => {
+          table(
+            items.map((r) => ({
+              at: fmtDate(r.startedAt),
+              ok: r.ok == null ? t("running", "corriendo") : r.ok ? "ok" : t("failed", "fall\xF3"),
+              status: r.status ?? "\u2014",
+              took: duration(r.durationMs),
+              trigger: r.trigger,
+              summary: (r.error ?? r.summary ?? "").slice(0, 80)
+            })),
+            [["at", "STARTED"], ["ok", "RESULT"], ["status", "HTTP"], ["took", "TOOK"], ["trigger", "TRIGGER"], ["summary", "SUMMARY"]],
+            t("No runs yet.", "Todav\xEDa no hay corridas.")
+          );
+          const failed = items.find((r) => r.ok === false && r.error);
+          if (failed) console.log(`
+${t("Last error", "\xDAltimo error")} (${fmtDate(failed.startedAt)}):
+${failed.error}`);
+        });
+      }
+    },
+    run: {
+      summary: "Run one of your crons or a platform job now, in the background (trigger manual)",
+      usage: "easybits crons run <id|name|job>",
+      examples: ["easybits crons run 66f0c2a1b2c3d4e5f6a7b8c9", "easybits crons run purge-notifications --json"],
+      async run(ctx) {
+        const key = need(ctx, 0, "id|name|job", this.usage);
+        const mine = await userCronOrNull(ctx, key);
+        const r = await api(ctx, "POST", mine ? `/crons/${mine.id}/run` : `/admin/crons/${encodeURIComponent(key)}/run`);
+        emit(
+          ctx,
+          r,
+          () => console.log(t(`Started ${key}. Follow it with: easybits crons runs ${key}`, `Arranc\xF3 ${key}. S\xEDguela con: easybits crons runs ${key}`))
+        );
+      }
+    },
+    pause: {
+      summary: "Pause one of your crons or a platform job until you resume it",
+      usage: "easybits crons pause <id|name|job>",
+      examples: ["easybits crons pause 66f0c2a1b2c3d4e5f6a7b8c9", "easybits crons pause check-hosting"],
+      async run(ctx) {
+        const key = need(ctx, 0, "id|name|job", this.usage);
+        const mine = await userCronOrNull(ctx, key);
+        const r = mine ? await api(ctx, "PATCH", `/crons/${mine.id}`, { enabled: false }) : await api(ctx, "POST", `/admin/crons/${encodeURIComponent(key)}/pause`, { paused: true });
+        emit(ctx, r, () => console.log(t(`Paused ${key}.`, `${key} en pausa.`)));
+      }
+    },
+    resume: {
+      summary: "Resume one of your crons or a platform job",
+      usage: "easybits crons resume <id|name|job>",
+      examples: ["easybits crons resume 66f0c2a1b2c3d4e5f6a7b8c9", "easybits crons resume check-hosting"],
+      async run(ctx) {
+        const key = need(ctx, 0, "id|name|job", this.usage);
+        const mine = await userCronOrNull(ctx, key);
+        const r = mine ? await api(ctx, "PATCH", `/crons/${mine.id}`, { enabled: true }) : await api(ctx, "POST", `/admin/crons/${encodeURIComponent(key)}/pause`, { paused: false });
+        emit(ctx, r, () => console.log(t(`Resumed ${key}.`, `${key} reanudada.`)));
+      }
+    },
+    create: {
+      aliases: ["add"],
+      summary: "Create a cron: call a public https URL or send a turn to one of your agents (at most every 5 min)",
+      usage: 'easybits crons create <name> --cron "<5 fields>" [--tz <IANA>] (--url <https-url> [--method] [--body] [--secret NAME] | --agent <id> --prompt <text>)',
+      options: {
+        cron: { type: "string", value: "expr", description: 'Cron of 5 fields, e.g. "30 8 * * *" = daily 8:30' },
+        tz: { type: "string", value: "zone", description: "IANA time zone (default America/Mexico_City)" },
+        ...ACTION_OPTIONS
+      },
+      examples: [
+        `easybits crons create "Study reminder" --cron "30 8 * * *" --url https://www.ghosty.studio/api/v2/me/push --method POST --body '{"title":"Study time"}' --secret GHOSTY_PUSH_TOKEN`,
+        'easybits crons create "Weekly report" --cron "0 9 * * 1" --agent 6a3c046d2cf7d7f4163f739d --prompt "Send me the weekly sales summary"'
+      ],
+      async run(ctx) {
+        const name = need(ctx, 0, "name", this.usage);
+        const cron = str(ctx, "cron");
+        if (!cron) throw usageError(t("Missing --cron.", "Falta --cron."), this.usage);
+        const a = actionFromFlags(flagsOf(ctx));
+        if ("error" in a) throw usageError(a.error, this.usage);
+        if (!a.action) throw usageError(t("Missing --url or --agent.", "Falta --url o --agent."), this.usage);
+        const c = await api(ctx, "POST", "/crons", { name, cron, ...str(ctx, "tz") ? { timezone: str(ctx, "tz") } : {}, action: a.action });
+        emit(ctx, c, () => console.log(t(`Created ${c.id} \xAB${c.name}\xBB \u2014 ${c.schedule}; next ${fmtDate(c.nextRunAt)}`, `Creado ${c.id} \xAB${c.name}\xBB \u2014 ${c.schedule}; pr\xF3xima ${fmtDate(c.nextRunAt)}`)));
+      }
+    },
+    update: {
+      aliases: ["edit", "set"],
+      summary: "Change one of your crons (only what you pass)",
+      usage: 'easybits crons update <id|name> [--name <n>] [--cron "<expr>"] [--tz <IANA>] [--url \u2026 | --agent \u2026 --prompt \u2026]',
+      options: {
+        name: { type: "string", value: "name", description: "New name" },
+        cron: { type: "string", value: "expr", description: "New schedule" },
+        tz: { type: "string", value: "zone", description: "New IANA time zone" },
+        ...ACTION_OPTIONS
+      },
+      examples: ['easybits crons update 66f0c2a1b2c3d4e5f6a7b8c9 --cron "0 7 * * 1-5"'],
+      async run(ctx) {
+        const ref = need(ctx, 0, "id|name", this.usage);
+        const mine = await resolveUserCron(ctx, ref);
+        if (!mine) throw new CliError(t(`You have no cron "${ref}".`, `No tienes un cron "${ref}".`), EXIT.API, "easybits crons ls", "not_found", 404);
+        const a = actionFromFlags(flagsOf(ctx));
+        if ("error" in a) throw usageError(a.error, this.usage);
+        const patch = {
+          ...str(ctx, "name") ? { name: str(ctx, "name") } : {},
+          ...str(ctx, "cron") ? { cron: str(ctx, "cron") } : {},
+          ...str(ctx, "tz") ? { timezone: str(ctx, "tz") } : {},
+          ...a.action ? { action: a.action } : {}
+        };
+        if (!Object.keys(patch).length) throw usageError(t("Nothing to change.", "No hay nada que cambiar."), this.usage);
+        const c = await api(ctx, "PATCH", `/crons/${mine.id}`, patch);
+        emit(ctx, c, () => console.log(t(`Updated \xAB${c.name}\xBB \u2014 ${c.schedule}`, `Actualizado \xAB${c.name}\xBB \u2014 ${c.schedule}`)));
+      }
+    },
+    rm: {
+      aliases: ["remove", "delete"],
+      summary: "Delete one of your crons",
+      usage: "easybits crons rm <id|name> [--yes]",
+      options: { ...YES_OPTION },
+      examples: ["easybits crons rm 66f0c2a1b2c3d4e5f6a7b8c9 --yes"],
+      async run(ctx) {
+        const ref = need(ctx, 0, "id|name", this.usage);
+        const mine = await resolveUserCron(ctx, ref);
+        if (!mine) throw new CliError(t(`You have no cron "${ref}".`, `No tienes un cron "${ref}".`), EXIT.API, "easybits crons ls", "not_found", 404);
+        requireYesIfHeadless(ctx);
+        await confirm(ctx, t(`Delete cron \xAB${mine.name}\xBB? It stops running right away.`, `\xBFBorrar el cron \xAB${mine.name}\xBB? Deja de correr de inmediato.`));
+        const r = await api(ctx, "DELETE", `/crons/${mine.id}`);
+        emit(ctx, r, () => console.log(t(`Deleted \xAB${mine.name}\xBB`, `Borrado \xAB${mine.name}\xBB`)));
+      }
+    }
+  },
+  defaultSub: "ls"
+};
+
 // src/commands/documents.ts
 import { existsSync as existsSync16, mkdirSync as mkdirSync7, readFileSync as readFileSync18, statSync as statSync11, writeFileSync as writeFileSync10 } from "fs";
 import { join as join11 } from "path";
@@ -6203,6 +6477,7 @@ var COMMANDS = [
   doctor2,
   usage,
   secrets,
+  crons,
   sandboxes,
   agents,
   fleet,
@@ -6543,6 +6818,29 @@ var HELP_ES = {
   "Path kept out of the release (repeatable)": "Ruta que no entra al release (repetible)",
   "Release a machine: stops billing, takes a last backup and destroys it": "Libera una m\xE1quina: deja de cobrarse, toma un \xFAltimo respaldo y la destruye",
   "The hosting catalog: sizes and monthly prices in MXN": "El cat\xE1logo de hosting: tama\xF1os y precio mensual en MXN",
+  // crons (tuyos y de la plataforma)
+  "Your scheduled jobs (call a URL or message an agent) and, for admins, the platform's": "Tus tareas programadas (pegarle a una URL o escribirle a un agente) y, para admins, las de la plataforma",
+  "List your crons (or, with --platform, the platform's scheduled jobs)": "Enlista tus crons (o, con --platform, las tareas de la plataforma)",
+  "Platform jobs (backups, purges\u2026; platform admins only)": "Tareas de la plataforma (respaldos, purgas\u2026; s\xF3lo admins)",
+  "Show the last runs of one of your crons (id or name) or of a platform job, with the full error": "Muestra las \xFAltimas corridas de un cron tuyo (id o nombre) o de una tarea de la plataforma, con el error completo",
+  "Run one of your crons or a platform job now, in the background (trigger manual)": "Corre ya un cron tuyo o una tarea de la plataforma, en segundo plano (manual)",
+  "Pause one of your crons or a platform job until you resume it": "Pausa un cron tuyo o una tarea de la plataforma hasta que lo reanudes",
+  "Resume one of your crons or a platform job": "Reanuda un cron tuyo o una tarea de la plataforma",
+  "Create a cron: call a public https URL or send a turn to one of your agents (at most every 5 min)": "Crea un cron: pegarle a una URL https p\xFAblica o mandarle un turno a uno de tus agentes (como mucho cada 5 min)",
+  'Cron of 5 fields, e.g. "30 8 * * *" = daily 8:30': 'Cron de 5 campos, p. ej. "30 8 * * *" = diario 8:30',
+  "IANA time zone (default America/Mexico_City)": "Zona horaria IANA (default America/Mexico_City)",
+  "Call this public https URL on each run": "Pegarle a esta URL https p\xFAblica en cada corrida",
+  "HTTP method (default GET)": "M\xE9todo HTTP (default GET)",
+  "Request body (not with GET)": "Cuerpo de la petici\xF3n (no con GET)",
+  "Vault secret sent as a header (default Authorization: Bearer)": "Secreto de la b\xF3veda que viaja como header (default Authorization: Bearer)",
+  "Header for --secret": "Header para --secret",
+  "Send a turn to this fleet agent instead of calling a URL": "Mandarle un turno a este agente de la flota en vez de pegarle a una URL",
+  "What the agent is told on each run (with --agent)": "Lo que se le dice al agente en cada corrida (con --agent)",
+  "Change one of your crons (only what you pass)": "Cambia un cron tuyo (s\xF3lo lo que pases)",
+  "New name": "Nombre nuevo",
+  "New schedule": "Horario nuevo",
+  "New IANA time zone": "Zona horaria IANA nueva",
+  "Delete one of your crons": "Borra un cron tuyo",
   // secrets (vault de la cuenta)
   "Your account's secrets vault: names only; used as $secret:NAME": "La b\xF3veda de secretos de tu cuenta: s\xF3lo nombres; se usan como $secret:NOMBRE",
   "List the names in your vault (values never come back)": "Enlista los nombres de tu b\xF3veda (los valores nunca regresan)",
@@ -6857,7 +7155,7 @@ function normalizeArgs(input) {
 }
 
 // src/index.ts
-var VERSION2 = true ? "0.17.0" : "dev";
+var VERSION2 = true ? "0.18.0" : "dev";
 var GLOBAL_OPTIONS = {
   json: { type: "boolean" },
   token: { type: "string" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easybits.cloud/cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Official CLI for EasyBits, the cloud for AI agents — sandboxes, hosting, domains, databases, agents and files from your terminal",
   "type": "module",
   "bin": {