@ghostystudio/cli 0.48.0 → 0.49.0

package/README.md

@@ -47,7 +47,7 @@ ghosty files ls|get|put|rm <id> [path]   [--file LOCAL] [--out LOCAL]
 ghosty skills ls|get|add|rm <id> [slug]  [--file SKILL.md | --dir FOLDER] [--out DIR]   # get without --out only lists
 ghosty skills enable|disable <id> <slug> # turn one of its skills (or one of Ghosty's) on or off
 ghosty skills templates <id>             # pdf-doc templates: its own and Ghosty's, and which folder wins
-ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--arg V]… [--external-write t1,t2] [--external-rows t:col+col] [--from easybits:ID --tables a,b --append --dry-run]
+ghosty dbs ls|tables|query|export|import|grant|revoke <id> [db]   [--write] [--arg V]… [--external-write t1,t2] [--external-rows t:col+col] [--from easybits:ID --tables a,b --append --dry-run]
 ghosty turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
 ghosty turns ls --workspace SLUG --quota-hits [--days 14]   # messages that got no turn because the balance ran out
 ghosty turns show <id> [turn-id|last]    # what came in, what it answered, where the time went   [--full]
@@ -76,7 +76,7 @@ ghosty schedule ls <id>
 ghosty schedule rm <id> <schedule-id>
 ghosty schedule add|ls|rm <id> … --teams <workspace>#<room>[/<thread-id>]   # in a Teams room/thread: it answers there as if mentioned
 
-ghosty me files ls|get|upload|rm         [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]
+ghosty me files ls|get|export|upload|rm  [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]
 ghosty me memories ls|add|edit|rm
 ghosty conversations archive|rm <id> --kind test|channel [--before 7d] [--dry-run]
 ghosty agents docs dedupe [--dry-run]    # your account: merge documents with the same content
@@ -103,6 +103,11 @@ Every command has its own help with examples: `ghosty <command> --help` or `ghos
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.49.0
+
+- `dbs export <id> <db> [--table T] [--out FILE]`: download a database — the whole thing as `.sqlite` (sqlite3, DB Browser, DBeaver) or one table as CSV (Excel). Same buttons on each database's page in /app/datos.
+- `me files export [--out DIR] [--kind K] [--dry-run]`: download every file in your account into `documents/`, `conversations/` and `library/`; rerunning only brings what's new.
+
 ### Changes in 0.48.0
 
 - `agents teams on <id> <workspace> --factory plan,build,check`: make an agent those Software Factory roles in that workspace (same as «Team» in /factory; each role keeps its name and avatar). `agents teams ls` shows the roles it holds.

package/dist/index.js

@@ -8127,6 +8127,11 @@ var SERVER_MESSAGES = [
   ["no pude conectar con el servicio de sitios ({})", "couldn't reach the sites service ({})"],
   ["no se pudo crear el sitio; int\xE9ntalo en un momento", "couldn't create the site; try again in a moment"],
   ["no se pudo subir {}: {}", "couldn't upload {}: {}"],
+  // — Exportar bases (dbs export)
+  ["el CSV es de una tabla: falta table", "a CSV is one table: table is missing"],
+  ["el token del agente no descarga bases: usa tu sesi\xF3n (ghosty login)", "the agent's token doesn't download databases: use your session (ghosty login)"],
+  ["format es sqlite o csv", "format is sqlite or csv"],
+  ["no existe la tabla {} en {}", "there's no table {} in {}"],
   // — Infra interna (casi nunca llega al CLI, pero por si acaso)
   ["SESSION_SECRET ausente en producci\xF3n \u2014 las cookies quedar\xEDan firmadas con un valor p\xFAblico. Inyectarlo con ./scripts/set_gs_secret.sh SESSION_SECRET (openssl rand -hex 32).", "SESSION_SECRET missing in production \u2014 cookies would be signed with a public value. Inject it with ./scripts/set_gs_secret.sh SESSION_SECRET (openssl rand -hex 32)."],
   ["sqld: fetch sin namespace", "sqld: fetch without namespace"],
@@ -8429,7 +8434,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.48.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.49.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8471,7 +8476,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.48.0"}`,
+      "user-agent": `ghosty-cli/${"0.49.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9271,8 +9276,8 @@ function capacityLine(c) {
 // src/commands/chat.ts
 import { randomUUID } from "node:crypto";
 import { createInterface as createInterface2 } from "node:readline/promises";
-import { readFile as readFile4, writeFile as writeFile4 } from "node:fs/promises";
-import { basename as basename2 } from "node:path";
+import { mkdir as mkdir4, readFile as readFile4, stat, writeFile as writeFile4 } from "node:fs/promises";
+import { basename as basename2, extname, join as join4 } from "node:path";
 
 // src/sse.ts
 async function* readSse(body) {
@@ -9482,9 +9487,65 @@ async function meMemories(sub, arg, text) {
       throw usage(t(`Unknown memories subcommand: ${sub}.`, `Subcomando de memories desconocido: ${sub}.`), ex);
   }
 }
+var safeName = (s) => s.replace(/[\\/:*?"<>|\u0000-\u001f]+/g, "_").trim() || "archivo";
+async function meFilesExport(v) {
+  const dir = v.out ?? "ghosty-archivos";
+  const all = [];
+  let cursor = null;
+  do {
+    const q = new URLSearchParams({ all: "1", ...cursor ? { cursor } : {} });
+    const r = await api(`/api/v2/me/files?${q}`);
+    all.push(...r.files);
+    cursor = r.nextCursor;
+  } while (cursor);
+  const files = v.kind ? all.filter((f) => f.kind === v.kind) : all;
+  const folder = { documents: t("documents", "documentos"), conversations: t("conversations", "conversaciones"), library: t("library", "biblioteca") };
+  const total = files.reduce((n, f) => n + f.size, 0);
+  if (v["dry-run"]) {
+    const byGroup = ["documents", "conversations", "library"].map((g) => files.filter((f) => f.group === g)).filter((fs) => fs.length).map((fs) => ({ folder: folder[fs[0].group], files: fs.length, MB: (fs.reduce((n, f) => n + f.size, 0) / 1e6).toFixed(1) }));
+    return out({ dir, files: files.length, bytes: total, groups: byGroup }, () => `${table(byGroup, ["folder", "files", "MB"])}
+${dim(t(`${files.length} file(s), ${(total / 1e6).toFixed(1)} MB \u2192 ${dir}/  (without --dry-run it downloads them)`, `${files.length} archivo(s), ${(total / 1e6).toFixed(1)} MB \u2192 ${dir}/  (sin --dry-run los baja)`))}`);
+  }
+  const used = /* @__PURE__ */ new Set();
+  let saved = 0, skipped = 0;
+  const failed = [];
+  for (const [i, f] of files.entries()) {
+    const sub = join4(dir, folder[f.group]);
+    let name = safeName(f.name);
+    if (used.has(join4(sub, name).toLowerCase())) name = `${basename2(name, extname(name))}-${f.id.slice(-6)}${extname(name)}`;
+    used.add(join4(sub, name).toLowerCase());
+    const path = join4(sub, name);
+    const prev = await stat(path).catch(() => null);
+    if (prev && prev.size === f.size) {
+      skipped++;
+      continue;
+    }
+    if (!globals.json) process.stderr.write(dim(`\r${i + 1}/${files.length} ${name.slice(0, 60)}`.padEnd(80)));
+    try {
+      const { url } = await api(`/api/v2/me/files/${enc3(f.id)}`);
+      const res = await fetch(url);
+      if (!res.ok) throw new Error(`${res.status}`);
+      await mkdir4(sub, { recursive: true });
+      await writeFile4(path, Buffer.from(await res.arrayBuffer()));
+      saved++;
+    } catch (e) {
+      failed.push({ id: f.id, name: f.name, error: e.message });
+    }
+  }
+  if (!globals.json) process.stderr.write("\r".padEnd(81) + "\r");
+  return out(
+    { dir, saved, skipped, failed },
+    () => `${lavender("\u2713")} ${t(`${saved} downloaded, ${skipped} already there \u2192 ${dir}/`, `${saved} bajado(s), ${skipped} ya estaban \u2192 ${dir}/`)}` + (failed.length ? `
+${red(t(`${failed.length} failed:`, `${failed.length} fallaron:`))}
+${failed.map((x) => `  ${x.name} ${dim(`${x.id} \xB7 ${x.error}`)}`).join("\n")}` : "")
+  );
+}
 async function meFiles(sub, arg, v) {
-  const ex = "ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] | get <file-id> [--out FILE] | upload <file> | rm <file-id>";
+  const ex = "ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] | get <file-id> [--out FILE] | export [--out DIR] | upload <file> | rm <file-id>";
   switch (sub) {
+    case "export":
+    case "download":
+      return meFilesExport(v);
     case "ls": {
       if (v.q !== void 0 || v.cursor) {
         const q = new URLSearchParams({ q: v.q ?? "", ...v.kind ? { kind: v.kind } : {}, ...v.cursor ? { cursor: v.cursor } : {}, ...v.limit ? { limit: v.limit } : {} });
@@ -9795,7 +9856,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.48.0"}`
+        "user-agent": `ghosty-cli/${"0.49.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10050,8 +10111,8 @@ async function partnerCmd(sub, a1, a2, v, a3) {
 }
 
 // src/commands/data.ts
-import { readdir as readdir2, readFile as readFile6 } from "node:fs/promises";
-import { basename as basename3, join as join4 } from "node:path";
+import { readdir as readdir2, readFile as readFile6, writeFile as writeFile6 } from "node:fs/promises";
+import { basename as basename3, join as join5 } from "node:path";
 
 // src/rows.ts
 var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -10208,6 +10269,26 @@ ${t(`Delete ${dry.name} for good? This cannot be undone.`, `\xBFBorrar ${dry.nam
   const r = await api(path, { body: {} });
   return out(r, () => `${lavender("\u2713")} ${t(`${r.name} deleted.`, `${r.name} borrada.`)}`);
 }
+async function dbsExport(id, db, v) {
+  const format = v.format ?? (v.table ? "csv" : "sqlite");
+  if (format !== "sqlite" && format !== "csv") throw usage(t("--format takes sqlite or csv.", "--format acepta sqlite o csv."), `ghosty dbs export ${id} ${db} --format csv --table <table>`);
+  if (format === "csv" && !v.table) throw usage(t("A CSV is one table: add --table.", "Un CSV es de una tabla: agrega --table."), `ghosty dbs export ${id} ${db} --table <table>   (ghosty dbs tables ${id} ${db})`);
+  const q = new URLSearchParams({ format, ...v.table ? { table: v.table } : {} });
+  const res = await request(agentPath2(id, `/dbs/${enc6(db)}/export?${q}`));
+  const suggested = /filename="([^"]+)"/.exec(res.headers.get("content-disposition") ?? "")?.[1] ?? (format === "csv" ? `${db}-${v.table}.csv` : `${db}.sqlite`);
+  const file = v.out ?? suggested;
+  const bytes = Buffer.from(await res.arrayBuffer());
+  await writeFile6(file, bytes);
+  const countsHeader = res.headers.get("x-gs-row-counts");
+  const counts = countsHeader ? JSON.parse(Buffer.from(countsHeader, "base64").toString("utf8")) : {};
+  const rows = Object.entries(counts).map(([tb, n]) => ({ table: tb, rows: n }));
+  return out(
+    { saved: file, bytes: bytes.length, format, ...v.table ? { table: v.table } : { tables: counts } },
+    () => `${lavender("\u2713")} ${file} ${dim(`(${bytes.length} bytes)`)}` + (rows.length ? `
+${table(rows, ["table", "rows"])}
+${dim(t("Open it with sqlite3, DB Browser for SQLite or DBeaver.", "\xC1brela con sqlite3, DB Browser for SQLite o DBeaver."))}` : "")
+  );
+}
 async function dbsCmd(sub, id, db, rest, v) {
   const ex = "ghosty dbs ls <agent-id>";
   id = need2(id, t("agent id", "el id del agente"), ex);
@@ -10282,6 +10363,11 @@ ${dim(`${t(`${rows.length} row(s)`, `${rows.length} fila(s)`)} \xB7 ${Math.round
       db = need2(db, t("database (id or name)", "la base (id o nombre)"), ex2);
       return dbsRename(id, db, need2(rest[0], t("new name", "el nombre nuevo"), ex2), !!v["dry-run"]);
     }
+    case "export":
+    case "download": {
+      db = need2(db, t("database (id or name)", "la base (id o nombre)"), "ghosty dbs export <agent-id> <db> [--table T] [--out FILE]");
+      return dbsExport(id, db, v);
+    }
     case "rm":
     case "delete": {
       db = need2(db, t("database (id or name)", "la base (id o nombre)"), "ghosty dbs rm <agent-id> <db> [--dry-run] [--yes]");
@@ -10557,7 +10643,7 @@ async function dbsPhotosCmd(verb, id, db, v) {
   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 items = await Promise.all(batch.map(async (f) => ({ key: f.key, filename: f.file, contentBase64: (await readFile6(join5(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}`));
@@ -10789,7 +10875,7 @@ import { readFile as readFile8 } from "node:fs/promises";
 
 // src/wa-auth.ts
 import { readdir as readdir3, readFile as readFile7 } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { join as join6 } 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) {
@@ -10803,7 +10889,7 @@ function keyOfFileName(name) {
 async function readMultiFileAuth(dir) {
   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(join5(dir, "creds.json"), "utf8"));
+  const authCreds = JSON.parse(await readFile7(join6(dir, "creds.json"), "utf8"));
   const authKeys = {};
   const counts = {};
   const skipped = [];
@@ -10814,7 +10900,7 @@ async function readMultiFileAuth(dir) {
       skipped.push(f);
       continue;
     }
-    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile7(join5(dir, f), "utf8"));
+    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile7(join6(dir, f), "utf8"));
     counts[k.type] = (counts[k.type] ?? 0) + 1;
   }
   return { authCreds, authKeys, counts, skipped };
@@ -11346,13 +11432,18 @@ var HELPS_ES = {
   },
   dbs: {
     summary: "Bases de datos que un agente puede usar, y qu\xE9 puede escribir desde canales de clientes.",
-    replace: [["# reads $EASYBITS_API_KEY", "# lee $EASYBITS_API_KEY"]],
+    replace: [
+      ["# reads $EASYBITS_API_KEY", "# lee $EASYBITS_API_KEY"],
+      ["# totequim-productos.csv (Excel)", "# totequim-productos.csv (Excel)"]
+    ],
     flags: [
       ["--orphans", "ls: s\xF3lo las bases que ning\xFAn agente tiene concedidas (candidatas a rm)"],
       ["--arg V", "query: valor para un marcador ? (repetible)"],
       ["--write", "query: permite INSERT/UPDATE/DELETE/DDL (default: s\xF3lo lectura)"],
       ["--external-write t1,t2", 'grant: tablas que puede escribir desde WhatsApp/Messenger ("" = ninguna)'],
       ["--external-rows t:col+col", 'grant: desde WhatsApp/Messenger cada cliente ve s\xF3lo SUS filas de t, por columna(s) de tel\xE9fono ("" = sin filtro)'],
+      ["--table T", "export: baja s\xF3lo esa tabla, en CSV (sin ella: la base entera como .sqlite)"],
+      ["--out FILE", "export: d\xF3nde guardarla (default: el nombre de la base, p. ej. totequim.sqlite o totequim-productos.csv)"],
       ["--from easybits:ID", "import: base de origen en EasyBits (llave de $EASYBITS_API_KEY)"],
       ["--tables a,b", "import: s\xF3lo estas tablas (default: todas)"],
       ["--append", "import: agrega filas en vez de reemplazarlas (reemplazar es el default idempotente)"],
@@ -11364,6 +11455,7 @@ var HELPS_ES = {
     ],
     notes: [
       "<db> es el id de la base o su nombre. Desde canales del due\xF1o el agente lee y escribe todo lo concedido.",
+      "export usa tu sesi\xF3n (no el token gat_ del agente) y deja registro en la bit\xE1cora; las mismas descargas est\xE1n en la p\xE1gina de la base, en /app/datos?tab=dbs.",
       "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.",
       "import con replace avisa de las filas escritas en gs que EasyBits no tiene (una base compartida con agentes que ya corren en gs) y pregunta antes de borrarlas.",
       "rename tambi\xE9n reescribe cada prompt, valor de env y SKILL.md que nombra la base; un prompt derivado sigue a su base. rm borra la base misma (revoke s\xF3lo le quita el acceso a este agente); las dos son s\xF3lo del due\xF1o (o del staff de Ghosty)."
@@ -11435,7 +11527,16 @@ var HELPS_ES = {
   },
   me: {
     summary: "Tu cuenta: archivos, memorias y uso.",
-    notes: ["Las memorias viajan a tus agentes s\xF3lo en tus chats personales (app, /c, notch), nunca a WhatsApp, Messenger ni demos."]
+    replace: [["# documents/, conversations/, library/", "# documentos/, conversaciones/, biblioteca/"]],
+    flags: [
+      ["--out DIR", "export: carpeta destino (default ghosty-archivos); get: archivo donde guardarlo"],
+      ["--kind K", "ls, export: s\xF3lo image | video | audio | document | other"],
+      ["-n, --dry-run", "export: cu\xE1ntos archivos y MB por carpeta, sin bajar nada"]
+    ],
+    notes: [
+      "Las memorias viajan a tus agentes s\xF3lo en tus chats personales (app, /c, notch), nunca a WhatsApp, Messenger ni demos.",
+      "export baja TODO lo de tu cuenta: documentos, archivos de tus chats y de los canales de tus agentes (lo que mandaron los clientes). Lo ya bajado con el mismo tama\xF1o se salta, as\xED que repetirlo s\xF3lo trae lo nuevo."
+    ]
   },
   credentials: {
     summary: "Llaves de proveedores en la b\xF3veda de tu cuenta (cifradas; s\xF3lo regresan los \xFAltimos 4 caracteres).",
@@ -11828,6 +11929,7 @@ var HELPS = {
       "ghosty dbs ls <agent-id> [--orphans]",
       "ghosty dbs tables <agent-id> <db>",
       'ghosty dbs query <agent-id> <db> "SQL" [--arg V]\u2026 [--write]',
+      "ghosty dbs export <agent-id> <db> [--table T] [--out FILE]",
       "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]",
@@ -11842,6 +11944,8 @@ var HELPS = {
       ["--write", "query: allow INSERT/UPDATE/DELETE/DDL (default: read only)"],
       ["--external-write t1,t2", 'grant: tables it may write from WhatsApp/Messenger ("" = none)'],
       ["--external-rows t:col+col", 'grant: from WhatsApp/Messenger each customer sees only THEIR rows of t, matched by phone column(s) ("" = no filter)'],
+      ["--table T", "export: download only that table, as CSV (without it: the whole database as .sqlite)"],
+      ["--out FILE", "export: where to save it (default: the database name, e.g. totequim.sqlite or totequim-productos.csv)"],
       ["--from easybits:ID", "import: source database in EasyBits (key from $EASYBITS_API_KEY)"],
       ["--tables a,b", "import: only these tables (default: all)"],
       ["--append", "import: add rows instead of replacing them (replace is the idempotent default)"],
@@ -11855,6 +11959,8 @@ var HELPS = {
       "ghosty dbs ls <id>",
       "ghosty dbs tables <id> totequim",
       'ghosty dbs query <id> totequim "SELECT count(*) AS n FROM productos"',
+      "ghosty dbs export <id> totequim                       # totequim.sqlite (sqlite3, DB Browser, DBeaver)",
+      "ghosty dbs export <id> totequim --table productos      # totequim-productos.csv (Excel)",
       "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",
@@ -11864,6 +11970,7 @@ var HELPS = {
     ],
     notes: [
       "<db> is the database id or its name. From owner channels the agent reads and writes everything granted.",
+      "export uses your session (not the agent's gat_ token) and leaves an audit entry; the same downloads are on the database page at /app/datos?tab=dbs.",
       "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.",
       "import with replace warns about rows written in gs that EasyBits doesn't have (a database shared with agents already running in gs) and asks before deleting them.",
       "rename also rewrites every prompt, env value and SKILL.md that names the database; a derived prompt follows its base. rm deletes the database itself (revoke only removes this agent's access); only its owner (or Ghosty staff) can do either."
@@ -11974,9 +12081,17 @@ var HELPS = {
   },
   me: {
     summary: "Your account: files, memories and usage.",
-    usage: ["ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]", "ghosty me files get <file-id> [--out FILE]", "ghosty me files upload <file> | rm <file-id>", 'ghosty me memories ls | add "text" | edit <id> "text" | rm <id>', "ghosty usage"],
-    examples: ["ghosty me files ls --kind document", "ghosty me files ls --q contrato", "ghosty me files get <id> --out contrato.pdf", 'ghosty chat <agent> "res\xFAmelo" --file <id>', 'ghosty me memories add "I prefer short answers"'],
-    notes: ["Memories travel to your agents only in your personal chats (app, /c, notch), never to WhatsApp, Messenger or demo threads."],
+    usage: ["ghosty me files ls [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]", "ghosty me files get <file-id> [--out FILE]", "ghosty me files export [--out DIR] [--kind K] [--dry-run]", "ghosty me files upload <file> | rm <file-id>", 'ghosty me memories ls | add "text" | edit <id> "text" | rm <id>', "ghosty usage"],
+    examples: ["ghosty me files ls --kind document", "ghosty me files ls --q contrato", "ghosty me files get <id> --out contrato.pdf", "ghosty me files export --dry-run", "ghosty me files export --out respaldo/   # documents/, conversations/, library/", 'ghosty chat <agent> "res\xFAmelo" --file <id>', 'ghosty me memories add "I prefer short answers"'],
+    flags: [
+      ["--out DIR", "export: destination folder (default ghosty-archivos); get: file to save"],
+      ["--kind K", "ls, export: only image | video | audio | document | other"],
+      ["-n, --dry-run", "export: how many files and MB per folder, without downloading"]
+    ],
+    notes: [
+      "Memories travel to your agents only in your personal chats (app, /c, notch), never to WhatsApp, Messenger or demo threads.",
+      "export brings EVERYTHING in your account: documents, files from your chats and from your agents' channels (what customers sent). A file already downloaded with the same size is skipped, so rerunning it only brings what's new."
+    ],
     learn: `${REF}#tu-cuenta`
   }
 };
@@ -12346,10 +12461,10 @@ function helpText(cmd) {
 }
 
 // src/update.ts
-import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile6 } from "node:fs/promises";
+import { mkdir as mkdir5, readFile as readFile9, writeFile as writeFile7 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
-import { dirname as dirname3, join as join6 } from "node:path";
-var FILE = join6(process.env.XDG_CONFIG_HOME || join6(homedir3(), ".config"), "ghosty", "update.json");
+import { dirname as dirname3, join as join7 } from "node:path";
+var FILE = join7(process.env.XDG_CONFIG_HOME || join7(homedir3(), ".config"), "ghosty", "update.json");
 var TTL = 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @ghostystudio/cli@latest";
 function newer(a, b) {
@@ -12371,8 +12486,8 @@ async function latestVersion(current2) {
       const r = await fetch("https://registry.npmjs.org/@ghostystudio/cli/latest", { signal: AbortSignal.timeout(1500) });
       const latest = (await r.json()).version;
       if (latest) cache2 = { latest, checkedAt: Date.now() };
-      await mkdir4(dirname3(FILE), { recursive: true });
-      await writeFile6(FILE, JSON.stringify(cache2));
+      await mkdir5(dirname3(FILE), { recursive: true });
+      await writeFile7(FILE, JSON.stringify(cache2));
     } catch {
     }
   }
@@ -12447,9 +12562,9 @@ function agentArgIndex(pos) {
 }
 
 // src/completion.ts
-import { mkdir as mkdir5, readFile as readFile10, writeFile as writeFile7 } from "node:fs/promises";
+import { mkdir as mkdir6, readFile as readFile10, writeFile as writeFile8 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
-import { join as join7 } from "node:path";
+import { join as join8 } 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"]);
@@ -12487,7 +12602,7 @@ function completionFor(words, current2, commands) {
   if (agentArgIndex([...pos, current2]) === pos.length) return { kind: "agents" };
   return { kind: "words", words: [] };
 }
-var cacheFile = () => join7(process.env.XDG_CACHE_HOME || join7(homedir4(), ".cache"), "ghosty", `complete${process.env.GHOSTY_PROFILE ? `.${process.env.GHOSTY_PROFILE}` : ""}.json`);
+var cacheFile = () => join8(process.env.XDG_CACHE_HOME || join8(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"));
@@ -12497,9 +12612,9 @@ 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(join7(cacheFile(), ".."), { recursive: true }).catch(() => {
+  await mkdir6(join8(cacheFile(), ".."), { recursive: true }).catch(() => {
   });
-  await writeFile7(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
+  await writeFile8(cacheFile(), JSON.stringify({ at: Date.now(), agents, workspaces })).catch(() => {
   });
   return { agents, workspaces };
 }
@@ -12577,8 +12692,8 @@ function normalizeArgs(pos, v) {
 
 // src/commands/spec.ts
 var import_yaml = __toESM(require_dist(), 1);
-import { mkdir as mkdir6, readdir as readdir4, readFile as readFile11, stat, writeFile as writeFile8 } from "node:fs/promises";
-import { join as join8, resolve as resolve2 } from "node:path";
+import { mkdir as mkdir7, readdir as readdir4, readFile as readFile11, stat as stat2, writeFile as writeFile9 } from "node:fs/promises";
+import { join as join9, 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");
@@ -12588,12 +12703,12 @@ async function agentsExport(id, v) {
     return void process.stdout.write(yaml);
   }
   const dir = resolve2(v.out);
-  await mkdir6(dir, { recursive: true });
-  await writeFile8(join8(dir, "agent.yaml"), yaml);
+  await mkdir7(dir, { recursive: true });
+  await writeFile9(join9(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(join8(dir, "skills", slug), sk);
+    await writeSkill(join9(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`))}`);
@@ -12614,12 +12729,12 @@ function fillSecrets(file) {
   return missing;
 }
 async function readSkills(dir) {
-  const root = join8(dir, "skills");
+  const root = join9(dir, "skills");
   const out2 = {};
   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(join8(root, e.name));
+    const { markdown, assets } = await readSkillDir(join9(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;
@@ -12627,8 +12742,8 @@ async function readSkills(dir) {
 var line = (c) => c.op === "!" ? dim(`! ${c.what}`) : `${c.op === "+" ? lavender("+") : c.op === "-" ? red("-") : "~"} ${c.what}`;
 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 ? join8(target, "agent.yaml") : target, "utf8");
+  const isDir = (await stat2(target).catch(() => null))?.isDirectory() ?? false;
+  const text = await readFile11(isDir ? join9(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);
@@ -12948,9 +13063,9 @@ ${dim(t(`${fmtTokens(total)} billable tokens \xB7 failed = error or stopped \xB7
 
 // src/commands/demos.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir7, readFile as readFile12, writeFile as writeFile9 } from "node:fs/promises";
+import { mkdir as mkdir8, readFile as readFile12, writeFile as writeFile10 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
-import { dirname as dirname4, join as join9 } from "node:path";
+import { dirname as dirname4, join as join10 } from "node:path";
 var enc11 = encodeURIComponent;
 var hora = (iso) => new Date(iso).toLocaleString("es-MX", { timeZone: "America/Mexico_City", hour12: false, dateStyle: "short", timeStyle: "short" });
 async function history(agent, v) {
@@ -12970,7 +13085,7 @@ async function history(agent, v) {
     return lines.join("\n");
   });
 }
-var jarPath = () => join9(process.env.XDG_CONFIG_HOME || join9(homedir5(), ".config"), "ghosty", "demo-cookies.json");
+var jarPath = () => join10(process.env.XDG_CONFIG_HOME || join10(homedir5(), ".config"), "ghosty", "demo-cookies.json");
 async function readJar() {
   try {
     return JSON.parse(await readFile12(jarPath(), "utf8"));
@@ -12990,8 +13105,8 @@ async function visitorCookie(base, slug, fresh) {
   const cookie = anonCookieOf(res.headers.get("set-cookie"));
   if (!cookie) throw new CliError(t("The demo didn't hand out a visitor cookie.", "El demo no entreg\xF3 cookie de visitante."), EXIT.API);
   jar[slug] = cookie;
-  await mkdir7(dirname4(jarPath()), { recursive: true });
-  await writeFile9(jarPath(), JSON.stringify(jar, null, 2), { mode: 384 });
+  await mkdir8(dirname4(jarPath()), { recursive: true });
+  await writeFile10(jarPath(), JSON.stringify(jar, null, 2), { mode: 384 });
   return cookie;
 }
 async function visitorTurn(base, slug, cookie, text) {
@@ -13063,12 +13178,12 @@ async function demosCmd(sub, a1, rest, v) {
 }
 
 // src/commands/sites.ts
-import { readdir as readdir5, readFile as readFile13, stat as stat2 } from "node:fs/promises";
-import { basename as basename4, join as join10, relative as relative2, sep } from "node:path";
+import { readdir as readdir5, readFile as readFile13, stat as stat3 } from "node:fs/promises";
+import { basename as basename4, join as join11, relative as relative2, sep } from "node:path";
 var TEXT_EXT = /* @__PURE__ */ new Set(["html", "htm", "css", "js", "mjs", "json", "txt", "xml", "svg", "webmanifest", "md"]);
 var SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", ".DS_Store"]);
 async function collectSiteFiles(target) {
-  const st = await stat2(target).catch(() => null);
+  const st = await stat3(target).catch(() => null);
   if (!st) throw usage(t(`Not found: ${target}`, `No existe: ${target}`));
   if (st.isFile()) {
     if (!/\.html?$/i.test(target)) throw usage(t("A single file must be .html (or pass a folder).", "Un archivo suelto debe ser .html (o pasa una carpeta)."));
@@ -13079,7 +13194,7 @@ async function collectSiteFiles(target) {
   const walk = async (dir) => {
     for (const e of await readdir5(dir, { withFileTypes: true })) {
       if (e.name.startsWith(".") || SKIP.has(e.name)) continue;
-      const full = join10(dir, e.name);
+      const full = join11(dir, e.name);
       if (e.isDirectory()) await walk(full);
       else if (e.isFile()) {
         const path = relative2(target, full).split(sep).join("/");
@@ -13461,7 +13576,8 @@ ${bold("Configure an agent")}
   skills house <id>                  Ghosty's skills in bulk   [--only a,b | --enable a,b | --disable a,b] [--dry-run]
   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|rename|rm <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run] [--table T --column C]
+  dbs ls|tables|query|export|import|rehost|grant|revoke|rename|rm <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run] [--table T --column C]
+  dbs export <id> <db>      Download a database: whole as .sqlite, or one table as CSV   [--table T] [--out FILE]
   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]  (http headers accept \${turn.token})
   channels whatsapp ls|enable|disable <id> [number]   Which WhatsApp Business numbers it answers   [--dry-run]
@@ -13520,7 +13636,8 @@ ${bold("Partners")}  ${dim("(give an agent to each of YOUR customers \u2014 see:
   partner ls | enable | credentials | agent | tenants | audit | try
 
 ${bold("Your account")}
-  me files ls|get|upload|rm Files in your account        [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out FILE]
+  me files ls|get|export|upload|rm Files in your account [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out FILE]
+  me files export           Download ALL your files to a folder (documents, conversations, library); rerun = only new   [--out DIR] [--kind K] [--dry-run]
   me memories ls|add|edit|rm What your agents remember about you (personal chats only)   add "text" \xB7 edit <id> "text" \xB7 rm <id>
   credentials ls|set|rm [provider]   Provider keys in your vault (hidden prompt, stdin or --from-env VAR; never as an argument)
   connectors ls|connect|disconnect [id]   Your connectors (Shopify, Stripe, monday\u2026): connect opens the browser or asks for the key
@@ -13607,7 +13724,8 @@ ${bold("Configurar un agente")}
   skills house <id>                  Las skills de Ghosty en bloque   [--only a,b | --enable a,b | --disable a,b] [--dry-run]
   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|rename|rm <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 ls|tables|query|export|import|rehost|grant|revoke|rename|rm <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 export <id> <db>      Descarga una base: entera como .sqlite, o una tabla en CSV   [--table T] [--out ARCHIVO]
   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]  (headers http admiten \${turn.token})
   channels whatsapp ls|enable|disable <id> [n\xFAmero]   Qu\xE9 n\xFAmeros de WhatsApp Business contesta   [--dry-run]
@@ -13666,7 +13784,8 @@ ${bold("Partners")}  ${dim("(dale un agente a cada uno de TUS clientes \u2014 ve
   partner ls | enable | credentials | agent | tenants | audit | try
 
 ${bold("Tu cuenta")}
-  me files ls|get|upload|rm Archivos de tu cuenta         [--q TEXTO] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out ARCHIVO]
+  me files ls|get|export|upload|rm Archivos de tu cuenta [--q TEXTO] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out ARCHIVO]
+  me files export           Baja TODOS tus archivos a una carpeta (documentos, conversaciones, biblioteca); repetirlo = s\xF3lo lo nuevo   [--out CARPETA] [--kind K] [--dry-run]
   me memories ls|add|edit|rm Lo que tus agentes recuerdan de ti (s\xF3lo chats personales)   add "texto" \xB7 edit <id> "texto" \xB7 rm <id>
   credentials ls|set|rm [proveedor]   Llaves de proveedor en tu b\xF3veda (prompt oculto, stdin o --from-env VAR; nunca como argumento)
   connectors ls|connect|disconnect [id]   Tus conectores (Shopify, Stripe, monday\u2026): connect abre el navegador o pide la llave
@@ -13917,7 +14036,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.48.0" }, () => "0.48.0");
+  if (v.version) return out({ version: "0.49.0" }, () => "0.49.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -14077,7 +14196,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.48.0").catch(() => null);
+var notice = updateNotice("0.49.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.48.0",
+  "version": "0.49.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": {