@ghostystudio/cli 0.14.0 → 0.15.0

package/README.md

@@ -44,11 +44,13 @@ ghosty channels whatsapp history <id> --integration ID [--days 7]   [--dry-run]
 ghosty channels wa import <id> --from-file F | --from-dir DIR --own-number yes|no   [--dry-run]   # personal WhatsApp session, no QR
 ghosty channels wa pair|status|pause <id>   [--phone N]
 ghosty channels wa groups ls|set|create <id> [group]      [--role equipo|cliente] [--on|--off] [--dry-run]   # personal WhatsApp groups
+ghosty board ls <id>                     [--q TEXT] [--limit 20]              # recent cards on its sales board
+ghosty board show <id> <folio|phone|id>  [--limit 20]                         # a card's thread, attachments and whether gs kept a copy
 ghosty board archive <id>                --integration X | --column X | --before 30d   [--dry-run]
 ghosty mcp get|set <id>                  [--file servers.json]
 
 ghosty try <id> "message"                [--session] [--reset]
-ghosty try <id> "message" --waba --session PHONE [--media FILE] [--history FILE]   # real WhatsApp path, nothing sent
+ghosty try <id> "message" --waba --session PHONE [--media FILE [--as-formmy]] [--history FILE]   # real WhatsApp path, nothing sent
 ghosty try <id> --replay FILE --out DIR  [--max 15] [--concurrency 8] [--resume]
 ghosty chat <id> ["message"]             [--conversation ID]
 ghosty conversations ls <id>
@@ -84,6 +86,12 @@ 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.15.0
+
+- `try --waba` lists everything the agent would send, tools included: 📍 location, 📄 files, 🎤 voice, ↩️ quotes, 🔘 buttons, 👤 contacts, reactions. Quotes and reactions now find the test message to point at.
+- `try --waba --media FILE --as-formmy`: the attachment arrives like a real Formmy forward (proxy with credential, copy to gs, transcription) and the output says whether the copy worked.
+- `board ls` (recent cards) and `board show <folio|phone|id>` (a card's thread: who wrote, text, attachment, copy in gs).
+
 ### Changes in 0.14.0
 
 - Fix: `--json` output over a pipe no longer gets cut at 64 KB (an 80 KB prompt came out as invalid JSON). The CLI now waits for stdout to drain before exiting.

package/dist/index.js

@@ -288,7 +288,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.14.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.15.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -330,7 +330,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.14.0"}`,
+      "user-agent": `ghosty-cli/${"0.15.0"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -428,13 +428,34 @@ async function uploadMedia(file) {
   const mime = MIME[ext] ?? "application/octet-stream";
   return { url: r.url, mime, filename: r.name, type: mime.startsWith("image/") ? "image" : mime.startsWith("audio/") ? "audio" : mime.startsWith("video/") ? "video" : "document" };
 }
+function richLine(s) {
+  const d = s.data ?? {};
+  const str = (k) => typeof d[k] === "string" ? d[k] : "";
+  switch (s.rich) {
+    case "ubicacion":
+      return `\u{1F4CD} ${str("nombre") || "location"} \xB7 ${Number(d.latitud).toFixed(4)},${Number(d.longitud).toFixed(4)}${str("direccion") ? dim(` ${str("direccion")}`) : ""}`;
+    case "boton":
+      return `\u{1F518} ${str("boton")} ${dim(str("url"))}  ${str("texto")}`;
+    case "contacto":
+      return `\u{1F464} ${str("nombre")} ${str("telefono")}`;
+    case "encuesta":
+      return `\u{1F4CA} ${str("pregunta")}`;
+    case "reaccion":
+      return `${str("emoji")} ${dim(`reaction to ${str("mensajeId") || "the last message"}`)}`;
+    case "cita":
+      return `\u21A9\uFE0F ${str("texto")} ${dim(`quoting ${str("mensajeId") || "the last message"}`)}`;
+  }
+}
 function sentText(sent) {
-  return sent.map((s) => s.kind === "text" ? `${lavender("\u2192")} ${s.text}` : s.kind === "voice" ? `${lavender("\u{1F3A4}")} ${s.text}` : `${lavender("\u{1F4CE}")} ${s.name} ${dim(s.url)}`).join("\n\n");
+  return sent.map(
+    (s) => s.kind === "text" ? `${lavender("\u2192")} ${s.text}` : s.kind === "voice" ? `${lavender("\u{1F3A4}")} ${s.text}` : s.kind === "file" ? `${lavender(/^audio\//.test(s.mime ?? "") ? "\u{1F3A4}" : "\u{1F4C4}")} ${s.name} ${dim(s.url)}` : richLine(s)
+  ).join("\n\n");
 }
 async function tryWaba(id, text, v) {
   const phone = v.session ?? "";
   if (!/^\d{10,15}$/.test(phone)) throw usage("--waba needs --session <phone> (10-15 digits, a made-up number).", 'Example: ghosty try <agent-id> "hola" --waba --session 5210000000009');
   if ((v.media?.length ?? 0) > 1) throw usage("One --media per turn (WhatsApp sends one file per message).", "Send several turns, one file each.");
+  if (v["as-formmy"] && !v.media?.length) throw usage("--as-formmy goes with --media FILE.", 'Example: ghosty try <agent-id> "" --waba --session 5210000000009 --media nota.ogg --as-formmy');
   if (!text && !v.media?.length && !v.reset) throw usage("Missing message.", 'Example: ghosty try <agent-id> "hola" --waba --session 5210000000009');
   let history;
   if (v.history) {
@@ -445,9 +466,11 @@ async function tryWaba(id, text, v) {
   }
   const media = v.media?.[0] ? await uploadMedia(v.media[0]) : void 0;
   if (process.stderr.isTTY && !globals.json && (text || media)) info(dim("Thinking\u2026 (the real WhatsApp path; nothing is sent)"));
-  const r = await tryPost(id, { as: "waba", session: phone, reset: v.reset, text: text ?? "", ...media ? { media } : {}, ...history ? { history } : {} });
+  const r = await tryPost(id, { as: "waba", session: phone, reset: v.reset, text: text ?? "", ...media ? { media } : {}, ...history ? { history } : {}, ...v["as-formmy"] ? { asFormmy: true } : {} });
   if (r.status !== 200) throw Object.assign(new Error(`${r.status} ${r.body.error ?? "turn failed"}`), { code: 1 });
-  out(r.body, () => (r.body.sent ? sentText(r.body.sent) || dim("(the agent sent nothing)") : dim("Session reset.")) + (r.body.error ? `
+  const via = r.body.media ? `
+${r.body.media.copied ? dim("attachment: downloaded through the Formmy-like proxy and copied to gs") : red("attachment: NOT copied to gs (the proxy download failed)")}` : "";
+  out(r.body, () => (r.body.sent ? sentText(r.body.sent) || dim("(the agent sent nothing)") : dim("Session reset.")) + via + (r.body.error ? `
 ${dim(`(warning: ${r.body.error})`)}` : ""));
 }
 async function tryReplay(id, v) {
@@ -1220,7 +1243,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.14.0"}`
+        "user-agent": `ghosty-cli/${"0.15.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1891,8 +1914,37 @@ Cards appear on the team's board (no "new lead" alerts).`, { yes: v.yes, retry:
 }
 
 // src/commands/board.ts
-async function boardCmd(sub, id, v) {
-  if (sub !== "archive") throw usage(`Unknown board subcommand: ${sub ?? "(none)"}.`, "Try: ghosty board archive <agent-id> --integration prueba --dry-run");
+var WHO = { user: "customer", assistant: "agent", operator: "operator" };
+async function boardLs(id, v) {
+  const qs = new URLSearchParams({ ...v.q ? { q: v.q } : {}, ...v.limit ? { limit: v.limit } : {} });
+  const r = await api(`/api/v2/agents/${encodeURIComponent(id)}/board/conversations?${qs}`);
+  const rows = r.conversations.map((c) => ({ folio: c.folio ? `#${c.folio}` : "", name: c.name ?? "", phone: c.phone, column: c.column ?? "", msgs: c.messages, last: (c.lastActivity ?? "").slice(0, 16).replace("T", " ") }));
+  out(r, () => rows.length ? `${table(rows, ["folio", "name", "phone", "column", "msgs", "last"])}
+${dim(`\xAB${r.board}\xBB \xB7 thread: ghosty board show ${id} <folio|phone>`)}` : dim(`No cards on \xAB${r.board}\xBB${v.q ? ` matching "${v.q}"` : ""}.`));
+}
+async function boardShow(id, ref, v) {
+  if (!ref) throw usage("Missing conversation.", `Example: ghosty board show ${id} "#12"   (folio, phone, session or id; list them with ghosty board ls ${id})`);
+  const r = await api(`/api/v2/agents/${encodeURIComponent(id)}/board/conversations/${encodeURIComponent(ref)}${v.limit ? `?limit=${encodeURIComponent(v.limit)}` : ""}`);
+  const c = r.conversation;
+  const head = `${bold(c.name ?? c.phone)} ${dim(`${c.folio ? `#${c.folio} \xB7 ` : ""}+${c.phone} \xB7 ${c.column ?? "no column"} \xB7 ${c.session}`)}`;
+  const line = (m) => {
+    const at = m.createdAt.slice(5, 16).replace("T", " ");
+    const media = m.mediaType || m.mediaFilename ? `
+      ${dim(`\u{1F4CE} ${m.mediaType ?? "file"} ${m.mediaFilename ?? ""} \xB7 ${m.mediaCopied ? "copy in gs" : "no copy"}`)}` : "";
+    return `${dim(at)}  ${lavender((WHO[m.role] ?? m.role).padEnd(8))} ${m.content.replace(/\n/g, "\n                  ")}${media}`;
+  };
+  out(r, () => [head, ...r.messages.map(line)].join("\n"));
+}
+async function boardCmd(sub, id, v, ref) {
+  if (sub === "ls" || sub === "list") {
+    if (!id) throw usage("Missing agent id.", "Example: ghosty board ls <agent-id> [--q text] [--limit 20]");
+    return boardLs(id, v);
+  }
+  if (sub === "show") {
+    if (!id) throw usage("Missing agent id.", 'Example: ghosty board show <agent-id> "#12"');
+    return boardShow(id, ref, v);
+  }
+  if (sub !== "archive") throw usage(`Unknown board subcommand: ${sub ?? "(none)"}.`, "Try: ghosty board ls <agent-id> \xB7 ghosty board show <agent-id> <folio|phone> \xB7 ghosty board archive <agent-id> --integration prueba --dry-run");
   if (!id) throw usage("Missing agent id.", "Example: ghosty board archive <agent-id> --integration prueba --dry-run");
   const filter = { ...v.integration ? { integration: v.integration } : {}, ...v.column ? { column: v.column } : {}, ...v.before ? { before: v.before } : {} };
   if (!Object.keys(filter).length) throw usage("Add at least one filter: --integration, --column or --before.", "A filter-less archive would empty the board.");
@@ -2073,13 +2125,14 @@ var HELPS = {
     summary: "Test turns: plain, through the real WhatsApp path (nothing is sent), or a replay of real conversations.",
     usage: [
       'ghosty try <agent-id> "message" [--session ID] [--reset]',
-      'ghosty try <agent-id> "message" --waba --session PHONE [--media FILE] [--history FILE] [--reset]',
+      'ghosty try <agent-id> "message" --waba --session PHONE [--media FILE [--as-formmy]] [--history FILE] [--reset]',
       "ghosty try <agent-id> --replay FILE --out DIR [--max 15] [--concurrency 8] [--resume]"
     ],
     flags: [
       ["--waba", "the real WhatsApp Business path: inherited context, price rule, board, voice. Shows what it WOULD send"],
       ["--session PHONE", "with --waba: a made-up customer phone (10-15 digits); each phone is its own conversation"],
       ["--media FILE", "with --waba: the customer sends this photo/audio/PDF (one per turn)"],
+      ["--as-formmy", "with --media: it arrives like a real Formmy forward (proxy with credential, copy to gs, transcription) and says if the copy worked"],
       ["--history FILE", "with --waba: what was said before, as [{role: user|agent, text, at?}]; counts on the first turn (--reset)"],
       ["--reset", "forget that test session (with --waba also its test thread)"],
       ["--replay FILE", "run the conversations in FILE ({sample: [{id, fakePhone, messages}]}) against the agent"],
@@ -2096,7 +2149,8 @@ var HELPS = {
     ],
     notes: [
       "Replays survive Ghosty deploys: a 503 is retried after its Retry-After; the report lives on your disk.",
-      "--whatsapp is now an alias of --waba."
+      "--whatsapp is now an alias of --waba.",
+      "--waba lists everything it would send, tools included: \u{1F4CD} location, \u{1F4C4} files, \u{1F3A4} voice, \u21A9\uFE0F quotes, \u{1F518} buttons, \u{1F464} contacts, reactions."
     ],
     learn: `${REF}#turnos-de-prueba`
   },
@@ -2189,16 +2243,22 @@ HELPS.channels = {
 };
 HELPS.board = {
   summary: "The agent's sales board. It belongs to the WORKSPACE: you must be a member, a shared agent is not enough.",
-  usage: ["ghosty board archive <agent-id> [--integration ID] [--column NAME] [--before 30d|ISO] [--dry-run] [--yes]"],
+  usage: [
+    "ghosty board ls <agent-id> [--q TEXT] [--limit 20]",
+    "ghosty board show <agent-id> <folio|phone|session|id> [--limit 20]",
+    "ghosty board archive <agent-id> [--integration ID] [--column NAME] [--before 30d|ISO] [--dry-run] [--yes]"
+  ],
   flags: [
+    ["--q TEXT", "ls: cards whose name, phone or last message contains TEXT"],
+    ["--limit N", "ls: cards (default 20) \xB7 show: last N messages (default 20, max 500)"],
     ["--integration ID", "cards from this channel/integration (e.g. prueba)"],
     ["--column NAME", "cards in this column"],
     ["--before T", "cards with no activity since T (30d, 12h or an ISO date)"],
     ["-n, --dry-run", "count and show a sample, change nothing"],
     ["--yes", "skip the confirmation (required without a terminal)"]
   ],
-  examples: ["ghosty board archive <id> --integration prueba --dry-run", "ghosty board archive <id> --column Perdido --before 30d --yes"],
-  notes: ["Archiving is reversible: when the customer writes again the card comes back. At least one filter is required."],
+  examples: ["ghosty board ls <id> --q 7712", 'ghosty board show <id> "#12"', "ghosty board show <id> 5210000009922 --limit 50", "ghosty board archive <id> --integration prueba --dry-run", "ghosty board archive <id> --column Perdido --before 30d --yes"],
+  notes: ["show prints each message with who wrote it (customer, agent, operator), its attachment and whether gs keeps a copy of it.", "Archiving is reversible: when the customer writes again the card comes back. At least one filter is required."],
   learn: `${REF}#tablero`
 };
 HELPS.conversations = HELPS.chat;
@@ -2303,11 +2363,13 @@ ${bold("Configure an agent")}
   channels wa pair <id> --phone N         Pair a personal WhatsApp by code (no QR)
   channels wa status|pause <id>           Personal WhatsApp: how it is / pause it (keeps the session)
   channels wa groups ls|set|create <id> [group]        Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--on|--off] [--dry-run]
+  board ls <id>             Recent cards on its sales board   [--q TEXT] [--limit 20]
+  board show <id> <card>    A card's thread: who wrote, text, attachments and whether gs kept a copy   (folio, phone or id)
   board archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
 ${bold("Talk to an agent")}
   try <id> "message"        One test turn, prints the full answer   [--session] [--reset]
-    --waba --session PHONE  \u2026through the real WhatsApp path, nothing sent   [--media FILE] [--history FILE]
+    --waba --session PHONE  \u2026through the real WhatsApp path, nothing sent; lists what it would send (tools too)   [--media FILE [--as-formmy]] [--history FILE]
     --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
@@ -2419,6 +2481,8 @@ async function main() {
       limit: { type: "string" },
       verbose: { type: "boolean" },
       full: { type: "boolean" },
+      "as-formmy": { type: "boolean" },
+      q: { type: "string" },
       "prompt-out": { type: "string" },
       toolsets: { type: "string" },
       "prompt-base": { type: "string" },
@@ -2458,7 +2522,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.14.0" }, () => "0.14.0");
+  if (v.version) return out({ version: "0.15.0" }, () => "0.15.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;
@@ -2509,7 +2573,7 @@ async function main() {
     case "turns":
       return turnsCmd(sub, a1, a2, v);
     case "board":
-      return boardCmd(sub, a1, v);
+      return boardCmd(sub, a1, v, a2);
     case "channels":
       if (a1 === "groups") return groupsCmd(pos.slice(3).filter((x) => x !== void 0), v);
       return channelsCmd(sub, a1, a2, pos.slice(4).join(" ") || void 0, v);
@@ -2544,7 +2608,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.14.0").catch(() => null);
+var notice = updateNotice("0.15.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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