@easybits.cloud/cli 0.19.0 → 0.20.0

package/README.md

@@ -131,7 +131,10 @@ 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 create "Daily signups" --cron "0 9 * * *" --run "python3 count.py" --file count.py \
+  --machine my-app                                                       # runs with my-app's env and secrets (its DATABASE_URL), resolved each run
+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 +148,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)
@@ -164,6 +169,7 @@ easybits db query leads "SELECT * FROM leads" --json
 easybits db rename leads prospects --dry-run   # which agent prompts name it
 easybits db rm leads --dry-run                 # tables and rows that would be lost
 easybits db rm leads --yes
+easybits db attach clave                     # the database your machine opens at /v1/db/clave/
 
 # Agents
 easybits agents ls
@@ -307,6 +313,14 @@ Host *.ghosty
 
 Full reference: https://www.easybits.cloud/docs#cli · https://www.easybits.cloud/en/docs/cli.md
 
+## Changes in 0.20.0
+
+- `db attach <name> [--description <text>]`: adds to your account the database one of your machines
+  already uses (`DATABASE_URL=http://172.20.0.1:8090/v1/db/<name>/`). Nothing is created or copied;
+  from then on `db query|tables|ls` work on it. It does not count toward your plan's database limit,
+  and `db rm` only removes it from your list: the machine keeps its data. New API:
+  `POST /api/v2/databases { name, attach: true }`.
+
 ## Changes in 0.17.1
 
 - `easybits crons ls|runs|run|pause|resume`: EasyBits' scheduled jobs, the same as the

package/dist/index.js

@@ -3797,6 +3797,22 @@ var db = {
         emit(ctx, d, () => console.log(t(`Created ${d.name} (${d.id})`, `Creada ${d.name} (${d.id})`)));
       }
     },
+    attach: {
+      summary: "Add to your account the database one of your machines already uses",
+      usage: "easybits db attach <name> [--description <text>]",
+      options: { description: { type: "string", value: "text", description: "What it is for" } },
+      examples: [
+        "easybits db attach clave   # the machine's DATABASE_URL ends in /v1/db/clave/",
+        'easybits db query clave "SELECT count(*) FROM users" --json'
+      ],
+      // No crea nada: el servidor deriva el namespace de tu cuenta + nombre y exige que exista.
+      // Desde ahí sirven query/tables/export; `db rm` sólo la quita de la lista.
+      async run(ctx) {
+        const name = need(ctx, 0, "name", this.usage);
+        const d = await api(ctx, "POST", "/databases", { name, attach: true, description: str(ctx, "description") });
+        emit(ctx, d, () => console.log(t(`Attached ${d.name} (${d.id})`, `Adjunta ${d.name} (${d.id})`)));
+      }
+    },
     rm: {
       aliases: ["delete", "drop"],
       summary: "Delete a database (irreversible)",
@@ -3826,7 +3842,13 @@ var db = {
         const hit = await findDb(ctx, ref2);
         await confirm(ctx, t(`Delete database ${hit.name} (${hit.id}) and all its data?`, `\xBFBorrar la base ${hit.name} (${hit.id}) con todos sus datos?`), { typeName: hit.name });
         const r = await eb.deleteDatabase(hit.id);
-        emit(ctx, { ...r, id: hit.id, name: hit.name }, () => console.log(t(`Deleted ${hit.name} (${hit.id})`, `Borrada ${hit.name} (${hit.id})`)));
+        emit(
+          ctx,
+          { ...r, id: hit.id, name: hit.name },
+          () => console.log(
+            r.detached ? t(`Removed ${hit.name} from your list; its machine keeps the data`, `${hit.name} sali\xF3 de tu lista; su m\xE1quina conserva los datos`) : t(`Deleted ${hit.name} (${hit.id})`, `Borrada ${hit.name} (${hit.id})`)
+          )
+        );
       }
     },
     rename: {
@@ -4918,7 +4940,7 @@ async function updateNotice(current2) {
 }
 
 // src/commands/doctor.ts
-var VERSION = true ? "0.19.0" : "dev";
+var VERSION = true ? "0.20.0" : "dev";
 var doctor2 = {
   name: "doctor",
   group: "Account",
@@ -5438,6 +5460,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", "ejecuciones 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);
@@ -5464,7 +5499,8 @@ var ACTION_OPTIONS = {
   file: { type: "string", multiple: true, value: "local[=remote]", description: "File mounted for --run, next to the command by default (repeatable)" },
   "secret-file": { type: "string", multiple: true, value: "NAME:local[=remote]", description: "Upload a local file as a secret only this cron can read, written at the same ~ path in the box (repeatable; e.g. a .p8)" },
   template: { type: "string", value: "python|node|bun|ubuntu", description: "Box image for --run (default python)" },
-  timeout: { type: "string", value: "seconds", description: "Time limit for --run (default 300, max 600)" }
+  timeout: { type: "string", value: "seconds", description: "Time limit for --run (default 300, max 600)" },
+  machine: { type: "string", value: "id|name", description: "Run --run with that machine's config (its env and secrets, e.g. DATABASE_URL), resolved on every run" }
 };
 function remotePathFor(local, home = homedir7()) {
   const abs = resolve3(local.replace(/^~(?=\/)/, home));
@@ -5499,7 +5535,8 @@ function execFromFlags(f, read, home = homedir7()) {
       ...files3.length ? { files: files3 } : {},
       ...secrets2.length ? { secrets: secrets2 } : {},
       ...f.template ? { template: f.template } : {},
-      ...f.timeout ? { timeoutSeconds: Number(f.timeout) } : {}
+      ...f.timeout ? { timeoutSeconds: Number(f.timeout) } : {},
+      ...f.machine ? { machine: f.machine } : {}
     },
     ...Object.keys(secretValues).length ? { secretValues } : {}
   };
@@ -5579,7 +5616,7 @@ var whenOf = (ctx) => ({
   times: str(ctx, "times"),
   tz: str(ctx, "tz")
 });
-var nextLine = (c) => c.nextRunLocal ? t(`next ${c.nextRunLocal} ${c.timezone} (in ${c.in})`, `pr\xF3xima ${c.nextRunLocal} ${c.timezone} (en ${c.in})`) : t("no next run", "sin pr\xF3xima corrida");
+var nextLine = (c) => c.nextRunLocal ? t(`next ${c.nextRunLocal} ${c.timezone} (in ${c.in})`, `pr\xF3xima ${c.nextRunLocal} ${c.timezone} (en ${c.in})`) : t("no next run", "sin pr\xF3xima ejecuci\xF3n");
 var flagsOf = (ctx) => ({
   url: str(ctx, "url"),
   method: str(ctx, "method"),
@@ -5594,7 +5631,7 @@ function actionOf(ctx) {
   if (run && (str(ctx, "url") || str(ctx, "agent"))) return { error: "--run, --url and --agent are exclusive" };
   if (run) {
     return execFromFlags(
-      { run, files: list(ctx, "file"), secrets: list(ctx, "secret"), secretFiles: list(ctx, "secret-file"), template: str(ctx, "template"), timeout: str(ctx, "timeout") },
+      { run, files: list(ctx, "file"), secrets: list(ctx, "secret"), secretFiles: list(ctx, "secret-file"), template: str(ctx, "template"), timeout: str(ctx, "timeout"), machine: str(ctx, "machine") },
       (p) => {
         try {
           return readFileSync18(p, "utf8");
@@ -5612,10 +5649,10 @@ var STATUS = {
   tarde: ["late", "tarde"],
   fallo: ["failed", "fall\xF3"],
   pausado: ["paused", "pausado"],
-  nuevo: ["no runs yet", "sin corridas"]
+  nuevo: ["no runs yet", "sin ejecuciones"]
 };
 function cronStatus(c) {
-  if (c.running) return t("running", "corriendo");
+  if (c.running) return t("running", "en ejecuci\xF3n");
   const s = STATUS[c.status];
   return s ? t(s[0], s[1]) : c.status;
 }
@@ -5636,7 +5673,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,29 +5722,48 @@ 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(
             items.map((r) => ({
               at: fmtDate(r.startedAt),
-              ok: r.ok == null ? t("running", "corriendo") : r.ok ? "ok" : t("failed", "fall\xF3"),
+              ok: r.ok == null ? t("running", "en ejecuci\xF3n") : r.ok ? "ok" : t("failed", "fall\xF3"),
               status: r.exitCode != null ? `exit ${r.exitCode}` : 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.")
+            t("No runs yet.", "Todav\xEDa no hay ejecuciones.")
           );
           if (withLogs) {
             const last = items.find((r) => r.logs);
@@ -5754,7 +5810,7 @@ ${failed.error}`);
           }
           if (Date.now() >= deadline) {
             throw new CliError(
-              t(`Gave up waiting for \xAB${mine.name}\xBB${r.nextRunLocal ? ` (next run ${r.nextRunLocal})` : ""}.`, `Me cans\xE9 de esperar \xAB${mine.name}\xBB${r.nextRunLocal ? ` (pr\xF3xima corrida ${r.nextRunLocal})` : ""}.`),
+              t(`Gave up waiting for \xAB${mine.name}\xBB${r.nextRunLocal ? ` (next run ${r.nextRunLocal})` : ""}.`, `Me cans\xE9 de esperar \xAB${mine.name}\xBB${r.nextRunLocal ? ` (pr\xF3xima ejecuci\xF3n ${r.nextRunLocal})` : ""}.`),
               EXIT.API,
               `easybits crons wait ${mine.id} --timeout 2h`,
               "timeout"
@@ -5803,7 +5859,7 @@ ${failed.error}`);
     create: {
       aliases: ["add"],
       summary: "Create a cron: call a public https URL, send a turn to one of your agents or run a command in a throwaway box, repeating (at most every 5 min) or once",
-      usage: 'easybits crons create <name> (--cron "<5 fields>" [--until <when>] [--times N] | --at <when> | --in <duration>) [--tz <IANA>] (--url <https-url> [--method] [--body] [--secret NAME] | --agent <id> --prompt <text> | --run <cmd> [--file f]\u2026 [--secret NAME]\u2026 [--secret-file NAME:path]\u2026 [--template] [--timeout]) [--dry-run]',
+      usage: 'easybits crons create <name> (--cron "<5 fields>" [--until <when>] [--times N] | --at <when> | --in <duration>) [--tz <IANA>] (--url <https-url> [--method] [--body] [--secret NAME] | --agent <id> --prompt <text> | --run <cmd> [--file f]\u2026 [--secret NAME]\u2026 [--secret-file NAME:path]\u2026 [--template] [--timeout] [--machine id|name]) [--dry-run]',
       options: {
         cron: { type: "string", value: "expr", description: 'Cron of 5 fields, e.g. "30 8 * * *" = daily 8:30' },
         ...WHEN_OPTIONS,
@@ -5835,7 +5891,7 @@ ${failed.error}`);
           emit(ctx, p, () => {
             console.log(t(`OK, nothing created. \xAB${name}\xBB \u2014 ${p.schedule}`, `V\xE1lido, no se cre\xF3 nada. \xAB${name}\xBB \u2014 ${p.schedule}`));
             for (const r of p.nextRuns) console.log(`  ${r.local} ${p.timezone}  (${r.at})`);
-            if (p.in) console.log(t(`First run in ${p.in}.`, `La primera corre en ${p.in}.`));
+            if (p.in) console.log(t(`First run in ${p.in}.`, `La primera se ejecuta en ${p.in}.`));
           });
           return;
         }
@@ -5846,7 +5902,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" },
@@ -5890,7 +5946,7 @@ ${failed.error}`);
         const mine = await resolveUserCron(ctx, ref2);
         if (!mine) throw new CliError(t(`You have no cron "${ref2}".`, `No tienes un cron "${ref2}".`), 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.`));
+        await confirm(ctx, t(`Delete cron \xAB${mine.name}\xBB? It stops running right away.`, `\xBFBorrar el cron \xAB${mine.name}\xBB? Deja de ejecutarse 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`)));
       }
@@ -5987,7 +6043,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 +6096,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 +6124,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",
@@ -6944,7 +7040,7 @@ var HELP_ES = {
   "Compute": "C\xF3mputo",
   "Firecracker microVMs (alias: sb)": "MicroVMs Firecracker (alias: sb)",
   "List your sandboxes": "Enlista tus sandboxes",
-  "Create a sandbox and wait until it is running": "Crea un sandbox y espera a que est\xE9 corriendo",
+  "Create a sandbox and wait until it is running": "Crea un sandbox y espera a que est\xE9 en marcha",
   "Base template (default ubuntu): ubuntu, python, node, code-interpreter\u2026": "Template base (default ubuntu): ubuntu, python, node, code-interpreter\u2026",
   "Human label (lets you `ssh <name>.ghosty`)": "Nombre para personas (permite `ssh <nombre>.ghosty`)",
   "Time to live before auto-destroy (was --timeout)": "Tiempo de vida antes de autodestruirse (antes --timeout)",
@@ -6953,7 +7049,7 @@ var HELP_ES = {
   "KEY=VALUE lines (dotenv); - reads stdin. Use it for secrets": "Renglones KEY=VALUE (dotenv); - lee stdin. \xDAsalo para secretos",
   "Return right away instead of waiting for running": "Regresa de inmediato en vez de esperar a que corra",
   "Show one sandbox": "Muestra un sandbox",
-  "Run a shell command inside a sandbox": "Corre un comando de shell dentro de un sandbox",
+  "Run a shell command inside a sandbox": "Ejecuta un comando de shell dentro de un sandbox",
   "Working directory": "Directorio de trabajo",
   "Kill the command after this long": "Mata el comando despu\xE9s de este tiempo",
   "Read the sandbox journal (optionally one systemd unit)": "Lee el journal del sandbox (opcionalmente de una unit de systemd)",
@@ -6971,7 +7067,7 @@ var HELP_ES = {
   "Skip the confirmation (required without a terminal or with --json)": "Salta la confirmaci\xF3n (obligatorio sin terminal o con --json)",
   "Capture a copy-on-write snapshot without stopping the box": "Toma un snapshot copy-on-write sin detener la caja",
   "Snapshot label": "Nombre del snapshot",
-  "Agents running in their own sandbox": "Agentes que corren en su propio sandbox",
+  "Agents running in their own sandbox": "Agentes que viven en su propio sandbox",
   "List your agents": "Enlista tus agentes",
   "Show one agent: record, prompt, MCP servers, skills and files": "Muestra un agente: registro, prompt, servidores MCP, skills y archivos",
   "Only these fields: agentId, name, template, status, lastError, sandboxId, agentUrl, embedToken, createdAt, expiresAt, systemPrompt, systemPromptMode, mcpServers, skills, files": "S\xF3lo estos campos: agentId, name, template, status, lastError, sandboxId, agentUrl, embedToken, createdAt, expiresAt, systemPrompt, systemPromptMode, mcpServers, skills, files",
@@ -7117,6 +7213,8 @@ var HELP_ES = {
   "SQL databases (libSQL)": "Bases de datos SQL (libSQL)",
   "List your databases": "Enlista tus bases de datos",
   "Create a database": "Crea una base de datos",
+  "Add to your account the database one of your machines already uses": "Agrega a tu cuenta la base que ya usa una de tus m\xE1quinas",
+  "the machine's DATABASE_URL ends in /v1/db/clave/": "el DATABASE_URL de la m\xE1quina termina en /v1/db/clave/",
   "What it is for": "Para qu\xE9 es",
   "Delete a database (irreversible)": "Borra una base de datos (irreversible)",
   "Show its tables and rows; delete nothing": "Ense\xF1a sus tablas y filas; no borra nada",
@@ -7128,7 +7226,7 @@ var HELP_ES = {
   "asks you to type the name": "te pide teclear el nombre",
   "scripts and agents": "scripts y agentes",
   "List tables with row counts and columns, and how many links are permanent": "Enlista las tablas con sus filas y columnas, y cu\xE1ntas ligas son permanentes",
-  "Run one SQL statement (by database id or name)": "Corre una sentencia SQL (por id o nombre de la base)",
+  "Run one SQL statement (by database id or name)": "Ejecuta una sentencia SQL (por id o nombre de la base)",
   "Positional ? parameter (repeatable)": "Par\xE1metro ? posicional (repetible)",
   "Storage": "Almacenamiento",
   "Your files in EasyBits storage": "Tus archivos en el almacenamiento de EasyBits",
@@ -7211,24 +7309,25 @@ var HELP_ES = {
   "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, message an agent or run a command; repeating or once) and, for admins, the platform's": "Tus tareas programadas (pegarle a una URL, escribirle a un agente o correr un comando; repetidas o de una sola vez) y, para admins, las de la plataforma",
+  "Your scheduled jobs (call a URL, message an agent or run a command; repeating or once) and, for admins, the platform's": "Tus tareas programadas (pegarle a una URL, escribirle a un agente o ejecutar un comando; repetidas o de una sola vez) 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)",
+  "Show the last runs of one of your crons (id or name) or of a platform job, with the full error": "Muestra las \xFAltimas ejecuciones 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)": "Ejecuta 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, send a turn to one of your agents or run a command in a throwaway box, repeating (at most every 5 min) or once": "Crea un cron: pegarle a una URL https p\xFAblica, mandarle un turno a uno de tus agentes o correr un comando en una caja desechable, repetido (como mucho cada 5 min) o de una sola vez",
+  "Create a cron: call a public https URL, send a turn to one of your agents or run a command in a throwaway box, repeating (at most every 5 min) or once": "Crea un cron: pegarle a una URL https p\xFAblica, mandarle un turno a uno de tus agentes o ejecutar un comando en una caja desechable, repetido (como mucho cada 5 min) o de una sola vez",
   "Vault secret: a header with --url (default Authorization: Bearer); an env var with --run (repeatable)": "Secreto de la b\xF3veda: header con --url (default Authorization: Bearer); variable de entorno con --run (repetible)",
-  "Run this shell command in a throwaway box instead (python, files and secrets included; success = exit 0)": "Correr este comando de shell en una caja desechable (con python, tus archivos y secretos; \xE9xito = exit 0)",
+  "Run this shell command in a throwaway box instead (python, files and secrets included; success = exit 0)": "Ejecutar este comando de shell en una caja desechable (con python, tus archivos y secretos; \xE9xito = exit 0)",
   "File mounted for --run, next to the command by default (repeatable)": "Archivo que se monta para --run, junto al comando por default (repetible)",
   "Upload a local file as a secret only this cron can read, written at the same ~ path in the box (repeatable; e.g. a .p8)": "Sube un archivo local como secreto que s\xF3lo este cron puede leer; se escribe en la misma ruta ~ dentro de la caja (repetible; p. ej. un .p8)",
   "Box image for --run (default python)": "Imagen de la caja para --run (default python)",
   "Time limit for --run (default 300, max 600)": "Tiempo l\xEDmite de --run (default 300, m\xE1ximo 600)",
-  "Also print stdout/stderr of --run crons (last 64 KB per run)": "Muestra tambi\xE9n stdout/stderr de los crons --run (\xFAltimos 64 KB por corrida)",
-  "Wait for the next run of one of your crons to finish and exit with its result (exec: its exit code)": "Espera a que termine la siguiente corrida de un cron tuyo y sale con su resultado (exec: su c\xF3digo de salida)",
+  "Run --run with that machine's config (its env and secrets, e.g. DATABASE_URL), resolved on every run": "Corre --run con la configuraci\xF3n de esa m\xE1quina (su env y sus secretos, p. ej. DATABASE_URL), resuelta en cada ejecuci\xF3n",
+  "Also print stdout/stderr of --run crons (last 64 KB per run)": "Muestra tambi\xE9n stdout/stderr de los crons --run (\xFAltimos 64 KB por ejecuci\xF3n)",
+  "Wait for the next run of one of your crons to finish and exit with its result (exec: its exit code)": "Espera a que termine la siguiente ejecuci\xF3n de un cron tuyo y sale con su resultado (exec: su c\xF3digo de salida)",
   "Give up after this long (default 30m; 10m, 2h\u2026)": "Se rinde despu\xE9s de este tiempo (default 30m; 10m, 2h\u2026)",
-  "Tell you after each run: push to the Ghosty app (vault secret GHOSTY_PUSH_TOKEN), email to your account and/or an event in one of your inboxes; none removes it": "Te avisa tras cada corrida: push a la app de Ghosty (secreto GHOSTY_PUSH_TOKEN de la b\xF3veda), correo a tu cuenta y/o un evento en uno de tus buzones; none lo quita",
+  "Tell you after each run: push to the Ghosty app (vault secret GHOSTY_PUSH_TOKEN), email to your account and/or an event in one of your inboxes; none removes it": "Te avisa tras cada ejecuci\xF3n: push a la app de Ghosty (secreto GHOSTY_PUSH_TOKEN de la b\xF3veda), correo a tu cuenta y/o un evento en uno de tus buzones; none lo quita",
   // inbox (buzones de eventos)
   "Event inboxes: your own webhook URL whose events reach your terminal live or wait for you to read them": "Buzones de eventos: tu propia URL de webhook; lo que llega te alcanza en la terminal en vivo o te espera para que lo leas",
   "List your inboxes with their URL and unread events": "Enlista tus buzones con su URL y los eventos sin leer",
@@ -7241,20 +7340,27 @@ 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 se ejecuta (--json: el objeto completo)",
+  "At most N runs of one of your crons (1-50, default 50)": "Como m\xE1ximo N ejecuciones 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",
+  'Run ONCE at this time: ISO ("2026-10-18T23:00", read in --tz) or "23:00" (today)': 'Ejecutar 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": "Ejecutar UNA SOLA VEZ dentro de: 10m, 2h, 1h30m, 1d",
   "A repeating cron stops after this date": "Un cron que se repite se detiene despu\xE9s de esta fecha",
-  "A repeating cron stops after N more runs": "Un cron que se repite se detiene tras N corridas m\xE1s",
-  "Validate and show the next 3 runs without creating anything": "Valida y muestra las pr\xF3ximas 3 corridas sin crear nada",
+  "A repeating cron stops after N more runs": "Un cron que se repite se detiene tras N ejecuciones m\xE1s",
+  "Validate and show the next 3 runs without creating anything": "Valida y muestra las pr\xF3ximas 3 ejecuciones sin crear nada",
   '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",
+  "Call this public https URL on each run": "Pegarle a esta URL https p\xFAblica en cada ejecuci\xF3n",
   "HTTP method (default GET)": "M\xE9todo HTTP (default GET)",
   "Request body (not with GET)": "Cuerpo de la petici\xF3n (no con GET)",
   "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)",
+  "What the agent is told on each run (with --agent)": "Lo que se le dice al agente en cada ejecuci\xF3n (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",
@@ -7574,7 +7680,7 @@ function normalizeArgs(input) {
 }
 
 // src/index.ts
-var VERSION2 = true ? "0.19.0" : "dev";
+var VERSION2 = true ? "0.20.0" : "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.20.0",
   "description": "Official CLI for EasyBits, the cloud for AI agents — sandboxes, hosting, domains, databases, agents and files from your terminal",
   "type": "module",
   "bin": {