@ghostystudio/cli 0.11.0 → 0.12.0

package/README.md

@@ -35,6 +35,7 @@ ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--arg V]
 ghosty turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
 ghosty turns show <id> [turn-id|last]    # where a turn's time went: each tool with its seconds, output tokens
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
+ghosty channels wa groups ls|set|create <id> [group]      [--role equipo|cliente] [--on|--off] [--dry-run]   # personal WhatsApp groups
 ghosty board archive <id>                --integration X | --column X | --before 30d   [--dry-run]
 ghosty mcp get|set <id>                  [--file servers.json]
 
@@ -75,6 +76,10 @@ Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 - `try --replay FILE --out DIR`: replays real conversations from your machine. The report is written after every step, survives Ghosty deploys (it honors `Retry-After`), and `--resume` continues a partial run.
 - `agents doctor` speaks English like the rest of the CLI; `channels whatsapp ls` returns a full URL.
 
+### Changes in 0.12.0
+
+- New: `channels wa groups ls|set|create`: which groups of the agent's personal WhatsApp it answers, and as `equipo` or `cliente`. Turning a group on asks first (`--yes` without a terminal); `--dry-run` shows the plan.
+
 ### Changes in 0.11.0
 
 - New: `conversations show` (what was said in a conversation; `--limit 0` for all).

package/dist/index.js

@@ -282,7 +282,7 @@ async function postLong(path, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.11.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.12.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -324,7 +324,7 @@ async function request(path, opts = {}, retried = false) {
     method: opts.method ?? (opts.body !== void 0 || opts.raw !== void 0 ? "POST" : "GET"),
     headers: {
       authorization: `Bearer ${token}`,
-      "user-agent": `ghosty-cli/${"0.11.0"}`,
+      "user-agent": `ghosty-cli/${"0.12.0"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -1136,7 +1136,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.11.0"}`
+        "user-agent": `ghosty-cli/${"0.12.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1606,6 +1606,51 @@ Real customers will get answers from this agent.`, { yes: v.yes, expect: digits(
   const r = await api(path, { method: "PUT", body: { numbers: wanted } });
   return out(r, () => `${lavender("\u2713")} ${plan.slice(2)}`);
 }
+function findGroup(groups, ref) {
+  const byJid = groups.find((g) => g.jid === ref);
+  if (byJid) return byJid;
+  const byName = groups.filter((g) => g.name.toLowerCase() === ref.toLowerCase());
+  if (byName.length === 1) return byName[0];
+  if (byName.length > 1) throw usage(`${byName.length} groups are called "${ref}".`, `Use its jid: ${byName.map((g) => g.jid).join(", ")}`);
+  throw usage(`No group "${ref}" for this agent.`, groups.length ? `Groups: ${groups.map((g) => g.name).join(", ")}` : "Is its personal WhatsApp paired and in some group? See the agent's Channels page.");
+}
+async function groupsCmd(args, v) {
+  const [sub, id, ...rest] = args;
+  const ex = 'ghosty channels wa groups ls <agent-id> | set <agent-id> <group> [--role equipo|cliente] [--on|--off] | create <agent-id> "Name"';
+  if (!id) throw usage("Missing agent id.", `Example: ${ex}`);
+  const path = `/api/v2/agents/${enc7(id)}/wa/groups`;
+  if (v.role !== void 0 && v.role !== "equipo" && v.role !== "cliente") throw usage("--role takes equipo or cliente.");
+  if (!sub || sub === "ls" || sub === "list") {
+    const r2 = await api(`${path}${v.cached ? "?live=0" : ""}`);
+    const rows = r2.groups.map((g2) => ({ name: g2.name, on: g2.enabled ? lavender("on") : dim("off"), role: g2.role, jid: g2.jid }));
+    return out(r2, () => rows.length ? table(rows, ["name", "on", "role", "jid"]) : dim('No groups. Pair its personal WhatsApp in the web, or: ghosty channels wa groups create <agent-id> "Name"'));
+  }
+  if (sub === "create") {
+    const name = rest.join(" ").trim();
+    if (!name) throw usage("Missing group name.", `Example: ghosty channels wa groups create ${id} "Equipo ventas" --role equipo`);
+    const r2 = await api(path, { method: "POST", body: { create: name, role: v.role ?? "equipo" } });
+    return out(r2, () => `${lavender("\u2713")} Created ${bold(name)} (${v.role ?? "equipo"}, on)
+  invite: ${r2.inviteUrl}`);
+  }
+  if (sub !== "set") throw usage(`Unknown groups subcommand: ${sub}.`, ex);
+  const ref = rest.join(" ").trim();
+  if (!ref) throw usage("Missing group (name or jid).", `Example: ghosty channels wa groups set ${id} "Pia-cotizadora" --role equipo --on`);
+  if (v.on && v.off) throw usage("Use --on or --off, not both.");
+  const cur = await api(`${path}?live=0`);
+  const g = findGroup(cur.groups, ref);
+  const enabled = v.on ? true : v.off ? false : g.enabled;
+  const role = v.role ?? g.role;
+  const changes = [...enabled !== g.enabled ? [`${g.enabled ? "on" : "off"}\u2192${enabled ? "on" : "off"}`] : [], ...role !== g.role ? [`${g.role}\u2192${role}`] : []];
+  if (!changes.length) return out({ changed: 0, group: g }, () => dim(`Nothing to do: ${g.name} is already ${g.enabled ? "on" : "off"} as ${g.role}.`));
+  const plan = `~ ${g.name}: ${changes.join(", ")}`;
+  if (v["dry-run"]) return out({ dryRun: true, plan: [plan] }, () => `${plan}
+${dim("Dry run: nothing changed.")}`);
+  if (enabled && !g.enabled) await confirm(`${bold(plan)}
+The agent will start answering in this group as ${role}.`, { yes: v.yes, retry: `ghosty channels wa groups set ${id} "${ref}"${v.role ? ` --role ${v.role}` : ""} --on` });
+  const r = await api(path, { method: "POST", body: { jid: g.jid, enabled, role } });
+  const now = r.groups.find((x) => x.jid === g.jid);
+  return out({ group: now ?? null, plan: [plan] }, () => `${lavender("\u2713")} ${g.name}: ${now?.enabled ? "on" : "off"} as ${now?.role ?? role}`);
+}
 
 // src/commands/board.ts
 async function boardCmd(sub, id, v) {
@@ -1831,14 +1876,34 @@ HELPS.credentials = {
 };
 HELPS.creds = HELPS.credentials;
 HELPS.channels = {
-  summary: "Which WhatsApp Business numbers an agent answers. Pair new numbers in the web.",
-  usage: ["ghosty channels whatsapp ls <agent-id>", "ghosty channels whatsapp enable <agent-id> <number> [--dry-run] [--yes]", "ghosty channels whatsapp disable <agent-id> <number> [--dry-run]"],
+  summary: "Which WhatsApp Business numbers an agent answers, and which groups of its personal WhatsApp (and as whom). Pair numbers in the web.",
+  usage: [
+    "ghosty channels whatsapp ls <agent-id>",
+    "ghosty channels whatsapp enable <agent-id> <number> [--dry-run] [--yes]",
+    "ghosty channels whatsapp disable <agent-id> <number> [--dry-run]",
+    "ghosty channels wa groups ls <agent-id> [--cached]",
+    "ghosty channels wa groups set <agent-id> <group> [--role equipo|cliente] [--on | --off] [--dry-run] [--yes]",
+    'ghosty channels wa groups create <agent-id> "Name" [--role equipo|cliente]'
+  ],
   flags: [
     ["-n, --dry-run", "print the plan (+ starts answering, - stops) and change nothing"],
-    ["--yes", "enable: skip typing the last 4 digits (required without a terminal)"]
+    ["--yes", "enable / groups set --on: skip the confirmation (required without a terminal)"],
+    ["--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)"]
+  ],
+  examples: [
+    "ghosty channels whatsapp ls <id>",
+    "ghosty channels whatsapp enable <id> 5512345678 --dry-run",
+    "ghosty channels whatsapp disable <id> 5512345678",
+    "ghosty channels wa groups ls <id>",
+    'ghosty channels wa groups set <id> "Pia-cotizadora" --role equipo --on --dry-run'
+  ],
+  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.",
+    "Groups belong to the PERSONAL WhatsApp paired to the agent (not WhatsApp Business). <group> is its name or its jid."
   ],
-  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: `${REF}#canales-de-whatsapp`
 };
 HELPS.board = {
@@ -1944,6 +2009,7 @@ ${bold("Configure an agent")}
   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 wa groups ls|set|create <id> [group]        Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--on|--off] [--dry-run]
   board archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
 ${bold("Talk to an agent")}
@@ -2071,6 +2137,8 @@ async function main() {
       column: { type: "string" },
       before: { type: "string" },
       recycle: { type: "boolean" },
+      role: { type: "string" },
+      cached: { type: "boolean" },
       check: { type: "string", multiple: true },
       contains: { type: "string", multiple: true }
     }
@@ -2079,7 +2147,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.11.0" }, () => "0.11.0");
+  if (v.version) return out({ version: "0.12.0" }, () => "0.12.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;
@@ -2131,6 +2199,7 @@ async function main() {
     case "board":
       return boardCmd(sub, a1, v);
     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);
     case "credentials":
     case "creds":
@@ -2163,7 +2232,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.11.0").catch(() => null);
+var notice = updateNotice("0.12.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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