@easybits.cloud/cli 0.14.1 → 0.15.1

package/README.md

@@ -73,6 +73,8 @@ easybits db create leads
 easybits db tables leads             # tables, row counts, columns, permanent vs external links
 easybits db photos put catalog --table products --key-column sku --dir photos/   # SKU-123.jpg → row sku=SKU-123
 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
 
 # Agents
@@ -166,6 +168,25 @@ Host *.ghosty
 
 Full reference: https://www.easybits.cloud/docs#cli · https://www.easybits.cloud/en/docs/cli.md
 
+## Changes in 0.15.1
+
+- After a `--dry-run`, the last line is the real command (`To apply: …`); without a terminal it
+  already carries `--yes` when the command asks for confirmation.
+- A 404 with a reason prints the reason; a bare «Not found» says it may also be missing access
+  (another account's resource) and points to `easybits whoami`.
+- The «new version» notice checks npm every hour (it was once a day), and asks again when the
+  cache is older than what you have installed.
+
+## Changes in 0.15.0
+
+- `db rename <db> <new-name> [--skip-prompts] [--dry-run]` (alias `mv`): renames the database (the
+  id does not change, so the `db_*` tools keep working) and rewrites the name in your ghosty-lite /
+  goose agents' prompts where it appears as a standalone word — never inside `x.com`, `@x`, `x_test`
+  or in capitals. `--dry-run` lists each prompt and line; a prompt that fails is reported (exit 1)
+  and the rename stays. New API: `PATCH /api/v2/databases/:dbId { name?, description? }`.
+- `db rm --dry-run`: the tables and row counts you would lose.
+- `agents create --prompt/--prompt-file` prints which prompt was applied and its size.
+
 ## Changes in 0.14.1
 
 - `machines launch --machine` takes a name too, like every other command.

package/dist/index.js

@@ -108,6 +108,17 @@ function notLoggedIn() {
     "not_logged_in"
   );
 }
+function isGenericNotFound(body) {
+  let msg = body;
+  try {
+    const j = JSON.parse(body);
+    msg = j?.message ?? j?.error ?? j?.detail ?? "";
+  } catch {
+  }
+  if (typeof msg !== "string") return false;
+  const s = msg.trim();
+  return !s || s.startsWith("<") || /^(404\s*:?\s*)?not found\.?$/i.test(s);
+}
 function apiMessage(body) {
   try {
     const j = JSON.parse(body);
@@ -142,6 +153,14 @@ function toCliError(err) {
         401
       );
     }
+    if (err.status === 404) {
+      const hint404 = t(
+        "Check the id (list what you have with the matching `ls` command) and that your key is from the account that owns it (easybits whoami).",
+        "Revisa el id (enlista lo que tienes con el `ls` que corresponda) y que tu key sea de la cuenta due\xF1a (easybits whoami)."
+      );
+      if (isGenericNotFound(err.body)) return new CliError(t("Not found \u2014 or you don't have access to it.", "No se encontr\xF3, o no tienes acceso."), EXIT.API, hint404, "not_found", 404);
+      return new CliError(message2, EXIT.API, (kind && KIND_HINTS()[kind]) ?? hint404, "not_found", 404);
+    }
     const hint = (kind && KIND_HINTS()[kind]) ?? (err.status === 403 ? t("Your key may lack the scope for this action (READ/WRITE/DELETE).", "Tu key quiz\xE1 no tiene el permiso para esto (READ/WRITE/DELETE).") : err.status === 404 ? t("Check the id. List what you have with the matching `ls` command.", "Revisa el id. Enlista lo que tienes con el `ls` que corresponda.") : err.status === 402 ? t("Plan limit reached. See: easybits usage", "Llegaste al l\xEDmite de tu plan. Mira: easybits usage") : void 0);
     return new CliError(`${t("API error", "Error de la API")} ${err.status}: ${message2}`, EXIT.API, hint, "api_error", err.status);
   }
@@ -683,9 +702,18 @@ import { createInterface } from "readline/promises";
 var YES_OPTION = {
   yes: { type: "boolean", short: "y", description: "Skip the confirmation (required without a terminal or with --json)" }
 };
-function sameCommand() {
-  const argv2 = process.argv.slice(2).map((a) => /^[\w@%+=:,./-]+$/.test(a) ? a : `'${a.replace(/'/g, `'\\''`)}'`);
-  return `easybits ${argv2.join(" ")}`;
+function sameCommand(argv2 = process.argv.slice(2)) {
+  const quoted = argv2.map((a) => /^[\w@%+=:,./-]+$/.test(a) ? a : `'${a.replace(/'/g, `'\\''`)}'`);
+  return `easybits ${quoted.join(" ")}`;
+}
+function applyCommand(argv2, opts) {
+  const rest = argv2.filter((a) => a !== "--dry-run");
+  const hasYes = rest.some((a) => a === "--yes" || a === "-y");
+  return `${sameCommand(rest)}${opts.needsYes && opts.headless && !hasYes ? " --yes" : ""}`;
+}
+function applyHint(ctx, opts = {}) {
+  const cmd = applyCommand(process.argv.slice(2), { headless: !interactive(ctx), needsYes: opts.needsYes });
+  return t(`To apply: ${cmd}`, `Para aplicarlo: ${cmd}`);
 }
 async function ask(question) {
   const rl = createInterface({ input: process.stdin, output: process.stderr });
@@ -1419,6 +1447,7 @@ var REF_ARGS = {
   "domains verify": { index: 0, kind: "sandbox" },
   "domains rm": { index: 0, kind: "sandbox" },
   "db rm": { index: 0, kind: "db" },
+  "db rename": { index: 0, kind: "db" },
   "db tables": { index: 0, kind: "db" },
   "db query": { index: 0, kind: "db" },
   "db photos": { index: 1, kind: "db" }
@@ -1778,7 +1807,7 @@ var domains = {
 };
 
 // src/commands/db.ts
-import { existsSync as existsSync7, readFileSync as readFileSync8, statSync as statSync4 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync9, statSync as statSync5 } from "fs";
 
 // src/photos.ts
 import { createHash as createHash2 } from "crypto";
@@ -1872,248 +1901,6 @@ function parseLinkStats(columns, row) {
   return columns.map((column, i) => ({ column, permanent: n(i * 4), expiring: n(i * 4 + 1), external: n(i * 4 + 2), empty: n(i * 4 + 3) })).filter((s) => s.permanent + s.expiring + s.external > 0);
 }
 
-// src/commands/db.ts
-async function findDb(ctx, id) {
-  const hit = (await listRefs(ctx, "db")).find((d) => d.id === id);
-  if (!hit) throw new CliError(t(`No database "${id}".`, `No existe la base "${id}".`), 1, t("List them with: easybits db ls", "Enl\xEDstalas con: easybits db ls"), "not_found", 404);
-  return { id, name: hit.name ?? id };
-}
-var db = {
-  name: "db",
-  aliases: ["databases", "database"],
-  group: "Data",
-  summary: "SQL databases (libSQL)",
-  synopsis: "db",
-  subs: {
-    ls: {
-      aliases: ["list"],
-      summary: "List your databases",
-      usage: "easybits db ls",
-      examples: ["easybits db ls --json"],
-      async run(ctx) {
-        const eb = await getClient(ctx);
-        const { items } = await eb.listDatabases();
-        emit(
-          ctx,
-          items,
-          () => table(
-            items.map((d) => ({ ...d, createdAt: fmtDate(d.createdAt) })),
-            [["id", "ID"], ["name", "NAME"], ["createdAt", "CREATED"], ["description", "DESCRIPTION"]],
-            t("No databases. Create one: easybits db create <name>", "No hay bases. Crea una: easybits db create <nombre>")
-          )
-        );
-      }
-    },
-    create: {
-      summary: "Create a database",
-      usage: "easybits db create <name> [--description <text>]",
-      options: { description: { type: "string", value: "text", description: "What it is for" } },
-      examples: ["easybits db create leads --description 'CRM leads'"],
-      async run(ctx) {
-        const name = need(ctx, 0, "name", this.usage);
-        const eb = await getClient(ctx);
-        const d = await eb.createDatabase({ name, description: str(ctx, "description") });
-        emit(ctx, d, () => console.log(t(`Created ${d.name} (${d.id})`, `Creada ${d.name} (${d.id})`)));
-      }
-    },
-    rm: {
-      aliases: ["delete", "drop"],
-      summary: "Delete a database (irreversible)",
-      usage: "easybits db rm <db-id|name> [--yes]",
-      options: { ...YES_OPTION },
-      examples: ["easybits db rm leads            # asks you to type the name", "easybits db rm leads --yes      # scripts and agents"],
-      async run(ctx) {
-        const ref = need(ctx, 0, "db-id|name", this.usage);
-        requireYesIfHeadless(ctx);
-        const eb = await getClient(ctx);
-        const hit = await findDb(ctx, ref);
-        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})`)));
-      }
-    },
-    tables: {
-      aliases: ["inspect", "schema"],
-      summary: "List tables with row counts and columns, and how many links are permanent",
-      usage: "easybits db tables <db-id|name>",
-      examples: ["easybits db tables leads", "easybits db tables leads --json"],
-      // Patrón de `turso db inspect` / `.tables` + `.schema` de sqlite3, en una sola vista.
-      async run(ctx) {
-        const ref = need(ctx, 0, "db-id|name", this.usage);
-        const eb = await getClient(ctx);
-        const hit = await findDb(ctx, ref);
-        const q = (sql, args) => eb.queryDatabase(hit.id, sql, args);
-        const names = (await q("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '_litestream_%' ORDER BY name")).rows.map((r) => String(r[0]));
-        const ident2 = (n) => `"${n.replace(/"/g, '""')}"`;
-        const tables = [];
-        for (const name of names) {
-          const info2 = await q(`PRAGMA table_info(${ident2(name)})`);
-          const col = (k) => info2.cols.indexOf(k);
-          const columns = info2.rows.map((r) => ({ name: String(r[col("name")]), type: String(r[col("type")] ?? ""), pk: Number(r[col("pk")]) > 0 }));
-          const count = await q(`SELECT count(*) FROM ${ident2(name)}`);
-          const textCols = columns.filter((c) => !c.type || /CHAR|TEXT|CLOB/i.test(c.type)).map((c) => c.name);
-          const links = textCols.length ? parseLinkStats(textCols, (await q(linkStatsSql(name, textCols))).rows[0] ?? []) : [];
-          tables.push({ name, rows: Number(count.rows[0]?.[0] ?? 0), columns, links });
-        }
-        emit(ctx, tables, () => {
-          table(
-            tables.map((t2) => ({
-              name: t2.name,
-              rows: t2.rows,
-              columns: t2.columns.map((c) => `${c.name}${c.type ? ` ${c.type}` : ""}${c.pk ? " PK" : ""}`).join(", ")
-            })),
-            [["name", "TABLE"], ["rows", "ROWS"], ["columns", "COLUMNS"]],
-            t(`No tables in ${hit.name}. Create one: easybits db query ${hit.name} 'CREATE TABLE \u2026'`, `No hay tablas en ${hit.name}. Crea una: easybits db query ${hit.name} 'CREATE TABLE \u2026'`)
-          );
-          const withLinks = tables.flatMap((tb) => tb.links.map((l) => ({ ...l, table: tb.name })));
-          if (withLinks.length) {
-            console.log("\n" + t("Links (permanent = EasyBits public storage; expiring = signed URL):", "Ligas (permanente = almacenamiento p\xFAblico de EasyBits; caduca = URL firmada):"));
-            table(
-              withLinks.map((l) => ({ where: `${l.table}.${l.column}`, permanent: l.permanent, expiring: l.expiring, external: l.external, empty: l.empty })),
-              [["where", "COLUMN"], ["permanent", "PERMANENT"], ["expiring", "EXPIRING"], ["external", "EXTERNAL"], ["empty", "EMPTY"]]
-            );
-            if (withLinks.some((l) => l.external + l.expiring > 0)) {
-              console.log(t("Make them permanent: easybits db photos put <db> --table T --key-column sku --dir photos/", "Hazlas permanentes: easybits db photos put <db> --table T --key-column sku --dir fotos/"));
-            }
-          }
-        });
-      }
-    },
-    photos: {
-      summary: "Put catalog photos in a table: SKU-123.jpg \u2192 the row whose key is SKU-123, as a permanent public link",
-      usage: "easybits db photos put <db> --table <table> --key-column <col> --dir <folder> [--column <col>] [--replace] [--dry-run]",
-      options: {
-        table: { type: "string", value: "table", description: "Table to update" },
-        "key-column": { type: "string", value: "col", description: "Column that matches the file name (e.g. sku)" },
-        dir: { type: "string", value: "folder", description: "Folder with the photos (JPEG, PNG or WebP, max 10 MB each)" },
-        column: { type: "string", value: "col", description: "Column for the link (default: image_url, photo_url, imagen\u2026)" },
-        replace: { type: "boolean", description: "Also replace rows that already have a permanent link" },
-        "dry-run": { type: "boolean", description: "Show the plan; upload nothing" }
-      },
-      examples: [
-        "easybits db photos put catalogo --table productos --key-column sku --dir fotos/ --dry-run",
-        "easybits db photos put catalogo --table productos --key-column sku --dir fotos/ --column foto",
-        "easybits db tables catalogo                  # how many links are permanent, external or empty"
-      ],
-      async run(ctx) {
-        const action = need(ctx, 0, "put", this.usage);
-        if (action !== "put") throw usageError(t(`Unknown photos action "${action}".`, `Acci\xF3n de photos desconocida "${action}".`), this.usage);
-        const ref = need(ctx, 1, "db", this.usage);
-        const tableName = str(ctx, "table");
-        const keyCol = str(ctx, "key-column");
-        const dir = str(ctx, "dir");
-        if (!tableName || !keyCol || !dir) throw usageError(t("Missing --table, --key-column or --dir.", "Faltan --table, --key-column o --dir."), this.usage);
-        if (!existsSync7(dir) || !statSync4(dir).isDirectory()) throw usageError(t(`Not a folder: ${dir}`, `No es una carpeta: ${dir}`), this.usage);
-        const { photos, rejected } = photoFiles(dir);
-        const eb = await getClient(ctx);
-        const hit = await findDb(ctx, ref);
-        const q = (sql, args) => eb.queryDatabase(hit.id, sql, args);
-        const ident2 = (n) => `"${n.replace(/"/g, '""')}"`;
-        const info2 = await q(`PRAGMA table_info(${ident2(tableName)})`);
-        const cols = info2.rows.map((r) => String(r[info2.cols.indexOf("name")]));
-        if (!cols.length) throw new CliError(t(`No table "${tableName}" in ${hit.name}.`, `No hay tabla "${tableName}" en ${hit.name}.`), 1, t(`See: easybits db tables ${hit.name}`, `Mira: easybits db tables ${hit.name}`), "not_found", 404);
-        if (!cols.includes(keyCol)) throw usageError(t(`No column "${keyCol}" in ${tableName} (${cols.join(", ")}).`, `No hay columna "${keyCol}" en ${tableName} (${cols.join(", ")}).`), this.usage);
-        const column = str(ctx, "column") ?? defaultPhotoColumn(cols);
-        if (!column) throw usageError(t(`${tableName} has no photo column: pass --column (${cols.join(", ")}).`, `${tableName} no tiene columna de foto: pasa --column (${cols.join(", ")}).`), this.usage);
-        if (!cols.includes(column)) throw usageError(t(`No column "${column}" in ${tableName} (${cols.join(", ")}).`, `No hay columna "${column}" en ${tableName} (${cols.join(", ")}).`), this.usage);
-        const current2 = /* @__PURE__ */ new Map();
-        for (let i = 0; i < photos.length; i += 100) {
-          const keys = photos.slice(i, i + 100).map((p) => p.key);
-          const r = await q(`SELECT ${ident2(keyCol)}, ${ident2(column)} FROM ${ident2(tableName)} WHERE ${ident2(keyCol)} IN (${keys.map(() => "?").join(",")})`, keys);
-          for (const row of r.rows) current2.set(String(row[0]), row[1]);
-        }
-        const plan = planPhotos(photos, current2, bool(ctx, "replace"));
-        const big = photos.filter((p) => p.bytes > WHATSAPP_MAX_BYTES).map((p) => p.file);
-        const summary = { db: hit.name, table: tableName, keyColumn: keyCol, column, plan, rejected, overWhatsappLimit: big };
-        const count = (a) => plan.filter((p) => p.action === a).length;
-        const why = (r) => r === "not_an_image" ? t("not a JPEG/PNG/WebP", "no es JPEG/PNG/WebP") : r === "too_large" ? t("over 10 MB", "m\xE1s de 10 MB") : t("empty file", "archivo vac\xEDo");
-        const printPlan2 = () => {
-          for (const p of plan) {
-            const what = p.action === "update" ? t("update", "actualizar") : p.action === "keep" ? t("keep (already permanent; --replace to redo)", "se queda (ya es permanente; --replace para rehacerla)") : t("no row with that key", "no hay fila con esa llave");
-            console.log(`${p.action === "update" ? "~" : "!"} ${p.file} \u2192 ${keyCol}=${p.key}: ${what}`);
-          }
-          for (const r of rejected) console.log(`! ${r.file}: ${why(r.reason)}`);
-          if (big.length) console.log(t(`Over 5 MB (WhatsApp won't send them by link): ${big.join(", ")}`, `M\xE1s de 5 MB (WhatsApp no las manda por liga): ${big.join(", ")}`));
-        };
-        if (bool(ctx, "dry-run") || !count("update")) {
-          emit(ctx, { ...summary, dryRun: bool(ctx, "dry-run") }, () => {
-            printPlan2();
-            console.log(count("update") ? t("(dry run: nothing uploaded)", "(simulaci\xF3n: no se subi\xF3 nada)") : t("Nothing to update.", "Nada que actualizar."));
-          });
-          return;
-        }
-        const urls = /* @__PURE__ */ new Map();
-        const results = [];
-        for (const item of plan.filter((p) => p.action === "update")) {
-          const photo = photos.find((p) => p.key === item.key);
-          try {
-            let url = urls.get(photo.sha);
-            if (!url) {
-              const up = await eb.uploadFile({ fileName: `${photo.sha.slice(0, 32)}.${photo.ext}`, contentType: photo.mime, size: photo.bytes, access: "public" });
-              const res = await fetch(up.putUrl, { method: "PUT", body: readFileSync8(photo.path), headers: { "Content-Type": photo.mime } });
-              if (!res.ok) throw new Error(t(`storage answered ${res.status}`, `el almacenamiento contest\xF3 ${res.status}`));
-              url = up.file.url;
-              if (!url) throw new Error(t("the API returned no public link", "la API no devolvi\xF3 liga p\xFAblica"));
-              urls.set(photo.sha, url);
-            }
-            await q(`UPDATE ${ident2(tableName)} SET ${ident2(column)} = ? WHERE ${ident2(keyCol)} = ?`, [url, item.key]);
-            results.push({ key: item.key, file: item.file, url });
-            if (!ctx.json) console.log(`~ ${item.file} \u2192 ${keyCol}=${item.key}: ${url}`);
-          } catch (e) {
-            results.push({ key: item.key, file: item.file, error: e.message });
-            if (!ctx.json) console.error(`! ${item.file}: ${e.message}`);
-          }
-        }
-        const failed = results.filter((r) => r.error).length;
-        emit(ctx, { ...summary, results }, () => {
-          for (const p of plan.filter((x) => x.action !== "update")) console.log(`! ${p.file} \u2192 ${keyCol}=${p.key}: ${p.action === "keep" ? t("kept", "se qued\xF3") : t("no row with that key", "no hay fila con esa llave")}`);
-          for (const r of rejected) console.log(`! ${r.file}: ${why(r.reason)}`);
-          console.log(t(`Updated ${results.length - failed} row(s)${failed ? `, ${failed} failed` : ""}.`, `${results.length - failed} fila(s) actualizadas${failed ? `, ${failed} fallaron` : ""}.`));
-        });
-        if (failed) process.exitCode = 1;
-      }
-    },
-    query: {
-      aliases: ["sql"],
-      summary: "Run one SQL statement (by database id or name)",
-      usage: "easybits db query <db-id|name> <sql> [--arg <value>]...",
-      options: { arg: { type: "string", multiple: true, value: "value", description: "Positional ? parameter (repeatable)" } },
-      examples: [
-        "easybits db query leads 'SELECT * FROM leads LIMIT 10'",
-        "easybits db query leads 'INSERT INTO leads(name) VALUES (?)' --arg Ana",
-        "easybits db query leads 'SELECT count(*) AS n FROM leads' --json"
-      ],
-      async run(ctx) {
-        const ref = need(ctx, 0, "db-id|name", this.usage);
-        const sql = need(ctx, 1, "sql", this.usage);
-        const eb = await getClient(ctx);
-        const hit = await findDb(ctx, ref);
-        const args = list(ctx, "arg");
-        const r = await eb.queryDatabase(hit.id, sql, args.length ? args : void 0);
-        emit(ctx, r, () => {
-          if (r.cols.length) {
-            table(
-              r.rows.map((row) => Object.fromEntries(r.cols.map((c, i) => [c, row[i]]))),
-              r.cols.map((c) => [c, c]),
-              "(0 rows)"
-            );
-          } else {
-            console.log(
-              t(
-                `OK, ${r.affected_row_count} row(s) affected${r.last_insert_rowid ? `, last id ${r.last_insert_rowid}` : ""}`,
-                `OK, ${r.affected_row_count} fila(s) afectadas${r.last_insert_rowid ? `, \xFAltimo id ${r.last_insert_rowid}` : ""}`
-              )
-            );
-          }
-        });
-      }
-    }
-  }
-};
-
-// src/commands/agents.ts
-import { existsSync as existsSync11, readFileSync as readFileSync12, statSync as statSync7 } from "fs";
-
 // src/api.ts
 import { EasybitsError as EasybitsError2, resolveBaseUrl as resolveBaseUrl4 } from "@easybits.cloud/sdk";
 async function api(ctx, method, path, body, opts = {}) {
@@ -2142,7 +1929,7 @@ async function api(ctx, method, path, body, opts = {}) {
 var encodePath = (p) => p.replace(/^\/+/, "").split("/").map(encodeURIComponent).join("/");
 
 // src/commands/agents-config.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync3, readFileSync as readFileSync9, readdirSync as readdirSync2, statSync as statSync5, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync8, readdirSync as readdirSync2, statSync as statSync4, writeFileSync as writeFileSync4 } from "fs";
 import { basename as basename3, dirname, join as join4, relative, resolve } from "path";
 var WORK_DIR = "/data/work";
 var MACHINE_TEMPLATES = /* @__PURE__ */ new Set(["ghosty-lite", "goose"]);
@@ -2222,8 +2009,8 @@ function readLocalText(path, usage2) {
     if (process.stdin.isTTY) throw usageError(t("Expected the content on stdin.", "Se esperaba el contenido por stdin."), usage2);
     return readStdin().then((b) => b.toString("utf8"));
   }
-  if (!existsSync8(path)) throw usageError(t(`File not found: ${path}`, `No existe el archivo: ${path}`), usage2);
-  return readFileSync9(path, "utf8");
+  if (!existsSync7(path)) throw usageError(t(`File not found: ${path}`, `No existe el archivo: ${path}`), usage2);
+  return readFileSync8(path, "utf8");
 }
 function parseMcpFile(text, usage2) {
   let j;
@@ -2379,6 +2166,7 @@ var set = {
         if (!Object.keys(changes).length) return console.log(t("No changes: the agent already has that prompt.", "Sin cambios: el agente ya tiene ese prompt."));
         for (const [k, v] of Object.entries(changes)) console.log(`${k}: ${v.from} \u2192 ${v.to}`);
         console.log(t("(dry run: nothing changed)", "(simulaci\xF3n: no cambi\xF3 nada)"));
+        console.log(applyHint(ctx));
       });
       return;
     }
@@ -2438,19 +2226,20 @@ var files2 = {
       if (!rest.length) throw usageError(t("Give one or more local files.", "Pasa uno o m\xE1s archivos locales."), FILES_USAGE2);
       const to = (str(ctx, "to") ?? "").replace(/^\/+|\/+$/g, "");
       const plan = rest.map((local) => {
-        if (!existsSync8(local) || !statSync5(local).isFile()) throw usageError(t(`File not found: ${local}`, `No existe el archivo: ${local}`), FILES_USAGE2);
-        return { local, path: to ? `${to}/${basename3(local)}` : basename3(local), bytes: statSync5(local).size };
+        if (!existsSync7(local) || !statSync4(local).isFile()) throw usageError(t(`File not found: ${local}`, `No existe el archivo: ${local}`), FILES_USAGE2);
+        return { local, path: to ? `${to}/${basename3(local)}` : basename3(local), bytes: statSync4(local).size };
       });
       if (bool(ctx, "dry-run")) {
         emit(ctx, { agentId: id, dryRun: true, upload: plan }, () => {
           for (const p of plan) console.log(`${p.local} \u2192 ${WORK_DIR}/${p.path} (${fmtBytes(p.bytes)})`);
           console.log(t("(dry run: nothing uploaded)", "(simulaci\xF3n: no se subi\xF3 nada)"));
+          console.log(applyHint(ctx));
         });
         return;
       }
       const done = [];
       for (const p of plan) {
-        const r = await api(ctx, "PUT", `/agents/${id}/files/${encodePath(p.path)}`, readFileSync9(p.local), { raw: true });
+        const r = await api(ctx, "PUT", `/agents/${id}/files/${encodePath(p.path)}`, readFileSync8(p.local), { raw: true });
         done.push({ local: p.local, ...r });
         if (!ctx.json) console.log(`${t("Uploaded", "Subido")} ${p.local} \u2192 ${WORK_DIR}/${p.path} (${fmtBytes(p.bytes)})`);
       }
@@ -2461,6 +2250,7 @@ var files2 = {
       if (bool(ctx, "dry-run")) {
         emit(ctx, { agentId: id, dryRun: true, delete: rest }, () => {
           for (const p of rest) console.log(`${t("would delete", "borrar\xEDa")} ${WORK_DIR}/${p}`);
+          console.log(applyHint(ctx, { needsYes: true }));
         });
         return;
       }
@@ -2480,7 +2270,7 @@ function readSkillDir(dir) {
       if (e.name.startsWith(".") || e.name === "node_modules") continue;
       const p = join4(d, e.name);
       if (e.isDirectory()) visit(p);
-      else if (e.isFile() && relative(dir, p) !== "SKILL.md") assets.push({ name: relative(dir, p).split("\\").join("/"), contentBase64: readFileSync9(p).toString("base64") });
+      else if (e.isFile() && relative(dir, p) !== "SKILL.md") assets.push({ name: relative(dir, p).split("\\").join("/"), contentBase64: readFileSync8(p).toString("base64") });
     }
   };
   visit(dir);
@@ -2544,8 +2334,8 @@ var skills = {
       const dir = str(ctx, "dir");
       if (!!file === !!dir) throw usageError(t("Pass --file SKILL.md or --dir <folder>.", "Pasa --file SKILL.md o --dir <carpeta>."), SKILLS_USAGE);
       const mdPath = file ?? join4(dir, "SKILL.md");
-      if (!existsSync8(mdPath)) throw usageError(t(`File not found: ${mdPath}`, `No existe el archivo: ${mdPath}`), SKILLS_USAGE);
-      const markdown = readFileSync9(mdPath, "utf8");
+      if (!existsSync7(mdPath)) throw usageError(t(`File not found: ${mdPath}`, `No existe el archivo: ${mdPath}`), SKILLS_USAGE);
+      const markdown = readFileSync8(mdPath, "utf8");
       const fm = skillFrontmatter(markdown);
       if (fm.error) throw usageError(`${mdPath}: ${fm.error}`, SKILLS_USAGE);
       const slug = str(ctx, "slug") ?? (fm.name && SLUG_RE.test(fm.name) ? fm.name : basename3(resolve(dir ?? dirname(mdPath))).toLowerCase());
@@ -2553,9 +2343,12 @@ var skills = {
       const assets = dir ? readSkillDir(dir) : [];
       const plan = { agentId: id, slug, files: ["SKILL.md", ...assets.map((a) => a.name)], restart: bool(ctx, "restart") };
       if (bool(ctx, "dry-run")) {
-        emit(ctx, { ...plan, dryRun: true }, () => console.log(t(`would add skill ${slug} (${plan.files.length} file(s))${plan.restart ? " and restart" : ""}
+        emit(ctx, { ...plan, dryRun: true }, () => {
+          console.log(t(`would add skill ${slug} (${plan.files.length} file(s))${plan.restart ? " and restart" : ""}
 (dry run: nothing changed)`, `agregar\xEDa la skill ${slug} (${plan.files.length} archivo(s))${plan.restart ? " y reiniciar\xEDa" : ""}
-(simulaci\xF3n: no cambi\xF3 nada)`)));
+(simulaci\xF3n: no cambi\xF3 nada)`));
+          console.log(applyHint(ctx));
+        });
         return;
       }
       const r = await api(ctx, "PUT", `/agents/${id}/skills/${slug}`, { markdown, assets });
@@ -2568,7 +2361,10 @@ var skills = {
       const slugs = ctx.args.slice(2);
       if (!slugs.length) throw usageError(t("Give one or more slugs.", "Pasa uno o m\xE1s slugs."), SKILLS_USAGE);
       if (bool(ctx, "dry-run")) {
-        emit(ctx, { agentId: id, dryRun: true, delete: slugs }, () => slugs.forEach((s) => console.log(`${t("would remove skill", "quitar\xEDa la skill")} ${s}`)));
+        emit(ctx, { agentId: id, dryRun: true, delete: slugs }, () => {
+          slugs.forEach((s) => console.log(`${t("would remove skill", "quitar\xEDa la skill")} ${s}`));
+          console.log(applyHint(ctx, { needsYes: true }));
+        });
         return;
       }
       requireYesIfHeadless(ctx);
@@ -2632,6 +2428,7 @@ var mcp2 = {
 removed: ${diff.removed.join(", ") || "-"}
 changed: ${diff.changed.join(", ") || "-"}`);
         console.log(t("(dry run: nothing changed; a real set restarts the agent)", "(simulaci\xF3n: no cambi\xF3 nada; un set de verdad reinicia el agente)"));
+        console.log(applyHint(ctx));
       });
       return;
     }
@@ -2805,10 +2602,10 @@ var exportAgent = {
   }
 };
 function readExport(path, usage2) {
-  if (!existsSync8(path)) throw usageError(t(`File not found: ${path}`, `No existe el archivo: ${path}`), usage2);
+  if (!existsSync7(path)) throw usageError(t(`File not found: ${path}`, `No existe el archivo: ${path}`), usage2);
   let x;
   try {
-    x = JSON.parse(readFileSync9(path, "utf8"));
+    x = JSON.parse(readFileSync8(path, "utf8"));
   } catch (e) {
     throw usageError(t(`${path} is not JSON: ${e.message}`, `${path} no es JSON: ${e.message}`), usage2);
   }
@@ -2852,13 +2649,381 @@ async function applyExport(ctx, id, x, opts) {
   return copied;
 }
 
-// src/commands/spec.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync4, readFileSync as readFileSync11, statSync as statSync6, writeFileSync as writeFileSync5 } from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname as dirname2, join as join6, resolve as resolve2 } from "path";
+// src/db-name-refs.ts
+var EDGE = "A-Za-z0-9_.@/-";
+var escape2 = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var nameRe = (name) => new RegExp(`(?<![${EDGE}])${escape2(name)}(?![${EDGE}])`, "g");
+function findNameRefs(text, name) {
+  const re = nameRe(name);
+  return text.split("\n").flatMap((l, i) => {
+    re.lastIndex = 0;
+    return re.test(l) ? [{ line: i + 1, text: l.trim().slice(0, 160) }] : [];
+  });
+}
+function replaceName(text, from, to) {
+  return text.replace(nameRe(from), to);
+}
 
-// src/specfile.ts
-import { existsSync as existsSync9, readFileSync as readFileSync10, readdirSync as readdirSync3 } from "fs";
+// src/commands/db.ts
+async function findDb(ctx, id) {
+  const hit = (await listRefs(ctx, "db")).find((d) => d.id === id);
+  if (!hit) throw new CliError(t(`No database "${id}".`, `No existe la base "${id}".`), 1, t("List them with: easybits db ls", "Enl\xEDstalas con: easybits db ls"), "not_found", 404);
+  return { id, name: hit.name ?? id };
+}
+var ident2 = (n) => `"${n.replace(/"/g, '""')}"`;
+async function tableCounts(ctx, id) {
+  const eb = await getClient(ctx);
+  const q = (sql) => eb.queryDatabase(id, sql);
+  const names = (await q("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '_litestream_%' AND name NOT LIKE '_easybits_%' ORDER BY name")).rows.map((r) => String(r[0]));
+  const out = [];
+  for (const name of names) out.push({ name, rows: Number((await q(`SELECT count(*) FROM ${ident2(name)}`)).rows[0]?.[0] ?? 0) });
+  return out;
+}
+async function promptRefs(ctx, name) {
+  const eb = await getClient(ctx);
+  const found = [];
+  const skipped = [];
+  for (const a of await eb.listAgents()) {
+    if (!MACHINE_TEMPLATES.has(a.template)) continue;
+    const agent = a.name ?? a.agentId;
+    if (a.status === "lost" || a.status === "error") {
+      skipped.push({ agentId: a.agentId, agent, reason: a.status });
+      continue;
+    }
+    try {
+      const p = await api(ctx, "GET", `/agents/${a.agentId}/prompt`);
+      const refs = findNameRefs(p.systemPrompt ?? "", name);
+      if (refs.length) found.push({ agentId: a.agentId, agent, refs });
+    } catch (e) {
+      skipped.push({ agentId: a.agentId, agent, reason: e.message });
+    }
+  }
+  return { found, skipped };
+}
+var db = {
+  name: "db",
+  aliases: ["databases", "database"],
+  group: "Data",
+  summary: "SQL databases (libSQL)",
+  synopsis: "db",
+  subs: {
+    ls: {
+      aliases: ["list"],
+      summary: "List your databases",
+      usage: "easybits db ls",
+      examples: ["easybits db ls --json"],
+      async run(ctx) {
+        const eb = await getClient(ctx);
+        const { items } = await eb.listDatabases();
+        emit(
+          ctx,
+          items,
+          () => table(
+            items.map((d) => ({ ...d, createdAt: fmtDate(d.createdAt) })),
+            [["id", "ID"], ["name", "NAME"], ["createdAt", "CREATED"], ["description", "DESCRIPTION"]],
+            t("No databases. Create one: easybits db create <name>", "No hay bases. Crea una: easybits db create <nombre>")
+          )
+        );
+      }
+    },
+    create: {
+      summary: "Create a database",
+      usage: "easybits db create <name> [--description <text>]",
+      options: { description: { type: "string", value: "text", description: "What it is for" } },
+      examples: ["easybits db create leads --description 'CRM leads'"],
+      async run(ctx) {
+        const name = need(ctx, 0, "name", this.usage);
+        const eb = await getClient(ctx);
+        const d = await eb.createDatabase({ name, description: str(ctx, "description") });
+        emit(ctx, d, () => console.log(t(`Created ${d.name} (${d.id})`, `Creada ${d.name} (${d.id})`)));
+      }
+    },
+    rm: {
+      aliases: ["delete", "drop"],
+      summary: "Delete a database (irreversible)",
+      usage: "easybits db rm <db-id|name> [--dry-run] [--yes]",
+      options: { "dry-run": { type: "boolean", description: "Show its tables and rows; delete nothing" }, ...YES_OPTION },
+      examples: [
+        "easybits db rm leads --dry-run  # what would be lost",
+        "easybits db rm leads            # asks you to type the name",
+        "easybits db rm leads --yes      # scripts and agents"
+      ],
+      async run(ctx) {
+        const ref = need(ctx, 0, "db-id|name", this.usage);
+        if (bool(ctx, "dry-run")) {
+          const hit2 = await findDb(ctx, ref);
+          const tables = await tableCounts(ctx, hit2.id);
+          const rows = tables.reduce((n, x) => n + x.rows, 0);
+          emit(ctx, { id: hit2.id, name: hit2.name, dryRun: true, tables }, () => {
+            console.log(t(`${hit2.name} (${hit2.id}): ${tables.length} table(s), ${rows} row(s)`, `${hit2.name} (${hit2.id}): ${tables.length} tabla(s), ${rows} fila(s)`));
+            for (const x of tables) console.log(`  ${x.name}: ${x.rows}`);
+            console.log(t("(dry run: nothing deleted)", "(simulaci\xF3n: no se borr\xF3 nada)"));
+            console.log(applyHint(ctx, { needsYes: true }));
+          });
+          return;
+        }
+        requireYesIfHeadless(ctx);
+        const eb = await getClient(ctx);
+        const hit = await findDb(ctx, ref);
+        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})`)));
+      }
+    },
+    rename: {
+      aliases: ["mv"],
+      summary: "Rename a database and rewrite the agent prompts that name it",
+      usage: "easybits db rename <db-id|name> <new-name> [--skip-prompts] [--dry-run]",
+      options: {
+        "skip-prompts": { type: "boolean", description: "Rename only; leave your agents' prompts as they are" },
+        "dry-run": { type: "boolean", description: "Show the prompts that name it; change nothing" }
+      },
+      examples: [
+        "easybits db rename totequim catalogo --dry-run   # which prompts name it",
+        "easybits db rename totequim catalogo",
+        "easybits db rename totequim catalogo --skip-prompts --json"
+      ],
+      // El id no cambia (las tools db_* van por id). Se reescribe el nombre como palabra suelta:
+      // `totequim.com`, `@totequim`, `totequim_prueba` y «TOTEQUIM» se quedan (db-name-refs.ts).
+      async run(ctx) {
+        const ref = need(ctx, 0, "db-id|name", this.usage);
+        const to = need(ctx, 1, "new-name", this.usage).trim();
+        if (!/^[a-zA-Z0-9_-]{1,64}$/.test(to)) throw usageError(t("The name takes letters, digits, - and _ (max 64).", "El nombre lleva letras, d\xEDgitos, - y _ (m\xE1x 64)."), this.usage);
+        const hit = await findDb(ctx, ref);
+        const from = hit.name;
+        if (to === from) throw usageError(t(`${from} already has that name.`, `${from} ya se llama as\xED.`), this.usage);
+        const taken = (await listRefs(ctx, "db")).find((d) => d.name === to);
+        if (taken) throw new CliError(t(`A database named "${to}" already exists (${taken.id}).`, `Ya hay una base "${to}" (${taken.id}).`), 1, void 0, "conflict", 409);
+        const scan = bool(ctx, "skip-prompts") ? { found: [], skipped: [] } : await promptRefs(ctx, from);
+        const base = { id: hit.id, from, to, references: scan.found, skipped: scan.skipped };
+        const printRefs = () => {
+          if (bool(ctx, "skip-prompts")) return console.log(t("Prompts not checked (--skip-prompts).", "Prompts sin revisar (--skip-prompts)."));
+          if (!scan.found.length) console.log(t("No agent prompt names it.", "Ning\xFAn prompt de tus agentes la nombra."));
+          else console.log(t(`Named in ${scan.found.length} prompt(s):`, `La nombran ${scan.found.length} prompt(s):`));
+          for (const r of scan.found) {
+            console.log(`  ${r.agent} (${r.agentId})`);
+            for (const l of r.refs.slice(0, 3)) console.log(`    ${l.line}: ${l.text}`);
+            if (r.refs.length > 3) console.log(t(`    \u2026 +${r.refs.length - 3} more`, `    \u2026 +${r.refs.length - 3} m\xE1s`));
+          }
+          for (const x of scan.skipped) console.log(t(`  ! ${x.agent} (${x.agentId}) not checked: ${x.reason}`, `  ! ${x.agent} (${x.agentId}) sin revisar: ${x.reason}`));
+        };
+        if (bool(ctx, "dry-run")) {
+          emit(ctx, { ...base, dryRun: true }, () => {
+            console.log(`${from} \u2192 ${to}`);
+            printRefs();
+            console.log(t("(dry run: nothing changed; without --dry-run those prompts are rewritten too)", "(simulaci\xF3n: no cambi\xF3 nada; sin --dry-run tambi\xE9n se reescriben esos prompts)"));
+            console.log(applyHint(ctx));
+          });
+          return;
+        }
+        await api(ctx, "PATCH", `/databases/${hit.id}`, { name: to });
+        const rewritten = [];
+        const failed = [];
+        for (const r of scan.found) {
+          try {
+            const cur = await api(ctx, "GET", `/agents/${r.agentId}/prompt`);
+            await api(ctx, "PATCH", `/agents/${r.agentId}`, { systemPrompt: replaceName(cur.systemPrompt, from, to) });
+            rewritten.push(r.agentId);
+          } catch (e) {
+            failed.push({ agentId: r.agentId, error: e.message });
+          }
+        }
+        emit(ctx, { ...base, dryRun: false, rewritten, failed }, () => {
+          console.log(t(`Renamed ${from} \u2192 ${to} (${hit.id}). ${rewritten.length} prompt(s) rewritten.`, `Renombrada ${from} \u2192 ${to} (${hit.id}). ${rewritten.length} prompt(s) reescritos.`));
+          for (const f of failed) console.error(`! ${f.agentId}: ${f.error}`);
+          for (const x of scan.skipped) console.log(t(`! ${x.agent} (${x.agentId}) not checked: ${x.reason}`, `! ${x.agent} (${x.agentId}) sin revisar: ${x.reason}`));
+          console.log(`${t("Undo", "Deshacer")}: easybits db rename ${to} ${from}`);
+        });
+        if (failed.length) process.exitCode = 1;
+      }
+    },
+    tables: {
+      aliases: ["inspect", "schema"],
+      summary: "List tables with row counts and columns, and how many links are permanent",
+      usage: "easybits db tables <db-id|name>",
+      examples: ["easybits db tables leads", "easybits db tables leads --json"],
+      // Patrón de `turso db inspect` / `.tables` + `.schema` de sqlite3, en una sola vista.
+      async run(ctx) {
+        const ref = need(ctx, 0, "db-id|name", this.usage);
+        const eb = await getClient(ctx);
+        const hit = await findDb(ctx, ref);
+        const q = (sql, args) => eb.queryDatabase(hit.id, sql, args);
+        const names = (await q("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '_litestream_%' ORDER BY name")).rows.map((r) => String(r[0]));
+        const tables = [];
+        for (const name of names) {
+          const info2 = await q(`PRAGMA table_info(${ident2(name)})`);
+          const col = (k) => info2.cols.indexOf(k);
+          const columns = info2.rows.map((r) => ({ name: String(r[col("name")]), type: String(r[col("type")] ?? ""), pk: Number(r[col("pk")]) > 0 }));
+          const count = await q(`SELECT count(*) FROM ${ident2(name)}`);
+          const textCols = columns.filter((c) => !c.type || /CHAR|TEXT|CLOB/i.test(c.type)).map((c) => c.name);
+          const links = textCols.length ? parseLinkStats(textCols, (await q(linkStatsSql(name, textCols))).rows[0] ?? []) : [];
+          tables.push({ name, rows: Number(count.rows[0]?.[0] ?? 0), columns, links });
+        }
+        emit(ctx, tables, () => {
+          table(
+            tables.map((t2) => ({
+              name: t2.name,
+              rows: t2.rows,
+              columns: t2.columns.map((c) => `${c.name}${c.type ? ` ${c.type}` : ""}${c.pk ? " PK" : ""}`).join(", ")
+            })),
+            [["name", "TABLE"], ["rows", "ROWS"], ["columns", "COLUMNS"]],
+            t(`No tables in ${hit.name}. Create one: easybits db query ${hit.name} 'CREATE TABLE \u2026'`, `No hay tablas en ${hit.name}. Crea una: easybits db query ${hit.name} 'CREATE TABLE \u2026'`)
+          );
+          const withLinks = tables.flatMap((tb) => tb.links.map((l) => ({ ...l, table: tb.name })));
+          if (withLinks.length) {
+            console.log("\n" + t("Links (permanent = EasyBits public storage; expiring = signed URL):", "Ligas (permanente = almacenamiento p\xFAblico de EasyBits; caduca = URL firmada):"));
+            table(
+              withLinks.map((l) => ({ where: `${l.table}.${l.column}`, permanent: l.permanent, expiring: l.expiring, external: l.external, empty: l.empty })),
+              [["where", "COLUMN"], ["permanent", "PERMANENT"], ["expiring", "EXPIRING"], ["external", "EXTERNAL"], ["empty", "EMPTY"]]
+            );
+            if (withLinks.some((l) => l.external + l.expiring > 0)) {
+              console.log(t("Make them permanent: easybits db photos put <db> --table T --key-column sku --dir photos/", "Hazlas permanentes: easybits db photos put <db> --table T --key-column sku --dir fotos/"));
+            }
+          }
+        });
+      }
+    },
+    photos: {
+      summary: "Put catalog photos in a table: SKU-123.jpg \u2192 the row whose key is SKU-123, as a permanent public link",
+      usage: "easybits db photos put <db> --table <table> --key-column <col> --dir <folder> [--column <col>] [--replace] [--dry-run]",
+      options: {
+        table: { type: "string", value: "table", description: "Table to update" },
+        "key-column": { type: "string", value: "col", description: "Column that matches the file name (e.g. sku)" },
+        dir: { type: "string", value: "folder", description: "Folder with the photos (JPEG, PNG or WebP, max 10 MB each)" },
+        column: { type: "string", value: "col", description: "Column for the link (default: image_url, photo_url, imagen\u2026)" },
+        replace: { type: "boolean", description: "Also replace rows that already have a permanent link" },
+        "dry-run": { type: "boolean", description: "Show the plan; upload nothing" }
+      },
+      examples: [
+        "easybits db photos put catalogo --table productos --key-column sku --dir fotos/ --dry-run",
+        "easybits db photos put catalogo --table productos --key-column sku --dir fotos/ --column foto",
+        "easybits db tables catalogo                  # how many links are permanent, external or empty"
+      ],
+      async run(ctx) {
+        const action = need(ctx, 0, "put", this.usage);
+        if (action !== "put") throw usageError(t(`Unknown photos action "${action}".`, `Acci\xF3n de photos desconocida "${action}".`), this.usage);
+        const ref = need(ctx, 1, "db", this.usage);
+        const tableName = str(ctx, "table");
+        const keyCol = str(ctx, "key-column");
+        const dir = str(ctx, "dir");
+        if (!tableName || !keyCol || !dir) throw usageError(t("Missing --table, --key-column or --dir.", "Faltan --table, --key-column o --dir."), this.usage);
+        if (!existsSync8(dir) || !statSync5(dir).isDirectory()) throw usageError(t(`Not a folder: ${dir}`, `No es una carpeta: ${dir}`), this.usage);
+        const { photos, rejected } = photoFiles(dir);
+        const eb = await getClient(ctx);
+        const hit = await findDb(ctx, ref);
+        const q = (sql, args) => eb.queryDatabase(hit.id, sql, args);
+        const info2 = await q(`PRAGMA table_info(${ident2(tableName)})`);
+        const cols = info2.rows.map((r) => String(r[info2.cols.indexOf("name")]));
+        if (!cols.length) throw new CliError(t(`No table "${tableName}" in ${hit.name}.`, `No hay tabla "${tableName}" en ${hit.name}.`), 1, t(`See: easybits db tables ${hit.name}`, `Mira: easybits db tables ${hit.name}`), "not_found", 404);
+        if (!cols.includes(keyCol)) throw usageError(t(`No column "${keyCol}" in ${tableName} (${cols.join(", ")}).`, `No hay columna "${keyCol}" en ${tableName} (${cols.join(", ")}).`), this.usage);
+        const column = str(ctx, "column") ?? defaultPhotoColumn(cols);
+        if (!column) throw usageError(t(`${tableName} has no photo column: pass --column (${cols.join(", ")}).`, `${tableName} no tiene columna de foto: pasa --column (${cols.join(", ")}).`), this.usage);
+        if (!cols.includes(column)) throw usageError(t(`No column "${column}" in ${tableName} (${cols.join(", ")}).`, `No hay columna "${column}" en ${tableName} (${cols.join(", ")}).`), this.usage);
+        const current2 = /* @__PURE__ */ new Map();
+        for (let i = 0; i < photos.length; i += 100) {
+          const keys = photos.slice(i, i + 100).map((p) => p.key);
+          const r = await q(`SELECT ${ident2(keyCol)}, ${ident2(column)} FROM ${ident2(tableName)} WHERE ${ident2(keyCol)} IN (${keys.map(() => "?").join(",")})`, keys);
+          for (const row of r.rows) current2.set(String(row[0]), row[1]);
+        }
+        const plan = planPhotos(photos, current2, bool(ctx, "replace"));
+        const big = photos.filter((p) => p.bytes > WHATSAPP_MAX_BYTES).map((p) => p.file);
+        const summary = { db: hit.name, table: tableName, keyColumn: keyCol, column, plan, rejected, overWhatsappLimit: big };
+        const count = (a) => plan.filter((p) => p.action === a).length;
+        const why = (r) => r === "not_an_image" ? t("not a JPEG/PNG/WebP", "no es JPEG/PNG/WebP") : r === "too_large" ? t("over 10 MB", "m\xE1s de 10 MB") : t("empty file", "archivo vac\xEDo");
+        const printPlan2 = () => {
+          for (const p of plan) {
+            const what = p.action === "update" ? t("update", "actualizar") : p.action === "keep" ? t("keep (already permanent; --replace to redo)", "se queda (ya es permanente; --replace para rehacerla)") : t("no row with that key", "no hay fila con esa llave");
+            console.log(`${p.action === "update" ? "~" : "!"} ${p.file} \u2192 ${keyCol}=${p.key}: ${what}`);
+          }
+          for (const r of rejected) console.log(`! ${r.file}: ${why(r.reason)}`);
+          if (big.length) console.log(t(`Over 5 MB (WhatsApp won't send them by link): ${big.join(", ")}`, `M\xE1s de 5 MB (WhatsApp no las manda por liga): ${big.join(", ")}`));
+        };
+        if (bool(ctx, "dry-run") || !count("update")) {
+          emit(ctx, { ...summary, dryRun: bool(ctx, "dry-run") }, () => {
+            printPlan2();
+            console.log(count("update") ? t("(dry run: nothing uploaded)", "(simulaci\xF3n: no se subi\xF3 nada)") : t("Nothing to update.", "Nada que actualizar."));
+          });
+          return;
+        }
+        const urls = /* @__PURE__ */ new Map();
+        const results = [];
+        for (const item of plan.filter((p) => p.action === "update")) {
+          const photo = photos.find((p) => p.key === item.key);
+          try {
+            let url = urls.get(photo.sha);
+            if (!url) {
+              const up = await eb.uploadFile({ fileName: `${photo.sha.slice(0, 32)}.${photo.ext}`, contentType: photo.mime, size: photo.bytes, access: "public" });
+              const res = await fetch(up.putUrl, { method: "PUT", body: readFileSync9(photo.path), headers: { "Content-Type": photo.mime } });
+              if (!res.ok) throw new Error(t(`storage answered ${res.status}`, `el almacenamiento contest\xF3 ${res.status}`));
+              url = up.file.url;
+              if (!url) throw new Error(t("the API returned no public link", "la API no devolvi\xF3 liga p\xFAblica"));
+              urls.set(photo.sha, url);
+            }
+            await q(`UPDATE ${ident2(tableName)} SET ${ident2(column)} = ? WHERE ${ident2(keyCol)} = ?`, [url, item.key]);
+            results.push({ key: item.key, file: item.file, url });
+            if (!ctx.json) console.log(`~ ${item.file} \u2192 ${keyCol}=${item.key}: ${url}`);
+          } catch (e) {
+            results.push({ key: item.key, file: item.file, error: e.message });
+            if (!ctx.json) console.error(`! ${item.file}: ${e.message}`);
+          }
+        }
+        const failed = results.filter((r) => r.error).length;
+        emit(ctx, { ...summary, results }, () => {
+          for (const p of plan.filter((x) => x.action !== "update")) console.log(`! ${p.file} \u2192 ${keyCol}=${p.key}: ${p.action === "keep" ? t("kept", "se qued\xF3") : t("no row with that key", "no hay fila con esa llave")}`);
+          for (const r of rejected) console.log(`! ${r.file}: ${why(r.reason)}`);
+          console.log(t(`Updated ${results.length - failed} row(s)${failed ? `, ${failed} failed` : ""}.`, `${results.length - failed} fila(s) actualizadas${failed ? `, ${failed} fallaron` : ""}.`));
+        });
+        if (failed) process.exitCode = 1;
+      }
+    },
+    query: {
+      aliases: ["sql"],
+      summary: "Run one SQL statement (by database id or name)",
+      usage: "easybits db query <db-id|name> <sql> [--arg <value>]...",
+      options: { arg: { type: "string", multiple: true, value: "value", description: "Positional ? parameter (repeatable)" } },
+      examples: [
+        "easybits db query leads 'SELECT * FROM leads LIMIT 10'",
+        "easybits db query leads 'INSERT INTO leads(name) VALUES (?)' --arg Ana",
+        "easybits db query leads 'SELECT count(*) AS n FROM leads' --json"
+      ],
+      async run(ctx) {
+        const ref = need(ctx, 0, "db-id|name", this.usage);
+        const sql = need(ctx, 1, "sql", this.usage);
+        const eb = await getClient(ctx);
+        const hit = await findDb(ctx, ref);
+        const args = list(ctx, "arg");
+        const r = await eb.queryDatabase(hit.id, sql, args.length ? args : void 0);
+        emit(ctx, r, () => {
+          if (r.cols.length) {
+            table(
+              r.rows.map((row) => Object.fromEntries(r.cols.map((c, i) => [c, row[i]]))),
+              r.cols.map((c) => [c, c]),
+              "(0 rows)"
+            );
+          } else {
+            console.log(
+              t(
+                `OK, ${r.affected_row_count} row(s) affected${r.last_insert_rowid ? `, last id ${r.last_insert_rowid}` : ""}`,
+                `OK, ${r.affected_row_count} fila(s) afectadas${r.last_insert_rowid ? `, \xFAltimo id ${r.last_insert_rowid}` : ""}`
+              )
+            );
+          }
+        });
+      }
+    }
+  }
+};
+
+// src/commands/agents.ts
+import { existsSync as existsSync11, readFileSync as readFileSync12, statSync as statSync7 } from "fs";
+
+// src/commands/spec.ts
+import { existsSync as existsSync10, mkdirSync as mkdirSync4, readFileSync as readFileSync11, statSync as statSync6, writeFileSync as writeFileSync5 } from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname2, join as join6, resolve as resolve2 } from "path";
+
+// src/specfile.ts
+import { existsSync as existsSync9, readFileSync as readFileSync10, readdirSync as readdirSync3 } from "fs";
 import { join as join5, relative as relative2 } from "path";
 function walkLocal(root) {
   const out = [];
@@ -2990,6 +3155,7 @@ async function applyTarget(ctx, target, o) {
         for (const s of Object.keys(uploads.skills ?? {})) console.log(`+ skill ${s}`);
         for (const f of Object.keys(uploads.files ?? {})) console.log(`+ file ${f}`);
         console.log(t("(dry run: nothing created)", "(simulaci\xF3n: no se cre\xF3 nada)"));
+        console.log(applyHint(ctx));
       });
       return;
     }
@@ -3030,6 +3196,7 @@ async function applyTarget(ctx, target, o) {
       console.log(
         actionable.length ? t("(dry run: nothing changed)", "(simulaci\xF3n: no cambi\xF3 nada)") : plan.plan.length ? t("Nothing to apply (see the ! lines).", "Nada que aplicar (mira los renglones con !).") : t("No changes: the agent already matches the file.", "Sin cambios: el agente ya coincide con el archivo.")
       );
+      if (o.dryRun && actionable.length) console.log(applyHint(ctx, { needsYes: true }));
     });
     return;
   }
@@ -3195,6 +3362,7 @@ var agents = {
             for (const [k, v] of Object.entries(plan)) console.log(`${k.padEnd(12)} ${Array.isArray(v) ? v.join(", ") || "-" : v ?? "-"}`);
             if (source) console.log(t("Env is never copied: pass the engine's keys with --dotenv.", "El env nunca se copia: pasa las llaves del motor con --dotenv."));
             console.log(t("(dry run: nothing created)", "(simulaci\xF3n: no se cre\xF3 nada)"));
+            console.log(applyHint(ctx));
           });
           return;
         }
@@ -3212,6 +3380,10 @@ var agents = {
           console.log(`${t("Agent:  ", "Agente: ")} ${a.agentId}`);
           console.log(`Sandbox: ${a.sandboxId}`);
           console.log(`URL:     ${a.agentUrl}`);
+          if (prompt) {
+            const origin = promptFile ?? (promptInline != null ? "--prompt" : `${t("from", "de")} ${source?.source.agentId ?? "export"}`);
+            console.log(`Prompt:  ${origin}, ${prompt.length.toLocaleString("en-US")} ${t("chars", "caracteres")}`);
+          }
           if (copied) console.log(t(`Copied:  ${copied.skills.length} skill(s), ${copied.files.length} file(s)${copied.skippedFiles.length ? ` (${copied.skippedFiles.length} skipped: export without --with-files)` : ""}`, `Copiado: ${copied.skills.length} skill(s), ${copied.files.length} archivo(s)${copied.skippedFiles.length ? ` (${copied.skippedFiles.length} sin copiar: export sin --with-files)` : ""}`));
           console.log(t(`Talk to it: easybits agents try ${a.agentId} "hello"`, `H\xE1blale: easybits agents try ${a.agentId} "hola"`));
         });
@@ -3446,7 +3618,7 @@ import { mkdirSync as mkdirSync6, readFileSync as readFileSync14, writeFileSync
 import { homedir as homedir5 } from "os";
 import { dirname as dirname4, join as join8 } from "path";
 var FILE = join8(process.env.XDG_CONFIG_HOME || join8(homedir5(), ".config"), "easybits", "update.json");
-var DAY = 24 * 60 * 60 * 1e3;
+var TTL = 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @easybits.cloud/cli@latest";
 function newer(a, b) {
   const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
@@ -3474,10 +3646,14 @@ async function fetchLatest(timeoutMs = 1500) {
     return null;
   }
 }
-async function latestVersion() {
+function cacheFresh(c, current2, now = Date.now()) {
+  if (!c.latest || !c.checkedAt || now - c.checkedAt >= TTL) return false;
+  return !(current2 && current2 !== "dev" && newer(current2, c.latest));
+}
+async function latestVersion(current2) {
   if (updateCheckDisabled()) return null;
   const c = readCache();
-  if (c.latest && c.checkedAt && Date.now() - c.checkedAt < DAY) return c.latest;
+  if (cacheFresh(c, current2)) return c.latest;
   return await fetchLatest() ?? c.latest ?? null;
 }
 function cachedNewer(current2) {
@@ -3487,12 +3663,12 @@ function cachedNewer(current2) {
 }
 async function updateNotice(current2) {
   if (current2 === "dev") return null;
-  const latest = await latestVersion();
+  const latest = await latestVersion(current2);
   return latest && newer(latest, current2) ? t(`Update available: ${current2} \u2192 ${latest}. Run: ${UPGRADE}`, `Hay versi\xF3n nueva: ${current2} \u2192 ${latest}. Corre: ${UPGRADE}`) : null;
 }
 
 // src/commands/doctor.ts
-var VERSION = true ? "0.14.1" : "dev";
+var VERSION = true ? "0.15.1" : "dev";
 var doctor2 = {
   name: "doctor",
   group: "Account",
@@ -3762,6 +3938,12 @@ var HELP_ES = {
   "Create a database": "Crea una base de datos",
   "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",
+  "what would be lost": "lo que se perder\xEDa",
+  "Rename a database and rewrite the agent prompts that name it": "Renombra una base y reescribe los prompts de agentes que la nombran",
+  "Rename only; leave your agents' prompts as they are": "S\xF3lo renombra; deja los prompts de tus agentes como est\xE1n",
+  "Show the prompts that name it; change nothing": "Ense\xF1a los prompts que la nombran; no cambia nada",
+  "which prompts name it": "qu\xE9 prompts la nombran",
   "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",
@@ -3990,7 +4172,7 @@ function normalizeArgs(input) {
 }
 
 // src/index.ts
-var VERSION2 = true ? "0.14.1" : "dev";
+var VERSION2 = true ? "0.15.1" : "dev";
 var GLOBAL_OPTIONS = {
   json: { type: "boolean" },
   token: { type: "string" },

package/package.json

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