@ghostystudio/cli 0.13.2 → 0.15.0

package/README.md

@@ -16,9 +16,11 @@ npm i -g @ghostystudio/cli && ghosty login
 ghosty whoami
 ghosty usage                                          # plan and usage this week / month (also: ghosty me usage)
 ghosty agents ls
-ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,…]
-ghosty agents get <id> [--fields name,model,prompt]
-ghosty agents set <id> [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,…] [--connect ID,…] [--disconnect ID,…]
+ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,…] [--workspace SLUG] [--channels teams=off]
+ghosty agents get <id> [--fields name,model,prompt] [--prompt-out FILE]
+ghosty agents set <id> [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,…] [--connect ID,…] [--disconnect ID,…] [--toolsets +crm]
+ghosty agents set <id> --prompt-base <base-id> --prompt-overlay overlay.json [--dry-run]   # prompt = another agent's + edits, kept in sync
+ghosty agents share|unshare <id> <email> [--role editor|admin]   # share without handing it over · agents shares <id> lists them
 ghosty agents rm <id> [--yes]
 ghosty agents restart <id>
 ghosty agents box <id> [--check PATH]… [--contains PATH=TEXT]… [--recycle]   # is its machine on the new image?
@@ -26,24 +28,29 @@ ghosty agents demo <id> [--slug NAME] [--on | --off] [--vence "YYYY-MM-DDTHH:MM"
                         [--welcome TEXT] [--starter TEXT] [--chips "a|b|c"] [--sponsor on|off] [--rotate]   # public /p/ link, no account needed
 ghosty agents doctor <id> [--verbose]                 # exits 1 when it finds a problem
 ghosty agents docs ls|grant|revoke <id> [doc]         [--write] [--no-deliver]
+ghosty agents docs add <id> --url URL | --file PATH   [--description TEXT] [--grant read|write|no]
 ghosty agents set <id> --voice elevenlabs:ID --voice-replies auto --auto-stage on
 
 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 on|off <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 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 turns show <id> [turn-id|last]    # what came in, what it answered, where the time went   [--full]
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
 ghosty channels whatsapp link|unlink <id> --integration ID --answer on|off   [--forward] [--dry-run]   # bring a WABA number from Formmy
+ghosty channels whatsapp history <id> --integration ID [--days 7]   [--dry-run]   # its recent cards, messages and orders (no duplicates)
 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>
@@ -79,6 +86,21 @@ 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.
+- `agents get --prompt-out FILE`; `agents create --workspace SLUG --channels …` (born in a workspace, active in its Teams); `agents set --toolsets`; `agents share|unshare|shares`; `agents docs add --url|--file`; `skills on|off`.
+- `turns show` prints what came in and what the agent answered, on any engine or channel (`--full` for the whole text).
+- `agents doctor` flags databases the prompt names that the agent doesn't have (EasyBits ids left over from a migration).
+- `agents set --prompt-base <agent> --prompt-overlay overlay.json`: a prompt derived from another agent's plus a JSON overlay of edits; it regenerates when the base changes (`--prompt-base none` unlinks).
+- `channels whatsapp history`: bring a WhatsApp Business number's recent cards, messages and orders from Formmy to the board.
+
 ### Changes in 0.13.2
 
 - `channels whatsapp ls` shows the real number, "records only" numbers, and whether Formmy forwards to gs. `whatsapp link` stores the number's name and phone.

package/dist/index.js

@@ -52,6 +52,12 @@ function table(rows, cols) {
   const line = (vals) => vals.map((v, i) => v.padEnd(w[i])).join("  ").trimEnd();
   return [bold(line(cols.map((c) => c.toUpperCase()))), ...rows.map((r) => line(cols.map((c) => cell(r[c]))))].join("\n");
 }
+function exitAfterFlush(code) {
+  process.exitCode = code;
+  process.stdout.write("", () => process.exit(code));
+  return new Promise(() => {
+  });
+}
 function fail(e) {
   const err = e instanceof CliError ? e : new CliError(e instanceof Error ? e.message : String(e));
   if (globals.json) {
@@ -60,7 +66,7 @@ function fail(e) {
     info(red("Error: ") + err.message);
     if (err.hint) info(dim(err.hint));
   }
-  process.exit(err.code);
+  return exitAfterFlush(err.code);
 }
 async function openUrl(url) {
   const { spawn } = await import("node:child_process");
@@ -282,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.13.2"}`, "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);
@@ -324,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.13.2"}`,
+      "user-agent": `ghosty-cli/${"0.15.0"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -422,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) {
@@ -439,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) {
@@ -522,8 +551,18 @@ function parseEnv(raw) {
   }
   return env;
 }
+function parseChannels(raw) {
+  if (!raw) return void 0;
+  const ch = {};
+  for (const pair of raw.split(",").map((x) => x.trim()).filter(Boolean)) {
+    const [k, val] = pair.split("=");
+    if (!["teams", "web", "whatsapp", "messenger", "wa"].includes(k) || val !== "on" && val !== "off") throw usage(`Bad --channels entry: ${pair}.`, "Use teams|web|whatsapp|messenger|wa=on|off, comma-separated (wa = personal WhatsApp)");
+    ch[k] = val === "on";
+  }
+  return ch;
+}
 async function agentsCreate(v) {
-  const name = need(v.name, "--name", "ghosty agents create --name Moon --engine ghosty-lite --model gpt-5.6-luna");
+  const name = need(v.name, "--name", "ghosty agents create --name Moon --engine ghosty-lite --model gpt-5.6-luna [--workspace SLUG]");
   const body = { name };
   if (v.engine) body.engine = v.engine;
   if (v.model) body.model = v.model;
@@ -531,31 +570,64 @@ async function agentsCreate(v) {
   if (v["prompt-file"]) body.prompt = await readFile3(v["prompt-file"], "utf8");
   const env = parseEnv(v.env);
   if (env) body.env = env;
+  if (v.workspace) body.workspace = v.workspace;
+  const channels = parseChannels(v.channels);
+  if (channels) body.channels = channels;
   const r = await api("/api/v2/me/agents", { method: "POST", body });
+  const where = r.workspace ? `
+  workspace: ${r.workspace}${r.handle ? ` \xB7 @${r.handle} in Teams` : dim(" \xB7 not active in Teams")}` : "";
   out(r, () => `${lavender("\u2713")} Created ${r.name} ${dim(`(${r.engine} \xB7 ${r.model ?? "default"})`)}
-  id: ${r.id}`);
+  id: ${r.id}${where}`);
 }
-async function agentsGet(id, fields) {
+async function agentsGet(id, fields, promptOut) {
   id = need(id, "agent id", "ghosty agents get <agent-id>");
+  if (promptOut) {
+    const r = await api(agentPath(id, "?fields=prompt"));
+    const prompt = r.prompt ?? "";
+    await writeFile3(promptOut, prompt);
+    return out({ saved: resolve(promptOut), bytes: Buffer.byteLength(prompt) }, () => `${lavender("\u2713")} Prompt \u2192 ${promptOut} ${dim(`(${Buffer.byteLength(prompt)} bytes) \xB7 back: ghosty agents set ${id} --prompt-file ${promptOut}`)}`);
+  }
   const q = fields ? `?fields=${enc2(fields)}` : "?full=1";
   out(await api(agentPath(id, q)));
 }
 async function agentsSet(id, v) {
   id = need(id, "agent id", "ghosty agents set <agent-id> --prompt-file PROMPT.md");
+  if (v["prompt-base"]) {
+    const unlink = v["prompt-base"] === "none";
+    if (!unlink && !v["prompt-overlay"]) throw usage("Missing --prompt-overlay FILE.", 'Its format: {"edits":[{"what":"name","find":"Tania","replace":"Pia","all":true}]} (regex: true for patterns)');
+    const promptBase = unlink ? null : { agentId: v["prompt-base"], overlay: JSON.parse(await readFile3(v["prompt-overlay"], "utf8")) };
+    const r2 = await api(agentPath(id), { method: "PATCH", body: { promptBase, ...v["dry-run"] ? { dryRun: true } : {} } });
+    if (v["dry-run"] && r2.prompt) {
+      const out_ = v.out;
+      if (out_) await writeFile3(out_, r2.prompt);
+      return out({ ...r2, ...out_ ? { prompt: void 0, saved: resolve(out_) } : {} }, () => `${r2.chars} chars (base ${r2.baseChars}): every edit applies.${out_ ? ` Written to ${out_}.` : dim(" --out FILE to read it.")}
+${dim("Dry run: nothing changed.")}`);
+    }
+    return out(r2, () => r2.unlinked ? `${lavender("\u2713")} Unlinked: the prompt stays as it is and is edited by hand again.` : `${lavender("\u2713")} Prompt = ${v["prompt-base"]} + ${v["prompt-overlay"]} (${r2.chars} chars). It regenerates when the base changes; ghosty agents doctor ${id} tells if the overlay stops applying.`);
+  }
   const body = {};
   if (v.name) body.name = v.name;
   if (v.engine) body.engine = v.engine;
   if (v.model) body.model = v.model;
   if (v.prompt) body.prompt = v.prompt;
   if (v["prompt-file"]) body.prompt = await readFile3(v["prompt-file"], "utf8");
-  if (v.channels) {
-    const ch = {};
-    for (const pair of v.channels.split(",").map((x) => x.trim()).filter(Boolean)) {
-      const [k, val] = pair.split("=");
-      if (!["teams", "web", "whatsapp", "messenger", "wa"].includes(k) || val !== "on" && val !== "off") throw usage(`Bad --channels entry: ${pair}.`, "Use teams|web|whatsapp|messenger|wa=on|off, comma-separated (wa = personal WhatsApp)");
-      ch[k] = val === "on";
+  const channels = parseChannels(v.channels);
+  if (channels) body.channels = channels;
+  if (v.toolsets) {
+    const items = v.toolsets.split(",").map((x) => x.trim()).filter(Boolean);
+    const cur = await api(agentPath(id, "?fields=tools"));
+    const known = Object.keys(cur.tools?.toolsets ?? {});
+    const bad = items.map((x) => x.replace(/^[+-]/, "")).filter((x) => !known.includes(x));
+    if (bad.length) throw usage(`Unknown toolset: ${bad.join(", ")}.`, `Known: ${known.join(", ")}`);
+    const delta = items.every((x) => /^[+-]/.test(x));
+    if (!delta && items.some((x) => /^[+-]/.test(x))) throw usage("Mix of plain and +/- toolsets.", "Either a full list (crm,sales) or changes (+crm,-sales).");
+    const next = new Set(delta ? known.filter((k) => cur.tools?.toolsets?.[k]?.granted) : []);
+    for (const x of items) {
+      if (x.startsWith("-")) next.delete(x.slice(1));
+      else next.add(x.replace(/^\+/, ""));
     }
-    body.channels = ch;
+    next.delete("core");
+    body.tools = { toolsets: [...next] };
   }
   const env = parseEnv(v.env);
   if (env) body.env = env;
@@ -579,7 +651,7 @@ async function agentsSet(id, v) {
     if (v["auto-stage"] !== "on" && v["auto-stage"] !== "off") throw usage("--auto-stage takes on or off.");
     body.autoStage = v["auto-stage"] === "on";
   }
-  if (!Object.keys(body).length) throw usage("Nothing to change.", "Use --name, --engine, --model, --prompt, --prompt-file, --env, --channels, --connect, --disconnect, --voice, --voice-replies or --auto-stage.");
+  if (!Object.keys(body).length) throw usage("Nothing to change.", "Use --name, --engine, --model, --prompt, --prompt-file, --env, --channels, --toolsets, --connect, --disconnect, --voice, --voice-replies or --auto-stage.");
   const r = await api(agentPath(id), { method: "PATCH", body });
   out(r, () => `${lavender("\u2713")} Updated ${Object.keys(body).join(", ")}.`);
 }
@@ -592,6 +664,25 @@ async function agentsRm(id, v = {}) {
   }
   out(await api(agentPath(id), { method: "DELETE" }), () => `${lavender("\u2713")} Deleted ${id}.`);
 }
+async function agentsShare(sub, id, email, v) {
+  id = need(id, "agent id", "ghosty agents share <agent-id> <email> [--role admin|editor]");
+  if (sub === "shares") {
+    const r2 = await api(agentPath(id, "/shares"));
+    const rows = r2.shares.map((x) => ({ email: x.email, role: x.role, accepted: x.acceptedAt ? "yes" : "not yet" }));
+    return out(r2, () => `${dim(`owner: ${r2.owner ?? "?"}`)}
+${rows.length ? table(rows, ["email", "role", "accepted"]) : dim("Not shared with anyone.")}`);
+  }
+  email = need(email, "email", `ghosty agents ${sub} ${id} ana@empresa.com`);
+  if (sub === "unshare") {
+    requireYesIfHeadless(v.yes, `ghosty agents unshare ${id} ${email}`);
+    if (!v.yes) await confirm(`Remove ${email}'s access? On ACP agents this rotates the connection token (apps reconnect).`, { retry: `ghosty agents unshare ${id} ${email}` });
+    const r2 = await api(agentPath(id, "/shares"), { method: "DELETE", body: { email } });
+    return out(r2, () => `${lavender("\u2713")} ${email} no longer has access.${r2.tokenRotated ? dim(" Token rotated.") : ""}`);
+  }
+  if (v.role && v.role !== "admin" && v.role !== "editor") throw usage("--role takes admin or editor.");
+  const r = await api(agentPath(id, "/shares"), { method: "POST", body: { email, ...v.role ? { role: v.role } : {} } });
+  out(r, () => `${lavender("\u2713")} ${r.already ? `Already shared with ${r.email}` : `Shared with ${r.email}; they got an email`} ${dim(`(${r.role})`)}.`);
+}
 async function agentsRestart(id) {
   id = need(id, "agent id", "ghosty agents restart <agent-id>");
   out(await api(agentPath(id, "/restart"), { method: "POST", body: {} }), () => `${lavender("\u2713")} Restarting \u2014 the next turn uses the new config.`);
@@ -681,7 +772,7 @@ async function readSkillDir(dir) {
 }
 var trashDir = (id, slug) => join3(process.env.XDG_CONFIG_HOME || join3(homedir2(), ".config"), "ghosty", "trash", id, `${slug}-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`);
 async function skillsCmd(sub, id, slug, v) {
-  const ex = "ghosty skills ls <agent-id> | get <agent-id> <slug> [--out DIR] | templates <agent-id> | add <agent-id> <slug> [--file SKILL.md | --dir FOLDER] | rm <agent-id> <slug>";
+  const ex = "ghosty skills ls <agent-id> | on|off <agent-id> <slug> | get <agent-id> <slug> [--out DIR] | templates <agent-id> | add <agent-id> <slug> [--file SKILL.md | --dir FOLDER] | rm <agent-id> <slug>";
   id = need(id, "agent id", ex);
   switch (sub ?? "ls") {
     case "ls":
@@ -697,6 +788,13 @@ async function skillsCmd(sub, id, slug, v) {
 ${dim(`${more} more in the community catalog: ghosty skills add <agent-id> <slug> (--json lists them) \xB7 overlaps: ghosty agents doctor ${id}`)}`);
       return;
     }
+    case "on":
+    case "off": {
+      slug = need(slug, "skill slug", `ghosty skills ${sub} <agent-id> <slug>`);
+      const r = await api(agentPath(id, `/skills/${enc2(slug)}`), { method: "PATCH", body: { enabled: sub === "on" } });
+      out(r, () => `${lavender("\u2713")} ${slug} ${sub === "on" ? "on" : "off"} ${dim(`(${r.source === "house" ? "Ghosty's" : "own"}${r.nota ? `; ${r.nota}` : ""})`)}`);
+      return;
+    }
     case "get": {
       slug = need(slug, "skill slug", "ghosty skills get <agent-id> <slug> [--out DIR]");
       const sk = await api(agentPath(id, `/skills/${enc2(slug)}`));
@@ -1145,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.13.2"}`
+        "user-agent": `ghosty-cli/${"0.15.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1310,6 +1408,10 @@ 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";
+
 // src/rows.ts
 var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
 function parseRowScope(raw) {
@@ -1439,17 +1541,30 @@ async function agentDocsCmd(sub, id, doc, v) {
       const r = await api(agentPath2(id, `/documents/${enc6(doc)}`), { method: "PUT", body });
       return out(r, () => `${lavender("\u2713")} ${r.name}: ${r.mode === "write" ? "reads and replaces it" : "reads it"}${r.deliverable ? ", and can send it" : ", never sends it"}.`);
     }
+    case "add": {
+      if (!v.url === !v.file) throw usage("Use --url URL or --file PATH (one of them).", 'Example: ghosty agents docs add <agent-id> --url https://\u2026/lista.pdf --description "Precios 2026"');
+      if (v.grant && !["read", "write", "no"].includes(v.grant)) throw usage("--grant takes read, write or no.");
+      const body = {
+        ...v.url ? { url: v.url } : { contentBase64: (await readFile6(v.file)).toString("base64"), name: v.name ?? basename3(v.file) },
+        ...v.url && v.name ? { name: v.name } : {},
+        ...v.description ? { description: v.description } : {},
+        grant: v.grant === "no" ? false : v.grant === "write" || v.write ? "write" : "read",
+        ...v["no-deliver"] ? { deliverable: false } : {}
+      };
+      const r = await api(agentPath2(id, "/documents"), { method: "POST", body });
+      return out(r, () => `${lavender("\u2713")} ${r.name} uploaded ${dim(`(${r.size} bytes)`)}${r.granted ? `, ${r.mode === "write" ? "it reads and replaces it" : "it reads it"}.` : ". Not granted: ghosty agents docs grant " + id + ` "${r.name}"`}`);
+    }
     case "revoke": {
       doc = need2(doc, "document (id or exact name)", 'ghosty agents docs revoke <agent-id> "Cat\xE1logo.pdf"');
       const r = await api(agentPath2(id, `/documents/${enc6(doc)}`), { method: "DELETE" });
       return out(r, () => `${lavender("\u2713")} ${r.name} revoked. ${dim(`Undo: ghosty agents docs grant ${id} "${r.name}"`)}`);
     }
     default:
-      throw usage(`Unknown agents docs subcommand: ${sub}.`, "Try: ghosty agents docs ls | grant | revoke");
+      throw usage(`Unknown agents docs subcommand: ${sub}.`, "Try: ghosty agents docs ls | add | grant | revoke");
   }
 }
 async function turnsCmd(sub, id, turnId, v) {
-  if (sub === "show") return turnShow(id, turnId);
+  if (sub === "show") return turnShow(id, turnId, !!v.full);
   if (sub && sub !== "ls" && sub !== "list") throw usage(`Unknown turns subcommand: ${sub}.`, "Try: ghosty turns ls <agent-id> --errors --since 1h \xB7 ghosty turns show <agent-id> [turn-id|last]");
   id = need2(id, "agent id", "ghosty turns ls <agent-id> --errors --since 1h");
   const q = new URLSearchParams();
@@ -1472,12 +1587,19 @@ async function turnsCmd(sub, id, turnId, v) {
   out(r, () => rows.length ? `${table(rows, ["id", "started", "state", "secs", "from", "session", "error"])}
 ${dim(`${v.since ? `since ${v.since}: ` : ""}${tally} \xB7 where the time went: ghosty turns show ${id} <turn-id>`)}` : dim(`No ${status ?? ""} turns${v.since ? ` since ${v.since}` : ""}.`));
 }
-async function turnShow(id, turnId) {
-  id = need2(id, "agent id", "ghosty turns show <agent-id> [turn-id|last]");
+async function turnShow(id, turnId, full = false) {
+  id = need2(id, "agent id", "ghosty turns show <agent-id> [turn-id|last] [--full]");
   const r = await api(agentPath2(id, `/turns/${enc6(turnId ?? "last")}`));
   out(r, () => {
     const t = r.turn;
-    const head = `${bold(t.id)}  ${t.state === "error" ? red(t.state) : t.state}  ${t.secs ?? "?"} s  ${dim(`${r.totals.model ?? ""} \xB7 ${r.totals.modelCalls} model calls \xB7 ${r.totals.outputTokens} output tokens \xB7 ${r.totals.toolSecs} s in tools`)}`;
+    const clip = (s) => full || s.length <= 600 ? s : `${s.slice(0, 600)}\u2026 ${dim(`(+${s.length - 600} chars, --full)`)}`;
+    const io = [
+      `${lavender("in ")} ${r.input ? clip(r.input) : dim("(no copy of the message)")}`,
+      `${lavender("out")} ${r.output ? clip(r.output) : dim("(no answer saved)")}`
+    ];
+    const state = `${bold(t.id)}  ${t.state === "error" ? red(t.state) : t.state}  ${t.secs ?? "?"} s${t.session ? dim(`  ${t.session}`) : ""}`;
+    if (!r.totals) return [state, ...io, dim(`no timeline: ${r.why ?? "no transcript"}`)].join("\n");
+    const head = `${state}  ${dim(`${r.totals.model ?? ""} \xB7 ${r.totals.modelCalls} model calls \xB7 ${r.totals.outputTokens} output tokens \xB7 ${r.totals.toolSecs} s in tools`)}`;
     const line = (s) => {
       const at = `+${s.at.toFixed(1)}s`.padStart(8);
       if (s.kind === "tool") return `${at}  ${bold(s.tool ?? "?")} ${dim(s.input ?? "")}  ${s.secs === void 0 ? red("(no result)") : `${s.secs} s`}${s.error ? red(" error") : ""}`;
@@ -1485,7 +1607,7 @@ async function turnShow(id, turnId) {
       return s.kind === "thinking" ? `${at}  ${dim("thinking")}${tok}` : `${at}  ${s.text}${tok}`;
     };
     const top = r.byTool.slice(0, 5).map((b) => `${b.tool} ${b.secs} s (${b.calls})`).join(" \xB7 ");
-    return [head, ...r.steps.map(line), dim(`slowest: ${top || "\u2014"}`)].join("\n");
+    return [head, ...io, ...r.steps.map(line), dim(`slowest: ${top || "\u2014"}`)].join("\n");
   });
 }
 async function agentsDoctor(id, v) {
@@ -1507,7 +1629,7 @@ async function agentsDoctor(id, v) {
   }
   if (problems) {
     if (!globals.json) info(dim("Exit 1: problems found."));
-    process.exit(EXIT.API);
+    return exitAfterFlush(EXIT.API);
   }
 }
 
@@ -1583,10 +1705,10 @@ async function credentialsCmd2(sub, provider, v) {
 }
 
 // src/commands/channels.ts
-import { readFile as readFile7 } from "node:fs/promises";
+import { readFile as readFile8 } from "node:fs/promises";
 
 // src/wa-auth.ts
-import { readdir as readdir2, readFile as readFile6 } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile7 } from "node:fs/promises";
 import { join as join4 } 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) {
@@ -1601,7 +1723,7 @@ function keyOfFileName(name) {
 async function readMultiFileAuth(dir) {
   const files = (await readdir2(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 readFile6(join4(dir, "creds.json"), "utf8"));
+  const authCreds = JSON.parse(await readFile7(join4(dir, "creds.json"), "utf8"));
   const authKeys = {};
   const counts = {};
   const skipped = [];
@@ -1612,7 +1734,7 @@ async function readMultiFileAuth(dir) {
       skipped.push(f);
       continue;
     }
-    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile6(join4(dir, f), "utf8"));
+    (authKeys[k.type] ??= {})[k.id] = JSON.parse(await readFile7(join4(dir, f), "utf8"));
     counts[k.type] = (counts[k.type] ?? 0) + 1;
   }
   return { authCreds, authKeys, counts, skipped };
@@ -1631,6 +1753,7 @@ async function channelsCmd(kind, sub, id, ref, v) {
   if (kind !== "whatsapp" && kind !== "wa") throw usage(`Unknown channel: ${kind ?? "(none)"}.`, "Try: ghosty channels whatsapp ls <agent-id>");
   if (!id) throw usage("Missing agent id.", "Example: ghosty channels whatsapp ls <agent-id>");
   if (sub === "link" || sub === "unlink") return linkCmd(sub, id, v);
+  if (sub === "history") return historyCmd(id, v);
   if (sub === "import" || sub === "status" || sub === "pause" || sub === "pair") return waCmd(sub, id, v);
   if (sub === "enable" && !v["dry-run"]) requireYesIfHeadless(v.yes, `ghosty channels whatsapp enable ${id} ${ref ?? "<number>"}`);
   const path = `/api/v2/agents/${enc7(id)}/whatsapp`;
@@ -1646,7 +1769,7 @@ async function channelsCmd(kind, sub, id, ref, v) {
     }));
     return out(cur, () => rows.length ? table(rows, ["number", "answers", "formmy forwards", "id"]) : dim(`No WhatsApp Business numbers yet. Pair one at ${cur.salesUrl}`));
   }
-  if (sub !== "enable" && sub !== "disable") throw usage(`Unknown subcommand: ${sub}.`, "Try: ghosty channels whatsapp ls | enable | disable | link | unlink \xB7 ghosty channels wa import | status | pause | groups");
+  if (sub !== "enable" && sub !== "disable") throw usage(`Unknown subcommand: ${sub}.`, "Try: ghosty channels whatsapp ls | enable | disable | link | unlink | history \xB7 ghosty channels wa import | status | pause | groups");
   if (!ref) throw usage("Missing number.", `Example: ghosty channels whatsapp ${sub} ${id} +52 55 1234 5678`);
   const n = find(cur.numbers, ref);
   const on = sub === "enable";
@@ -1738,7 +1861,7 @@ ${dim("On the phone: WhatsApp \u2192 Linked devices \u2192 Link with phone numbe
     const m = await readMultiFileAuth(v["from-dir"]);
     info(dim(`${v["from-dir"]}: ${Object.entries(m.counts).map(([t, n]) => `${t} ${n}`).join(" \xB7 ") || "no keys"}${m.skipped.length ? ` \xB7 skipped ${m.skipped.length} unknown file(s)` : ""}`));
     data = { authCreds: m.authCreds, authKeys: m.authKeys };
-  } else data = JSON.parse(await readFile7(file, "utf8"));
+  } else data = JSON.parse(await readFile8(file, "utf8"));
   const body = { authCreds: data.authCreds, authKeys: data.authKeys, phone: data.phone, groups: data.groups, ownNumber: own === "yes", replace: !!v.replace };
   const plan = await api(`${base}/import`, { method: "POST", body: { ...body, dryRun: true } });
   if (v["dry-run"]) return out(plan, () => `${plan.plan.join("\n")}
@@ -1765,10 +1888,63 @@ ${sub === "link" ? "From now on this number's messages reach this agent in gs."
   const r = await api(path, { method: "POST", body });
   return out(r, () => `${lavender("\u2713")} ${sub === "link" ? `Linked (link ${r.linkId}). Check: ghosty channels whatsapp ls ${id} \xB7 ghosty turns ls ${id} --since 10m` : "Unlinked: Formmy points where it did before."}`);
 }
+async function historyCmd(id, v) {
+  if (!v.integration) throw usage("Missing --integration.", `Example: ghosty channels whatsapp history ${id} --integration <formmy-integration-id> --days 7 --dry-run`);
+  const days = Number(v.days ?? 7);
+  if (!Number.isInteger(days) || days < 1 || days > 30) throw usage("--days takes 1 to 30.");
+  const path = `/api/v2/agents/${enc7(id)}/whatsapp/history`;
+  const c = await api(path, { method: "POST", body: { integrationId: v.integration, days, dryRun: true } });
+  const plan = `${c.conversations} conversation(s), ${c.messages} message(s), ${c.orders} order(s) from the last ${days} day(s)${c.phoneNumber ? ` of +${c.phoneNumber}` : ""} \u2192 board ${c.board}`;
+  if (v["dry-run"]) return out(c, () => `${plan}
+${dim("Dry run: nothing imported. Re-running later never duplicates.")}`);
+  if (!c.conversations) return out({ ...c, imported: 0 }, () => dim(`Nothing to import: ${plan}.`));
+  await confirm(`${bold(plan)}
+Cards appear on the team's board (no "new lead" alerts).`, { yes: v.yes, retry: `ghosty channels whatsapp history ${id} --integration ${v.integration} --days ${days}` });
+  const sum = { newCards: 0, updatedCards: 0, messages: 0, orders: 0, suppressed: 0 };
+  let cursor = 0;
+  let done = 0;
+  while (cursor !== null) {
+    const p = await api(path, { method: "POST", body: { integrationId: v.integration, days, cursor } });
+    for (const k of Object.keys(sum)) sum[k] += p[k];
+    done += p.page;
+    if (!globals.json) info(dim(`  ${done}/${p.total} conversations`));
+    cursor = p.nextCursor;
+  }
+  out({ ...sum, conversations: done }, () => `${lavender("\u2713")} ${sum.newCards} new card(s), ${sum.updatedCards} updated, ${sum.messages} message(s), ${sum.orders} order(s)${sum.suppressed ? dim(` \xB7 ${sum.suppressed} bot draft(s) the customer never saw, skipped`) : ""}`);
+}
 
 // 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.");
@@ -1795,11 +1971,16 @@ var HELPS = {
     summary: "Create, inspect, change, check and delete agents.",
     usage: [
       "ghosty agents ls",
-      "ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,\u2026]",
-      "ghosty agents get <agent-id> [--fields name,model,prompt]",
-      "ghosty agents set <agent-id> [--name] [--engine] [--model] [--prompt | --prompt-file] [--env K=V,\u2026] [--connect ID,\u2026] [--disconnect ID,\u2026] [--voice E:ID] [--voice-replies auto|off] [--auto-stage on|off]",
+      "ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,\u2026] [--workspace SLUG] [--channels teams=off,\u2026]",
+      "ghosty agents get <agent-id> [--fields name,model,prompt] [--prompt-out FILE]",
+      "ghosty agents set <agent-id> [--name] [--engine] [--model] [--prompt | --prompt-file] [--env K=V,\u2026] [--connect ID,\u2026] [--disconnect ID,\u2026] [--voice E:ID] [--voice-replies auto|off] [--auto-stage on|off] [--toolsets crm,sales | +crm,-sales]",
+      "ghosty agents set <agent-id> --prompt-base <base-agent-id> --prompt-overlay overlay.json [--dry-run [--out FILE]]   |   --prompt-base none",
       "ghosty agents doctor <agent-id> [--verbose]",
       "ghosty agents docs ls|grant|revoke <agent-id> [doc] [--write] [--no-deliver]",
+      "ghosty agents docs add <agent-id> --url URL | --file PATH [--name N] [--description TEXT] [--grant read|write|no] [--no-deliver]",
+      "ghosty agents share <agent-id> <email> [--role editor|admin]",
+      "ghosty agents unshare <agent-id> <email> [--yes]",
+      "ghosty agents shares <agent-id>",
       "ghosty agents restart <agent-id>",
       "ghosty agents box <agent-id> [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle]",
       'ghosty agents demo <agent-id> [--slug NAME] [--on | --off] [--vence "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXT] [--starter TEXT] [--chips "a|b|c"] [--sponsor on|off] [--rotate]',
@@ -1807,13 +1988,21 @@ var HELPS = {
     ],
     flags: [
       ["--fields a,b", "get: return only these fields"],
-      ["--channels k=on|off,\u2026", "set: turn channels on/off: teams, web, whatsapp, messenger, wa (personal WhatsApp)"],
+      ["--prompt-out FILE", "get: write the prompt to FILE (edit it and come back with set --prompt-file)"],
+      ["--workspace SLUG", "create: born in that workspace (you own or administer it), owned by its owner and active in its Teams"],
+      ["--channels k=on|off,\u2026", "create/set: turn channels on/off: teams, web, whatsapp, messenger, wa (personal WhatsApp)"],
+      ["--toolsets LIST", "set: gs tool groups it gets (crm, sales\u2026): a list replaces; +x / -x add or remove"],
+      ["--prompt-base ID", "set: this agent's prompt = that agent's prompt + --prompt-overlay; regenerates when the base changes. none = unlink (keeps today's prompt)"],
+      ["--prompt-overlay FILE", 'set: JSON {"edits":[{"what","find","replace","regex"?,"all"?}]}, applied in order; each must find its place or nothing changes'],
       ["--voice E:ID", "set: voice for voice notes: elevenlabs:<voiceId> or kokoro:em_santa|em_alex|ef_dora"],
       ["--voice-replies M", "set: auto = answer with a voice note when the customer sends or asks for audio; off = always text"],
       ["--auto-stage on|off", "set: move board cards by itself after each customer turn (one extra model call per turn)"],
       ["--verbose", "doctor: also list the checks that passed"],
       ["--write", "docs grant: the agent may replace the document (default: read only)"],
-      ["--no-deliver", "docs grant: it can read it but never send it to whoever writes"],
+      ["--no-deliver", "docs grant/add: it can read it but never send it to whoever writes"],
+      ["--url URL | --file PATH", "docs add: where the document comes from (public URL, up to 25 MB, or a local file)"],
+      ["--grant read|write|no", "docs add: access for this agent (default read; no = only upload to the account)"],
+      ["--role R", "share: editor (configures and uses it) or admin (also shares it); again on a shared email changes the role"],
       ["--yes", "rm: skip the confirmation (required without a terminal)"],
       ["--slug NAME", "demo: link name; a 6-char code is appended (/p/NAME-CODE)"],
       ["--on | --off", "demo: turn the public link on or off"],
@@ -1835,16 +2024,23 @@ var HELPS = {
       "ghosty agents set <id> --voice elevenlabs:21m00Tcm4TlvDq8ikWAM --voice-replies auto --auto-stage on",
       'ghosty agents docs grant <id> "Cat\xE1logo 2026.pdf"',
       "ghosty agents docs grant <id> precios.xlsx --write --no-deliver",
+      'ghosty agents docs add <id> --url https://example.com/lista.pdf --description "Precios 2026"',
+      "ghosty agents create --name Pia --engine claude --workspace ventas --channels teams=off",
+      "ghosty agents set <id> --toolsets +crm",
+      "ghosty agents share <id> ana@empresa.com --role admin",
+      "ghosty agents get <id> --prompt-out PROMPT.md",
+      "ghosty agents set <pia-id> --prompt-base <tania-id> --prompt-overlay capa.json --dry-run --out /tmp/pia.md",
       'ghosty agents demo <id> --slug guardias --on --vence "2026-10-15T20:00" --starter "Ens\xE9\xF1ame c\xF3mo empezar"',
       "ghosty agents box <id> --contains /opt/claude-worker/skills/pdf-doc/render-doc.mjs=pdf-templates"
     ],
-    notes: ["doctor exits 1 when it finds a problem, so it can gate a script or CI.", "demo with no flags only prints its status: link, expiry, caps and numbers."],
+    notes: ["doctor exits 1 when it finds a problem, so it can gate a script or CI.", "A derived prompt can't be edited directly (409): change the base or the overlay, or unlink it with --prompt-base none.", "demo with no flags only prints its status: link, expiry, caps and numbers."],
     learn: `${REF}#agentes`
   },
   skills: {
     summary: "Skills of an agent (agentskills.io format: a folder with SKILL.md).",
     usage: [
       "ghosty skills ls <agent-id>",
+      "ghosty skills on|off <agent-id> <slug>",
       "ghosty skills get <agent-id> <slug> [--out DIR]",
       "ghosty skills templates <agent-id>",
       "ghosty skills add <agent-id> <slug> [--file SKILL.md | --dir FOLDER]",
@@ -1901,15 +2097,16 @@ var HELPS = {
   },
   turns: {
     summary: "An agent's recent turns: what answered, what failed and why, and where one turn's time went.",
-    usage: ["ghosty turns ls <agent-id> [--errors | --status STATE] [--since 1h] [--limit N]", "ghosty turns show <agent-id> [turn-id | last]"],
+    usage: ["ghosty turns ls <agent-id> [--errors | --status STATE] [--since 1h] [--limit N]", "ghosty turns show <agent-id> [turn-id | last] [--full]"],
     flags: [
       ["--errors", "only failed turns (same as --status error)"],
       ["--status S", "running | done | stopped | error"],
       ["--since T", "30m, 1h, 2d or an ISO date"],
-      ["--limit N", "max rows (default 20, max 500)"]
+      ["--limit N", "max rows (default 20, max 500)"],
+      ["--full", "show: the whole message that came in and the whole answer (default: first 600 chars)"]
     ],
     examples: ["ghosty turns ls <id> --errors --since 1h", "ghosty turns ls <id> --json --limit 100", "ghosty turns show <id>            # last turn: each tool, its seconds, output tokens"],
-    notes: ["show reads the worker's transcript: pool engines only (not ACP/goose)."],
+    notes: ["show prints what came in and what went out on any engine or channel (WhatsApp groups too); the timeline reads the worker's transcript, so pool engines only (not ACP/goose)."],
     learn: `${REF}#turnos`
   },
   files: {
@@ -1928,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"],
@@ -1951,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`
   },
@@ -1998,6 +2197,7 @@ HELPS.channels = {
     "ghosty channels whatsapp disable <agent-id> <number> [--dry-run]",
     "ghosty channels whatsapp link <agent-id> --integration <formmy-id> --answer on|off [--forward] [--dry-run] [--yes]",
     "ghosty channels whatsapp unlink <agent-id> --integration <formmy-id> [--dry-run] [--yes]",
+    "ghosty channels whatsapp history <agent-id> --integration <formmy-id> [--days 7] [--dry-run] [--yes]",
     "ghosty channels wa import <agent-id> --from-file creds.json | --from-dir auth/ --own-number yes|no [--replace] [--no-connect] [--dry-run] [--yes]",
     "ghosty channels wa pair <agent-id> --phone 5215512345678",
     "ghosty channels wa status|pause <agent-id>",
@@ -2011,7 +2211,8 @@ HELPS.channels = {
     ["--role R", "groups: equipo (the team: writes to databases, admin tools) or cliente (like any customer)"],
     ["--on | --off", "groups set: the agent answers in that group, or stops"],
     ["--cached", "groups ls: don't ask WhatsApp for the live list (faster; may miss new groups)"],
-    ["--integration ID", "link/unlink: the WhatsApp Business number's Integration id in Formmy"],
+    ["--integration ID", "link/unlink/history: the WhatsApp Business number's Integration id in Formmy"],
+    ["--days N", "history: conversations active in the last N days (1-30, default 7)"],
     ["--answer on|off", "link (required, no default): on = this agent answers real customers; off = it only records"],
     ["--forward", "link --answer off: still make Formmy forward, so gs sees the conversations"],
     ["--from-file F", "import: {authCreds, authKeys, phone, groups} exported from EasyBits"],
@@ -2027,6 +2228,7 @@ HELPS.channels = {
     "ghosty channels wa groups ls <id>",
     'ghosty channels wa groups set <id> "Pia-cotizadora" --role equipo --on --dry-run',
     "ghosty channels whatsapp link <id> --integration 6a3af395\u2026 --answer off --dry-run",
+    "ghosty channels whatsapp history <id> --integration 6a3af395\u2026 --days 7 --dry-run",
     "ghosty channels wa import <id> --from-file pia-wa.json --own-number no --dry-run"
   ],
   notes: [
@@ -2034,22 +2236,29 @@ HELPS.channels = {
     "Disabling keeps logging messages; nobody answers them.",
     "Groups belong to the PERSONAL WhatsApp paired to the agent (not WhatsApp Business). <group> is its name or its jid.",
     "link moves a number that already lives in Formmy (EasyBits, a droplet) without redoing Meta's signup; unlink sends it back. Only the owner, an admin of the agent or Ghosty staff.",
+    "history brings the number's recent cards, messages and orders from Formmy to the board (link it first). Re-running never duplicates: run it before the cutover and again right at it.",
     "import: turn off the EasyBits socket first WITHOUT logout (two sockets knock each other off; a logout invalidates the keys). Delete the file afterwards."
   ],
   learn: `${REF}#canales-de-whatsapp`
 };
 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;
@@ -2073,7 +2282,7 @@ function helpText(cmd) {
 }
 
 // src/update.ts
-import { mkdir as mkdir4, readFile as readFile8, writeFile as writeFile4 } from "node:fs/promises";
+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");
@@ -2089,7 +2298,7 @@ async function latestVersion() {
   if (process.env.GHOSTY_NO_UPDATE_CHECK || process.env.CI) return null;
   let cache = {};
   try {
-    cache = JSON.parse(await readFile8(FILE, "utf8"));
+    cache = JSON.parse(await readFile9(FILE, "utf8"));
   } catch {
   }
   if (!cache.checkedAt || Date.now() - cache.checkedAt > DAY) {
@@ -2122,13 +2331,18 @@ ${bold("Session")}
 ${bold("Agents")}
   agents ls                 List your agents
   agents create             Create an agent                   --name [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,\u2026]
-  agents get <id>           Show an agent's config            [--fields name,model,prompt]
+                            [--workspace SLUG] [--channels teams=off,\u2026]  born in a workspace, active in its Teams
+  agents get <id>           Show an agent's config            [--fields name,model,prompt] [--prompt-out FILE]
   agents set <id>           Change identity or engine         [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,\u2026]
                             [--connect google-drive,\u2026] [--disconnect \u2026]  give/remove access to your connectors
                             [--channels wa=on,teams=off]  turn channels on/off (wa = personal WhatsApp)
                             [--voice elevenlabs:ID | kokoro:em_santa] [--voice-replies auto|off] [--auto-stage on|off]
+                            [--toolsets crm,sales | +crm,-sales]  gs tool groups it gets
+                            [--prompt-base AGENT|none --prompt-overlay FILE [--dry-run]]  prompt = another agent's + edits, kept in sync
   agents doctor <id>        Check the config: overlapping skills, tools the prompt names, broken grants, failing turns
   agents docs ls|grant|revoke <id> [doc]   Documents it reads and may send   [--write] [--no-deliver]
+  agents docs add <id>      Upload a document and grant it   --url URL | --file PATH  [--description] [--grant read|write|no]
+  agents share|unshare <id> <email>   Share it without handing it over   [--role editor|admin] \xB7 agents shares <id> lists them
   agents rm <id>            Delete an agent (owner only; asks you to type its name, or --yes)
   agents restart <id>       Restart an ACP agent (needsRestart) so it loads new skills
   agents box <id>           The machine serving it: is it on the new image?   [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle]
@@ -2137,27 +2351,31 @@ ${bold("Agents")}
 
 ${bold("Configure an agent")}
   files ls|get|put|rm <id> [path]    Files in the agent's machine   [--file LOCAL] [--out LOCAL]
+  skills on|off <id> <slug>          Turn one of its skills (or one of Ghosty's) on or off
   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] [--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]
   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]
+  channels whatsapp history <id> --integration ID [--days 7]   Bring its recent cards, messages and orders from Formmy (no duplicates)   [--dry-run]
   channels wa import <id> --from-file F | --from-dir DIR --own-number yes|no   Move a personal WhatsApp session here, no QR   [--dry-run] [--replace] [--no-connect]
   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
   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)
+  turns show <id> [turn]    What came in, what it answered, and where the time went (default: last)   [--full]
 
 ${bold("Schedule turns")}  ${dim("(each run lands in a conversation and notifies your phone; an answer of exactly OK stays silent)")}
   schedule ls <id>                   Pending turns and recent runs
@@ -2184,7 +2402,7 @@ ${bold("Exit codes")}  0 ok \xB7 1 API error \xB7 2 usage error \xB7 3 not signe
 ${dim("Note: `ghosty` may collide with another binary on your PATH (e.g. the Ghosty TUI). Check with `which -a ghosty`; run `npx @ghostystudio/cli` to be sure.")}
 ${dim("Docs: https://www.ghosty.studio/docs/cli")}`;
 var COMMANDS = ["login", "logout", "whoami", "usage", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "partner", "me", "channels", "board", "credentials", "docs", "help"];
-var AGENTS_SUBS = ["ls", "create", "get", "set", "doctor", "docs", "rm", "restart", "demo", "box"];
+var AGENTS_SUBS = ["ls", "create", "get", "set", "doctor", "docs", "share", "unshare", "shares", "rm", "restart", "demo", "box"];
 function unknown(what, input, known, helpCmd) {
   const s = suggest(input, known);
   return usage(`Unknown command: ${what}.`, s ? `Did you mean "${s}"? Run: ${helpCmd}` : `Run: ${helpCmd}`);
@@ -2262,6 +2480,17 @@ async function main() {
       since: { type: "string" },
       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" },
+      "prompt-overlay": { type: "string" },
+      url: { type: "string" },
+      description: { type: "string" },
+      grant: { type: "string" },
+      days: { type: "string" },
       voice: { type: "string" },
       "voice-replies": { type: "string" },
       "auto-stage": { type: "string" },
@@ -2293,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.13.2" }, () => "0.13.2");
+  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;
@@ -2322,7 +2551,8 @@ async function main() {
     case "agents":
       if (sub === "ls" || sub === "list" || !sub) return agentsLs();
       if (sub === "create" || sub === "new") return agentsCreate(v);
-      if (sub === "get") return agentsGet(a1, v.fields);
+      if (sub === "get") return agentsGet(a1, v.fields, v["prompt-out"]);
+      if (sub === "share" || sub === "unshare" || sub === "shares") return agentsShare(sub, a1, a2, v);
       if (sub === "set") return agentsSet(a1, v);
       if (sub === "rm" || sub === "delete") return agentsRm(a1, v);
       if (sub === "doctor") return agentsDoctor(a1, v);
@@ -2343,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);
@@ -2378,19 +2608,19 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.13.2").catch(() => null);
+var notice = updateNotice("0.15.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;
     if (n) info(dim(n));
-    process.exit(EXIT.OK);
+    return exitAfterFlush(EXIT.OK);
   },
   async (e) => {
     if (e && typeof e === "object" && "code" in e && String(e.code).startsWith("ERR_PARSE_ARGS")) {
       const n = await notice;
-      fail(usage(e.message, n ? `${n}
+      return fail(usage(e.message, n ? `${n}
 This option may exist in the new version.` : `Run: ghosty --help   (or update: ${UPGRADE})`));
     }
-    fail(e);
+    return fail(e);
   }
 );

package/package.json

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