@easybits.cloud/cli 0.17.1 → 0.18.0

package/README.md

@@ -123,8 +123,19 @@ 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
 
-# Platform crons (platform admins only; key with the ADMIN scope)
+# 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

package/dist/index.js

@@ -4918,7 +4918,7 @@ async function updateNotice(current2) {
 }
 
 // src/commands/doctor.ts
-var VERSION = true ? "0.17.1" : "dev";
+var VERSION = true ? "0.18.0" : "dev";
 var doctor2 = {
   name: "doctor",
   group: "Account",
@@ -5425,6 +5425,63 @@ var secrets = {
 };
 
 // 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"],
@@ -5445,15 +5502,39 @@ var crons = {
   name: "crons",
   aliases: ["cron"],
   group: "Account",
-  summary: "Platform scheduled jobs (admins only): status, history, run now, pause",
-  synopsis: "crons <ls|runs|run|pause|resume>",
+  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 the scheduled jobs with status, schedule, last and next run",
-      usage: "easybits crons ls",
-      examples: ["easybits crons ls", "easybits crons ls --json"],
+      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,
@@ -5472,12 +5553,14 @@ var crons = {
       }
     },
     runs: {
-      summary: "Show a job's last 50 runs, with the full error when one failed",
-      usage: "easybits crons runs <job>",
-      examples: ["easybits crons runs backup-machines", "easybits crons runs check-hosting --json"],
+      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, "job", this.usage);
-        const { items } = await api(ctx, "GET", `/admin/crons/${encodeURIComponent(key)}/runs`);
+        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) => ({
@@ -5499,12 +5582,13 @@ ${failed.error}`);
       }
     },
     run: {
-      summary: "Run a job now in the background (recorded with trigger manual)",
-      usage: "easybits crons run <job>",
-      examples: ["easybits crons run purge-notifications", "easybits crons run backup-machines --json"],
+      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, "job", this.usage);
-        const r = await api(ctx, "POST", `/admin/crons/${encodeURIComponent(key)}/run`);
+        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,
@@ -5513,24 +5597,94 @@ ${failed.error}`);
       }
     },
     pause: {
-      summary: "Pause a job: scheduled runs answer skipped until you resume it",
-      usage: "easybits crons pause <job>",
-      examples: ["easybits crons pause check-hosting"],
+      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, "job", this.usage);
-        const r = await api(ctx, "POST", `/admin/crons/${encodeURIComponent(key)}/pause`, { paused: true });
+        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 a paused job",
-      usage: "easybits crons resume <job>",
-      examples: ["easybits crons resume check-hosting"],
+      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, "job", this.usage);
-        const r = await api(ctx, "POST", `/admin/crons/${encodeURIComponent(key)}/pause`, { paused: false });
+        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"
@@ -6664,13 +6818,30 @@ 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)
-  "Platform scheduled jobs (admins only): status, history, run now, pause": "Tareas programadas de la plataforma (s\xF3lo admins): estado, historial, ejecutar ahora, pausar",
-  "List the scheduled jobs with status, schedule, last and next run": "Enlista las tareas programadas con estado, horario, \xFAltima y pr\xF3xima corrida",
-  "Show a job's last 50 runs, with the full error when one failed": "Muestra las \xFAltimas 50 corridas de una tarea, con el error completo si alguna fall\xF3",
-  "Run a job now in the background (recorded with trigger manual)": "Corre una tarea ya, en segundo plano (queda registrada como manual)",
-  "Pause a job: scheduled runs answer skipped until you resume it": "Pausa una tarea: sus corridas programadas responden skipped hasta que la reanudes",
-  "Resume a paused job": "Reanuda una tarea en pausa",
   "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)",
   "Save or replace secrets from a dotenv file, or one value from stdin": "Guarda o reemplaza secretos desde un archivo dotenv, o un valor por stdin",
@@ -6984,7 +7155,7 @@ function normalizeArgs(input) {
 }
 
 // src/index.ts
-var VERSION2 = true ? "0.17.1" : "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.1",
+  "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": {