@ghostystudio/cli 0.50.0 → 0.51.0

package/README.md

@@ -38,6 +38,8 @@ ghosty agents box <id> [--check PATH]… [--contains PATH=TEXT]… [--recycle]
 ghosty agents demo enable|disable <id>
 ghosty agents demo <id> [--slug NAME] [--expires "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 embed enable|disable <id> [--domains a.com,*.b.com]   # web widget: chat bubble on your site, only on those domains
+ghosty agents embed <id> [--per-visitor N] [--per-ip N] [--welcome TEXT] [--color #hex] [--rotate]   # state + the <script> to paste
 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]
@@ -103,6 +105,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.51.0
+
+- `agents embed enable|disable <id> [--domains a.com,*.b.com] [--per-visitor N] [--per-ip N] [--welcome T] [--color #hex] [--rotate]`: the **web widget**, a chat bubble with the agent on your own site (one `<script>`), loading only on the domains you list; each visitor gets an isolated conversation and talks as a customer. Claude engine only. No flags = state + the snippet.
+
 ### Changes in 0.50.0
 
 - `cards pause|resume <id> <card> [--mode 30min|2h|24h|until_tomorrow|permanent]`: the thread's pause menu; resume also lifts "operator only" and doesn't answer by itself. Logged.

package/dist/index.js

@@ -8164,7 +8164,12 @@ var SERVER_MESSAGES = [
   ["s\xF3lo el due\xF1o de \xAB{}\xBB o el staff de Ghosty leen su bit\xE1cora", "only \xAB{}\xBB's owner or Ghosty staff read its audit log"],
   ["s\xF3lo aplica a conversaciones de WhatsApp Business", "only applies to WhatsApp Business conversations"],
   ["ese n\xFAmero ya no est\xE1 conectado", "that number is no longer connected"],
-  ["ese n\xFAmero no es de este tablero", "that number isn't on this board"]
+  ["ese n\xFAmero no es de este tablero", "that number isn't on this board"],
+  // — Widget web (`agents embed`)
+  ["s\xF3lo el due\xF1o del agente maneja su widget web", "only the agent's owner manages its web widget"],
+  ["dominio no v\xE1lido: {} (usa ejemplo.com o *.ejemplo.com, sin https:// ni rutas)", "invalid domain: {} (use example.com or *.example.com, no https:// or paths)"],
+  ["el widget web s\xF3lo corre con motor claude (es el que a\xEDsla a cada visitante)", "the web widget only runs on the claude engine (it's the one that isolates each visitor)"],
+  ["pon al menos un dominio donde va a vivir el widget (--domains ejemplo.com)", "add at least one domain where the widget will live (--domains example.com)"]
 ];
 
 // src/i18n.ts
@@ -8463,7 +8468,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.50.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.51.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8505,7 +8510,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.50.0"}`,
+      "user-agent": `ghosty-cli/${"0.51.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9339,6 +9344,33 @@ async function agentsDemo(id, v) {
     ].join("\n")
   );
 }
+async function agentsEmbed(id, v) {
+  id = need(id, "agent id", "ghosty agents embed enable <agent-id> --domains tusitio.com");
+  if (v.on && v.off) throw usage(t("Use enable or disable, not both.", "Usa enable o disable, no los dos."));
+  const body = {};
+  if (v.on) body.enabled = true;
+  if (v.off) body.enabled = false;
+  if (v.domains !== void 0) body.domains = v.domains.split(/[\s,]+/).map((d) => d.trim()).filter(Boolean);
+  if (v["per-visitor"]) body.perVisitorDay = Number(v["per-visitor"]);
+  if (v["per-ip"]) body.perIpDay = Number(v["per-ip"]);
+  if (v.welcome !== void 0) body.welcome = v.welcome || null;
+  if (v.color !== void 0) body.color = v.color;
+  if (v.rotate) body.rotate = true;
+  const e = Object.keys(body).length ? await api(agentPath(id, "/embed"), { method: "PUT", body }) : await api(agentPath(id, "/embed"));
+  out(
+    e,
+    () => [
+      `${e.enabled ? lavender(t("\u25CF on", "\u25CF encendido")) : dim(t("\u25CB off", "\u25CB apagado"))}  ${t("web widget", "widget web")}`,
+      e.domains.length ? `${t("domains", "dominios")}: ${e.domains.join(", ")}` : red(t("domains: (none \u2014 it loads nowhere; add --domains yoursite.com)", "dominios: (ninguno \u2014 no carga en ning\xFAn lado; agrega --domains tusitio.com)")),
+      ...e.engineOk ? [] : [red(t("engine: only claude isolates each visitor; switch with `ghosty agents set <id> --engine claude`", "motor: s\xF3lo claude a\xEDsla a cada visitante; c\xE1mbialo con `ghosty agents set <id> --engine claude`"))],
+      dim(t(`cap ${e.perVisitorDay} messages per visitor per day \xB7 ${e.perIpDay} per IP per day \xB7 color ${e.color}`, `tope ${e.perVisitorDay} mensajes por visitante al d\xEDa \xB7 ${e.perIpDay} por IP al d\xEDa \xB7 color ${e.color}`)),
+      e.welcome ? `${t("welcome", "bienvenida")}: ${e.welcome}` : dim(t("welcome: (default greeting)", "bienvenida: (saludo por defecto)")),
+      ...e.snippet ? ["", t("Paste before </body> on your site:", "Pega antes de </body> en tu sitio:"), e.snippet, ""] : [],
+      t(`visitors ${e.stats.visitantes} \xB7 messages ${e.stats.mensajes}`, `visitantes ${e.stats.visitantes} \xB7 mensajes ${e.stats.mensajes}`),
+      ...e.lastError ? [red(`${t("last failure", "\xFAltima falla")} ${e.lastError.at}: ${serverText(e.lastError.message ?? e.lastError.error ?? "")}`)] : []
+    ].join("\n")
+  );
+}
 async function agentsBox(id, v) {
   id = need(id, "agent id", "ghosty agents box <agent-id> [--check PATH] [--contains PATH=TEXT] [--recycle]");
   if (v.recycle) {
@@ -9950,7 +9982,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.50.0"}`
+        "user-agent": `ghosty-cli/${"0.51.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -11563,7 +11595,9 @@ var HELPS_ES = {
       ["# Teams workspaces you administer: where it answers, is paused, and with which @handle", "# los equipos de Teams que administras: d\xF3nde contesta, d\xF3nde est\xE1 en pausa y con qu\xE9 @handle"],
       ["# turn it on there (or change its @handle)", "# lo prende ah\xED (o le cambia el @handle)"],
       ["# pause it there; it keeps its @handle", "# lo pausa ah\xED; conserva su @handle"],
-      ["# remove it from there; the agent stays", "# lo quita de ah\xED; el agente sigue"]
+      ["# remove it from there; the agent stays", "# lo quita de ah\xED; el agente sigue"],
+      ["# web widget: chat bubble on your site, only on those domains", "# widget web: burbuja de chat en tu sitio, s\xF3lo en esos dominios"],
+      ["# state + the <script> to paste", "# su estado + el <script> para pegar"]
     ],
     flags: [
       ["--fields a,b", "get: regresa s\xF3lo estos campos"],
@@ -12065,6 +12099,8 @@ var HELPS = {
       "ghosty agents box <agent-id> [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle]",
       "ghosty agents demo enable|disable <agent-id>",
       'ghosty agents demo <agent-id> [--slug NAME] [--expires "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXT] [--starter TEXT] [--chips "a|b|c"] [--sponsor on|off] [--rotate]',
+      "ghosty agents embed enable|disable <agent-id> [--domains a.com,*.b.com]   # web widget: chat bubble on your site, only on those domains",
+      "ghosty agents embed <agent-id> [--domains \u2026] [--per-visitor N] [--per-ip N] [--welcome TEXT] [--color #hex] [--rotate]   # state + the <script> to paste",
       "ghosty agents rm <agent-id> [--from-workspace] [--yes]"
     ],
     flags: [
@@ -12143,6 +12179,7 @@ var HELPS = {
       "ghosty agents set <pia-id> --prompt-base <tania-id> --prompt-overlay capa.json --dry-run --out /tmp/pia.md",
       "ghosty agents demo enable <id>",
       'ghosty agents demo <id> --slug guardias --expires "2026-10-15T20:00" --starter "Ens\xE9\xF1ame c\xF3mo empezar"',
+      'ghosty agents embed enable <id> --domains "mitienda.com,*.mitienda.mx" --welcome "\xA1Hola! \xBFEn qu\xE9 te ayudo?"',
       "ghosty agents box <id> --contains /opt/claude-worker/skills/pdf-doc/render-doc.mjs=pdf-templates",
       "ghosty agents set <id> --tool wa:actualizar_identidad=off,teams:actualizar_identidad=on",
       'ghosty agents set minighosty --bag "MiniGhosty" --avatar https://www.ghosty.studio/avatars/minighosty.png',
@@ -12989,6 +13026,10 @@ function normalizeArgs(pos, v) {
     if (v.expires !== void 0) v.vence = v.expires;
     else if (v.vence !== void 0) notes.push(t("`--vence` is now `--expires`.", "`--vence` ahora es `--expires`."));
   }
+  if (cmd === "agents" && (sub === "embed" || sub === "widget") && (pos[2] === "enable" || pos[2] === "disable")) {
+    v[pos[2] === "enable" ? "on" : "off"] = true;
+    pos.splice(2, 1);
+  }
   if (cmd === "channels" && pos[2] === "groups") {
     if (pos[3] === "enable" || pos[3] === "disable") {
       v[pos[3] === "enable" ? "on" : "off"] = true;
@@ -13965,6 +14006,8 @@ ${bold("Agents")}
   agents box <id>           The machine serving it: is it on the new image?   [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle [--reenv] [--force]]
   agents demo enable|disable <id>   Turn its public demo link on or off
   agents demo <id>          Public demo link /p/<slug>: anyone tries it without an account, "Keep it" clones it to theirs
+  agents embed enable|disable <id>   Web widget: a chat bubble on YOUR site (one <script>), only on the domains you list   [--domains a.com,*.b.com] [--per-visitor N] [--per-ip N] [--welcome T] [--color #hex] [--rotate]
+  agents embed <id>         Its state and the snippet to paste (claude engine only: it isolates each visitor)
                             [--slug NAME] [--expires "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")}
@@ -14121,6 +14164,8 @@ ${bold("Agentes")}
   agents box <id>           La m\xE1quina que lo atiende: \xBFya trae la imagen nueva?   [--check RUTA]\u2026 [--contains RUTA=TEXTO]\u2026 [--recycle [--reenv] [--force]]
   agents demo enable|disable <id>   Prende o apaga su liga p\xFAblica de demo
   agents demo <id>          Liga p\xFAblica de demo /p/<slug>: cualquiera lo prueba sin cuenta y \xABQued\xE1rmelo\xBB lo clona a la suya
+  agents embed enable|disable <id>   Widget web: burbuja de chat en TU sitio (un <script>), s\xF3lo en los dominios que pongas   [--domains a.com,*.b.com] [--per-visitor N] [--per-ip N] [--welcome T] [--color #hex] [--rotate]
+  agents embed <id>         Su estado y el snippet para pegar (s\xF3lo motor claude: a\xEDsla a cada visitante)
                             [--slug NOMBRE] [--expires "AAAA-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXTO] [--chips "a|b|c"] [--starter TEXTO] [--sponsor on|off] [--rotate]
 
 ${bold("Configurar un agente")}
@@ -14214,7 +14259,7 @@ ${bold("C\xF3digos de salida")}  0 bien \xB7 1 error de la API \xB7 2 uso incorr
 ${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", "staff", "audit", "factory", "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"];
+var AGENTS_SUBS = ["ls", "create", "get", "set", "export", "doctor", "docs", "share", "unshare", "shares", "teams", "rm", "restart", "demo", "embed", "box"];
 function unknown(what, input, known, helpCmd) {
   const s = suggest(input, known);
   return usage(t(`Unknown command: ${what}.`, `Comando desconocido: ${what}.`), s ? t(`Did you mean "${s}"? Run: ${helpCmd}`, `\xBFQuisiste decir "${s}"? Corre: ${helpCmd}`) : t(`Run: ${helpCmd}`, `Corre: ${helpCmd}`));
@@ -14296,6 +14341,9 @@ async function main() {
       turns: { type: "string" },
       vence: { type: "string" },
       "per-ip": { type: "string" },
+      "per-visitor": { type: "string" },
+      domains: { type: "string" },
+      color: { type: "string" },
       welcome: { type: "string" },
       chips: { type: "string" },
       starter: { type: "string" },
@@ -14452,7 +14500,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.50.0" }, () => "0.50.0");
+  if (v.version) return out({ version: "0.51.0" }, () => "0.51.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -14520,6 +14568,7 @@ async function main() {
       if (sub === "docs" || sub === "documents") return agentDocsCmd(a1, a2, pos.slice(4).filter((x) => x !== void 0), v);
       if (sub === "restart") return agentsRestart(a1);
       if (sub === "demo") return agentsDemo(a1, v);
+      if (sub === "embed" || sub === "widget") return agentsEmbed(a1, v);
       if (sub === "box") return agentsBox(a1, v);
       if (sub === "export") return agentsExport(a1, v);
       throw unknown(`agents ${sub}`, sub, AGENTS_SUBS, "ghosty agents --help");
@@ -14617,7 +14666,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.50.0").catch(() => null);
+var notice = updateNotice("0.51.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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