@ghostystudio/cli 0.8.0 → 0.9.1

package/README.md

@@ -8,29 +8,36 @@ npx -y @ghostystudio/cli login
 npm i -g @ghostystudio/cli && ghosty login
 ```
 
-`ghosty login` opens your browser (OAuth2 + PKCE). If you already have a session on ghosty.studio, opening the link is all it takes. A coding agent can drive it for you: `ghosty login --json` prints `{"event":"login_url","url":…}` first so the agent can hand you the link.
+`ghosty login` opens your browser (OAuth2 + PKCE). If you already have a session on ghosty.studio, opening the link is all it takes. A coding agent can drive it for you: `ghosty login --json` prints `{"event":"login_url","url":…}` first so the agent can hand you the link. Over SSH, CI or from another device, `ghosty login --device` gives you a link + code instead (automatic when there is no local browser).
 
 ## Commands
 
 ```bash
 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] [--model] [--prompt | --prompt-file FILE]
+ghosty agents set <id> [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,…] [--connect ID,…] [--disconnect ID,…]
+ghosty agents rm <id> [--yes]
 ghosty agents restart <id>
+ghosty agents demo <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]   # 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 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]
-ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--external-write t1,t2] [--from easybits:ID --dry-run]
-ghosty turns ls <id>                     [--errors] [--since 1h] [--limit N]
+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 turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
 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] [--whatsapp]
+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> --replay FILE --out DIR  [--max 15] [--concurrency 8] [--resume]
 ghosty chat <id> ["message"]             [--conversation ID]
 ghosty conversations ls <id>
 
@@ -41,14 +48,29 @@ ghosty schedule rm <id> <schedule-id>
 ghosty me files ls|upload|rm             [--kind image|video|audio|document|other]
 ghosty credentials ls|set|rm [provider]  [--from-env VAR]   # never as an argument
 ghosty docs
+
+ghosty partner ls|enable|credentials|agent|tenants|audit|try   # one agent for each of YOUR customers: ghosty partner --help
 ```
 
-Global: `--json` (stdout is JSON only), `--token <token>` / `GHOSTY_TOKEN` (a `gat_…` agent token reaches only that agent), `--help`, `--version`.
+Global: `--json` (stdout is JSON only), `--token <token>` / `GHOSTY_TOKEN` (a `gat_…` agent token reaches only that agent), `--profile <name>` / `GHOSTY_PROFILE` (a separate saved session, e.g. one per account), `--yes`, `--help`, `--version`. Env: `GHOSTY_URL`, `XDG_CONFIG_HOME`, `NO_COLOR`; partner commands sign with `GHOSTY_PARTNER_KEY` + `GHOSTY_PARTNER_SECRET` when set.
+
+Aliases: `creds` = `credentials`, `db` = `dbs`, `dbs sql` = `dbs query`.
 
 Every command has its own help with examples: `ghosty <command> --help` or `ghosty help <command>`.
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.9.1
+
+- `ghosty agents --help` describes every `agents demo` flag; `ghosty usage --help` has its own page.
+- "Learn more" links point to the exact section of https://www.ghosty.studio/docs/cli/comandos; `partner --help` links to /docs/cli/partners.
+
+### Changes in 0.9.0
+
+- `try --waba`: a test turn through the **real** WhatsApp Business path (inherited context, price rule, board, voice decision). It prints what it would have sent (text, voice note, files) and sends nothing. `--media` for photos/audio/PDF and `--history` to seed what was said before. `--whatsapp` is now an alias.
+- `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.8.0
 
 - Destructive commands (`agents rm`, `files rm`, `skills rm`, `credentials rm`, `board archive`, `dbs import` over existing rows, `channels whatsapp enable`) ask first. **Without a terminal they need `--yes`** or exit `2`.

package/dist/index.js

@@ -273,6 +273,40 @@ async function currentToken() {
   if (cfg.expiresAt !== void 0 && cfg.expiresAt - Date.now() < 6e4) cfg = await refresh(cfg) ?? cfg;
   return cfg.accessToken;
 }
+async function postLong(path, body, timeoutMs = 9e5) {
+  const base = await baseUrl();
+  const token = await currentToken();
+  const httpsRequest = base.startsWith("https:") ? (await import("node:https")).request : (await import("node:http")).request;
+  const data = JSON.stringify(body);
+  return new Promise((resolve) => {
+    const req = httpsRequest(`${base}${path}`, {
+      method: "POST",
+      timeout: timeoutMs,
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.9.1"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+    }, (res) => {
+      let buf = "";
+      res.on("data", (c) => buf += c);
+      res.on("end", () => {
+        let parsed;
+        try {
+          parsed = JSON.parse(buf);
+        } catch {
+          parsed = { error: buf.slice(0, 300) };
+        }
+        resolve({ status: res.statusCode ?? 0, retryAfter: retryAfterSeconds(res.headers["retry-after"]), body: parsed });
+      });
+    });
+    req.on("timeout", () => req.destroy(new Error(`no answer in ${Math.round(timeoutMs / 6e4)} min`)));
+    req.on("error", (e) => resolve({ status: 0, retryAfter: null, body: { error: String(e) } }));
+    req.end(data);
+  });
+}
+function retryAfterSeconds(h, now = Date.now()) {
+  if (!h) return null;
+  if (/^\d+$/.test(h.trim())) return Number(h.trim());
+  const t = Date.parse(h);
+  return Number.isNaN(t) ? null : Math.max(0, Math.round((t - now) / 1e3));
+}
 async function api(path, opts = {}) {
   const res = await request(path, opts);
   const text = await res.text();
@@ -290,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.8.0"}`,
+      "user-agent": `ghosty-cli/${"0.9.1"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -322,9 +356,9 @@ async function toError(res) {
 }
 
 // src/commands/agents.ts
-import { mkdir as mkdir2, readdir, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { mkdir as mkdir3, readdir, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname2, join as join2, relative } from "node:path";
+import { dirname as dirname2, join as join3, relative } from "node:path";
 
 // src/prompt.ts
 import { createInterface } from "node:readline/promises";
@@ -359,9 +393,109 @@ function suggest(input, known) {
   return known.find((k) => k.startsWith(input) && input.length >= 2);
 }
 
-// src/commands/agents.ts
+// src/commands/replay.ts
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { basename, join as join2 } from "node:path";
 var enc = encodeURIComponent;
-var agentPath = (id, rest = "") => `/api/v2/agents/${enc(id)}${rest}`;
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var MIME = { jpg: "image/jpeg", jpeg: "image/jpeg", png: "image/png", webp: "image/webp", gif: "image/gif", pdf: "application/pdf", ogg: "audio/ogg", opus: "audio/ogg", mp3: "audio/mpeg", m4a: "audio/mp4", wav: "audio/wav", mp4: "video/mp4" };
+async function tryPost(id, body) {
+  for (let attempt = 0; ; attempt++) {
+    const r = await postLong(`/api/v2/agents/${enc(id)}/try`, body);
+    if ((r.status === 503 || r.status === 409 || r.status === 0) && attempt < 40) {
+      const wait = r.status === 503 ? r.retryAfter ?? 15 : Math.min(30, 2 ** Math.min(attempt, 4) + 1);
+      if (!globals.json) info(dim(`  ${r.status === 503 ? "Ghosty is restarting" : r.status === 409 ? "previous turn still running" : "network error"} \u2014 retrying in ${wait}s`));
+      await sleep(wait * 1e3);
+      continue;
+    }
+    return { status: r.status, body: r.body };
+  }
+}
+async function uploadMedia(file) {
+  const bytes = await readFile2(file);
+  const ext = file.split(".").pop()?.toLowerCase() ?? "";
+  const r = await api(`/api/v2/me/files?nombre=${enc(basename(file))}`, {
+    method: "POST",
+    raw: new Uint8Array(bytes),
+    headers: { "content-type": "application/octet-stream" }
+  });
+  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 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");
+}
+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 (!text && !v.media?.length && !v.reset) throw usage("Missing message.", 'Example: ghosty try <agent-id> "hola" --waba --session 5210000000009');
+  let history;
+  if (v.history) {
+    const raw = JSON.parse(await readFile2(v.history, "utf8"));
+    history = Array.isArray(raw) ? raw : raw.messages;
+    if (!Array.isArray(history)) throw usage(`${v.history}: expected [{role, text, at?}] or {messages: [...]}.`);
+    if (!v.reset) info(dim("Note: history only counts on the first turn of a session; add --reset to start over."));
+  }
+  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 } : {} });
+  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 ? `
+${dim(`(warning: ${r.body.error})`)}` : ""));
+}
+async function tryReplay(id, v) {
+  if (!v.out) throw usage("--replay needs --out DIR (the report is written there after every step).", "Example: ghosty try <agent-id> --replay muestra.json --out ./replay");
+  const max = Number(v.max ?? 15);
+  const conc = Math.max(1, Math.min(30, Number(v.concurrency ?? 8)));
+  const input = JSON.parse(await readFile2(v.replay, "utf8"));
+  const convs = input.sample ?? [];
+  if (!convs.length) throw usage(`${v.replay}: no conversations in "sample".`, 'Format: {"sample": [{"id", "fakePhone", "messages": [{"role": "user"|"agent", "text"}]}]}');
+  await mkdir2(v.out, { recursive: true });
+  const file = join2(v.out, "replay.json");
+  const prev = v.resume ? JSON.parse(await readFile2(file, "utf8").catch(() => "null")) : null;
+  const report = prev ?? { agentId: id, startedAt: (/* @__PURE__ */ new Date()).toISOString(), finishedAt: null, done: false, results: {} };
+  report.done = false;
+  let saving = Promise.resolve();
+  const save = () => saving = saving.then(() => writeFile2(file, JSON.stringify(report, null, 1)));
+  info(`${bold("Replay")} ${convs.length} conversation(s), up to ${max} customer turns each, ${conc} at a time \u2192 ${file}`);
+  const queue = [...convs];
+  const worker = async () => {
+    for (let c = queue.shift(); c; c = queue.shift()) {
+      const pairs = [];
+      for (const m of c.messages) {
+        if (m.role === "user") pairs.push({ user: m.text, original: "" });
+        else if (pairs.length) pairs[pairs.length - 1].original += (pairs[pairs.length - 1].original ? "\n\n" : "") + m.text;
+      }
+      const entry = report.results[c.id] ??= { tags: c.tags ?? [], steps: [] };
+      const todo = pairs.slice(0, max).slice(entry.steps.length);
+      if (!todo.length) continue;
+      if (!entry.steps.length) await tryPost(id, { as: "waba", session: c.fakePhone, reset: true });
+      for (const p of todo) {
+        const t0 = Date.now();
+        const r = await tryPost(id, { as: "waba", session: c.fakePhone, text: p.user });
+        entry.steps.push({ user: p.user, original: p.original, reply: r.body.text ?? "", sent: r.body.sent ?? [], error: r.body.error ?? null, ms: Date.now() - t0, status: r.status });
+        await save();
+      }
+      const bad = entry.steps.filter((s) => s.status !== 200 || !s.reply).length;
+      info(`  ${bad ? red("!") : lavender("\u2713")} ${c.id}: ${entry.steps.length} turn(s)${bad ? `, ${bad} without an answer` : ""}`);
+    }
+  };
+  await Promise.all(Array.from({ length: Math.min(conc, convs.length) }, worker));
+  report.done = true;
+  report.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await save();
+  const steps = Object.values(report.results).flatMap((r) => r.steps);
+  const failed = steps.filter((s) => s.status !== 200 || !s.reply).length;
+  const summary = { file, conversations: Object.keys(report.results).length, turns: steps.length, failed, medianMs: steps.map((s) => s.ms).sort((a, b) => a - b)[Math.floor(steps.length / 2)] ?? 0 };
+  out(summary, () => `${failed ? red("!") : lavender("\u2713")} ${summary.turns} turn(s) in ${summary.conversations} conversation(s), ${failed} without an answer, median ${Math.round(summary.medianMs / 1e3)}s
+${dim(`Report: ${file}   Failed turns: ghosty turns ls ${id} --errors --since 2h`)}`);
+  if (failed) process.exitCode = 1;
+}
+
+// src/commands/agents.ts
+var enc2 = encodeURIComponent;
+var agentPath = (id, rest = "") => `/api/v2/agents/${enc2(id)}${rest}`;
 var need = (v, what, example) => {
   if (!v) throw usage(`Missing ${what}.`, `Example: ${example}`);
   return v;
@@ -394,7 +528,7 @@ async function agentsCreate(v) {
   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 readFile2(v["prompt-file"], "utf8");
+  if (v["prompt-file"]) body.prompt = await readFile3(v["prompt-file"], "utf8");
   const env = parseEnv(v.env);
   if (env) body.env = env;
   const r = await api("/api/v2/me/agents", { method: "POST", body });
@@ -403,7 +537,7 @@ async function agentsCreate(v) {
 }
 async function agentsGet(id, fields) {
   id = need(id, "agent id", "ghosty agents get <agent-id>");
-  const q = fields ? `?fields=${enc(fields)}` : "?full=1";
+  const q = fields ? `?fields=${enc2(fields)}` : "?full=1";
   out(await api(agentPath(id, q)));
 }
 async function agentsSet(id, v) {
@@ -413,7 +547,7 @@ async function agentsSet(id, v) {
   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 readFile2(v["prompt-file"], "utf8");
+  if (v["prompt-file"]) body.prompt = await readFile3(v["prompt-file"], "utf8");
   const env = parseEnv(v.env);
   if (env) body.env = env;
   const connectors = {};
@@ -455,11 +589,13 @@ async function agentsRestart(id) {
 }
 async function tryTurn(id, text, v) {
   id = need(id, "agent id", 'ghosty try <agent-id> "hello"');
+  if (v.replay) return tryReplay(id, v);
+  if (v.whatsapp && !v.waba) info(dim("Note: --whatsapp is now --waba (the real WhatsApp path)."));
+  if (v.waba || v.whatsapp || v.media?.length || v.history) return tryWaba(id, text, v);
   if (!text && !v.reset) throw usage("Missing message.", 'Example: ghosty try <agent-id> "hello"');
-  if (!process.stdout.isTTY || !text) {
-  } else info(dim("Thinking\u2026 (a test turn can take up to 3 minutes)"));
+  if (process.stderr.isTTY && text && !globals.json) info(dim("Thinking\u2026 (a test turn can take up to 3 minutes)"));
   const r = await api(agentPath(id, "/try"), {
-    body: { text, session: v.session, reset: v.reset, ...v.whatsapp ? { as: "whatsapp" } : {} }
+    body: { text, session: v.session, reset: v.reset }
   });
   out(r, () => (r.text ?? "") + (r.error ? `
 ${dim(`(warning: ${r.error})`)}` : ""));
@@ -481,14 +617,14 @@ ${table(r.files ?? [], cols)}`);
       const res = await request(agentPath(id, `/files/${p}`));
       const bytes = Buffer.from(await res.arrayBuffer());
       if (v.out) {
-        await writeFile2(v.out, bytes);
+        await writeFile3(v.out, bytes);
         out({ path: p, saved: v.out, bytes: bytes.length }, () => `${lavender("\u2713")} Saved ${bytes.length} bytes to ${v.out}`);
       } else process.stdout.write(bytes);
       return;
     }
     case "put": {
       need(path, "path", ex);
-      const data = v.file ? await readFile2(v.file) : await readStdin();
+      const data = v.file ? await readFile3(v.file) : await readStdin();
       const r = await api(agentPath(id, `/files/${p}`), { method: "PUT", raw: new Uint8Array(data), headers: { "content-type": "application/octet-stream" } });
       out(r ?? { path: p, bytes: data.length }, () => `${lavender("\u2713")} Wrote ${p} (${data.length} bytes).`);
       return;
@@ -512,11 +648,11 @@ async function readStdin() {
 async function writeSkill(dir, sk) {
   let bytes = 0;
   for (const f of sk.files) {
-    const full = join2(dir, f.path);
+    const full = join3(dir, f.path);
     if (relative(dir, full).startsWith("..")) continue;
-    await mkdir2(dirname2(full), { recursive: true });
+    await mkdir3(dirname2(full), { recursive: true });
     const b = Buffer.from(f.contentBase64, "base64");
-    await writeFile2(full, b);
+    await writeFile3(full, b);
     bytes += b.length;
   }
   return bytes;
@@ -526,15 +662,15 @@ async function readSkillDir(dir) {
   let markdown;
   const assets = [];
   for (const e of files) {
-    const full = join2(e.parentPath, e.name);
+    const full = join3(e.parentPath, e.name);
     const rel = relative(dir, full).split("\\").join("/");
-    if (rel === "SKILL.md") markdown = await readFile2(full, "utf8");
-    else if (!rel.split("/").some((part) => part.startsWith("."))) assets.push({ name: rel, contentBase64: (await readFile2(full)).toString("base64") });
+    if (rel === "SKILL.md") markdown = await readFile3(full, "utf8");
+    else if (!rel.split("/").some((part) => part.startsWith("."))) assets.push({ name: rel, contentBase64: (await readFile3(full)).toString("base64") });
   }
   if (!markdown) throw usage(`No SKILL.md in ${dir}.`, "A skill folder has SKILL.md at its root (agentskills.io).");
   return { markdown, assets };
 }
-var trashDir = (id, slug) => join2(process.env.XDG_CONFIG_HOME || join2(homedir2(), ".config"), "ghosty", "trash", id, `${slug}-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`);
+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> | add <agent-id> <slug> [--file SKILL.md | --dir FOLDER] | rm <agent-id> <slug>";
   id = need(id, "agent id", ex);
@@ -554,7 +690,7 @@ ${dim(`${more} more in the community catalog: ghosty skills add <agent-id> <slug
     }
     case "get": {
       slug = need(slug, "skill slug", "ghosty skills get <agent-id> <slug> [--out DIR]");
-      const sk = await api(agentPath(id, `/skills/${enc(slug)}`));
+      const sk = await api(agentPath(id, `/skills/${enc2(slug)}`));
       const dir = v.out ?? slug;
       const bytes = await writeSkill(dir, sk);
       out({ slug, saved: dir, files: sk.files.map((f) => f.path), bytes }, () => `${lavender("\u2713")} ${slug} \u2192 ${dir}/ ${dim(`(${sk.files.length} file(s), ${bytes} bytes)`)}`);
@@ -563,8 +699,8 @@ ${dim(`${more} more in the community catalog: ghosty skills add <agent-id> <slug
     case "add": {
       slug = need(slug, "skill slug", ex);
       if (v.file && v.dir) throw usage("Use --file or --dir, not both.");
-      const body = v.dir ? await readSkillDir(v.dir) : v.file ? { markdown: await readFile2(v.file, "utf8") } : { fromCatalog: true };
-      const r = await api(agentPath(id, `/skills/${enc(slug)}`), { method: "PUT", body });
+      const body = v.dir ? await readSkillDir(v.dir) : v.file ? { markdown: await readFile3(v.file, "utf8") } : { fromCatalog: true };
+      const r = await api(agentPath(id, `/skills/${enc2(slug)}`), { method: "PUT", body });
       out(r, () => `${lavender("\u2713")} Skill ${slug} installed.${r?.nota ? dim(` (${r.nota})`) : ""}`);
       return;
     }
@@ -572,11 +708,11 @@ ${dim(`${more} more in the community catalog: ghosty skills add <agent-id> <slug
     case "remove": {
       slug = need(slug, "skill slug", ex);
       requireYesIfHeadless(v.yes, `ghosty skills rm ${id} ${slug}`);
-      const sk = await api(agentPath(id, `/skills/${enc(slug)}`)).catch(() => null);
+      const sk = await api(agentPath(id, `/skills/${enc2(slug)}`)).catch(() => null);
       await confirm(`Remove skill ${slug} from agent ${id}?${sk ? " A local copy is kept." : ""}`, { yes: v.yes, retry: `ghosty skills rm ${id} ${slug}` });
       const backup = sk ? trashDir(id, slug) : null;
       if (sk && backup) await writeSkill(backup, sk);
-      const r = await api(agentPath(id, `/skills/${enc(slug)}`), { method: "DELETE" }) ?? { deleted: slug };
+      const r = await api(agentPath(id, `/skills/${enc2(slug)}`), { method: "DELETE" }) ?? { deleted: slug };
       const restore = backup ? `ghosty skills add ${id} ${slug} --dir "${backup}"` : null;
       out({ ...r, backup, restore }, () => `${lavender("\u2713")} Skill ${slug} removed.${restore ? `
 ${dim(`Backup: ${backup}
@@ -593,7 +729,7 @@ async function mcpCmd(sub, id, v) {
   if (sub === "get") return out(await api(agentPath(id, "/mcp")));
   if (sub === "set") {
     const file = need(v.file, "--file", ex);
-    const parsed = JSON.parse(await readFile2(file, "utf8"));
+    const parsed = JSON.parse(await readFile3(file, "utf8"));
     const body = { servers: Array.isArray(parsed) ? parsed : parsed.servers ?? [] };
     const r = await api(agentPath(id, "/mcp"), { method: "PUT", body });
     return out(r, () => `${lavender("\u2713")} MCP servers replaced \u2014 ${r?.reiniciado ? "the agent restarted with them." : "they load on the next turn."}`);
@@ -608,11 +744,12 @@ async function agentsDemo(id, v) {
   if (v.on) body.enabled = true;
   if (v.off) body.enabled = false;
   if (v.turns) body.maxTurns = Number(v.turns);
-  if (v.hours) body.trialHours = Number(v.hours);
+  if (v.vence !== void 0) body.venceEl = v.vence === "no" ? null : new Date(v.vence).toISOString();
   if (v["per-ip"]) body.perIpDay = Number(v["per-ip"]);
   if (v.welcome !== void 0) body.welcome = v.welcome;
   if (v.chips !== void 0) body.chips = v.chips.split("|").map((c) => c.trim()).filter(Boolean);
   if (v.starter !== void 0) body.starter = v.starter || null;
+  if (v.rotate) body.rotate = true;
   if (v.sponsor !== void 0) {
     if (v.sponsor !== "on" && v.sponsor !== "off") throw usage("--sponsor takes on or off.");
     body.sponsor = v.sponsor === "on";
@@ -622,7 +759,7 @@ async function agentsDemo(id, v) {
     d,
     () => [
       `${d.enabled ? lavender("\u25CF on") : dim("\u25CB off")}  ${d.url ?? dim("(no link yet: --slug NAME)")}`,
-      dim(`trial: ${d.trialHours} h from the first message \xB7 cap ${d.maxTurns} messages per visitor \xB7 ${d.perIpDay} per IP per day`),
+      dim(`expires: ${d.venceEl ? new Date(d.venceEl).toLocaleString("es-MX") : "never"} \xB7 cap ${d.maxTurns} messages per visitor \xB7 ${d.perIpDay} per IP per day`),
       d.welcome ? `welcome: ${d.welcome}` : dim("welcome: (default greeting)"),
       d.starter ? `starter: \u2728 ${d.starter}` : dim("starter: (none)"),
       d.chips.length ? `chips: ${d.chips.join(" | ")}` : dim("chips: (default)"),
@@ -635,8 +772,8 @@ async function agentsDemo(id, v) {
 // src/commands/chat.ts
 import { randomUUID } from "node:crypto";
 import { createInterface as createInterface2 } from "node:readline/promises";
-import { readFile as readFile3 } from "node:fs/promises";
-import { basename } from "node:path";
+import { readFile as readFile4 } from "node:fs/promises";
+import { basename as basename2 } from "node:path";
 
 // src/sse.ts
 async function* readSse(body) {
@@ -671,8 +808,8 @@ function parseData(e) {
 }
 
 // src/commands/chat.ts
-var enc2 = encodeURIComponent;
-var convPath = (agent, rest = "") => `/api/v2/me/agents/${enc2(agent)}/conversations${rest}`;
+var enc3 = encodeURIComponent;
+var convPath = (agent, rest = "") => `/api/v2/me/agents/${enc3(agent)}/conversations${rest}`;
 async function conversationsLs(agent) {
   if (!agent) throw usage("Missing agent id.", "Example: ghosty conversations ls <agent-id>");
   const r = await api(convPath(agent));
@@ -682,17 +819,17 @@ async function conversationsLs(agent) {
 async function turn(agent, sid, text, first) {
   const turnId = randomUUID();
   const ctrl = new AbortController();
-  const res = await request(convPath(agent, `/${enc2(sid)}/events`), { signal: ctrl.signal, headers: { accept: "text/event-stream" } });
+  const res = await request(convPath(agent, `/${enc3(sid)}/events`), { signal: ctrl.signal, headers: { accept: "text/event-stream" } });
   let cancelled = false;
   const onSigint = () => {
     if (cancelled) process.exit(130);
     cancelled = true;
     info(dim("\n(cancelling\u2026 press Ctrl-C again to quit)"));
-    void api(convPath(agent, `/${enc2(sid)}/cancel`), { method: "POST", body: {} }).catch(() => {
+    void api(convPath(agent, `/${enc3(sid)}/cancel`), { method: "POST", body: {} }).catch(() => {
     });
   };
   process.on("SIGINT", onSigint);
-  const sent = api(convPath(agent, `/${enc2(sid)}/messages`), { body: { content: text, turnId, primerTurno: first } });
+  const sent = api(convPath(agent, `/${enc3(sid)}/messages`), { body: { content: text, turnId, primerTurno: first } });
   let answer = "";
   let usageData;
   let ours = false;
@@ -771,7 +908,7 @@ async function meFiles(sub, arg, v) {
   switch (sub) {
     case "ls": {
       const r = await api(
-        `/api/v2/me/files${v.kind ? `?kind=${enc2(v.kind)}` : ""}`
+        `/api/v2/me/files${v.kind ? `?kind=${enc3(v.kind)}` : ""}`
       );
       out(r, () => {
         const rows = r.files.map((f) => ({ id: f.id, name: f.name, kind: f.kind, size: f.size, created: f.createdAt.slice(0, 10) }));
@@ -782,8 +919,8 @@ ${dim(`${(r.storage.usedBytes / 1e9).toFixed(2)} GB of ${r.storage.limitGb} GB u
     }
     case "upload": {
       if (!arg) throw usage("Missing file.", ex);
-      const bytes = await readFile3(arg);
-      const r = await api(`/api/v2/me/files?nombre=${enc2(basename(arg))}`, {
+      const bytes = await readFile4(arg);
+      const r = await api(`/api/v2/me/files?nombre=${enc3(basename2(arg))}`, {
         method: "POST",
         raw: new Uint8Array(bytes),
         headers: { "content-type": "application/octet-stream" }
@@ -793,7 +930,7 @@ ${dim(`${(r.storage.usedBytes / 1e9).toFixed(2)} GB of ${r.storage.limitGb} GB u
     }
     case "rm": {
       if (!arg) throw usage("Missing file id.", ex);
-      out(await api(`/api/v2/me/files/${enc2(arg)}`, { method: "DELETE" }) ?? { deleted: arg }, () => `${lavender("\u2713")} Deleted ${arg}`);
+      out(await api(`/api/v2/me/files/${enc3(arg)}`, { method: "DELETE" }) ?? { deleted: arg }, () => `${lavender("\u2713")} Deleted ${arg}`);
       return;
     }
     default:
@@ -816,7 +953,7 @@ async function meUsage() {
 }
 
 // src/commands/schedule.ts
-var enc3 = encodeURIComponent;
+var enc4 = encodeURIComponent;
 function minutesOf(s, flag) {
   const m = /^(\d+(?:\.\d+)?)\s*(m|min|h|d)?$/i.exec(s.trim());
   if (!m) throw usage(`Invalid ${flag}: ${s}.`, "Use minutes, hours or days: 30m, 12h, 1d");
@@ -832,7 +969,7 @@ function isoOf(s, flag) {
 var every = (min) => min == null ? "once" : min % 1440 === 0 ? `${min / 1440}d` : min % 60 === 0 ? `${min / 60}h` : `${min}m`;
 var short = (s, n = 60) => s.length > n ? s.slice(0, n - 1) + "\u2026" : s;
 async function agentSchedule(agent) {
-  return api(`/api/v2/me/agents/${enc3(agent)}/schedule`);
+  return api(`/api/v2/me/agents/${enc4(agent)}/schedule`);
 }
 async function scheduleCmd(sub, agent, arg, v) {
   if (sub === "ls" || sub === "list") {
@@ -875,13 +1012,13 @@ async function scheduleCmd(sub, agent, arg, v) {
     }
     let r;
     try {
-      r = await api(convPath(agent, `/${enc3(sid)}/schedule`), { body });
+      r = await api(convPath(agent, `/${enc4(sid)}/schedule`), { body });
     } catch (e) {
-      if (created) await api(convPath(agent, `/${enc3(sid)}`), { method: "DELETE" }).catch(() => {
+      if (created) await api(convPath(agent, `/${enc4(sid)}`), { method: "DELETE" }).catch(() => {
       });
       throw e;
     }
-    if (v.title && created) await api(convPath(agent, `/${enc3(sid)}`), { method: "PATCH", body: { title: v.title } });
+    if (v.title && created) await api(convPath(agent, `/${enc4(sid)}`), { method: "PATCH", body: { title: v.title } });
     const p = r.programado;
     return out(
       { scheduled: p },
@@ -893,7 +1030,7 @@ ${dim(`conversation ${p.sessionId}`)}`
     if (!agent || !arg) throw usage("Missing agent id or schedule id.", "Example: ghosty schedule rm <agent-id> <schedule-id>   (ids: ghosty schedule ls <agent-id>)");
     const row = (await agentSchedule(agent)).pendientes.find((p) => p.id === arg);
     if (!row) throw usage(`No pending scheduled turn ${arg}.`, "See them with: ghosty schedule ls <agent-id>");
-    await api(convPath(agent, `/${enc3(row.sessionId)}/schedule/${enc3(arg)}`), { method: "DELETE" });
+    await api(convPath(agent, `/${enc4(row.sessionId)}/schedule/${enc4(arg)}`), { method: "DELETE" });
     return out({ canceled: arg }, () => `${lavender("\u2713")} Canceled ${arg}`);
   }
   throw usage(`Unknown schedule subcommand: ${sub ?? "(none)"}.`, "Try: ghosty schedule ls | add | rm");
@@ -901,7 +1038,7 @@ ${dim(`conversation ${p.sessionId}`)}`
 
 // src/commands/partner.ts
 import { createHmac } from "node:crypto";
-import { readFile as readFile4 } from "node:fs/promises";
+import { readFile as readFile5 } from "node:fs/promises";
 var PARTNER_HELP = `${bold("Usage:")} ghosty partner <command> [options]
 
 ${bold("Partner space")}  ${dim("(you, signed in as the space owner)")}
@@ -932,8 +1069,8 @@ ${bold("Options")}
   --json             Machine-readable output
 
 ${bold("Server credential mode")}  GHOSTY_PARTNER_KEY=gpk_\u2026 GHOSTY_PARTNER_SECRET=gps_\u2026 ghosty partner agent get
-${dim("Docs: https://www.ghosty.studio/docs/cli")}`;
-var enc4 = encodeURIComponent;
+${dim("Docs: https://www.ghosty.studio/docs/cli/partners")}`;
+var enc5 = encodeURIComponent;
 function partnerCreds() {
   const key = process.env.GHOSTY_PARTNER_KEY;
   const secret = process.env.GHOSTY_PARTNER_SECRET;
@@ -953,7 +1090,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.8.0"}`
+        "user-agent": `ghosty-cli/${"0.9.1"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1001,10 +1138,10 @@ async function credentialsCmd(sub, id, v) {
   if (sub === "rotate") {
     const grace = v.grace !== void 0 ? Number(v.grace) : void 0;
     if (grace !== void 0 && (!Number.isFinite(grace) || grace < 0)) throw usage("--grace must be minutes \u2265 0.");
-    return showSecret(await json(`/api/v2/partner/credentials/${enc4(id)}/rotate`, v, { ...owner, method: "POST", body: { graceMinutes: grace } }));
+    return showSecret(await json(`/api/v2/partner/credentials/${enc5(id)}/rotate`, v, { ...owner, method: "POST", body: { graceMinutes: grace } }));
   }
   if (sub === "revoke" || sub === "rm") {
-    const r = await json(`/api/v2/partner/credentials/${enc4(id)}`, v, { ...owner, method: "DELETE" });
+    const r = await json(`/api/v2/partner/credentials/${enc5(id)}`, v, { ...owner, method: "DELETE" });
     return out(r, () => `${lavender("\u2713")} Revoked ${r.keyId}.`);
   }
   throw usage(`Unknown credentials subcommand: ${sub}.`, "Try: ghosty partner credentials ls | create | rotate | revoke");
@@ -1023,7 +1160,7 @@ async function agentCmd(sub, v) {
   }
   if (sub === "apply" || sub === "set") {
     if (!v.file) throw usage("Missing --file.", "Example: ghosty partner agent apply --file agent.json");
-    const body = JSON.parse(await readFile4(v.file, "utf8"));
+    const body = JSON.parse(await readFile5(v.file, "utf8"));
     const r = await json("/api/v2/partner/agent", v, { method: "PUT", body });
     return out(r, () => `${lavender("\u2713")} ${r.created ? "Created" : r.changed ? "Updated" : "No changes"} \xB7 v${r.agent.version}`);
   }
@@ -1035,7 +1172,7 @@ async function tenantsCmd(sub, id, v) {
     return out(r, () => table(r.tenants.map((t) => ({ externalId: t.externalId, config: JSON.stringify(t.config ?? {}), updated: fmt(t.updatedAt) })), ["externalId", "config", "updated"]));
   }
   if (!id) throw usage("Missing externalId.", `Example: ghosty partner tenants ${sub} org_123`);
-  const path = `/api/v2/partner/tenants/${enc4(id)}`;
+  const path = `/api/v2/partner/tenants/${enc5(id)}`;
   if (sub === "get") return out(await json(path, v));
   if (sub === "set" || sub === "apply") {
     if (!v.config) throw usage("Missing --config.", `Example: --config '{"name":"Spa","timezone":"America/Mexico_City"}'`);
@@ -1119,8 +1256,8 @@ async function partnerCmd(sub, a1, a2, v) {
 }
 
 // src/commands/data.ts
-var enc5 = encodeURIComponent;
-var agentPath2 = (id, rest = "") => `/api/v2/agents/${enc5(id)}${rest}`;
+var enc6 = encodeURIComponent;
+var agentPath2 = (id, rest = "") => `/api/v2/agents/${enc6(id)}${rest}`;
 var need2 = (v, what, example) => {
   if (!v) throw usage(`Missing ${what}.`, `Example: ${example}`);
   return v;
@@ -1136,7 +1273,7 @@ async function dbsImport(id, db, v) {
   const easybitsKey = process.env.EASYBITS_API_KEY;
   if (!easybitsKey) throw usage("EASYBITS_API_KEY is not set.", "Export your EasyBits API key (https://www.easybits.cloud/dash/developer) and run again.");
   const body = { from: "easybits", sourceDb: m[1], easybitsKey, mode: v.append ? "append" : "replace", ...v.tables ? { tables: csv(v.tables) } : {} };
-  const path = agentPath2(id, `/dbs/${enc5(db)}/import`);
+  const path = agentPath2(id, `/dbs/${enc6(db)}/import`);
   const dry = await api(path, { body: { ...body, dryRun: true } });
   if (v["dry-run"]) return out(dry, () => `${dry.db} \u2190 easybits:${m[1]}
 ${planText(dry.plan)}
@@ -1160,7 +1297,7 @@ async function dbsCmd(sub, id, db, rest, v) {
     }
     case "tables": {
       db = need2(db, "database (id or name)", "ghosty dbs tables <agent-id> <db>");
-      const r = await api(agentPath2(id, `/dbs/${enc5(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(", ") }));
       return out(r, () => `${bold(r.name)} ${r.granted ? lavender("granted") : dim("not granted")}
@@ -1170,7 +1307,7 @@ ${table(rows, ["table", "rows", "customer writes", "columns"])}`);
     case "sql": {
       db = need2(db, "database (id or name)", 'ghosty dbs query <agent-id> <db> "SELECT \u2026"');
       const sql = need2(rest.join(" ").trim() || void 0, "SQL", 'ghosty dbs query <agent-id> <db> "SELECT * FROM t LIMIT 10"');
-      const r = await api(agentPath2(id, `/dbs/${enc5(db)}/query`), { body: { sql, args: v.arg ?? [], write: v.write === true } }).catch((e) => {
+      const r = await api(agentPath2(id, `/dbs/${enc6(db)}/query`), { body: { sql, args: v.arg ?? [], write: v.write === true } }).catch((e) => {
         if (e instanceof CliError && !v.write && /lectura|SELECT|escribir/i.test(e.message)) throw new CliError(e.message, EXIT.API, "To write on purpose, add --write.");
         throw e;
       });
@@ -1184,7 +1321,7 @@ ${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"]) } : {};
-      const r = await api(agentPath2(id, `/dbs/${enc5(db)}`), { method: "PUT", body });
+      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)"}.`)}`);
     }
     case "import": {
@@ -1193,7 +1330,7 @@ ${dim(`${rows.length} row(s) \xB7 ${Math.round(r.ms)} ms`)}`;
     }
     case "revoke": {
       db = need2(db, "database (id or name)", "ghosty dbs revoke <agent-id> <db>");
-      const r = await api(agentPath2(id, `/dbs/${enc5(db)}`), { method: "DELETE" });
+      const r = await api(agentPath2(id, `/dbs/${enc6(db)}`), { method: "DELETE" });
       return out(r, () => `${lavender("\u2713")} ${r.name} revoked. ${dim(`Undo: ghosty dbs grant ${id} ${r.name}`)}`);
     }
     default:
@@ -1215,12 +1352,12 @@ async function agentDocsCmd(sub, id, doc, v) {
       if (v.write) body.mode = "write";
       if (v["no-deliver"]) body.deliverable = false;
       else if (v.deliver) body.deliverable = true;
-      const r = await api(agentPath2(id, `/documents/${enc5(doc)}`), { method: "PUT", body });
+      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 "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/${enc5(doc)}`), { method: "DELETE" });
+      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:
@@ -1344,7 +1481,7 @@ async function credentialsCmd2(sub, provider, v) {
 }
 
 // src/commands/channels.ts
-var enc6 = encodeURIComponent;
+var enc7 = encodeURIComponent;
 var digits = (s) => s.replace(/\D/g, "");
 function find(nums, ref) {
   const d = digits(ref);
@@ -1356,7 +1493,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 === "enable" && !v["dry-run"]) requireYesIfHeadless(v.yes, `ghosty channels whatsapp enable ${id} ${ref ?? "<number>"}`);
-  const path = `/api/v2/agents/${enc6(id)}/whatsapp`;
+  const path = `/api/v2/agents/${enc7(id)}/whatsapp`;
   const cur = await api(path);
   if (!sub || sub === "ls" || sub === "list") {
     const rows = cur.numbers.map((n2) => ({ number: n2.label, answers: n2.mine ? lavender("this agent") : n2.takenByOther ? "another agent" : dim("nobody (silent)"), id: n2.id }));
@@ -1400,6 +1537,7 @@ Archive ${plan.matched} card(s) on \xAB${plan.board}\xBB? (reversible: a new mes
 
 // src/help.ts
 var DOCS = "https://www.ghosty.studio/docs/cli";
+var REF = `${DOCS}/comandos`;
 var HELPS = {
   agents: {
     summary: "Create, inspect, change, check and delete agents.",
@@ -1411,7 +1549,7 @@ var HELPS = {
       "ghosty agents doctor <agent-id> [--verbose]",
       "ghosty agents docs ls|grant|revoke <agent-id> [doc] [--write] [--no-deliver]",
       "ghosty agents restart <agent-id>",
-      "ghosty agents demo <agent-id> [--slug NAME] [--on | --off] \u2026",
+      '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]',
       "ghosty agents rm <agent-id> [--yes]"
     ],
     flags: [
@@ -1422,17 +1560,28 @@ var HELPS = {
       ["--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"],
-      ["--yes", "rm: skip the confirmation (required without a terminal)"]
+      ["--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"],
+      ["--vence DATE|no", `demo: fixed expiry in your machine's time ("2026-10-15T20:00"); no = never`],
+      ["--turns N", "demo: messages per visitor (default 150)"],
+      ["--per-ip N", "demo: messages per IP per day (default 30)"],
+      ["--welcome TEXT", "demo: chat greeting (empty = default)"],
+      ["--starter TEXT", 'demo: highlighted first suggestion ("" removes it)'],
+      ['--chips "a|b|c"', "demo: suggestions, separated by |"],
+      ["--sponsor on|off", "demo: copies people keep run on YOUR engine key"],
+      ["--rotate", "demo: new code; the old link stops working"]
     ],
     examples: [
       "ghosty agents doctor cmu7pgbyr0001gee3ruk172mm",
       "ghosty agents set <id> --prompt-file PROMPT.md",
       "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 grant <id> precios.xlsx --write --no-deliver",
+      'ghosty agents demo <id> --slug guardias --on --vence "2026-10-15T20:00" --starter "Ens\xE9\xF1ame c\xF3mo empezar"'
     ],
-    notes: ["doctor exits 1 when it finds a problem, so it can gate a script or CI."],
-    learn: `${DOCS}#agents`
+    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."],
+    learn: `${REF}#agentes`
   },
   skills: {
     summary: "Skills of an agent (agentskills.io format: a folder with SKILL.md).",
@@ -1455,7 +1604,7 @@ var HELPS = {
       "ghosty skills rm <id> cotizacion        # keeps a local copy first"
     ],
     notes: ["rm saves a copy under ~/.config/ghosty/trash/ and prints the command that restores it."],
-    learn: `${DOCS}#skills`
+    learn: `${REF}#skills`
   },
   dbs: {
     summary: "Databases an agent can use, and what it may write from customer channels.",
@@ -1484,7 +1633,7 @@ var HELPS = {
       "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."],
-    learn: `${DOCS}#dbs`
+    learn: `${REF}#bases-de-datos`
   },
   turns: {
     summary: "An agent's recent turns: what answered, what failed and why.",
@@ -1496,43 +1645,68 @@ var HELPS = {
       ["--limit N", "max rows (default 20, max 500)"]
     ],
     examples: ["ghosty turns ls <id> --errors --since 1h", "ghosty turns ls <id> --json --limit 100"],
-    learn: `${DOCS}#turns`
+    learn: `${REF}#turnos`
   },
   files: {
     summary: "Files in the agent's machine.",
     usage: ["ghosty files ls <agent-id> [dir]", "ghosty files get <agent-id> <path> [--out LOCAL]", "ghosty files put <agent-id> <path> [--file LOCAL | < stdin]", "ghosty files rm <agent-id> <path> [--yes]"],
     examples: ["ghosty files put <id> knowledge/precios.md --file precios.md", "cat notas.md | ghosty files put <id> notas.md"],
-    learn: `${DOCS}#files`
+    learn: `${REF}#archivos`
   },
   mcp: {
     summary: "MCP servers of an agent. set REPLACES the whole list.",
     usage: ["ghosty mcp get <agent-id>", "ghosty mcp set <agent-id> --file servers.json"],
     examples: ["ghosty mcp get <id> > servers.json && $EDITOR servers.json && ghosty mcp set <id> --file servers.json"],
-    learn: `${DOCS}#mcp`
+    learn: `${REF}#servidores-mcp`
   },
   try: {
-    summary: "One test turn; prints the whole answer.",
-    usage: ['ghosty try <agent-id> "message" [--session ID] [--reset] [--whatsapp]'],
-    examples: ['ghosty try <id> "\xBFcu\xE1nto cuesta el gal\xF3n?"', "ghosty try <id> --reset --session s1"],
-    learn: `${DOCS}#try`
+    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> --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)"],
+      ["--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"],
+      ["--out DIR", "replay: where replay.json is written, after every step"],
+      ["--max N", "replay: customer turns per conversation (default 15)"],
+      ["--concurrency N", "replay: conversations at the same time (default 8, max 30)"],
+      ["--resume", "replay: continue from DIR/replay.json, skipping finished steps"]
+    ],
+    examples: [
+      'ghosty try <id> "\xBFcu\xE1nto cuesta el gal\xF3n?"',
+      'ghosty try <id> "cot\xEDzame esto" --waba --session 5210000000009 --media lista.jpg',
+      'ghosty try <id> "\xBFy el env\xEDo?" --waba --session 5210000000009 --history hilo.json --reset',
+      "ghosty try <id> --replay muestra.json --out ./replay --max 5"
+    ],
+    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."
+    ],
+    learn: `${REF}#turnos-de-prueba`
   },
   chat: {
     summary: "Stream a conversation; with no message it is interactive.",
     usage: ['ghosty chat <agent-id> ["message"] [--conversation ID]', "ghosty conversations ls <agent-id>"],
     examples: ['ghosty chat <id> "hola"', "ghosty chat <id>"],
-    learn: `${DOCS}#chat`
+    learn: `${REF}#conversaciones`
   },
   schedule: {
     summary: "Turns that run later, on the agent's own clock.",
     usage: ['ghosty schedule add <agent-id> "what to do" --in 30m | --at ISO [--every 12h --until ISO] [--conversation ID] [--title T]', "ghosty schedule ls <agent-id>", "ghosty schedule rm <agent-id> <schedule-id>"],
     examples: ['ghosty schedule add <id> "revisa pedidos pendientes" --every 12h --in 1h'],
-    learn: `${DOCS}#schedule`
+    learn: `${REF}#programar-turnos`
   },
   me: {
     summary: "Your account: files and usage.",
     usage: ["ghosty me files ls|upload|rm [--kind image|video|audio|document|other]", "ghosty usage"],
     examples: ["ghosty me files ls --kind document"],
-    learn: `${DOCS}#me`
+    learn: `${REF}#tu-cuenta`
   }
 };
 HELPS.credentials = {
@@ -1548,7 +1722,7 @@ HELPS.credentials = {
     "op read op://vault/claude/token | ghosty credentials set anthropic-oauth"
   ],
   notes: ["The key is never accepted as an argument: it would stay in your shell history and in `ps`."],
-  learn: `${DOCS}#credentials`
+  learn: `${REF}#credenciales`
 };
 HELPS.creds = HELPS.credentials;
 HELPS.channels = {
@@ -1560,7 +1734,7 @@ HELPS.channels = {
   ],
   examples: ["ghosty channels whatsapp ls <id>", "ghosty channels whatsapp enable <id> 5512345678 --dry-run", "ghosty channels whatsapp disable <id> 5512345678"],
   notes: ["<number> is its id, its label or its last digits. One number, one agent: enabling it takes it from the other agent.", "Disabling keeps logging messages; nobody answers them."],
-  learn: `${DOCS}#channels`
+  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.",
@@ -1574,10 +1748,10 @@ HELPS.board = {
   ],
   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."],
-  learn: `${DOCS}#board`
+  learn: `${REF}#tablero`
 };
 HELPS.conversations = HELPS.chat;
-HELPS.usage = HELPS.me;
+HELPS.usage = { ...HELPS.me, summary: "Your plan and how much you've used this week and month.", usage: ["ghosty usage", "ghosty me usage"], examples: ["ghosty usage", "ghosty usage --json"], learn: `${REF}#uso` };
 function helpText(cmd) {
   const h = HELPS[cmd];
   if (!h) return void 0;
@@ -1618,7 +1792,7 @@ ${bold("Agents")}
   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 demo <id>          Public demo link /p/<slug>: anyone tries it without an account, "Keep it" clones it to theirs
-                            [--slug NAME] [--on | --off] [--hours N] [--turns N] [--per-ip N] [--welcome TEXT] [--chips "a|b|c"] [--starter TEXT] [--sponsor on|off]
+                            [--slug NAME] [--on | --off] [--vence "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXT] [--chips "a|b|c"] [--starter TEXT] [--sponsor on|off] [--rotate]
 
 ${bold("Configure an agent")}
   files ls|get|put|rm <id> [path]    Files in the agent's machine   [--file LOCAL] [--out LOCAL]
@@ -1629,7 +1803,9 @@ ${bold("Configure an agent")}
   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] [--whatsapp]
+  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]
+    --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
   turns ls <id>             Recent turns and why they failed   [--errors] [--since 1h] [--limit N]
@@ -1692,6 +1868,13 @@ async function main() {
       session: { type: "string" },
       reset: { type: "boolean" },
       whatsapp: { type: "boolean" },
+      waba: { type: "boolean" },
+      media: { type: "string", multiple: true },
+      history: { type: "string" },
+      replay: { type: "string" },
+      max: { type: "string" },
+      concurrency: { type: "string" },
+      resume: { type: "boolean" },
       conversation: { type: "string" },
       kind: { type: "string" },
       at: { type: "string" },
@@ -1710,11 +1893,12 @@ async function main() {
       on: { type: "boolean" },
       off: { type: "boolean" },
       turns: { type: "string" },
-      hours: { type: "string" },
+      vence: { type: "string" },
       "per-ip": { type: "string" },
       welcome: { type: "string" },
       chips: { type: "string" },
       starter: { type: "string" },
+      rotate: { type: "boolean" },
       sponsor: { type: "string" },
       yes: { type: "boolean", short: "y" },
       dir: { type: "string" },
@@ -1745,7 +1929,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.8.0" }, () => "0.8.0");
+  if (v.version) return out({ version: "0.9.1" }, () => "0.9.1");
   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;

package/package.json

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