@thesashadev/girl-agent 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.1.9
+
+Дата: 2026-05-07
+
+- Merge pull request #48 from TheSashaDev/devin/1778156776-auto-release-workflow
+- Merge pull request #50 from TheSashaDev/devin/1778176335-fix-markdown-escape
+- fix: also switch userbot editLastMessage to HTML spoilers, remove dead escapeMarkdownV2
+- fix(telegram): replace MarkdownV2 with HTML spoilers, plain text default (#46)
+- feat(ci): auto-release workflow — hourly patch bump + changelog
+- Merge pull request #47 from TheSashaDev/devin/1778156514-docker-latest-on-master
+- fix(docker): tag latest on master pushes, not main
+- Merge pull request #45 from TheSashaDev/devin/1778149966-fix-dockerfile-build-stage
+- fix(docker): add build tools to build stage for arm64 native modules
+- Merge pull request #44 from TheSashaDev/devin/1778149678-fix-dockerfile-arm64
+- fix(docker): add build tools for native modules on alpine arm64
+- Merge pull request #43 from TheSashaDev/devin/1778149272-fix-docker-install
+- fix: docker install — fix branch ref (main→master), fallback to local on pull failure
+- Merge pull request #37 from TheSashaDev/devin/1778090781-windows-installer-webui
+- feat(server): curl|sh installer + docker image + headless server mode
+- fix(cli): fail loudly on non-TTY terminals + catch unhandled rejections
+- feat(installer/desktop): paste, ClaudeHub referral, tournament names, custom sleep, profile picker
+- fix(installer): silent crash on Windows — panic=abort + windowed subsystem hid the panic
+- fix(installer): replace empty-text widgets in progress header with Space
+- feat(installer): bundle portable Node + cli.js, full TS-wizard parity, Cyrillic fonts
+- perf: add release-fast profile, mold linker, windows_subsystem
+- Добавить ссылки на Telegram канал и сообщество
+- feat: native Windows installer + desktop app + web UI (Rust/iced)
+- Merge pull request #36 from TheSashaDev/devin/1778089384-changelog-pr35
+- docs: add PR 35 to changelog
+
 ## 0.1.8 — OpenAI-compatible API compatibility
 
 Дата: 2026-05-06
@@ -7,6 +37,7 @@
 - JSON-ответы теперь сначала запрашиваются через `json_schema`, с fallback на `json_object` и `text` для разных OpenAI-compatible API. (#33)
 - LM Studio и Ollama больше не требуют реальный API ключ в wizard/headless setup.
 - Добавлена совместимость с OpenAI-compatible прокси, которые возвращают SSE/event-stream даже на обычный chat completions запрос.
+- Добавлена Docker-поддержка для 24/7 запуска на сервере: `Dockerfile`, `docker-compose.yml`, volume для `data` и инструкции в README. (#35)
 
 ## 0.1.7 — MarkdownV2 escaping fix
 

package/README.md

@@ -10,6 +10,8 @@
 Со всеми проблемами и багами пишите в Issues.
 ТГ создателя - @voided_net
 
+Тг канал: https://t.me/GirlAgentAI/
+Тг сообщество: https://t.me/GirlAgentAI_chat/
 ---
 
 ## Содержание
@@ -35,35 +37,97 @@
 
 ## Быстрый старт
 
-**Через NPX (рекомендуется):**
+### linux / macos / wsl — одной командой (без node на машине)
 
-```powershell
-npx @thesashadev/girl-agent
+```sh
+curl -fsSL https://raw.githubusercontent.com/TheSashaDev/girl-agent/master/scripts/install.sh | sh
+```
+
+Что произойдёт:
+- определит OS + arch (linux x64/arm64, macos x64/arm64, wsl)
+- если есть docker → поставит docker-обёртку (полная изоляция от системы)
+- иначе → скачает [official Node.js 22 LTS](https://nodejs.org) в `~/.local/share/girl-agent/runtime/` и поставит туда же `@thesashadev/girl-agent` (system node не трогается)
+- shim-скрипт `girl-agent` положит в `~/.local/bin/girl-agent`
+- ничего не пишется в `/usr/local/`, `sudo` не нужен
+
+Дальше:
+```sh
+girl-agent                   # ink-визард для интерактивной первичной настройки
+girl-agent --profile=arina   # запустить готовый профиль
+girl-agent server --help     # серверный режим (без TTY, для systemd / cron / CI)
+```
+
+Опции установщика:
+```sh
+# форсировать docker
+curl -fsSL .../install.sh | sh -s -- --docker
+
+# форсировать локальную ноду
+curl -fsSL .../install.sh | sh -s -- --local
+
+# конкретная версия пакета
+curl -fsSL .../install.sh | sh -s -- --version=0.1.9
 ```
 
-Wizard задаст пару вопросов — имя, возраст, Telegram-подключение, LLM-ключ. Всё.
+Удаление: `rm -rf ~/.local/share/girl-agent ~/.local/bin/girl-agent`
 
-Если профиль уже есть:
+### windows — десктоп-приложение
+
+В папке `desktop-rs/` лежит нативный десктоп-клиент на Rust (iced) и инсталлер-визард: ставит Node-пакет, создаёт профиль, открывает дашборд. Параллельно поднимается локальный веб-UI на `http://127.0.0.1:7777` с тем же дашбордом — открыть из соседнего окна / телефона по локалке. Без WebView, без Electron.
 
 ```powershell
+cd desktop-rs
+cargo run -p girl-agent-installer   # визард настройки персоны
+cargo run -p girl-agent-desktop     # открыть дашборд
+```
+
+Готовые бинари будут собираться в CI чуть позже — пока нужно `cargo build --release`.
+
+### если уже есть node ≥ 20
+
+```sh
+npx @thesashadev/girl-agent              # ink-визард
 npx @thesashadev/girl-agent --profile=arina
 ```
 
-**Через Docker (рекомендуется для сервера):**
+### docker (для серверов; нулевые зависимости на хосте)
+
+Интерактивная первичная настройка (ink-визард внутри контейнера):
+```sh
+docker run -it --rm -v girl-agent-data:/data ghcr.io/thesashadev/girl-agent:latest
+```
 
-Первый запуск с интерактивом (для настройки через визард):
-```bash
-docker-compose run --rm -it girl-agent
+Headless (для systemd / docker compose / k8s) — сначала готовим конфиг, потом запускаем без TTY:
+```sh
+# 1) шаблон конфига
+docker run --rm ghcr.io/thesashadev/girl-agent:latest server --print-config > bot.json
+# 2) отредактировать bot.json (token, api-key)
+# 3) поднять в фоне
+docker run -d --name girl-agent --restart=unless-stopped \
+  -v girl-agent-data:/data \
+  -v $PWD/bot.json:/config/bot.json:ro \
+  ghcr.io/thesashadev/girl-agent:latest \
+  server --config /config/bot.json --headless
 ```
-*(пройдите все шаги и после появления дашборда нажмите `Ctrl+C`)*
 
-Последующие (запуск в фоне):
-```bash
-docker-compose up -d
+Или совсем без файла, через env-vars (k8s secrets, docker compose):
+```sh
+docker run -d --name girl-agent --restart=unless-stopped \
+  -v girl-agent-data:/data \
+  -e GIRL_AGENT_MODE=bot \
+  -e GIRL_AGENT_TOKEN=... \
+  -e GIRL_AGENT_API_PRESET=claudehub \
+  -e GIRL_AGENT_API_KEY=... \
+  -e GIRL_AGENT_NAME='Аня' -e GIRL_AGENT_AGE=22 \
+  ghcr.io/thesashadev/girl-agent:latest \
+  server --headless
 ```
-*(если профилей несколько, запустите конкретный так: `docker-compose run -d girl-agent node dist/cli.js --profile=arina`)*
 
-*(посмотреть логи: `docker-compose logs -f`)*
+Готовые шаблоны:
+- `girl-agent server --print-config` — bot.json
+- `girl-agent server --print-systemd` — `/etc/systemd/system/girl-agent.service`
+- `girl-agent server --print-docker` — Dockerfile / compose / k8s snippets
+- [`docker-compose.example.yml`](./docker-compose.example.yml) в корне репо
 
 **Из исходников:**
 

package/dist/cli.js

@@ -19,15 +19,19 @@ var init_esm_shims = __esm({
 });
 
 // src/telegram/markdown.ts
-function escapeMarkdownV2(text) {
-  return text.replace(MD2_RESERVED, "\\$1");
+function hasSpoilers(text) {
+  return /\|\|.+?\|\|/.test(text);
+}
+function escapeHtml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function toHtmlWithSpoilers(text) {
+  return escapeHtml(text).replace(/\|\|(.+?)\|\|/g, "<tg-spoiler>$1</tg-spoiler>");
 }
-var MD2_RESERVED;
 var init_markdown = __esm({
   "src/telegram/markdown.ts"() {
     "use strict";
     init_esm_shims();
-    MD2_RESERVED = /([_*\[\]()~`>#+\-=|{}.!\\])/g;
   }
 });
 
@@ -190,11 +194,14 @@ function makeUserbotAdapter(cfg) {
     },
     async editLastMessage(chatId, messageId, text) {
       const peer = await resolvePeer(chatId);
-      try {
-        await client.editMessage(peer, { message: messageId, text: escapeMarkdownV2(text), parseMode: "MarkdownV2" });
-      } catch {
-        await client.editMessage(peer, { message: messageId, text });
+      if (hasSpoilers(text)) {
+        try {
+          await client.editMessage(peer, { message: messageId, text: toHtmlWithSpoilers(text), parseMode: "html" });
+          return;
+        } catch {
+        }
       }
+      await client.editMessage(peer, { message: messageId, text });
     },
     async deleteMessages(chatId, messageIds, revoke = false) {
       const peer = await resolvePeer(chatId);
@@ -293,13 +300,15 @@ function makeBotAdapter(cfg) {
       });
     },
     async sendText(chatId, text) {
-      try {
-        const msg = await bot.api.sendMessage(chatId, escapeMarkdownV2(text), { parse_mode: "MarkdownV2" });
-        return msg.message_id;
-      } catch {
-        const msg = await bot.api.sendMessage(chatId, text);
-        return msg.message_id;
+      if (hasSpoilers(text)) {
+        try {
+          const msg2 = await bot.api.sendMessage(chatId, toHtmlWithSpoilers(text), { parse_mode: "HTML" });
+          return msg2.message_id;
+        } catch {
+        }
       }
+      const msg = await bot.api.sendMessage(chatId, text);
+      return msg.message_id;
     },
     async setTyping(chatId, on) {
       if (on) {
@@ -800,7 +809,7 @@ function sameProfile(a, b) {
 init_esm_shims();
 import { promises as fs } from "fs";
 import path2 from "path";
-var DATA_ROOT = path2.resolve(process.cwd(), "data");
+var DATA_ROOT = process.env.GIRL_AGENT_DATA ? path2.resolve(process.env.GIRL_AGENT_DATA) : path2.resolve(process.cwd(), "data");
 function profileDir(slug) {
   return path2.join(DATA_ROOT, slug);
 }
@@ -1534,14 +1543,14 @@ var DEFAULT_PROXY = "https://tgproxy.girl-agent.com";
 function proxyUrl() {
   return process.env.GIRL_AGENT_AUTH_PROXY ?? DEFAULT_PROXY;
 }
-async function post(path5, body) {
-  const res = await fetch(`${proxyUrl()}${path5}`, {
+async function post(path6, body) {
+  const res = await fetch(`${proxyUrl()}${path6}`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   const data = await res.json();
-  if (!res.ok) throw new Error(data.error ?? `proxy ${path5} failed (${res.status})`);
+  if (!res.ok) throw new Error(data.error ?? `proxy ${path6} failed (${res.status})`);
   return data;
 }
 function remoteSendCode(phone) {
@@ -3093,8 +3102,8 @@ phoneAvailable=false \u043A\u043E\u0433\u0434\u0430: \u0441\u043F\u0438\u0442, \
 }
 async function loadOrGenerateDailyLife(llm, cfg, now = /* @__PURE__ */ new Date(), conflict = null) {
   const dateLocal = localDateStr(cfg.tz, now);
-  const path5 = `daily-life/${dateLocal}.md`;
-  const existing = await readMd(cfg.slug, path5);
+  const path6 = `daily-life/${dateLocal}.md`;
+  const existing = await readMd(cfg.slug, path6);
   if (existing) {
     try {
       const m = existing.match(/<!--daily:(.+?)-->/s);
@@ -3126,7 +3135,7 @@ async function loadOrGenerateDailyLife(llm, cfg, now = /* @__PURE__ */ new Date(
     dl = { dateLocal, vibe: "\u043E\u0431\u044B\u0447\u043D\u044B\u0439 \u0434\u0435\u043D\u044C", blocks: [], events: [], wants: [] };
   }
   const human = renderDailyLifeHuman(dl);
-  await writeMd(cfg.slug, path5, `${human}
+  await writeMd(cfg.slug, path6, `${human}
 
 <!--daily:${JSON.stringify(dl)}-->
 `);
@@ -3356,9 +3365,9 @@ async function ensureDefaults(cfg) {
     ["time/promises.md", "# promises\n"],
     ["memory/uncertain.md", "# uncertain\n"]
   ];
-  await Promise.all(defaults.map(async ([path5, content]) => {
-    const current = await readMd(cfg.slug, path5);
-    if (!current.trim()) await writeMd(cfg.slug, path5, content + "\n");
+  await Promise.all(defaults.map(async ([path6, content]) => {
+    const current = await readMd(cfg.slug, path6);
+    if (!current.trim()) await writeMd(cfg.slug, path6, content + "\n");
   }));
 }
 async function loadRealismContext(cfg, incoming) {
@@ -5730,6 +5739,536 @@ function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 
+// src/headless.ts
+init_esm_shims();
+import readline from "readline";
+async function runHeadlessJsonEvents(rt) {
+  const out = (obj) => {
+    process.stdout.write(JSON.stringify(obj) + "\n");
+  };
+  out({ type: "ready", profile: profileSummary(rt.cfg) });
+  rt.on("event", (e) => {
+    out({ ...e, t: Date.now() });
+  });
+  try {
+    const r = await readRelationship(rt.cfg.slug);
+    out({ type: "score", score: r.score, t: Date.now() });
+  } catch {
+  }
+  let paused = false;
+  const rl = readline.createInterface({ input: process.stdin, terminal: false });
+  rl.on("line", async (raw) => {
+    const line = raw.trim();
+    if (!line) return;
+    if (!line.startsWith(":")) {
+      out({ type: "response", ok: false, text: "\u043A\u043E\u043C\u0430\u043D\u0434\u044B \u043D\u0430\u0447\u0438\u043D\u0430\u044E\u0442\u0441\u044F \u0441 :" });
+      return;
+    }
+    const [head, ...rest] = line.slice(1).split(" ");
+    try {
+      let text = "";
+      switch (head) {
+        case "status":
+          text = await rt.cmdStatus();
+          break;
+        case "reset":
+          text = await rt.cmdReset();
+          break;
+        case "stage":
+          text = await rt.cmdSetStage(rest.join(" "));
+          break;
+        case "wake":
+          text = await rt.cmdWake(rest[0]);
+          break;
+        case "debug":
+          text = await rt.cmdDebug(rest[0]);
+          break;
+        case "why":
+          text = await rt.cmdWhy(rest[0]);
+          break;
+        case "amnesia":
+          text = await rt.cmdAmnesia(rest[0], rest[1]);
+          break;
+        case "block":
+          text = await rt.cmdBlock(rest[0]);
+          break;
+        case "unblock":
+          text = await rt.cmdUnblock(rest[0]);
+          break;
+        case "read":
+          text = await rt.cmdRead(rest[0]);
+          break;
+        case "clear-chat":
+          text = await rt.cmdClearChat(rest.find((x) => !x.startsWith("--")), rest.includes("--revoke"));
+          break;
+        case "report-spam":
+          text = await rt.cmdReportSpam(rest[0]);
+          break;
+        case "delete-last":
+          text = await rt.cmdDeleteLast(rest.find((x) => !x.startsWith("--")), !rest.includes("--local"));
+          break;
+        case "edit-last":
+          text = await rt.cmdEditLast(rest.join(" "));
+          break;
+        case "sticker":
+          text = await rt.cmdSticker(rest[0]);
+          break;
+        case "pause":
+          rt.pause();
+          paused = true;
+          text = "\u23F8 pause";
+          break;
+        case "resume":
+          rt.resume();
+          paused = false;
+          text = "\u25B6 resume";
+          break;
+        case "cringe": {
+          const r = await readRelationship(rt.cfg.slug);
+          text = `cringe=${r.score.cringe}; \u0441\u043C. memory/long-term.md \u0438 log/`;
+          break;
+        }
+        case "relationship": {
+          const r = await readRelationship(rt.cfg.slug);
+          text = `stage=${r.stage} score=${JSON.stringify(r.score)}`;
+          break;
+        }
+        case "persona": {
+          const p = await readMd(rt.cfg.slug, "persona.md");
+          text = p.slice(0, 4e3);
+          break;
+        }
+        case "log": {
+          const day = /^\d{4}-\d{2}-\d{2}$/.test(rest[0] ?? "") ? rest[0] : sessionDate(rt.cfg.tz);
+          const limit = Number(rest.find((x) => /^\d+$/.test(x)) ?? 3e3);
+          const p = await readSessionLog(rt.cfg.slug, day);
+          text = p.trim() ? p.slice(-Math.max(500, Math.min(limit, 2e4))) : `(log/${day}.md \u043F\u0443\u0441\u0442)`;
+          break;
+        }
+        case "snapshot": {
+          const r = await readRelationship(rt.cfg.slug);
+          out({
+            type: "snapshot",
+            t: Date.now(),
+            paused,
+            profile: profileSummary(rt.cfg),
+            stage: { id: r.stage, label: findStage(r.stage).label },
+            score: r.score
+          });
+          return;
+        }
+        case "help":
+          text = ":status :why :amnesia :reset :stage :wake :debug :pause :resume :cringe :relationship :persona :log :block :unblock :read :clear-chat :report-spam :delete-last :edit-last :sticker :snapshot :quit";
+          break;
+        case "quit":
+        case "exit":
+          await rt.stop();
+          out({ type: "response", ok: true, text: "bye" });
+          process.exit(0);
+        default:
+          out({ type: "response", ok: false, text: `\u043D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u0430\u044F \u043A\u043E\u043C\u0430\u043D\u0434\u0430: ${head}` });
+          return;
+      }
+      out({ type: "response", ok: true, text });
+    } catch (e) {
+      out({ type: "response", ok: false, text: "err: " + e.message });
+    }
+  });
+  const shutdown = async () => {
+    try {
+      await rt.stop();
+    } catch {
+    }
+    out({ type: "stopped", t: Date.now() });
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  await new Promise(() => {
+  });
+}
+function profileSummary(cfg) {
+  const stage = findStage(cfg.stage);
+  return {
+    slug: cfg.slug,
+    name: cfg.name,
+    age: cfg.age,
+    mode: cfg.mode,
+    nationality: cfg.nationality,
+    tz: cfg.tz,
+    stage: { id: cfg.stage, label: stage.label }
+  };
+}
+
+// src/server.ts
+init_esm_shims();
+import fs4 from "fs/promises";
+import path5 from "path";
+import os from "os";
+var SERVER_HELP = `
+girl-agent server \u2014 automation / ops mode (no TTY required)
+
+usage:
+  girl-agent server --print-config > bot.json
+  # \u043E\u0442\u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u0443\u0439 bot.json
+  girl-agent server --config bot.json --headless
+
+  girl-agent server --list
+  girl-agent server --profile=<slug> --headless
+
+  girl-agent server --print-systemd > /etc/systemd/system/girl-agent.service
+  girl-agent server --print-docker
+
+env-vars (\u0434\u043B\u044F CI / docker secrets / k8s):
+  GIRL_AGENT_DATA           \u043F\u0443\u0442\u044C \u043A \u043F\u0440\u043E\u0444\u0438\u043B\u044F\u043C (default: ./data)
+  GIRL_AGENT_MODE           bot|userbot
+  GIRL_AGENT_TOKEN          telegram bot token
+  GIRL_AGENT_API_PRESET     openai|anthropic|claudehub|...
+  GIRL_AGENT_API_KEY        \u043A\u043B\u044E\u0447 \u043E\u0442 \u043F\u0440\u043E\u0432\u0430\u0439\u0434\u0435\u0440\u0430
+  GIRL_AGENT_MODEL, _NAME, _AGE, _NATIONALITY, _TZ, _STAGE, _COMM_PRESET
+
+\u0434\u043B\u044F \u0438\u043D\u0442\u0435\u0440\u0430\u043A\u0442\u0438\u0432\u043D\u043E\u0439 \u043F\u0435\u0440\u0432\u0438\u0447\u043D\u043E\u0439 \u043D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0438 \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0439 \u0431\u0435\u0437 \u0444\u043B\u0430\u0433\u043E\u0432 \u0432 \u043E\u0431\u044B\u0447\u043D\u043E\u043C \u0442\u0435\u0440\u043C\u0438\u043D\u0430\u043B\u0435 \u2014
+\u043E\u0442\u043A\u0440\u043E\u0435\u0442\u0441\u044F ink-\u0432\u0438\u0437\u0430\u0440\u0434.
+`;
+function parseServerArgs(argv) {
+  return {
+    config: typeof argv.config === "string" ? argv.config : void 0,
+    printConfig: !!argv["print-config"],
+    printSystemd: !!argv["print-systemd"],
+    printDocker: !!argv["print-docker"],
+    headless: !!argv.headless,
+    jsonEvents: !!argv["json-events"],
+    noStart: !!argv["no-start"] || argv.start === false,
+    profile: typeof argv.profile === "string" ? argv.profile : void 0,
+    list: !!argv.list,
+    help: !!argv.help
+  };
+}
+async function runServer(rawArgv) {
+  const args = parseServerArgs(rawArgv);
+  if (args.help) {
+    process.stdout.write(SERVER_HELP);
+    return;
+  }
+  if (args.printConfig) {
+    process.stdout.write(buildConfigTemplate());
+    return;
+  }
+  if (args.printSystemd) {
+    process.stdout.write(buildSystemdUnit());
+    return;
+  }
+  if (args.printDocker) {
+    process.stdout.write(buildDockerArtifacts());
+    return;
+  }
+  if (args.list) {
+    const list = await listProfiles();
+    process.stdout.write(list.length ? list.join("\n") + "\n" : "(\u043D\u0435\u0442 \u043F\u0440\u043E\u0444\u0438\u043B\u0435\u0439)\n");
+    process.stdout.write(`data: ${DATA_ROOT}
+`);
+    return;
+  }
+  if (args.profile) {
+    const cfg = await readConfig(args.profile);
+    if (!cfg) {
+      process.stderr.write(`profile not found: ${args.profile}
+`);
+      process.stderr.write(`data dir: ${DATA_ROOT}
+`);
+      process.exit(1);
+    }
+    await startRuntime(cfg, args);
+    return;
+  }
+  if (args.config) {
+    const cfg = await loadConfigFile(args.config);
+    await persistAndMaybeStart(cfg, args);
+    return;
+  }
+  const cfgFromEnv = configFromEnv();
+  if (cfgFromEnv) {
+    process.stderr.write("[server] \u043F\u0440\u043E\u0432\u0438\u0436\u0443 \u043F\u0440\u043E\u0444\u0438\u043B\u044C \u0438\u0437 env vars\n");
+    await persistAndMaybeStart(cfgFromEnv, args);
+    return;
+  }
+  process.stderr.write(SERVER_HELP);
+  process.stderr.write("\n[server] \u0434\u043B\u044F \u0438\u043D\u0442\u0435\u0440\u0430\u043A\u0442\u0438\u0432\u043D\u043E\u0439 \u043D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0438 \u0437\u0430\u043F\u0443\u0441\u0442\u0438 \u0431\u0435\u0437 \u0444\u043B\u0430\u0433\u043E\u0432 \u0432 TTY-\u0442\u0435\u0440\u043C\u0438\u043D\u0430\u043B\u0435.\n");
+  process.exit(1);
+}
+async function persistAndMaybeStart(cfg, args) {
+  await writeConfig(cfg);
+  process.stderr.write(`[server] \u043F\u0440\u043E\u0444\u0438\u043B\u044C \u0441\u043E\u0445\u0440\u0430\u043D\u0451\u043D: ${path5.join(DATA_ROOT, cfg.slug)}
+`);
+  if (cfg.llm.apiKey || findPreset(cfg.llm.presetId)?.apiKeyRequired === false) {
+    try {
+      process.stderr.write("[server] \u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u043C persona/speech/communication...\n");
+      const llm = makeLLM(cfg.llm);
+      const generated = await generatePersonaPack(llm, cfg.slug, cfg.name, cfg.age, cfg.nationality, cfg.personaNotes ?? "");
+      cfg.busySchedule = generated.busySchedule;
+      await writeConfig(cfg);
+      process.stderr.write("[server] \u043F\u0435\u0440\u0441\u043E\u043D\u0430 \u0433\u043E\u0442\u043E\u0432\u0430.\n");
+    } catch (e) {
+      process.stderr.write(`[server] \u043E\u0448\u0438\u0431\u043A\u0430 \u0433\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u0438 \u043F\u0435\u0440\u0441\u043E\u043D\u044B: ${e?.message ?? e}
+`);
+      process.stderr.write("[server] \u043F\u0440\u043E\u0444\u0438\u043B\u044C \u0441\u043E\u0445\u0440\u0430\u043D\u0451\u043D, \u043D\u043E \u0431\u0435\u0437 persona.md. \u041C\u043E\u0436\u043D\u043E \u043F\u0435\u0440\u0435\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u043F\u043E\u0437\u0436\u0435.\n");
+    }
+  } else {
+    process.stderr.write("[server] api-\u043A\u043B\u044E\u0447 \u043D\u0435 \u0437\u0430\u0434\u0430\u043D \u2014 \u043F\u0440\u043E\u043F\u0443\u0441\u043A\u0430\u0435\u043C \u0433\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u044E \u043F\u0435\u0440\u0441\u043E\u043D\u044B.\n");
+  }
+  if (args.noStart) {
+    process.stderr.write(`[server] --no-start: \u0437\u0430\u043F\u0443\u0441\u043A \u043F\u0440\u043E\u043F\u0443\u0449\u0435\u043D.
+`);
+    return;
+  }
+  await startRuntime(cfg, args);
+}
+async function startRuntime(cfg, args) {
+  const rt = new Runtime(cfg);
+  await rt.start();
+  const wantsHeadless = !!(args.headless || args.jsonEvents);
+  if (wantsHeadless) {
+    await runHeadlessJsonEvents(rt);
+    return;
+  }
+  process.stderr.write(`[server] \u0431\u043E\u0442 \u0437\u0430\u043F\u0443\u0449\u0435\u043D: ${cfg.name} (${cfg.slug})
+`);
+  rt.on("event", (e) => {
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    const t = e.type ?? "event";
+    process.stdout.write(`${ts} ${t} ${JSON.stringify(e)}
+`);
+  });
+  const stop = async () => {
+    process.stderr.write("[server] \u043E\u0441\u0442\u0430\u043D\u043E\u0432\u043A\u0430...\n");
+    await rt.stop();
+    process.exit(0);
+  };
+  process.on("SIGINT", stop);
+  process.on("SIGTERM", stop);
+}
+function configFromEnv() {
+  const e = process.env;
+  if (!e.GIRL_AGENT_MODE && !e.GIRL_AGENT_TOKEN && !e.GIRL_AGENT_API_KEY) return null;
+  const mode = e.GIRL_AGENT_MODE === "userbot" ? "userbot" : "bot";
+  const presetId = e.GIRL_AGENT_API_PRESET ?? "claudehub";
+  const preset = findPreset(presetId);
+  if (!preset) {
+    process.stderr.write(`[server] unknown api preset in env: ${presetId}
+`);
+    process.exit(1);
+  }
+  const nationality = e.GIRL_AGENT_NATIONALITY === "UA" ? "UA" : "RU";
+  const name = e.GIRL_AGENT_NAME || pickRandomNames(nationality, 1)[0];
+  const age = Number(e.GIRL_AGENT_AGE ?? 18);
+  const tz = e.GIRL_AGENT_TZ ? parseTzFlag(e.GIRL_AGENT_TZ) ?? defaultTzForNationality(nationality) : defaultTzForNationality(nationality);
+  const stage = e.GIRL_AGENT_STAGE || "tg-given-cold";
+  const commPreset = COMMUNICATION_PRESETS.find((c) => c.id === (e.GIRL_AGENT_COMM_PRESET ?? "normal")) ?? COMMUNICATION_PRESETS[0];
+  return {
+    slug: slugify(name),
+    name,
+    age,
+    nationality,
+    tz,
+    mode,
+    stage,
+    llm: {
+      presetId,
+      proto: preset.proto,
+      baseURL: preset.baseURL,
+      apiKey: e.GIRL_AGENT_API_KEY ?? preset.defaultApiKey ?? "",
+      model: e.GIRL_AGENT_MODEL ?? preset.defaultModel
+    },
+    telegram: mode === "bot" ? { botToken: e.GIRL_AGENT_TOKEN ?? "" } : {
+      apiId: Number(e.GIRL_AGENT_TG_API_ID ?? 0),
+      apiHash: e.GIRL_AGENT_TG_API_HASH ?? "",
+      phone: e.GIRL_AGENT_TG_PHONE ?? ""
+    },
+    mcp: [],
+    privacy: "owner-only",
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    sleepFrom: Number(e.GIRL_AGENT_SLEEP_FROM ?? 23),
+    sleepTo: Number(e.GIRL_AGENT_SLEEP_TO ?? 8),
+    nightWakeChance: Number(e.GIRL_AGENT_NIGHT_WAKE ?? 0.05),
+    communication: commPreset.profile,
+    vibe: commPreset.profile.messageStyle === "one-liners" ? "short" : "warm",
+    busySchedule: []
+  };
+}
+async function loadConfigFile(file) {
+  const abs = path5.isAbsolute(file) ? file : path5.join(process.cwd(), file);
+  let raw;
+  try {
+    raw = await fs4.readFile(abs, "utf-8");
+  } catch (e) {
+    process.stderr.write(`[server] \u043D\u0435 \u043C\u043E\u0433\u0443 \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u0442\u044C ${abs}: ${e?.message ?? e}
+`);
+    process.exit(1);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (e) {
+    process.stderr.write(`[server] ${abs} \u043D\u0435 \u044F\u0432\u043B\u044F\u0435\u0442\u0441\u044F \u0432\u0430\u043B\u0438\u0434\u043D\u044B\u043C JSON: ${e?.message ?? e}
+`);
+    process.exit(1);
+  }
+  return validateConfig(parsed);
+}
+function validateConfig(raw) {
+  const c = raw;
+  const errs = [];
+  if (!c.name) errs.push("name");
+  if (!c.age || c.age < 14 || c.age > 99) errs.push("age (14..99)");
+  if (!c.nationality || c.nationality !== "RU" && c.nationality !== "UA") errs.push("nationality (RU|UA)");
+  if (!c.tz) errs.push("tz");
+  if (!c.mode || c.mode !== "bot" && c.mode !== "userbot") errs.push("mode (bot|userbot)");
+  if (!c.stage) errs.push("stage");
+  if (!c.llm?.presetId) errs.push("llm.presetId");
+  if (!c.llm?.model) errs.push("llm.model");
+  if (errs.length) {
+    process.stderr.write(`[server] \u043A\u043E\u043D\u0444\u0438\u0433 \u043D\u0435\u0432\u0430\u043B\u0438\u0434\u0435\u043D, \u043D\u0435\u0434\u043E\u0441\u0442\u0430\u044E\u0449\u0438\u0435 \u043F\u043E\u043B\u044F:
+  - ${errs.join("\n  - ")}
+`);
+    process.stderr.write(`[server] \u0441\u043C. \u0448\u0430\u0431\u043B\u043E\u043D: girl-agent server --print-config
+`);
+    process.exit(1);
+  }
+  const filled = {
+    slug: c.slug || slugify(c.name),
+    name: c.name,
+    age: c.age,
+    nationality: c.nationality,
+    tz: c.tz,
+    mode: c.mode,
+    stage: c.stage,
+    llm: {
+      presetId: c.llm.presetId,
+      proto: c.llm.proto ?? findPreset(c.llm.presetId)?.proto ?? "openai",
+      baseURL: c.llm.baseURL ?? findPreset(c.llm.presetId)?.baseURL,
+      apiKey: c.llm.apiKey ?? "",
+      model: c.llm.model
+    },
+    telegram: c.telegram ?? {},
+    mcp: c.mcp ?? [],
+    privacy: c.privacy ?? "owner-only",
+    createdAt: c.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    sleepFrom: c.sleepFrom ?? 23,
+    sleepTo: c.sleepTo ?? 8,
+    nightWakeChance: c.nightWakeChance ?? 0.05,
+    communication: c.communication ?? COMMUNICATION_PRESETS[0].profile,
+    vibe: c.vibe,
+    personaNotes: c.personaNotes,
+    busySchedule: c.busySchedule ?? []
+  };
+  return filled;
+}
+function buildConfigTemplate() {
+  const sample = {
+    slug: "anya",
+    name: "\u0410\u043D\u044F",
+    age: 22,
+    nationality: "RU",
+    tz: "Europe/Moscow",
+    mode: "bot",
+    stage: "tg-given-cold",
+    llm: {
+      presetId: "claudehub",
+      proto: "anthropic",
+      baseURL: "https://api.claudehub.fun",
+      apiKey: "REPLACE_ME",
+      model: "claude-sonnet-4.6"
+    },
+    telegram: { botToken: "REPLACE_ME" },
+    mcp: [],
+    privacy: "owner-only",
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    sleepFrom: 23,
+    sleepTo: 8,
+    nightWakeChance: 0.05,
+    communication: COMMUNICATION_PRESETS[0].profile,
+    vibe: "warm",
+    busySchedule: []
+  };
+  return JSON.stringify(sample, null, 2) + "\n";
+}
+function buildSystemdUnit() {
+  const home = os.homedir();
+  return `# /etc/systemd/system/girl-agent.service
+# install: sudo cp this.service /etc/systemd/system/girl-agent.service
+#          sudo systemctl daemon-reload
+#          sudo systemctl enable --now girl-agent
+
+[Unit]
+Description=girl-agent (Telegram AI girl)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=%i
+WorkingDirectory=${home}
+ExecStart=${home}/.local/bin/girl-agent server --config ${home}/.config/girl-agent/bot.json --headless
+Restart=on-failure
+RestartSec=10
+StandardOutput=journal
+StandardError=journal
+Environment=NODE_ENV=production
+# uncomment for env-driven setup:
+# Environment=GIRL_AGENT_MODE=bot
+# Environment=GIRL_AGENT_TOKEN=...
+# Environment=GIRL_AGENT_API_PRESET=claudehub
+# Environment=GIRL_AGENT_API_KEY=...
+
+[Install]
+WantedBy=multi-user.target
+`;
+}
+function buildDockerArtifacts() {
+  return `# === \u043E\u0434\u043D\u043E\u0439 \u043A\u043E\u043C\u0430\u043D\u0434\u043E\u0439 ===
+docker run -it --rm \\
+  -v girl-agent-data:/data \\
+  -e GIRL_AGENT_DATA=/data \\
+  ghcr.io/thesashadev/girl-agent:latest
+
+# === headless \u0441 \u0433\u043E\u0442\u043E\u0432\u044B\u043C \u043A\u043E\u043D\u0444\u0438\u0433\u043E\u043C ===
+docker run -d --name girl-agent --restart=unless-stopped \\
+  -v girl-agent-data:/data \\
+  -v "$PWD/bot.json:/config/bot.json:ro" \\
+  -e GIRL_AGENT_DATA=/data \\
+  ghcr.io/thesashadev/girl-agent:latest \\
+  server --config /config/bot.json --headless
+
+# === \u0442\u043E\u043B\u044C\u043A\u043E env vars (\u0431\u0435\u0437 \u0444\u0430\u0439\u043B\u0430) ===
+docker run -d --name girl-agent --restart=unless-stopped \\
+  -v girl-agent-data:/data \\
+  -e GIRL_AGENT_DATA=/data \\
+  -e GIRL_AGENT_MODE=bot \\
+  -e GIRL_AGENT_TOKEN=... \\
+  -e GIRL_AGENT_API_PRESET=claudehub \\
+  -e GIRL_AGENT_API_KEY=... \\
+  -e GIRL_AGENT_NAME='\u0410\u043D\u044F' \\
+  -e GIRL_AGENT_AGE=22 \\
+  ghcr.io/thesashadev/girl-agent:latest \\
+  server --headless
+
+# === docker-compose.yml ===
+# version: "3.9"
+# services:
+#   girl-agent:
+#     image: ghcr.io/thesashadev/girl-agent:latest
+#     command: ["server", "--config", "/config/bot.json", "--headless"]
+#     environment:
+#       GIRL_AGENT_DATA: /data
+#     volumes:
+#       - girl-agent-data:/data
+#       - ./bot.json:/config/bot.json:ro
+#     restart: unless-stopped
+# volumes:
+#   girl-agent-data:
+`;
+}
+
 // src/cli.tsx
 var HELP = `
 girl-agent \u2014 AI girl for Telegram
@@ -5741,6 +6280,14 @@ usage:
   npx girl-agent --reset --profile=<slug>
   npx girl-agent <flags>               # \u043F\u0440\u043E\u043F\u0443\u0441\u0442\u0438\u0442\u044C \u0432\u0438\u0437\u0430\u0440\u0434 \u0441 \u0430\u0440\u0433\u0443\u043C\u0435\u043D\u0442\u0430\u043C\u0438
 
+server (\u0434\u043B\u044F \u0441\u0438\u0441\u0442\u0435\u043C \u0431\u0435\u0437 TTY: docker / systemd / cron / CI):
+  npx girl-agent server --print-config > bot.json
+  npx girl-agent server --config bot.json --headless
+  npx girl-agent server --print-systemd | --print-docker | --list
+
+\u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043A\u0430 \u043E\u0434\u043D\u043E\u0439 \u043A\u043E\u043C\u0430\u043D\u0434\u043E\u0439 (\u0431\u0435\u0437 node \u043D\u0430 \u043C\u0430\u0448\u0438\u043D\u0435):
+  curl -fsSL https://raw.githubusercontent.com/TheSashaDev/girl-agent/main/scripts/install.sh | sh
+
 required flags \u0434\u043B\u044F headless setup (--name --age --stage --api-preset --mode; --api-key \u043D\u0443\u0436\u0435\u043D \u0442\u043E\u043B\u044C\u043A\u043E \u0434\u043B\u044F \u043F\u0440\u043E\u0432\u0430\u0439\u0434\u0435\u0440\u043E\u0432 \u0441 \u0430\u0432\u0442\u043E\u0440\u0438\u0437\u0430\u0446\u0438\u0435\u0439):
   --profile=<slug>            slug \u043F\u0440\u043E\u0444\u0438\u043B\u044F
   --mode=bot|userbot
@@ -5796,15 +6343,71 @@ async function main() {
       "message-style",
       "initiative",
       "life-sharing",
-      "privacy"
+      "privacy",
+      "config"
+    ],
+    boolean: [
+      "help",
+      "list",
+      "reset",
+      "new",
+      "json-events",
+      "headless",
+      "server",
+      "print-config",
+      "print-systemd",
+      "print-docker",
+      "no-start"
     ],
-    boolean: ["help", "list", "reset", "new"],
     alias: { h: "help" }
   });
+  const positional = argv._ ?? [];
+  const isServer = positional[0] === "server" || !!argv.server || !!argv["print-config"] || !!argv["print-systemd"] || !!argv["print-docker"];
+  if (isServer) {
+    await runServer(argv);
+    return;
+  }
   if (argv.help) {
     process.stdout.write(HELP);
     return;
   }
+  const isHeadless = !!(argv["json-events"] || argv.headless || argv.list || argv.help);
+  if (!isHeadless) {
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    const stdinOk = !!stdin.isTTY;
+    const stdoutOk = !!stdout.isTTY;
+    if (!stdinOk || !stdoutOk) {
+      process.stderr.write(
+        `
+[girl-agent] \u044D\u0442\u043E\u0442 \u0442\u0435\u0440\u043C\u0438\u043D\u0430\u043B \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442 \u0438\u043D\u0442\u0435\u0440\u0430\u043A\u0442\u0438\u0432\u043D\u044B\u0439 ink-\u0432\u0438\u0437\u0430\u0440\u0434 (\u043D\u0435\u0442 TTY).
+  stdin.isTTY = ${stdinOk}, stdout.isTTY = ${stdoutOk}
+
+\u0447\u0442\u043E \u0434\u0435\u043B\u0430\u0442\u044C (\u0434\u043B\u044F \u0441\u0435\u0440\u0432\u0435\u0440\u043E\u0432 / docker / ssh \u0431\u0435\u0437 -t / cron / CI):
+
+  1. \u043F\u043E\u0441\u0442\u0430\u0432\u044C \u0441\u0435\u0431\u0435 girl-agent \u043E\u0434\u043D\u043E\u0439 \u043A\u043E\u043C\u0430\u043D\u0434\u043E\u0439 (\u0431\u0435\u0437 node \u043D\u0430 \u043C\u0430\u0448\u0438\u043D\u0435):
+       curl -fsSL https://raw.githubusercontent.com/TheSashaDev/girl-agent/main/scripts/install.sh | sh
+     \u0434\u0430\u043B\u044C\u0448\u0435:    girl-agent          # ink-\u0432\u0438\u0437\u0430\u0440\u0434 \u0432 \u043E\u0431\u044B\u0447\u043D\u043E\u043C tty
+
+  2. \u0433\u043E\u0442\u043E\u0432\u044B\u0439 \u043A\u043E\u043D\u0444\u0438\u0433 + headless (\u0434\u043B\u044F systemd / cron / CI):
+       girl-agent server --print-config > bot.json
+       # \u043E\u0442\u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u0443\u0439 bot.json
+       girl-agent server --config bot.json --headless
+
+  3. docker (\u0432\u0441\u0451 \u0432\u043D\u0443\u0442\u0440\u0438 \u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440\u0430, \u043D\u043E\u043B\u044C \u0437\u0430\u0432\u0438\u0441\u0438\u043C\u043E\u0441\u0442\u0435\u0439 \u043D\u0430 \u0445\u043E\u0441\u0442\u0435):
+       docker run -it --rm -v girl-agent-data:/data \\
+         ghcr.io/thesashadev/girl-agent:latest
+
+  4. systemd:  girl-agent server --print-systemd
+     docker:   girl-agent server --print-docker
+
+  5. \u043D\u0430 windows \u0431\u044B\u0441\u0442\u0440\u0435\u0435 \u0432\u0441\u0435\u0433\u043E \u2014 \u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043A\u0438\u0439 \u0438\u043D\u0441\u0442\u0430\u043B\u043B\u0435\u0440 girl-agent-installer.exe.
+`
+      );
+      process.exit(2);
+    }
+  }
+  const jsonEvents = !!(argv["json-events"] || argv.headless);
   if (argv.age != null) {
     const a = Number(argv.age);
     if (!Number.isFinite(a) || a < 13 || a > 99) {
@@ -5834,7 +6437,7 @@ ${profiles.join("\n")}
       cfg.stage = "tg-given-cold";
       await writeConfig(cfg);
     }
-    await runRuntime(cfg);
+    await runRuntime(cfg, { jsonEvents });
     return;
   }
   const presetForFlags = argv["api-preset"] ? findPreset(String(argv["api-preset"])) : void 0;
@@ -5850,7 +6453,7 @@ ${profiles.join("\n")}
     const generated = await generatePersonaPack(llm, cfg.slug, cfg.name, cfg.age, cfg.nationality, personaNotesForGeneration2(cfg));
     cfg.busySchedule = generated.busySchedule;
     await writeConfig(cfg);
-    await runRuntime(cfg);
+    await runRuntime(cfg, { jsonEvents });
     return;
   }
   if (!argv.new && !argv.profile && !haveEnoughForFlags) {
@@ -5860,7 +6463,7 @@ ${profiles.join("\n")}
       if (cfg) {
         process.stdout.write(`\u0437\u0430\u0433\u0440\u0443\u0436\u0430\u044E \u043F\u0440\u043E\u0444\u0438\u043B\u044C: ${cfg.name}
 `);
-        await runRuntime(cfg);
+        await runRuntime(cfg, { jsonEvents });
         return;
       }
     } else if (profiles.length > 1) {
@@ -5876,7 +6479,7 @@ ${profiles.join("\n")}
     const inst = render(
       /* @__PURE__ */ React3.createElement(Wizard, { onDone: async (cfg) => {
         inst.unmount();
-        await runRuntime(cfg);
+        await runRuntime(cfg, { jsonEvents });
         resolve();
       } }),
       { exitOnCtrlC: true }
@@ -5949,9 +6552,13 @@ function personaNotesForGeneration2(cfg) {
   ].filter(Boolean);
   return parts.join("\n\n");
 }
-async function runRuntime(cfg) {
+async function runRuntime(cfg, opts = {}) {
   const rt = new Runtime(cfg);
   await rt.start();
+  if (opts.jsonEvents) {
+    await runHeadlessJsonEvents(rt);
+    return;
+  }
   const inst = render(/* @__PURE__ */ React3.createElement(Dashboard, { runtime: rt }), { exitOnCtrlC: true });
   process.on("SIGINT", async () => {
     await rt.stop();
@@ -5961,7 +6568,17 @@ async function runRuntime(cfg) {
   await inst.waitUntilExit();
   await rt.stop();
 }
+process.on("unhandledRejection", (reason) => {
+  const r = reason;
+  const text = typeof r === "object" && r && r.stack ? r.stack : String(reason);
+  process.stderr.write("[girl-agent] unhandled rejection: " + text + "\n");
+  process.exit(1);
+});
+process.on("uncaughtException", (err) => {
+  process.stderr.write("[girl-agent] uncaught: " + (err?.stack ?? err) + "\n");
+  process.exit(1);
+});
 main().catch((e) => {
-  process.stderr.write("fatal: " + (e?.stack ?? e) + "\n");
+  process.stderr.write("[girl-agent] fatal: " + (e?.stack ?? e) + "\n");
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thesashadev/girl-agent",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Telegram AI persona engine with memory, schedule, relationship state and MTProto userbot mode.",
   "type": "module",
   "bin": {