@ghostystudio/cli 0.10.1 → 0.11.0

package/README.md

@@ -31,7 +31,7 @@ ghosty agents set <id> --voice elevenlabs:ID --voice-replies auto --auto-stage o
 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 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] [--from easybits:ID --tables a,b --append --dry-run]
+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 turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
 ghosty turns show <id> [turn-id|last]    # where a turn's time went: each tool with its seconds, output tokens
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
@@ -43,6 +43,7 @@ ghosty try <id> "message" --waba --session PHONE [--media FILE] [--history FILE]
 ghosty try <id> --replay FILE --out DIR  [--max 15] [--concurrency 8] [--resume]
 ghosty chat <id> ["message"]             [--conversation ID]
 ghosty conversations ls <id>
+ghosty conversations show <id> <conversation-id> [--limit 20]   # what was said
 
 ghosty schedule add <id> "what to do"    --in 30m | --at ISO  [--every 12h --until ISO] [--conversation ID] [--title T]
 ghosty schedule ls <id>
@@ -74,6 +75,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.11.0
+
+- New: `conversations show` (what was said in a conversation; `--limit 0` for all).
+
 ### Changes in 0.10.0
 
 - Tells you when a new version is out (checks npm once a day, on stderr; `GHOSTY_NO_UPDATE_CHECK=1` or `CI` turns it off). An unknown option on an old version says to update.

package/dist/index.js

@@ -282,7 +282,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.10.1"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.11.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -324,7 +324,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.10.1"}`,
+      "user-agent": `ghosty-cli/${"0.11.0"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -851,6 +851,17 @@ async function conversationsLs(agent) {
   const rows = r.conversaciones.map((c) => ({ id: c.id, title: c.titulo, updated: c.actualizada }));
   out(rows, () => table(rows, ["id", "title", "updated"]));
 }
+async function conversationsShow(agent, sid, v) {
+  if (!agent || !sid) throw usage("Missing agent id or conversation id.", "Example: ghosty conversations show <agent-id> <conversation-id> [--limit 20]");
+  const tail = v.limit ?? "20";
+  const r = await api(convPath(agent, `/${enc3(sid)}?tail=${enc3(tail)}`));
+  out(r, () => {
+    const lines = r.messages.map((m) => `${bold(m.role === "user" ? "User" : m.role === "assistant" ? "Agent" : m.role)}  ${m.text.trim()}`);
+    const head = r.saltados ? [dim(`(${r.saltados} earlier messages not shown \xB7 --limit 0 for all)`)] : [];
+    const tailNote = r.enCurso ? [dim("(a turn is running: its answer is not here yet)")] : [];
+    return [...head, ...lines, ...tailNote].join("\n\n") || dim("(empty)");
+  });
+}
 async function turn(agent, sid, text, first) {
   const turnId = randomUUID();
   const ctrl = new AbortController();
@@ -1125,7 +1136,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.10.1"}`
+        "user-agent": `ghosty-cli/${"0.11.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1290,6 +1301,24 @@ async function partnerCmd(sub, a1, a2, v) {
   }
 }
 
+// src/rows.ts
+var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function parseRowScope(raw) {
+  const s = raw.trim();
+  if (!s) return null;
+  const out2 = {};
+  for (const part of s.split(",").map((x) => x.trim()).filter(Boolean)) {
+    const [table2, cols = ""] = part.split(":").map((x) => x.trim());
+    const list = cols.split("+").map((x) => x.trim()).filter(Boolean);
+    if (!IDENT.test(table2 ?? "") || !list.length || !list.every((c) => IDENT.test(c))) {
+      throw new Error(`\xAB${part}\xBB no es tabla:columna(+columna); ej. clientes:telefono+tel_secundario`);
+    }
+    out2[table2] = list;
+  }
+  return out2;
+}
+var describeRowScope = (scope) => Object.entries(scope ?? {}).map(([t, c]) => `${t} (${c.join(", ")})`).join("; ");
+
 // src/commands/data.ts
 var enc6 = encodeURIComponent;
 var agentPath2 = (id, rest = "") => `/api/v2/agents/${enc6(id)}${rest}`;
@@ -1327,16 +1356,17 @@ async function dbsCmd(sub, id, db, rest, v) {
     case "ls":
     case "list": {
       const r = await api(agentPath2(id, "/dbs"));
-      const rows = r.dbs.map((d) => ({ name: d.name, access: d.granted ? "granted" : "\u2014", "writes from customers": d.granted ? d.externalWriteTables.join(", ") || "(none)" : "", id: d.id }));
-      return out(r.dbs, () => rows.length ? table(rows, ["name", "access", "writes from customers", "id"]) : dim("This account has no databases yet: create one at /app/dbs."));
+      const rows = r.dbs.map((d) => ({ name: d.name, access: d.granted ? "granted" : "\u2014", "writes from customers": d.granted ? d.externalWriteTables.join(", ") || "(none)" : "", "own rows": d.granted ? Object.keys(d.externalRowScope ?? {}).join(", ") : "", id: d.id }));
+      return out(r.dbs, () => rows.length ? table(rows, ["name", "access", "writes from customers", "own rows", "id"]) : dim("This account has no databases yet: create one at /app/dbs."));
     }
     case "tables": {
       db = need2(db, "database (id or name)", "ghosty dbs tables <agent-id> <db>");
       const r = await api(agentPath2(id, `/dbs/${enc6(db)}`));
       const ext = new Set(r.externalWriteTables);
-      const rows = r.tables.map((t) => ({ table: t.name, rows: t.rows, "customer writes": ext.has(t.name) ? "yes" : "", columns: t.columns.map((c) => `${c.name}${c.pk ? "*" : ""}`).join(", ") }));
+      const own = r.externalRowScope ?? {};
+      const rows = r.tables.map((t) => ({ table: t.name, rows: t.rows, "customer writes": ext.has(t.name) ? "yes" : "", "customer sees": own[t.name] ? `own rows (${own[t.name].join(", ")})` : "", columns: t.columns.map((c) => `${c.name}${c.pk ? "*" : ""}`).join(", ") }));
       return out(r, () => `${bold(r.name)} ${r.granted ? lavender("granted") : dim("not granted")}
-${table(rows, ["table", "rows", "customer writes", "columns"])}`);
+${table(rows, ["table", "rows", "customer writes", "customer sees", "columns"])}`);
     }
     case "query":
     case "sql": {
@@ -1354,10 +1384,20 @@ ${dim(`${rows.length} row(s) \xB7 ${Math.round(r.ms)} ms`)}`;
       });
     }
     case "grant": {
-      db = need2(db, "database (id or name)", "ghosty dbs grant <agent-id> <db> [--external-write t1,t2]");
-      const body = v["external-write"] !== void 0 ? { externalWriteTables: csv(v["external-write"]) } : {};
+      db = need2(db, "database (id or name)", "ghosty dbs grant <agent-id> <db> [--external-write t1,t2] [--external-rows t:col+col]");
+      let rowScope;
+      try {
+        rowScope = v["external-rows"] !== void 0 ? parseRowScope(v["external-rows"]) : void 0;
+      } catch (e) {
+        throw usage(e.message, `ghosty dbs grant ${id} ${db} --external-rows clientes:telefono+tel_secundario`);
+      }
+      const body = {
+        ...v["external-write"] !== void 0 ? { externalWriteTables: csv(v["external-write"]) } : {},
+        ...rowScope !== void 0 ? { externalRowScope: rowScope } : {}
+      };
       const r = await api(agentPath2(id, `/dbs/${enc6(db)}`), { method: "PUT", body });
-      return out(r, () => `${lavender("\u2713")} ${r.name} granted. ${dim(`From customer channels it writes to: ${r.externalWriteTables.join(", ") || "nothing (read only)"}.`)}`);
+      const own = describeRowScope(r.externalRowScope);
+      return out(r, () => `${lavender("\u2713")} ${r.name} granted. ${dim(`From customer channels it writes to: ${r.externalWriteTables.join(", ") || "nothing (read only)"}.${own ? ` Each customer sees only their own rows of: ${own}.` : ""}`)}`);
     }
     case "import": {
       db = need2(db, "database (id or name)", "ghosty dbs import <agent-id> <db> --from easybits:<db-id>");
@@ -1675,13 +1715,14 @@ var HELPS = {
       "ghosty dbs tables <agent-id> <db>",
       '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] [--dry-run] [--yes]",
-      "ghosty dbs grant <agent-id> <db> [--external-write t1,t2]",
+      "ghosty dbs grant <agent-id> <db> [--external-write t1,t2] [--external-rows t:col+col,\u2026]",
       "ghosty dbs revoke <agent-id> <db>"
     ],
     flags: [
       ["--arg V", "query: value for a ? placeholder (repeatable)"],
       ["--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)'],
       ["--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)"],
@@ -1692,6 +1733,7 @@ var HELPS = {
       "ghosty dbs tables <id> totequim",
       '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"
     ],
     notes: ["<db> is the database id or its name. From owner channels the agent reads and writes everything granted."],
@@ -1755,7 +1797,7 @@ var HELPS = {
   },
   chat: {
     summary: "Stream a conversation; with no message it is interactive.",
-    usage: ['ghosty chat <agent-id> ["message"] [--conversation ID]', "ghosty conversations ls <agent-id>"],
+    usage: ['ghosty chat <agent-id> ["message"] [--conversation ID]', "ghosty conversations ls <agent-id>", "ghosty conversations show <agent-id> <conversation-id> [--limit 20]"],
     examples: ['ghosty chat <id> "hola"', "ghosty chat <id>"],
     learn: `${REF}#conversaciones`
   },
@@ -1899,7 +1941,7 @@ ${bold("Configure an agent")}
   files ls|get|put|rm <id> [path]    Files in the agent's machine   [--file LOCAL] [--out LOCAL]
   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|grant|revoke <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--from easybits:ID --dry-run]
+  dbs ls|tables|query|import|grant|revoke <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --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]
   board archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
@@ -1910,6 +1952,7 @@ ${bold("Talk to an agent")}
     --replay FILE --out DIR Replay real conversations; report written locally   [--max 15] [--concurrency 8] [--resume]
   chat <id> ["message"]     Stream a conversation (no message = interactive)   [--conversation ID]
   conversations ls <id>     List conversations
+  conversations show <id> <conversation>   What was said   [--limit 20] (0 = all)
   turns ls <id>             Recent turns and why they failed   [--errors] [--since 1h] [--limit N]
   turns show <id> [turn]    Where a turn's time went: each tool with its seconds, output tokens (default: last)
 
@@ -2008,6 +2051,7 @@ async function main() {
       arg: { type: "string", multiple: true },
       write: { type: "boolean" },
       "external-write": { type: "string" },
+      "external-rows": { type: "string" },
       "no-deliver": { type: "boolean" },
       deliver: { type: "boolean" },
       errors: { type: "boolean" },
@@ -2035,7 +2079,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.10.1" }, () => "0.10.1");
+  if (v.version) return out({ version: "0.11.0" }, () => "0.11.0");
   const [cmd, sub, a1, a2] = pos;
   if (cmd === "partner" && (v.help || !sub || sub === "help")) return out({ help: PARTNER_HELP }, () => PARTNER_HELP);
   const topic = cmd === "help" ? sub : v.help ? cmd : void 0;
@@ -2097,7 +2141,8 @@ async function main() {
       return chat(sub, a1, v);
     case "conversations":
       if (sub === "ls" || sub === "list") return conversationsLs(a1);
-      throw usage(`Unknown conversations subcommand: ${sub ?? "(none)"}.`, "Try: ghosty conversations ls <agent-id>");
+      if (sub === "show") return conversationsShow(a1, a2, v);
+      throw usage(`Unknown conversations subcommand: ${sub ?? "(none)"}.`, "Try: ghosty conversations ls <agent-id> \xB7 ghosty conversations show <agent-id> <conversation-id>");
     case "schedule":
       return scheduleCmd(sub, a1, a2, v);
     case "partner":
@@ -2118,7 +2163,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.10.1").catch(() => null);
+var notice = updateNotice("0.11.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.10.1",
+  "version": "0.11.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' --define:__VERSION__=\\\"$npm_package_version\\\"",
     "prepack": "npm run build",
-    "test": "for t in flags prompt api; 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; 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",