@ghostystudio/cli 0.43.0 → 0.44.0

package/README.md

@@ -86,6 +86,7 @@ ghosty agents doctor --user EMAIL [agent] [--turns 8] · usage --images [--plan
 ghosty novedades ls|create|set|test|send|rm   [--title] [--body] [--image FILE] [--link] [--to] [--publish] [--at]
 ghosty sites ls [--house] · sites publish <file.html|folder> [--title] [--slug S] [--site <slug|id>] · sites slug <slug|id> <new-slug>   # house sites on EasyBits
 ghosty credentials ls|set|rm [provider]  [--from-env VAR]   # never as an argument
+ghosty connectors ls|connect|disconnect [id]  [--q TEXT] [--from-env VAR] [--no-open]   # Shopify, Stripe, monday…
 ghosty docs
 
 ghosty partner ls|enable|credentials|agent|tenants|audit|try   # one agent for each of YOUR customers: ghosty partner --help
@@ -101,6 +102,10 @@ Every command has its own help with examples: `ghosty <command> --help` or `ghos
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.44.0
+
+- New `connectors ls|connect|disconnect`: the connectors of your account (Shopify, Stripe, monday, Mercado Libre…), the same as `/app/connectors`. `connect` opens the browser for OAuth (`--no-open` prints the URL) or asks for the key fields (hidden, `--from-env VAR` or stdin). Then `agents set <id> --connect <connector>` gives it to an agent.
+
 ### Changes in 0.42.0
 
 - `agents teams off` now **pauses** the agent in that workspace (it keeps its `@handle`; `on` resumes it). `agents teams rm <id> <workspace> [--yes]` removes it and frees the handle. `ls` shows `paused` and the workspaces where it was activated by someone else (read-only). Without `--handle`, `on` reuses the handle it already has in your other workspaces.

package/dist/index.js

@@ -8422,7 +8422,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.43.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.44.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8464,7 +8464,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.43.0"}`,
+      "user-agent": `ghosty-cli/${"0.44.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9725,7 +9725,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.43.0"}`
+        "user-agent": `ghosty-cli/${"0.44.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -10557,6 +10557,143 @@ async function credentialsCmd2(sub, provider, v) {
   }
 }
 
+// src/commands/connectors.ts
+async function hiddenPrompt2(label) {
+  process.stderr.write(label);
+  const stdin = process.stdin;
+  stdin.setRawMode(true);
+  stdin.resume();
+  stdin.setEncoding("utf8");
+  return new Promise((resolve3, reject) => {
+    let value = "";
+    const onData = (chunk) => {
+      for (const ch of chunk) {
+        if (ch === "\r" || ch === "\n") {
+          stdin.setRawMode(false);
+          stdin.pause();
+          stdin.off("data", onData);
+          process.stderr.write("\n");
+          return resolve3(value);
+        }
+        if (ch === "") {
+          stdin.setRawMode(false);
+          process.stderr.write("\n");
+          return reject(usage(t("Cancelled.", "Cancelado.")));
+        }
+        if (ch === "\x7F") value = value.slice(0, -1);
+        else value += ch;
+      }
+    };
+    stdin.on("data", onData);
+  });
+}
+async function visiblePrompt(label) {
+  const { createInterface: createInterface3 } = await import("node:readline/promises");
+  const rl = createInterface3({ input: process.stdin, output: process.stderr });
+  try {
+    return (await rl.question(label)).trim();
+  } finally {
+    rl.close();
+  }
+}
+function kindOf(c) {
+  if (c.kind === "credential") return t("key", "llave");
+  if (c.store === "teams") return "OAuth (Teams)";
+  return "OAuth";
+}
+async function catalog() {
+  return (await api("/api/v2/me/connectors")).connectors;
+}
+async function find(id) {
+  const all = await catalog();
+  const q = id.toLowerCase();
+  const c = all.find((x) => x.id === q) ?? all.find((x) => x.nombre.toLowerCase() === q);
+  if (!c) throw usage(t(`Unknown connector: ${id}.`, `Conector desconocido: ${id}.`), t("List them with: ghosty connectors ls", "L\xEDstalos con: ghosty connectors ls"));
+  return c;
+}
+async function readValues(c, fromEnv) {
+  const fields = c.credential?.fields ?? [];
+  const secrets = fields.filter((f) => f.secret !== false);
+  const values = {};
+  if (fromEnv || !process.stdin.isTTY) {
+    if (fields.length !== 1) {
+      throw usage(
+        t(`${c.nombre} asks for ${fields.length} fields: run it in a terminal to answer them.`, `${c.nombre} pide ${fields.length} campos: c\xF3rrelo en una terminal para contestarlos.`),
+        fields.map((f) => `${f.key}: ${f.label}`).join(" \xB7 ")
+      );
+    }
+    if (fromEnv) {
+      const v = process.env[fromEnv];
+      if (!v) throw usage(t(`$${fromEnv} is empty or not set.`, `$${fromEnv} est\xE1 vac\xEDa o no existe.`));
+      values[fields[0].key] = v.trim();
+    } else {
+      const parts = [];
+      for await (const ch of process.stdin) parts.push(ch);
+      values[fields[0].key] = Buffer.concat(parts).toString("utf8").trim();
+    }
+    return values;
+  }
+  if (!canPrompt()) throw usage(t("Nothing to save.", "No hay nada que guardar."), t("Use --from-env VAR or pipe the key.", "Usa --from-env VAR o pasa la llave por tuber\xEDa."));
+  if (c.credential?.help) info(dim(c.credential.help + (c.credential.helpUrl ? ` ${c.credential.helpUrl}` : "")));
+  for (const f of fields) {
+    const label = `${f.label}${f.placeholder ? dim(` (${f.placeholder})`) : ""}: `;
+    values[f.key] = secrets.includes(f) ? (await hiddenPrompt2(label)).trim() : await visiblePrompt(label);
+  }
+  return values;
+}
+async function connectorsCmd(sub, id, v) {
+  switch (sub ?? "ls") {
+    case "ls":
+    case "list": {
+      let all = await catalog();
+      if (v.q) {
+        const q = v.q.toLowerCase();
+        all = all.filter((c) => `${c.id} ${c.nombre} ${c.descripcion}`.toLowerCase().includes(q));
+      }
+      const rows = all.map((c) => ({
+        id: c.id,
+        name: c.nombre,
+        status: c.conectado ? t("connected", "conectado") : c.disponible ? t("available", "disponible") : t("soon", "muy pronto"),
+        kind: kindOf(c)
+      }));
+      return out(all, () => table(rows, ["id", "name", "status", "kind"]));
+    }
+    case "connect": {
+      if (!id) throw usage(t("Missing connector.", "Falta el conector."), t("Example: ghosty connectors connect shopify   (ghosty connectors ls lists them)", "Ejemplo: ghosty connectors connect shopify   (ghosty connectors ls los lista)"));
+      const c = await find(id);
+      if (!c.disponible) throw usage(t(`${c.nombre} isn't available yet.`, `${c.nombre} todav\xEDa no est\xE1 disponible.`));
+      if (c.kind === "credential" && c.credential) {
+        const values = await readValues(c, v["from-env"]);
+        if (Object.values(values).some((x) => !x)) throw usage(t("Empty field: nothing saved.", "Campo vac\xEDo: no se guard\xF3 nada."));
+        const r2 = await api(`/api/v2/me/connectors/${encodeURIComponent(c.id)}/credentials`, { method: "POST", body: { values } });
+        return out(r2, () => `${lavender("\u2713")} ${c.nombre} ${t("connected", "conectado")}${r2.account ? dim(` (${r2.account})`) : ""}. ${dim(t("Give it to an agent: ghosty agents set <id> --connect " + c.id, "D\xE1selo a un agente: ghosty agents set <id> --connect " + c.id))}`);
+      }
+      const r = await api(`/api/v2/me/connectors/${encodeURIComponent(c.id)}/start?from=connectors`, { method: "POST" });
+      if (!v["no-open"]) await openUrl(r.url);
+      return out(
+        r,
+        () => [
+          `${lavender("\u2192")} ${t(`Finish connecting ${c.nombre} in your browser:`, `Termina de conectar ${c.nombre} en tu navegador:`)}`,
+          `  ${r.url}`,
+          dim(t("Then check it with: ghosty connectors ls --q " + c.id, "Luego rev\xEDsalo con: ghosty connectors ls --q " + c.id))
+        ].join("\n")
+      );
+    }
+    case "disconnect":
+    case "rm": {
+      if (!id) throw usage(t("Missing connector.", "Falta el conector."), t("Example", "Ejemplo") + ": ghosty connectors disconnect shopify");
+      const c = await find(id);
+      if (!c.conectado) throw usage(t(`${c.nombre} isn't connected.`, `${c.nombre} no est\xE1 conectado.`));
+      await confirm(t(`Disconnect ${c.nombre}? Your agents stop using it.`, `\xBFDesconectar ${c.nombre}? Tus agentes dejar\xE1n de usarlo.`), { yes: v.yes, retry: `ghosty connectors disconnect ${c.id}` });
+      const r = await api(`/api/v2/me/connectors/${encodeURIComponent(c.id)}`, { method: "DELETE" });
+      return out(r, () => `${lavender("\u2713")} ${c.nombre} ${t("disconnected.", "desconectado.")}${r.aviso ? `
+${dim(r.aviso)}` : ""}`);
+    }
+    default:
+      throw usage(t(`Unknown connectors subcommand: ${sub}.`, `Subcomando de connectors desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty connectors ls | connect | disconnect   (ghosty connectors --help)");
+  }
+}
+
 // src/commands/channels.ts
 import { readFile as readFile8 } from "node:fs/promises";
 
@@ -10596,7 +10733,7 @@ async function readMultiFileAuth(dir) {
 // src/commands/channels.ts
 var enc7 = encodeURIComponent;
 var digits = (s) => s.replace(/\D/g, "");
-function find(nums, ref) {
+function find2(nums, ref) {
   const d = digits(ref);
   const hit = nums.find((n) => n.id === ref) ?? nums.find((n) => n.label.toLowerCase() === ref.toLowerCase()) ?? (d.length >= 6 ? nums.find((n) => digits(n.label).endsWith(d)) : void 0);
   if (!hit) throw usage(t(`No WhatsApp number "${ref}" for this agent.`, `Este agente no tiene el n\xFAmero de WhatsApp "${ref}".`), nums.length ? `${t("Available", "Disponibles")}: ${nums.map((n) => n.label).join(", ")}` : t("Pair a number first in the web (the agent's Channels page).", "Primero parea un n\xFAmero en la web (p\xE1gina Canales del agente)."));
@@ -10626,7 +10763,7 @@ async function channelsCmd(kind, sub, id, ref, v) {
   }
   if (sub !== "enable" && sub !== "disable") throw usage(t(`Unknown subcommand: ${sub}.`, `Subcomando desconocido: ${sub}.`), t("Try", "Prueba") + ": ghosty channels whatsapp ls | enable | disable | integrations | link | unlink | history \xB7 ghosty channels wa import | status | pause | groups");
   if (!ref) throw usage(t("Missing number.", "Falta el n\xFAmero."), t("Example", "Ejemplo") + `: ghosty channels whatsapp ${sub} ${id} +52 55 1234 5678`);
-  const n = find(cur.numbers, ref);
+  const n = find2(cur.numbers, ref);
   const on = sub === "enable";
   if (on === n.mine) return out({ changed: 0, number: n.label, answers: on }, () => dim(t(`Nothing to do: ${n.label} is already ${on ? "answered by this agent" : "not answered by it"}.`, `Nada que hacer: ${n.label} ya ${on ? "lo contesta este agente" : "no lo contesta este agente"}.`)));
   const plan = on ? `+ ${n.label}: ${t(`this agent starts answering its customers${n.takenByOther ? " (takes it from the agent answering today)" : ""}`, `este agente empieza a contestarles a sus clientes${n.takenByOther ? " (se lo quita al agente que contesta hoy)" : ""}`)}` : `- ${n.label}: ${t("this agent stops answering (messages are still logged)", "este agente deja de contestar (los mensajes se siguen registrando)")}`;
@@ -11215,6 +11352,17 @@ var HELPS_ES = {
     ],
     notes: ["La llave nunca se acepta como argumento: se quedar\xEDa en el historial de tu shell y en `ps`."]
   },
+  connectors: {
+    summary: "Los conectores de tu cuenta (los mismos de /app/connectors y la app): listar, conectar y desconectar.",
+    replace: [["# opens the browser: type your store and approve", "# abre el navegador: escribe tu tienda y autoriza"], ["# then give it to an agent", "# luego d\xE1selo a un agente"]],
+    flags: [
+      ["--q TEXT", "ls: filtra por id, nombre o descripci\xF3n"],
+      ["--from-env VAR", "connect: los de llave con UN campo la leen de esta variable de entorno"],
+      ["--no-open", "connect: imprime la URL sin abrir el navegador (SSH, agentes)"],
+      ["--yes", "disconnect: se salta la confirmaci\xF3n"]
+    ],
+    notes: ["Los de OAuth terminan en el navegador; los de llave se verifican antes de guardarse. Las llaves nunca se aceptan como argumento."]
+  },
   channels: {
     summary: "Qu\xE9 n\xFAmeros de WhatsApp Business contesta un agente, y qu\xE9 grupos de su WhatsApp personal (y como qui\xE9n). Los n\xFAmeros se emparejan en la web.",
     replace: [['"Name"', '"Nombre"']],
@@ -11416,7 +11564,7 @@ var HELPS_ES = {
     notes: ["create sigue las reglas de la web: queda a tu nombre, nace como prueba de 30 d\xEDas, tu correo debe estar confirmado y tu plan topa cu\xE1ntos tienes. Sigue: ghosty partner enable <slug>.", "Con suscripci\xF3n de Stripe renew se niega: la fecha la mueve la factura pagada.", "rename cambia s\xF3lo el slug (id y namespace se quedan, as\xED que tablero, Stripe y WhatsApp siguen funcionando); las ligas viejas <slug>.sales dejan de servir.", "transfer se lleva los agentes con el espacio y recicla sus cajas (el due\xF1o va horneado en la caja); sin --copy-keys la simulaci\xF3n dice qu\xE9 llaves le faltan al nuevo \u2014 esos agentes dejar\xEDan de contestar."]
   }
 };
-var HELP_ALIASES = { creds: "credentials", board: "cards", conversations: "chat", workspaces: "spaces" };
+var HELP_ALIASES = { creds: "credentials", conectores: "connectors", board: "cards", conversations: "chat", workspaces: "spaces" };
 
 // src/help.ts
 var DOCS = "https://www.ghosty.studio/docs/cli";
@@ -11735,6 +11883,25 @@ HELPS.credentials = {
   learn: `${REF}#credenciales`
 };
 HELPS.creds = HELPS.credentials;
+HELPS.connectors = {
+  summary: "Your account's connectors (the same as /app/connectors and the app): list, connect and disconnect.",
+  usage: ["ghosty connectors ls [--q TEXT]", "ghosty connectors connect <id> [--from-env VAR | < stdin] [--no-open]", "ghosty connectors disconnect <id> [--yes]"],
+  flags: [
+    ["--q TEXT", "ls: filter by id, name or description"],
+    ["--from-env VAR", "connect: key connectors with ONE field read it from this environment variable"],
+    ["--no-open", "connect: print the URL without opening the browser (SSH, agents)"],
+    ["--yes", "disconnect: skip the confirmation"]
+  ],
+  examples: [
+    "ghosty connectors ls --q shop",
+    "ghosty connectors connect shopify          # opens the browser: type your store and approve",
+    "ghosty connectors connect stripe --from-env STRIPE_SECRET_KEY",
+    "ghosty agents set <agent> --connect shopify  # then give it to an agent"
+  ],
+  notes: ["OAuth connectors finish in the browser; key connectors are verified before saving. Keys are never accepted as arguments."],
+  learn: `${REF}#conectores`
+};
+HELPS.conectores = HELPS.connectors;
 HELPS.channels = {
   summary: "Which WhatsApp Business numbers an agent answers, and which groups of its personal WhatsApp (and as whom). Pair numbers in the web.",
   usage: [
@@ -13171,6 +13338,7 @@ ${bold("Your account")}
   me files ls|get|upload|rm Files in your account        [--q TEXT] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out FILE]
   me memories ls|add|edit|rm What your agents remember about you (personal chats only)   add "text" \xB7 edit <id> "text" \xB7 rm <id>
   credentials ls|set|rm [provider]   Provider keys in your vault (hidden prompt, stdin or --from-env VAR; never as an argument)
+  connectors ls|connect|disconnect [id]   Your connectors (Shopify, Stripe, monday\u2026): connect opens the browser or asks for the key
   docs [topic]              Open the docs
 
 ${bold("Global options")}
@@ -13310,6 +13478,7 @@ ${bold("Tu cuenta")}
   me files ls|get|upload|rm Archivos de tu cuenta         [--q TEXTO] [--kind image|video|audio|document|other] [--cursor C] \xB7 get <id> [--out ARCHIVO]
   me memories ls|add|edit|rm Lo que tus agentes recuerdan de ti (s\xF3lo chats personales)   add "texto" \xB7 edit <id> "texto" \xB7 rm <id>
   credentials ls|set|rm [proveedor]   Llaves de proveedor en tu b\xF3veda (prompt oculto, stdin o --from-env VAR; nunca como argumento)
+  connectors ls|connect|disconnect [id]   Tus conectores (Shopify, Stripe, monday\u2026): connect abre el navegador o pide la llave
   docs [tema]               Abre la documentaci\xF3n
 
 ${bold("Opciones globales")}
@@ -13325,7 +13494,7 @@ ${bold("Opciones globales")}
 ${bold("C\xF3digos de salida")}  0 bien \xB7 1 error de la API \xB7 2 uso incorrecto \xB7 3 sin sesi\xF3n
 ${dim("Nota: `ghosty` puede chocar con otro binario en tu PATH (p. ej. la TUI de Ghosty). Rev\xEDsalo con `which -a ghosty`; corre `npx @ghostystudio/cli` para ir a la segura.")}
 ${dim("Documentaci\xF3n: https://www.ghosty.studio/docs/cli")}`;
-var COMMANDS = ["login", "logout", "whoami", "usage", "use", "apply", "plan", "engines", "bags", "spaces", "workspaces", "demos", "sites", "push", "novedades", "completion", "cards", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "partner", "me", "channels", "board", "boards", "credentials", "browser", "docs", "help"];
+var COMMANDS = ["login", "logout", "whoami", "usage", "use", "apply", "plan", "engines", "bags", "spaces", "workspaces", "demos", "sites", "push", "novedades", "completion", "cards", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "partner", "me", "channels", "board", "boards", "credentials", "connectors", "browser", "docs", "help"];
 var AGENTS_SUBS = ["ls", "create", "get", "set", "export", "doctor", "docs", "share", "unshare", "shares", "teams", "rm", "restart", "demo", "box"];
 function unknown(what, input, known, helpCmd) {
   const s = suggest(input, known);
@@ -13455,6 +13624,7 @@ async function main() {
       create: { type: "boolean" },
       prune: { type: "boolean" },
       q: { type: "string" },
+      "no-open": { type: "boolean" },
       "prompt-out": { type: "string" },
       toolsets: { type: "string" },
       "prompt-base": { type: "string" },
@@ -13551,7 +13721,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.43.0" }, () => "0.43.0");
+  if (v.version) return out({ version: "0.44.0" }, () => "0.44.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -13654,6 +13824,9 @@ async function main() {
     case "credentials":
     case "creds":
       return credentialsCmd2(sub, a1, v);
+    case "connectors":
+    case "conectores":
+      return connectorsCmd(sub, a1, v);
     case "try":
       return tryTurn(sub, a1, v);
     case "chat":
@@ -13706,7 +13879,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.43.0").catch(() => null);
+var notice = updateNotice("0.44.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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