@ghostystudio/cli 0.20.0 → 0.21.0

package/README.md

@@ -90,6 +90,10 @@ Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 - `try --replay FILE --out DIR`: replays real conversations from your machine. The report is written after every step, survives Ghosty deploys (it honors `Retry-After`), and `--resume` continues a partial run.
 - `agents doctor` speaks English like the rest of the CLI; `channels whatsapp ls` returns a full URL.
 
+### Changes in 0.21.0
+
+- Catalog photos: `dbs tables` shows, per photo/link column, how many links are permanent (img.ghosty.studio), external or empty; `dbs import` warns before replacing permanent links with external ones (and gives the exact `--rehost-images`); `dbs photos put <agent> <db> --table T --key-column sku --dir photos/` uploads loose photos (SKU-123.jpg → its row) to permanent links, with `--dry-run`.
+
 ### Changes in 0.20.0
 
 - **Your language.** Spanish with a Spanish locale (`LANG=es_*`), English otherwise; `--lang es|en` or `GHOSTY_LANG` forces it. The server's messages are translated to English too. `--json` output is unchanged.

package/dist/index.js

@@ -7569,6 +7569,11 @@ var SERVER_MESSAGES = [
   ["el almacenamiento no est\xE1 configurado", "storage isn't configured"],
   ["storage sin configurar (TIGRIS_*/STORAGE_*)", "storage not configured (TIGRIS_*/STORAGE_*)"],
   ["storage sin configurar", "storage not configured"],
+  // — Fotos sueltas de un catálogo (`dbs photos put`)
+  ["items: de 1 a 20 fotos por petici\xF3n", "items: 1 to 20 photos per request"],
+  ["no es JPEG/PNG/WebP", "not a JPEG/PNG/WebP"],
+  ["pasa de 10 MB", "larger than 10 MB"],
+  ["table, keyColumn y column: nombres v\xE1lidos", "table, keyColumn and column: valid names"],
   ["no es JPEG/PNG/WebP ({})", "not JPEG/PNG/WebP ({})"],
   ["no se pudo bajar (respuesta vac\xEDa, no 2xx o m\xE1s de 10 MB)", "couldn't download (empty response, not 2xx or over 10 MB)"],
   ["no se pudo bajar: {}", "couldn't download: {}"],
@@ -8248,7 +8253,7 @@ async function postLong(path, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.20.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.21.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8290,7 +8295,7 @@ async function request(path, opts = {}, retried = false) {
     method: opts.method ?? (opts.body !== void 0 || opts.raw !== void 0 ? "POST" : "GET"),
     headers: {
       authorization: `Bearer ${token}`,
-      "user-agent": `ghosty-cli/${"0.20.0"}`,
+      "user-agent": `ghosty-cli/${"0.21.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9278,7 +9283,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.20.0"}`
+        "user-agent": `ghosty-cli/${"0.21.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -9444,8 +9449,8 @@ async function partnerCmd(sub, a1, a2, v) {
 }
 
 // src/commands/data.ts
-import { readFile as readFile6 } from "node:fs/promises";
-import { basename as basename3 } from "node:path";
+import { readdir as readdir2, readFile as readFile6 } from "node:fs/promises";
+import { basename as basename3, join as join4 } from "node:path";
 
 // src/rows.ts
 var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -9473,6 +9478,21 @@ var need2 = (v, what, example) => {
   return v;
 };
 var csv = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+function importWarnings(ws) {
+  if (!ws?.length) return "";
+  const flag = ws.map((w) => `${w.table}.${w.column}`).join(",");
+  const lines = ws.map(
+    (w) => red(
+      t(
+        `  ! ${w.table}.${w.column}: ${w.permanent} permanent photo link(s) would go back to ${w.incomingExternal} external link(s)`,
+        `  ! ${w.table}.${w.column}: ${w.permanent} liga(s) de foto permanentes volver\xEDan a ${w.incomingExternal} liga(s) de fuera`
+      )
+    )
+  );
+  return `
+${lines.join("\n")}
+${dim(t(`Keep them permanent: add --rehost-images ${flag}`, `Para que sigan permanentes: agrega --rehost-images ${flag}`))}`;
+}
 function planText(plan) {
   return plan.map((p) => p.action === "create" ? t(`  + ${p.table}  create, ${p.sourceRows} row(s)`, `  + ${p.table}  crear, ${p.sourceRows} fila(s)`) : t(`  ~ ${p.table}  ${p.action} ${p.targetRows} \u2192 ${p.resultRows} row(s)`, `  ~ ${p.table}  ${p.action === "replace" ? "reemplazar" : "agregar"} ${p.targetRows} \u2192 ${p.resultRows} fila(s)`)).join("\n");
 }
@@ -9486,10 +9506,10 @@ async function dbsImport(id, db, v) {
   const path = agentPath2(id, `/dbs/${enc6(db)}/import`);
   const dry = await api(path, { body: { ...body, dryRun: true } });
   if (v["dry-run"]) return out(dry, () => `${dry.db} \u2190 easybits:${m[1]}
-${planText(dry.plan)}
+${planText(dry.plan)}${importWarnings(dry.warnings)}
 ${dim(t("Dry run: nothing changed.", "Simulaci\xF3n: no cambi\xF3 nada."))}`);
   const destructive = dry.plan.some((p) => p.action === "replace" && p.targetRows > 0);
-  if (destructive) await confirm(`${planText(dry.plan)}
+  if (destructive) await confirm(`${planText(dry.plan)}${importWarnings(dry.warnings)}
 ${t(`Replace the rows above in ${dry.db}?`, `\xBFReemplazar las filas de arriba en ${dry.db}?`)}`, { yes: v.yes, retry: `ghosty dbs import ${id} ${db} --from ${v.from}${v.tables ? ` --tables ${v.tables}` : ""}` });
   const r = await api(path, { body });
   const img = r.rehosted ? `
@@ -9547,8 +9567,16 @@ async function dbsCmd(sub, id, db, rest, v) {
       const ext = new Set(r.externalWriteTables);
       const own = r.externalRowScope ?? {};
       const rows = r.tables.map((tb) => ({ table: tb.name, rows: tb.rows, "customer writes": ext.has(tb.name) ? "yes" : "", "customer sees": own[tb.name] ? `own rows (${own[tb.name].join(", ")})` : "", columns: tb.columns.map((c) => `${c.name}${c.pk ? "*" : ""}`).join(", ") }));
+      const linkLines = r.tables.flatMap(
+        (tb) => (tb.links ?? []).map(
+          (l) => `  ${tb.name}.${l.column}: ${t(`${l.permanent} permanent \xB7 ${l.external} external \xB7 ${l.empty} empty`, `${l.permanent} permanentes \xB7 ${l.external} de fuera \xB7 ${l.empty} vac\xEDas`)}` + (l.external ? dim(`  \u2192 ghosty dbs rehost ${id} ${db} --table ${tb.name} --column ${l.column}`) : "")
+        )
+      );
+      const linksText = linkLines.length ? `
+${t("Photo/link columns", "Columnas de fotos/ligas")}:
+${linkLines.join("\n")}` : "";
       return out(r, () => `${bold(r.name)} ${r.granted ? lavender(t("granted", "concedida")) : dim(t("not granted", "no concedida"))}
-${table(rows, ["table", "rows", "customer writes", "customer sees", "columns"])}`);
+${table(rows, ["table", "rows", "customer writes", "customer sees", "columns"])}${linksText}`);
     }
     case "query":
     case "sql": {
@@ -9718,6 +9746,50 @@ async function agentsDoctor(id, v) {
     return exitAfterFlush(EXIT.API);
   }
 }
+var PHOTO_EXT = /\.(jpe?g|png|webp)$/i;
+function photoFiles(names2) {
+  return names2.filter((n) => PHOTO_EXT.test(n) && !n.startsWith(".")).sort().map((file) => ({ key: file.replace(PHOTO_EXT, ""), file }));
+}
+async function dbsPhotosCmd(verb, id, db, v) {
+  const ex = "ghosty dbs photos put <agent> <db> --table catalogo --key-column sku --dir fotos/ [--column imagen_url] [--dry-run]";
+  if (verb !== "put") throw usage(t(`Unknown dbs photos subcommand: ${verb ?? "(none)"}.`, `Subcomando desconocido de dbs photos: ${verb ?? "(ninguno)"}.`), `${t("Example", "Ejemplo")}: ${ex}`);
+  id = need2(id, t("agent", "el agente"), ex);
+  db = need2(db, t("database (id or name)", "la base (id o nombre)"), ex);
+  const tableName = need2(v.table, "--table", ex);
+  const keyColumn = need2(v["key-column"], "--key-column", ex);
+  const dir = need2(v.dir, "--dir", ex);
+  let column = v.column;
+  if (!column) {
+    const r = await api(agentPath2(id, `/dbs/${enc6(db)}`));
+    const tb = r.tables.find((x) => x.name === tableName);
+    if (!tb) throw usage(t(`${db} has no table ${tableName}.`, `${db} no tiene la tabla ${tableName}.`));
+    column = tb.columns.find((c) => c.name === "imagen_url")?.name;
+    if (!column) throw usage(t("Which column gets the photo link? Pass --column.", "\xBFEn qu\xE9 columna va la liga de la foto? Usa --column."), `${t("Columns", "Columnas")}: ${tb.columns.map((c) => c.name).join(", ")}`);
+  }
+  const files = photoFiles(await readdir2(dir));
+  if (!files.length) throw usage(t(`No .jpg/.png/.webp files in ${dir}.`, `No hay archivos .jpg/.png/.webp en ${dir}.`), t("Name each photo after its key: SKU-123.jpg", "Nombra cada foto con su clave: SKU-123.jpg"));
+  const path = agentPath2(id, `/dbs/${enc6(db)}/photos`);
+  const results = [];
+  for (let i = 0; i < files.length; i += 8) {
+    const batch = files.slice(i, i + 8);
+    const items = await Promise.all(batch.map(async (f) => ({ key: f.key, filename: f.file, contentBase64: (await readFile6(join4(dir, f.file))).toString("base64") })));
+    const r = await api(path, { body: { table: tableName, keyColumn, column, items, ...v["dry-run"] ? { dryRun: true } : {} } });
+    results.push(...r.items);
+    if (!globals.json && files.length > 8) info(dim(`  ${Math.min(i + 8, files.length)}/${files.length}`));
+  }
+  const by = (s) => results.filter((r) => r.status === s);
+  const stored = by(v["dry-run"] ? "would_store" : "stored");
+  const missing = by("missing_row");
+  const bad = [...by("bad_type"), ...by("too_big"), ...by("failed")];
+  const summary = [
+    `${lavender("\u2713")} ${v["dry-run"] ? t(`${stored.length} photo(s) would go to ${tableName}.${column}`, `${stored.length} foto(s) ir\xEDan a ${tableName}.${column}`) : t(`${stored.length} photo(s) stored in ${tableName}.${column} (permanent links)`, `${stored.length} foto(s) guardadas en ${tableName}.${column} (ligas permanentes)`)}`,
+    missing.length ? red(t(`${missing.length} with no row where ${keyColumn} = file name: ${missing.map((x) => x.key).join(", ")}`, `${missing.length} sin fila con ${keyColumn} = nombre del archivo: ${missing.map((x) => x.key).join(", ")}`)) : "",
+    bad.length ? red(t(`${bad.length} not stored: ${bad.map((b) => `${b.key} (${b.error ? serverText(b.error) : b.status})`).join(", ")}`, `${bad.length} sin guardar: ${bad.map((b) => `${b.key} (${b.error ?? b.status})`).join(", ")}`)) : "",
+    ...results.filter((x) => x.warning).map((x) => dim(`  ${x.key}: ${serverText(x.warning)}`)),
+    v["dry-run"] ? dim(t("Dry run: nothing uploaded.", "Simulaci\xF3n: no se subi\xF3 nada.")) : ""
+  ].filter(Boolean);
+  out({ table: tableName, keyColumn, column, dryRun: !!v["dry-run"], items: results }, () => summary.join("\n"));
+}
 
 // src/commands/credentials.ts
 async function hiddenPrompt(label) {
@@ -9794,8 +9866,8 @@ async function credentialsCmd2(sub, provider, v) {
 import { readFile as readFile8 } from "node:fs/promises";
 
 // src/wa-auth.ts
-import { readdir as readdir2, readFile as readFile7 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { readdir as readdir3, readFile as readFile7 } from "node:fs/promises";
+import { join as join5 } from "node:path";
 var TYPES = ["app-state-sync-version", "app-state-sync-key", "sender-key-memory", "sender-key", "lid-mapping", "device-list", "identity-key", "pre-key", "session", "tctoken"];
 function keyOfFileName(name) {
   for (const type of TYPES) {
@@ -9807,9 +9879,9 @@ function keyOfFileName(name) {
   return null;
 }
 async function readMultiFileAuth(dir) {
-  const files = (await readdir2(dir)).filter((f) => f.endsWith(".json"));
+  const files = (await readdir3(dir)).filter((f) => f.endsWith(".json"));
   if (!files.includes("creds.json")) throw new Error(`${dir} has no creds.json: not a Baileys multi-file auth folder`);
-  const authCreds = JSON.parse(await readFile7(join4(dir, "creds.json"), "utf8"));
+  const authCreds = JSON.parse(await readFile7(join5(dir, "creds.json"), "utf8"));
   const authKeys = {};
   const counts = {};
   const skipped = [];
@@ -9820,7 +9892,7 @@ async function readMultiFileAuth(dir) {
       skipped.push(f);
       continue;
     }
-    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile7(join4(dir, f), "utf8"));
+    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile7(join5(dir, f), "utf8"));
     counts[k.type] = (counts[k.type] ?? 0) + 1;
   }
   return { authCreds, authKeys, counts, skipped };
@@ -10188,9 +10260,13 @@ var HELPS_ES = {
       ["--append", "import: agrega filas en vez de reemplazarlas (reemplazar es el default idempotente)"],
       ["--rehost-images t.col,\u2026", "import: copia las ligas de imagen de esas columnas al almacenamiento p\xFAblico de Ghosty (ligas permanentes en img.ghosty.studio)"],
       ["--table T --column C", "rehost: la columna de ligas de imagen (p. ej. catalogo imagen_url) que se pasa a ligas permanentes en img.ghosty.studio; idempotente, una liga que falla se queda como estaba"],
-      ["-n, --dry-run", "import: imprime el plan (+ crear, ~ reemplazar N \u2192 M filas), no cambia nada"]
+      ["--key-column K --dir DIR", "photos put: cada archivo de DIR se llama como la clave de su fila (SKU-123.jpg \u2192 la fila donde K = SKU-123); va al almacenamiento permanente y su liga a --column (default imagen_url)"],
+      ["-n, --dry-run", "import: imprime el plan (+ crear, ~ reemplazar N \u2192 M filas), no cambia nada \xB7 photos put: lista las claves sin fila y los archivos que no son imagen"]
     ],
-    notes: ["<db> es el id de la base o su nombre. Desde canales del due\xF1o el agente lee y escribe todo lo concedido."]
+    notes: [
+      "<db> es el id de la base o su nombre. Desde canales del due\xF1o el agente lee y escribe todo lo concedido.",
+      "tables dice, por columna de fotos/ligas, cu\xE1ntas son permanentes (img.ghosty.studio), de fuera o vac\xEDas; import avisa antes de reemplazar ligas permanentes por ligas de fuera."
+    ]
   },
   turns: {
     summary: "Los turnos recientes de un agente: qu\xE9 contest\xF3, qu\xE9 fall\xF3 y por qu\xE9, y en qu\xE9 se fue el tiempo de un turno.",
@@ -10477,6 +10553,7 @@ var HELPS = {
       'ghosty dbs query <agent-id> <db> "SQL" [--arg V]\u2026 [--write]',
       "ghosty dbs import <agent-id> <db> --from easybits:<db-id> [--tables a,b] [--append] [--rehost-images t.col,\u2026] [--dry-run] [--yes]",
       "ghosty dbs rehost <agent-id> <db> --table T --column C [--dry-run]",
+      "ghosty dbs photos put <agent-id> <db> --table T --key-column K --dir DIR [--column C] [--dry-run]",
       "ghosty dbs grant <agent-id> <db> [--external-write t1,t2] [--external-rows t:col+col,\u2026]",
       "ghosty dbs revoke <agent-id> <db>"
     ],
@@ -10490,7 +10567,8 @@ var HELPS = {
       ["--append", "import: add rows instead of replacing them (replace is the idempotent default)"],
       ["--rehost-images t.col,\u2026", "import: copy the image links in those columns to Ghosty's public storage (permanent links at img.ghosty.studio)"],
       ["--table T --column C", "rehost: the column of image links (e.g. catalogo imagen_url) to move to permanent links at img.ghosty.studio; idempotent, a link that fails stays as it was"],
-      ["-n, --dry-run", "import: print the plan (+ create, ~ replace N \u2192 M rows), change nothing"]
+      ["--key-column K --dir DIR", "photos put: each file in DIR is named after its row's key (SKU-123.jpg \u2192 the row where K = SKU-123); it goes to permanent storage and its link to --column (default imagen_url)"],
+      ["-n, --dry-run", "import: print the plan (+ create, ~ replace N \u2192 M rows), change nothing \xB7 photos put: list keys with no row and files that aren't images"]
     ],
     examples: [
       "ghosty dbs ls <id>",
@@ -10498,9 +10576,13 @@ var HELPS = {
       'ghosty dbs query <id> totequim "SELECT count(*) AS n FROM productos"',
       "ghosty dbs grant <id> totequim --external-write cotizaciones,folio",
       "ghosty dbs grant <id> totequim --external-rows clientes:telefono+tel_secundario,cotizaciones:cliente_tel",
-      "ghosty dbs import <id> totequim --from easybits:6a10c84c\u2026 --dry-run   # reads $EASYBITS_API_KEY"
+      "ghosty dbs import <id> totequim --from easybits:6a10c84c\u2026 --dry-run   # reads $EASYBITS_API_KEY",
+      "ghosty dbs photos put <id> siiqtec --table catalogo --key-column sku --dir fotos/ --dry-run"
+    ],
+    notes: [
+      "<db> is the database id or its name. From owner channels the agent reads and writes everything granted.",
+      "tables shows, per photo/link column, how many links are permanent (img.ghosty.studio), external or empty; import warns before replacing permanent links with external ones."
     ],
-    notes: ["<db> is the database id or its name. From owner channels the agent reads and writes everything granted."],
     learn: `${REF}#bases-de-datos`
   },
   turns: {
@@ -10768,8 +10850,8 @@ function helpText(cmd) {
 // src/update.ts
 import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
-import { dirname as dirname3, join as join5 } from "node:path";
-var FILE = join5(process.env.XDG_CONFIG_HOME || join5(homedir3(), ".config"), "ghosty", "update.json");
+import { dirname as dirname3, join as join6 } from "node:path";
+var FILE = join6(process.env.XDG_CONFIG_HOME || join6(homedir3(), ".config"), "ghosty", "update.json");
 var DAY = 24 * 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @ghostystudio/cli@latest";
 function newer(a, b) {
@@ -10843,6 +10925,7 @@ function agentArgIndex(pos) {
     case "mcp":
     case "dbs":
     case "db":
+      return sub === "photos" ? 3 : 2;
     case "turns":
     case "board":
     case "conversations":
@@ -10863,7 +10946,7 @@ function agentArgIndex(pos) {
 // src/completion.ts
 import { mkdir as mkdir5, readFile as readFile10, writeFile as writeFile5 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 var GLOBAL_FLAGS = ["--json", "--token", "--profile", "--yes", "--help", "--version", "--lang", "--dry-run"];
 var AGENT_FLAGS = /* @__PURE__ */ new Set(["--like", "--agent", "--prompt-base"]);
 var WORKSPACE_FLAGS = /* @__PURE__ */ new Set(["--workspace"]);
@@ -10901,7 +10984,7 @@ function completionFor(words, current2, commands) {
   if (agentArgIndex([...pos, current2]) === pos.length) return { kind: "agents" };
   return { kind: "words", words: [] };
 }
-var cacheFile = () => join6(process.env.XDG_CACHE_HOME || join6(homedir4(), ".cache"), "ghosty", `complete${process.env.GHOSTY_PROFILE ? `.${process.env.GHOSTY_PROFILE}` : ""}.json`);
+var cacheFile = () => join7(process.env.XDG_CACHE_HOME || join7(homedir4(), ".cache"), "ghosty", `complete${process.env.GHOSTY_PROFILE ? `.${process.env.GHOSTY_PROFILE}` : ""}.json`);
 async function names() {
   try {
     const c = JSON.parse(await readFile10(cacheFile(), "utf8"));
@@ -10911,7 +10994,7 @@ async function names() {
   const list = await listAgents();
   const agents = [...new Set(list.map((a) => a.nombre))];
   const workspaces = [...new Set(list.map((a) => a.espacio?.tipo === "workspace" ? a.espacio.nombre : void 0).filter((x) => !!x))];
-  await mkdir5(join6(cacheFile(), ".."), { recursive: true }).catch(() => {
+  await mkdir5(join7(cacheFile(), ".."), { recursive: true }).catch(() => {
   });
   await writeFile5(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
   });
@@ -10991,8 +11074,8 @@ function normalizeArgs(pos, v) {
 
 // src/commands/spec.ts
 var import_yaml = __toESM(require_dist(), 1);
-import { mkdir as mkdir6, readdir as readdir3, readFile as readFile11, stat, writeFile as writeFile6 } from "node:fs/promises";
-import { join as join7, resolve as resolve2 } from "node:path";
+import { mkdir as mkdir6, readdir as readdir4, readFile as readFile11, stat, writeFile as writeFile6 } from "node:fs/promises";
+import { join as join8, resolve as resolve2 } from "node:path";
 var enc9 = encodeURIComponent;
 async function agentsExport(id, v) {
   if (!id) throw usage(t("Missing agent.", "Falta el agente."), t("Example", "Ejemplo") + ": ghosty agents export pia-0 > pia.yaml   \xB7   ghosty agents export pia-0 --out ./pia");
@@ -11003,11 +11086,11 @@ async function agentsExport(id, v) {
   }
   const dir = resolve2(v.out);
   await mkdir6(dir, { recursive: true });
-  await writeFile6(join7(dir, "agent.yaml"), yaml);
+  await writeFile6(join8(dir, "agent.yaml"), yaml);
   const own = (0, import_yaml.parse)(yaml)["x-ghosty"]?.skills?.own ?? [];
   for (const slug of own) {
     const sk = await api(`/api/v2/agents/${enc9(id)}/skills/${enc9(slug)}`);
-    await writeSkill(join7(dir, "skills", slug), sk);
+    await writeSkill(join8(dir, "skills", slug), sk);
   }
   out({ saved: dir, skills: own }, () => `${lavender("\u2713")} ${dir}/agent.yaml${own.length ? ` + skills/ (${own.join(", ")})` : ""}
 ${dim(t(`Edit it, then: ghosty apply ${v.out} --dry-run`, `Ed\xEDtalo y luego: ghosty apply ${v.out} --dry-run`))}`);
@@ -11028,12 +11111,12 @@ function fillSecrets(file) {
   return missing;
 }
 async function readSkills(dir) {
-  const root = join7(dir, "skills");
+  const root = join8(dir, "skills");
   const out2 = {};
-  const slugs = await readdir3(root, { withFileTypes: true }).catch(() => []);
+  const slugs = await readdir4(root, { withFileTypes: true }).catch(() => []);
   for (const e of slugs) {
     if (!e.isDirectory() || e.name.startsWith(".")) continue;
-    const { markdown, assets } = await readSkillDir(join7(root, e.name));
+    const { markdown, assets } = await readSkillDir(join8(root, e.name));
     out2[e.name] = [{ path: "SKILL.md", contentBase64: Buffer.from(markdown).toString("base64") }, ...assets.map((a) => ({ path: a.name, contentBase64: a.contentBase64 }))];
   }
   return out2;
@@ -11042,7 +11125,7 @@ var line = (c) => c.op === "!" ? dim(`! ${c.what}`) : `${c.op === "+" ? lavender
 async function applyCmd(target, v) {
   if (!target) throw usage(t("Missing file or directory.", "Falta el archivo o el directorio."), t("Example: ghosty apply pia.yaml --dry-run   \xB7   ghosty apply ./pia (from agents export --out)", "Ejemplo: ghosty apply pia.yaml --dry-run   \xB7   ghosty apply ./pia (de agents export --out)"));
   const isDir = (await stat(target).catch(() => null))?.isDirectory() ?? false;
-  const text = await readFile11(isDir ? join7(target, "agent.yaml") : target, "utf8");
+  const text = await readFile11(isDir ? join8(target, "agent.yaml") : target, "utf8");
   const file = (0, import_yaml.parse)(text);
   if (!file || typeof file !== "object") throw usage(t(`${target} is not a YAML/JSON agent file.`, `${target} no es un archivo de agente YAML/JSON.`));
   const missing = fillSecrets(file);
@@ -11126,6 +11209,7 @@ ${bold("Configure an agent")}
   skills ls|get|add|rm <id> [slug]   Skills (add from catalog, --file SKILL.md or --dir FOLDER; get lists, --out DIR saves; rm keeps a copy)
   skills templates <id>              pdf-doc templates it sees: its own and Ghosty's, and which folder wins
   dbs ls|tables|query|import|rehost|grant|revoke <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run] [--table T --column C]
+  dbs photos put <id> <db> --table T --key-column K --dir DIR   Loose photos to a catalog (SKU-123.jpg \u2192 its row), permanent links   [--column C] [--dry-run]
   mcp get|set <id>                   MCP servers                    [--file servers.json]
   channels whatsapp ls|enable|disable <id> [number]   Which WhatsApp Business numbers it answers   [--dry-run]
   channels whatsapp link|unlink <id> --integration ID --answer on|off   Bring a WhatsApp Business number from Formmy/EasyBits to this agent, or send it back   [--forward] [--dry-run]
@@ -11219,6 +11303,7 @@ ${bold("Configurar un agente")}
   skills ls|get|add|rm <id> [slug]   Skills (add del cat\xE1logo, --file SKILL.md o --dir CARPETA; get lista, --out DIR guarda; rm deja copia)
   skills templates <id>              Plantillas de pdf-doc que ve: las suyas y las de Ghosty, y qu\xE9 carpeta gana
   dbs ls|tables|query|import|rehost|grant|revoke <id> [db]   Bases de datos que usa   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run] [--table T --column C]
+  dbs photos put <id> <db> --table T --key-column K --dir DIR   Fotos sueltas a un cat\xE1logo (SKU-123.jpg \u2192 su fila), ligas permanentes   [--column C] [--dry-run]
   mcp get|set <id>                   Servidores MCP                 [--file servers.json]
   channels whatsapp ls|enable|disable <id> [n\xFAmero]   Qu\xE9 n\xFAmeros de WhatsApp Business contesta   [--dry-run]
   channels whatsapp link|unlink <id> --integration ID --answer on|off   Trae un n\xFAmero de WhatsApp Business de Formmy/EasyBits a este agente, o devu\xE9lvelo   [--forward] [--dry-run]
@@ -11367,6 +11452,7 @@ async function main() {
       verbose: { type: "boolean" },
       full: { type: "boolean" },
       "as-formmy": { type: "boolean" },
+      "key-column": { type: "string" },
       like: { type: "string" },
       "copy-dbs": { type: "boolean" },
       "no-notify": { type: "boolean" },
@@ -11426,7 +11512,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.20.0" }, () => "0.20.0");
+  if (v.version) return out({ version: "0.21.0" }, () => "0.21.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -11500,6 +11586,7 @@ async function main() {
       return mcpCmd(sub, a1, v);
     case "dbs":
     case "db":
+      if (sub === "photos") return dbsPhotosCmd(a1, a2, pos[4], v);
       return dbsCmd(sub, a1, a2, pos.slice(4).filter((x) => x !== void 0), v);
     case "turns":
       return turnsCmd(sub, a1, a2, v);
@@ -11541,7 +11628,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.20.0").catch(() => null);
+var notice = updateNotice("0.21.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
   "scripts": {
     "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --outfile=dist/index.js --banner:js='#!/usr/bin/env node\nimport { createRequire as __cr } from \"node:module\"; const require = __cr(import.meta.url);' --define:__VERSION__=\\\"$npm_package_version\\\"",
     "prepack": "npm run build",
-    "test": "for t in flags prompt api rows wa-auth resolve aliases i18n help completion; do esbuild src/$t.test.ts --bundle --platform=node --format=esm --outfile=/tmp/ghosty-cli-$t.test.mjs --log-level=error || exit 1; done && node --test /tmp/ghosty-cli-*.test.mjs"
+    "test": "for t in flags prompt api rows wa-auth resolve aliases i18n help completion photos; do esbuild src/$t.test.ts --bundle --platform=node --format=esm --outfile=/tmp/ghosty-cli-$t.test.mjs --log-level=error || exit 1; done && node --test /tmp/ghosty-cli-*.test.mjs"
   },
   "keywords": [
     "ghosty",