@easybits.cloud/cli 0.19.0 → 0.19.1

package/README.md

@@ -131,7 +131,8 @@ easybits crons create "Heads-up" --at 23:00 --url https://my-app.com/api/notice
 easybits crons create "Heads-up" --in 2h --url https://my-app.com/api/notice --method POST              # once; --until/--times end repeating ones
 easybits crons create "Review" --at 23:00 --run "python3 asc.py submit" --file scripts/asc.py \
   --secret-file ASC_P8:~/.appstoreconnect/private_keys/AuthKey_X.p8     # a command in a throwaway box; the .p8 only this cron reads
-easybits crons runs "Review" --logs                                      # exit code + stdout/stderr
+easybits crons get "Review"                                              # what it does, how it notifies you, next run (--json: all of it)
+easybits crons runs "Review" --logs --limit 5                            # exit code + stdout/stderr
 easybits crons wait "Review" --timeout 2h                                # blocks until it runs; exits with its exit code
 easybits crons update "Review" --notify push,email --notify-on always    # push to the Ghosty app / email to you
 easybits crons ls
@@ -145,7 +146,9 @@ easybits crons rm "Study reminder" --yes
 easybits inbox create builds              # prints the URL (anyone with it can write)
 easybits inbox ls
 easybits inbox listen builds              # one JSON line per event, live (Claude Code: run it with Monitor)
-easybits inbox read builds                # the unread ones, marked read
+easybits inbox read builds                # the unread ones, marked read (--since <seq>: from a cursor)
+easybits inbox update builds --retention 30   # rename (--name) or keep events longer; the URL stays
+easybits inbox rotate builds --yes        # new URL; the old one stops working (if it leaked)
 easybits inbox rm builds --yes
 
 # Platform crons (platform admins only; key with the ADMIN scope)

package/dist/index.js

@@ -4918,7 +4918,7 @@ async function updateNotice(current2) {
 }
 
 // src/commands/doctor.ts
-var VERSION = true ? "0.19.0" : "dev";
+var VERSION = true ? "0.19.1" : "dev";
 var doctor2 = {
   name: "doctor",
   group: "Account",
@@ -5438,6 +5438,19 @@ function describeCronAction(a) {
   }
   return `agent ${a.fleetAgentId}: ${a.prompt.length > 40 ? a.prompt.slice(0, 39) + "\u2026" : a.prompt}`;
 }
+function describeCron(c) {
+  const n = c.notify;
+  const chans = n ? [n.push ? "push" : "", n.email ? "email" : "", n.inbox ? `inbox:${n.inbox}` : ""].filter(Boolean).join(", ") : "";
+  const state = c.enabled ? t("active", "activo") : c.done ? t("done", "terminado") : t("paused", "en pausa");
+  return [
+    `${c.id} \xAB${c.name}\xBB (${state})`,
+    `${t("Schedule", "Horario")}: ${c.schedule} (${c.timezone})${c.until ? ` ${t("until", "hasta")} ${c.until}` : ""}${c.timesLeft != null ? ` \xB7 ${t("runs left", "corridas restantes")}: ${c.timesLeft}` : ""}`,
+    `${t("Next run", "Pr\xF3xima")}: ${c.enabled && c.nextRunLocal ? `${c.nextRunLocal} (${c.in})` : "\u2014"}`,
+    `${t("Does", "Hace")}: ${describeCronAction(c.action)}`,
+    `${t("Notifies", "Avisa")}: ${chans ? `${chans} (${n.on === "always" ? t("always", "siempre") : t("on failure", "si falla")})` : "\u2014"}`,
+    `${t("Last run", "\xDAltima")}: ${c.lastRunAt ? `${fmtDate(c.lastRunAt)} ${c.lastOk === false ? t("failed", "fall\xF3") : "ok"}${c.lastError ? ` \u2014 ${c.lastError}` : ""}` : "\u2014"}`
+  ];
+}
 async function resolveUserCron(ctx, ref2) {
   const { items } = await api(ctx, "GET", "/crons");
   const byId = items.find((c) => c.id === ref2);
@@ -5636,7 +5649,7 @@ var crons = {
   aliases: ["cron"],
   group: "Account",
   summary: "Your scheduled jobs (call a URL, message an agent or run a command; repeating or once) and, for admins, the platform's",
-  synopsis: "crons <ls|create|update|rm|run|runs|wait|pause|resume>",
+  synopsis: "crons <ls|get|create|update|rm|run|runs|wait|pause|resume>",
   subs: {
     ls: {
       aliases: ["list"],
@@ -5685,16 +5698,35 @@ var crons = {
         );
       }
     },
+    get: {
+      aliases: ["show"],
+      summary: "Show one of your crons: what it does, how it notifies you and when it runs (--json: the whole object)",
+      usage: "easybits crons get <id|name> [--json]",
+      examples: ['easybits crons get "Review 1.0.10"', "easybits crons get 66f0c2a1b2c3d4e5f6a7b8c9 --json"],
+      async run(ctx) {
+        const ref2 = need(ctx, 0, "id|name", this.usage);
+        const c = await resolveUserCron(ctx, ref2);
+        if (!c) throw new CliError(t(`You have no cron "${ref2}".`, `No tienes un cron "${ref2}".`), EXIT.API, "easybits crons ls", "not_found", 404);
+        emit(ctx, c, () => {
+          for (const line2 of describeCron(c)) console.log(line2);
+        });
+      }
+    },
     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> [--logs]",
-      options: { logs: { type: "boolean", description: "Also print stdout/stderr of --run crons (last 64 KB per run)" } },
+      usage: "easybits crons runs <id|name|job> [--limit N] [--logs]",
+      options: {
+        limit: { type: "string", value: "N", description: "At most N runs of one of your crons (1-50, default 50)" },
+        logs: { type: "boolean", description: "Also print stdout/stderr of --run crons (last 64 KB per run)" }
+      },
       examples: ["easybits crons runs 66f0c2a1b2c3d4e5f6a7b8c9", 'easybits crons runs "Review 1.0.10" --logs', "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 withLogs = bool(ctx, "logs");
-        const path = mine ? `/crons/${mine.id}/runs?limit=50${withLogs ? "&logs=1" : ""}` : `/admin/crons/${encodeURIComponent(key)}/runs`;
+        const limit = str(ctx, "limit") ?? "50";
+        if (!/^\d+$/.test(limit) || Number(limit) < 1 || Number(limit) > 50) throw usageError(t("--limit is 1 to 50.", "--limit va de 1 a 50."), this.usage);
+        const path = mine ? `/crons/${mine.id}/runs?limit=${limit}${withLogs ? "&logs=1" : ""}` : `/admin/crons/${encodeURIComponent(key)}/runs`;
         const { items } = await api(ctx, "GET", path);
         emit(ctx, { items }, () => {
           table(
@@ -5846,7 +5878,7 @@ ${failed.error}`);
     update: {
       aliases: ["edit", "set"],
       summary: "Change one of your crons (only what you pass)",
-      usage: 'easybits crons update <id|name> [--name <n>] [--cron "<expr>" | --at <when> | --in <duration>] [--until <when>] [--times N] [--tz <IANA>] [--url \u2026 | --agent \u2026 --prompt \u2026]',
+      usage: 'easybits crons update <id|name> [--name <n>] [--cron "<expr>" | --at <when> | --in <duration>] [--until <when>] [--times N] [--tz <IANA>] [--url \u2026 | --agent \u2026 --prompt \u2026 | --run <cmd> [--file f]\u2026 [--secret NAME]\u2026] [--notify push,email,inbox:<name>|none] [--notify-on failure|always]',
       options: {
         name: { type: "string", value: "name", description: "New name" },
         cron: { type: "string", value: "expr", description: "New schedule" },
@@ -5987,7 +6019,7 @@ var inbox = {
   aliases: ["inboxes"],
   group: "Account",
   summary: "Event inboxes: your own webhook URL whose events reach your terminal live or wait for you to read them",
-  synopsis: "inbox <ls|create|listen|read|rm>",
+  synopsis: "inbox <ls|create|listen|read|update|rotate|rm>",
   subs: {
     ls: {
       aliases: ["list"],
@@ -6040,17 +6072,22 @@ var inbox = {
     },
     read: {
       summary: "Show the events you haven't read yet and mark them read (the next read brings only new ones)",
-      usage: "easybits inbox read <id|name> [--all] [--no-ack] [--limit N]",
+      usage: "easybits inbox read <id|name> [--all | --since <seq>] [--no-ack] [--limit N]",
       options: {
         all: { type: "boolean", description: "Everything still kept, read or not" },
+        since: { type: "string", value: "seq", description: "Events after this one, read or not (the cursor of a previous read)" },
         "no-ack": { type: "boolean", description: "Just look; don't mark them read" },
         limit: { type: "string", value: "N", description: "At most N events (default 50, max 200)" }
       },
-      examples: ["easybits inbox read builds", "easybits inbox read builds --all --no-ack --json"],
+      examples: ["easybits inbox read builds", "easybits inbox read builds --all --no-ack --json", "easybits inbox read builds --since 12 --no-ack"],
       async run(ctx) {
         const name = need(ctx, 0, "id|name", this.usage);
+        const since = str(ctx, "since");
+        if (since != null && !/^\d+$/.test(since)) throw usageError(t("--since is an event number.", "--since es un n\xFAmero de evento."), this.usage);
+        if (since != null && bool(ctx, "all")) throw usageError(t("--all and --since are exclusive.", "--all y --since no van juntos."), this.usage);
         const q = new URLSearchParams();
         if (bool(ctx, "all")) q.set("since", "0");
+        if (since != null) q.set("since", since);
         if (bool(ctx, "no-ack")) q.set("ack", "0");
         if (str(ctx, "limit")) q.set("limit", str(ctx, "limit"));
         const r = await api(ctx, "GET", `/inboxes/${ref(name)}/events${q.size ? `?${q}` : ""}`);
@@ -6063,6 +6100,41 @@ Quedan ${r.unread} sin leer: easybits inbox read ${name}`));
         });
       }
     },
+    update: {
+      aliases: ["edit", "set"],
+      summary: "Rename an inbox or change how long it keeps events (its URL stays the same)",
+      usage: "easybits inbox update <id|name> [--name <new>] [--retention <days>]",
+      options: {
+        name: { type: "string", value: "new", description: "New name, unique in your account" },
+        retention: { type: "string", value: "days", description: "Days events are kept (1-30)" }
+      },
+      examples: ["easybits inbox update builds --retention 30", "easybits inbox update builds --name ci --json"],
+      async run(ctx) {
+        const name = need(ctx, 0, "id|name", this.usage);
+        const days = str(ctx, "retention");
+        if (days != null && !/^\d+$/.test(days)) throw usageError(t("--retention is whole days.", "--retention son d\xEDas enteros."), this.usage);
+        const patch = { ...str(ctx, "name") ? { name: str(ctx, "name") } : {}, ...days ? { retentionDays: Number(days) } : {} };
+        if (!Object.keys(patch).length) throw usageError(t("Nothing to change: pass --name or --retention.", "No hay nada que cambiar: pasa --name o --retention."), this.usage);
+        const b = await api(ctx, "PATCH", `/inboxes/${ref(name)}`, patch);
+        emit(ctx, b, () => console.log(t(`Updated \xAB${b.name}\xBB: keeps events ${b.retentionDays} days.`, `Actualizado \xAB${b.name}\xBB: guarda los eventos ${b.retentionDays} d\xEDas.`)));
+      }
+    },
+    rotate: {
+      summary: "Give an inbox a new URL and print it; the old one stops accepting writes right away (stored events stay)",
+      usage: "easybits inbox rotate <id|name> [--yes]",
+      options: { ...YES_OPTION },
+      examples: ["easybits inbox rotate builds --yes", "easybits inbox rotate builds --yes --json"],
+      async run(ctx) {
+        const name = need(ctx, 0, "id|name", this.usage);
+        requireYesIfHeadless(ctx);
+        await confirm(ctx, t(`New URL for \xAB${name}\xBB? Whoever uses the old one stops getting through.`, `\xBFURL nueva para \xAB${name}\xBB? Quien use la vieja deja de poder escribir.`));
+        const b = await api(ctx, "POST", `/inboxes/${ref(name)}/rotate`);
+        emit(ctx, b, () => {
+          console.log(t(`New URL for \xAB${b.name}\xBB (the old one no longer works):`, `URL nueva de \xAB${b.name}\xBB (la vieja ya no sirve):`));
+          console.log(`  ${b.url}`);
+        });
+      }
+    },
     rm: {
       aliases: ["remove", "delete"],
       summary: "Delete an inbox and its events; its URL stops accepting writes",
@@ -7241,6 +7313,13 @@ var HELP_ES = {
   "Just look; don't mark them read": "S\xF3lo mirar; no marcarlos como le\xEDdos",
   "At most N events (default 50, max 200)": "Como m\xE1ximo N eventos (default 50, tope 200)",
   "Delete an inbox and its events; its URL stops accepting writes": "Borra un buz\xF3n y sus eventos; su URL deja de aceptar escrituras",
+  "Events after this one, read or not (the cursor of a previous read)": "Los eventos despu\xE9s de \xE9ste, le\xEDdos o no (el cursor de una lectura anterior)",
+  "Rename an inbox or change how long it keeps events (its URL stays the same)": "Renombra un buz\xF3n o cambia cu\xE1nto guarda los eventos (su URL no cambia)",
+  "New name, unique in your account": "Nombre nuevo, \xFAnico en tu cuenta",
+  "Days events are kept (1-30)": "D\xEDas que se guardan los eventos (1-30)",
+  "Give an inbox a new URL and print it; the old one stops accepting writes right away (stored events stay)": "Le da al buz\xF3n una URL nueva y la imprime; la vieja deja de aceptar escrituras de inmediato (los eventos guardados se quedan)",
+  "Show one of your crons: what it does, how it notifies you and when it runs (--json: the whole object)": "Muestra un cron tuyo: qu\xE9 hace, c\xF3mo te avisa y cu\xE1ndo corre (--json: el objeto completo)",
+  "At most N runs of one of your crons (1-50, default 50)": "Como m\xE1ximo N corridas de un cron tuyo (1-50, default 50)",
   "When to notify (default failure)": "Cu\xE1ndo avisar (default failure: s\xF3lo si falla)",
   'Run ONCE at this time: ISO ("2026-10-18T23:00", read in --tz) or "23:00" (today)': 'Correr UNA SOLA VEZ a esta hora: ISO ("2026-10-18T23:00", en la zona de --tz) o "23:00" (hoy)',
   "Run ONCE after this long: 10m, 2h, 1h30m, 1d": "Correr UNA SOLA VEZ dentro de: 10m, 2h, 1h30m, 1d",
@@ -7574,7 +7653,7 @@ function normalizeArgs(input) {
 }
 
 // src/index.ts
-var VERSION2 = true ? "0.19.0" : "dev";
+var VERSION2 = true ? "0.19.1" : "dev";
 var GLOBAL_OPTIONS = {
   json: { type: "boolean" },
   token: { type: "string" },

package/package.json

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