@ghostystudio/cli 0.50.0 → 0.52.0

package/README.md

@@ -38,6 +38,10 @@ 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 embed <id> [--title T] [--avatar URL] [--icon chat|avatar|ghost] [--position left] [--theme auto] [--bubble-text T] [--auto-open S] [--starters "a|b"]   # its look
+ghosty agents embed <id> [--style '{json}'] [--theme-source teams|site --site-url URL] [--style-file theme.json]   # its theme · `theme` exports it
 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 +107,16 @@ 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.52.0
+
+- `agents embed <id>` customizes the web widget: `--title`, `--subtitle`, `--avatar URL|none`, `--icon chat|avatar|ghost`, `--placeholder`, `--position right|left`, `--offset X[,Y]`, `--theme light|dark|auto`, `--bubble-text`, `--auto-open S|off`, `--starters "a|b"` (up to 4 of yours; Ghosty's never show). The pasted `<script>` doesn't change.
+- Fine style without free CSS: `--style '{json}'|none` (fontFamily from a Google Fonts allow-list, radius 0–24, header/bubble/input/send/launcher colors, titleUppercase, statusDot, sendArrow), shortcuts `--font` and `--radius`.
+- Theme source: `--theme-source teams` (your Ghosty Teams workspace brand, `--workspace SLUG`) or `--theme-source site --site-url URL` (your site's CSS colors), imported as editable values. `agents embed <id> theme` exports it as JSON; `--style-file theme.json` applies it back.
+
+### 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.52.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.52.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -9339,6 +9344,101 @@ async function agentsDemo(id, v) {
     ].join("\n")
   );
 }
+function styleSummary(st) {
+  if (!st) return "";
+  return Object.entries(st).filter(([k, x]) => x !== null && !(k === "headerAvatar" && x === true) && !(k === "titleUppercase" && x === false) && !(k === "sendArrow" && x === "up")).map(([k, x]) => `${k}=${x}`).join(" ");
+}
+async function agentsEmbed(id, v, action) {
+  id = need(id, "agent id", "ghosty agents embed enable <agent-id> --domains tusitio.com");
+  if (action === "theme") {
+    const e2 = await api(agentPath(id, "/embed"));
+    const theme = { themeSource: e2.themeSource ?? "custom", themeFrom: e2.themeFrom ?? null, siteUrl: e2.siteUrl ?? null, color: e2.color, theme: e2.theme ?? "light", style: e2.style ?? {} };
+    return out(theme, () => JSON.stringify(theme, null, 2));
+  }
+  if (action) throw usage(t(`Unknown: agents embed <id> ${action}`, `No existe: agents embed <id> ${action}`), "ghosty agents embed <id> theme");
+  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;
+  const clear = (x) => x === "" || x.toLowerCase() === "none" ? null : x;
+  if (v.avatar !== void 0) body.avatarUrl = clear(v.avatar);
+  if (v.title !== void 0) body.title = clear(v.title);
+  if (v.subtitle !== void 0) body.subtitle = clear(v.subtitle);
+  if (v.placeholder !== void 0) body.placeholder = clear(v.placeholder);
+  if (v["bubble-text"] !== void 0) body.bubbleText = clear(v["bubble-text"]);
+  if (v.icon !== void 0) body.icon = v.icon;
+  if (v.position !== void 0) body.position = v.position;
+  if (v.theme !== void 0) body.theme = v.theme;
+  if (v.offset !== void 0) {
+    const [x, y] = v.offset.split(/[,x ]+/).map((n) => Number(n));
+    if (!Number.isFinite(x)) throw usage(t("--offset takes px: 20 or 20,40 (side,bottom)", "--offset va en px: 20 o 20,40 (lado,abajo)"));
+    body.offsetX = x;
+    body.offsetY = Number.isFinite(y) ? y : x;
+  }
+  if (v["auto-open"] !== void 0) body.autoOpen = /^(off|no|0|)$/i.test(v["auto-open"]) ? 0 : Number(v["auto-open"]);
+  if (v.starters !== void 0) body.starters = v.starters.split("|").map((x) => x.trim()).filter(Boolean);
+  if (v.style !== void 0) {
+    if (v.style.toLowerCase() === "none") body.style = null;
+    else {
+      try {
+        body.style = JSON.parse(v.style);
+      } catch {
+        throw usage(t(`--style takes JSON: '{"headerBg":"#2d4a2e","radius":0}'`, `--style va en JSON: '{"headerBg":"#2d4a2e","radius":0}'`));
+      }
+    }
+  }
+  if (v["style-file"]) {
+    let j;
+    try {
+      j = JSON.parse(await readFile3(v["style-file"], "utf8"));
+    } catch (err) {
+      throw usage(t(`Could not read ${v["style-file"]} as JSON: ${err.message}`, `No pude leer ${v["style-file"]} como JSON: ${err.message}`));
+    }
+    const isTheme = j && typeof j === "object" && "style" in j;
+    body.style = isTheme ? j.style : j;
+    if (isTheme && typeof j.color === "string" && body.color === void 0) body.color = j.color;
+    if (isTheme && typeof j.theme === "string" && body.theme === void 0) body.theme = j.theme;
+  }
+  if (v["theme-source"] !== void 0) body.themeSource = v["theme-source"];
+  if (v["site-url"] !== void 0) {
+    body.siteUrl = v["site-url"];
+    if (body.themeSource === void 0) body.themeSource = "site";
+  }
+  if (body.themeSource === "teams" && v.workspace) body.teamsWorkspace = v.workspace;
+  if (v.font !== void 0 || v.radius !== void 0) {
+    const st = body.style && typeof body.style === "object" ? body.style : {};
+    if (v.font !== void 0) st.fontFamily = clear(v.font);
+    if (v.radius !== void 0) st.radius = v.radius === "" || v.radius === "none" ? null : Number(v.radius);
+    body.style = st;
+  }
+  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}`)),
+      `${t("first message", "primer mensaje")}: ${e.welcome ?? dim(e.welcomeShown ?? t("(default greeting)", "(saludo por defecto)"))}`,
+      `${t("header", "encabezado")}: ${e.title ?? e.agentName ?? ""}${e.subtitle ? ` \xB7 ${e.subtitle}` : ""}  ${dim(`${t("avatar", "avatar")} ${e.avatarUrl ?? t("ghost", "fantasma")} \xB7 ${t("icon", "\xEDcono")} ${e.icon ?? "chat"}`)}`,
+      dim(
+        `${t("position", "lado")} ${e.position ?? "right"} (${e.offsetX ?? 20},${e.offsetY ?? 20}px) \xB7 ${t("theme", "tema")} ${e.theme ?? "light"} \xB7 ${t("text on color", "texto sobre el color")} ${e.textColor ?? ""} \xB7 ${t("auto-open", "abrir solo")} ${e.autoOpen ? `${e.autoOpen}s` : "off"}${e.bubbleText ? ` \xB7 ${t("label", "etiqueta")} \xAB${e.bubbleText}\xBB` : ""}${e.placeholder ? ` \xB7 placeholder \xAB${e.placeholder}\xBB` : ""}`
+      ),
+      e.starters?.length ? `${t("suggestions", "sugerencias")}: ${e.starters.join(" | ")}` : dim(t("suggestions: (none)", "sugerencias: (ninguna)")),
+      `${t("theme", "tema")}: ${e.themeSource ?? "custom"}${e.themeFrom ? dim(` \xB7 ${e.themeFrom}`) : ""}`,
+      ...styleSummary(e.style) ? [dim(`${t("style", "estilo")}: ${styleSummary(e.style)}`)] : [],
+      ...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 +10050,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.52.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -11555,6 +11655,10 @@ var HELPS_ES = {
     summary: "Crea, revisa, cambia, diagnostica y borra agentes.",
     replace: [
       ["# the agent as a file; see ghosty apply --help", "# el agente como archivo; ver ghosty apply --help"],
+      ["# its look", "# su apariencia"],
+      ["# its theme", "# su tema"],
+      ["# export the theme as JSON (edit it, apply it back with --style-file)", "# exporta el tema en JSON (ed\xEDtalo y vuelve a aplicarlo con --style-file)"],
+      ["--style-file theme.json", "--style-file tema.json"],
       ["# who is @build in Teams (that workspace, or all of yours)", "# qui\xE9n es @build en Teams (en ese espacio, o en todos los tuyos)"],
       ["# change one piece of the prompt, on the server's current one", "# cambia un pedazo del prompt, sobre el actual del servidor"],
       ["# your account: merge copies with the same content", "# tu cuenta: une las copias con el mismo contenido"],
@@ -11563,7 +11667,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"],
@@ -11606,6 +11712,22 @@ var HELPS_ES = {
       ['--chips "a|b|c"', "demo: sugerencias, separadas por |"],
       ["--sponsor on|off", "demo: las copias que la gente se queda corren con TU llave del motor"],
       ["--rotate", "demo: c\xF3digo nuevo; la liga vieja deja de servir"],
+      ["--domains a.com,*.b.com", "embed: d\xF3nde puede cargarse el widget (vac\xEDo = en ning\xFAn lado)"],
+      ["--welcome TEXT", "embed: el primer mensaje que ve el visitante (vac\xEDo = \xAB\xA1Hola! \xBFEn qu\xE9 te ayudo?\xBB)"],
+      ["--title T / --subtitle T", "embed: nombre en el encabezado del widget (default: el del agente) y un rengl\xF3n chico debajo (\xABResponde en minutos\xBB)"],
+      ["--avatar URL|none", "embed: tu imagen (https JPEG/PNG/WebP, se rehospeda en img.ghosty.studio); none = el fantasma del agente"],
+      ["--icon chat|avatar|ghost", "embed: qu\xE9 lleva el bot\xF3n flotante"],
+      ["--placeholder T", "embed: el texto gris de la caja para escribir"],
+      ["--position right|left / --offset X[,Y]", "embed: esquina de la p\xE1gina y separaci\xF3n en px del lado y de abajo (0-200, default 20)"],
+      ["--theme light|dark|auto", "embed: tema del panel del chat (auto = el del visitante)"],
+      ["--bubble-text T", "embed: etiqueta junto al bot\xF3n (\xAB\xBFDudas?\xBB)"],
+      ["--auto-open S|off", "embed: se abre solo a los S segundos (1-120), una vez por visita, nunca en el tel\xE9fono"],
+      ['--starters "a|b|c"', 'embed: hasta 4 sugerencias TUYAS ("" las quita; nunca salen las de Ghosty)'],
+      ["--style '{json}'|none", "embed: estilo fino, s\xF3lo llaves conocidas: fontFamily, radius, headerBg, headerText, titleUppercase, statusDot, headerAvatar, panelBg, userBubbleBg/Text, agentBubbleBg/Text, inputBg, sendBg, sendIcon, sendArrow (up|right), launcherBg, launcherIcon. PATCH por llave (null resetea una); none resetea todo"],
+      ["--font NOMBRE / --radius 0-24", "embed: atajos de style.fontFamily (lista de Google Fonts: Barlow, Inter, Poppins\u2026) y style.radius"],
+      ["--theme-source custom|teams|site", "embed: importa el tema de la marca de tu espacio de Ghosty Teams (--workspace SLUG para elegir) o de tu sitio (--site-url); queda editable"],
+      ["--site-url URL", "embed: el sitio del que se sacan los colores (implica --theme-source site)"],
+      ["--style-file ARCHIVO", "embed: aplica un tema exportado con `agents embed <id> theme` (o s\xF3lo el objeto style)"],
       ["--check PATH", "box: este archivo debe existir en la m\xE1quina (repetible), p. ej. un archivo que trae la imagen nueva"],
       ["--contains PATH=TEXT", "box: ese archivo debe contener TEXT (un cambio que no agrega archivos)"],
       ["--recycle", "box: reemplaza sus m\xE1quinas (nunca a media respuesta); pool: la nueva nace en el siguiente turno; ACP (goose, lite): su caja se recrea ya con la imagen actual"],
@@ -12065,6 +12187,11 @@ 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 embed <agent-id> [--title T] [--subtitle T] [--avatar URL] [--icon chat|avatar|ghost] [--placeholder T] [--position right|left] [--offset X,Y] [--theme light|dark|auto] [--bubble-text T] [--auto-open S] [--starters "a|b"]   # its look',
+      "ghosty agents embed <agent-id> [--theme-source custom|teams|site] [--site-url URL] [--style '{json}'] [--style-file theme.json] [--font NAME] [--radius 0-24]   # its theme",
+      "ghosty agents embed <agent-id> theme   # export the theme as JSON (edit it, apply it back with --style-file)",
       "ghosty agents rm <agent-id> [--from-workspace] [--yes]"
     ],
     flags: [
@@ -12108,6 +12235,22 @@ var HELPS = {
       ['--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"],
+      ["--domains a.com,*.b.com", "embed: where the widget may load (empty = nowhere)"],
+      ["--welcome TEXT", "embed: the first message the visitor sees (empty = \xAB\xA1Hola! \xBFEn qu\xE9 te ayudo?\xBB)"],
+      ["--title T / --subtitle T", `embed: name in the widget header (default: the agent's name) and a small line under it ("Replies in minutes")`],
+      ["--avatar URL|none", "embed: your own image (https JPEG/PNG/WebP, re-hosted on img.ghosty.studio); none = the agent's ghost"],
+      ["--icon chat|avatar|ghost", "embed: what the floating button shows"],
+      ["--placeholder T", "embed: grey text in the message box"],
+      ["--position right|left / --offset X[,Y]", "embed: corner of the page and distance in px from the side and the bottom (0-200, default 20)"],
+      ["--theme light|dark|auto", "embed: the chat panel's theme (auto = the visitor's)"],
+      ["--bubble-text T", 'embed: label next to the button ("Questions?")'],
+      ["--auto-open S|off", "embed: open by itself after S seconds (1-120), once per visit, never on phones"],
+      ['--starters "a|b|c"', `embed: up to 4 of YOUR suggestions ("" removes them; Ghosty's are never shown)`],
+      ["--style '{json}'|none", "embed: fine style, only known keys: fontFamily, radius, headerBg, headerText, titleUppercase, statusDot, headerAvatar, panelBg, userBubbleBg/Text, agentBubbleBg/Text, inputBg, sendBg, sendIcon, sendArrow (up|right), launcherBg, launcherIcon. Patch per key (null resets one); none resets all"],
+      ["--font NAME / --radius 0-24", "embed: shortcuts for style.fontFamily (Google Fonts allow-list: Barlow, Inter, Poppins\u2026) and style.radius"],
+      ["--theme-source custom|teams|site", "embed: import the theme from the brand of your Ghosty Teams workspace (--workspace SLUG to pick one) or from your site (--site-url); it stays editable"],
+      ["--site-url URL", "embed: the site to take colors from (implies --theme-source site)"],
+      ["--style-file FILE", "embed: apply a theme exported with `agents embed <id> theme` (or a plain style object)"],
       ["--check PATH", "box: this file must exist in the machine (repeatable), e.g. a file the new image brings"],
       ["--contains PATH=TEXT", "box: that file must contain TEXT (a change that adds no files)"],
       ["--recycle", "box: replace its machines (not mid-turn); pool: the new one starts on the next turn; ACP (goose, lite): its box is recreated now with the current image"],
@@ -12143,6 +12286,10 @@ 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 embed <id> --title "Palmera Legal" --subtitle "Responde en minutos" --position left --bubble-text "\xBFDudas?" --starters "\xBFCu\xE1nto cuesta una consulta?|\xBFD\xF3nde est\xE1n?"',
+      "ghosty agents embed <id> --theme-source site --site-url https://palmeralegal.mx",
+      "ghosty agents embed <id> theme > tema.json   \xB7   ghosty agents embed <id> --style-file tema.json",
       "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 +13136,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 +14116,12 @@ ${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]
+                            look: [--title T] [--subtitle T] [--avatar URL|none] [--icon chat|avatar|ghost] [--placeholder T] [--position right|left] [--offset X[,Y]]
+                            [--theme light|dark|auto] [--bubble-text T] [--auto-open SECONDS|off] [--starters "a|b|c"] [--font NAME] [--radius 0-24] [--style '{json}'|none]
+                            theme: [--theme-source custom|teams|site] [--workspace SLUG] [--site-url URL] [--style-file theme.json]
+  agents embed <id> theme   Export the widget theme as JSON (edit it and apply it back with --style-file)
+  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 +14278,12 @@ ${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]
+                            look: [--title T] [--subtitle T] [--avatar URL|none] [--icon chat|avatar|ghost] [--placeholder T] [--position right|left] [--offset X[,Y]]
+                            [--theme light|dark|auto] [--bubble-text T] [--auto-open SEGUNDOS|off] [--starters "a|b|c"] [--font NOMBRE] [--radius 0-24] [--style '{json}'|none]
+                            tema: [--theme-source custom|teams|site] [--workspace SLUG] [--site-url URL] [--style-file tema.json]
+  agents embed <id> theme   Exporta el tema del widget en JSON (ed\xEDtalo y vuelve a aplicarlo con --style-file)
+  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 +14377,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,10 +14459,28 @@ 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" },
       rotate: { type: "boolean" },
+      subtitle: { type: "string" },
+      placeholder: { type: "string" },
+      position: { type: "string" },
+      offset: { type: "string" },
+      theme: { type: "string" },
+      icon: { type: "string" },
+      "bubble-text": { type: "string" },
+      "auto-open": { type: "string" },
+      starters: { type: "string" },
+      style: { type: "string" },
+      font: { type: "string" },
+      radius: { type: "string" },
+      "style-file": { type: "string" },
+      "theme-source": { type: "string" },
+      "site-url": { type: "string" },
       sponsor: { type: "string" },
       yes: { type: "boolean", short: "y" },
       dir: { type: "string" },
@@ -14452,7 +14633,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.52.0" }, () => "0.52.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 +14701,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, a2);
       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 +14799,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.50.0").catch(() => null);
+var notice = updateNotice("0.52.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.52.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": {