@thesashadev/girl-agent 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # 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
+
+- 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
 
 Дата: 2026-05-06

package/README.md

@@ -1,4 +1,4 @@
-![girl-agent banner](https://girl-agent.com/og-image.png)
+![girl-agent banner](https://girl-agent.com/og-image.png)
 
 [website]: https://girl-agent.com
 [docs]: https://docs.girl-agent.com
@@ -10,6 +10,8 @@
 Со всеми проблемами и багами пишите в Issues.
 ТГ создателя - @voided_net
 
+Тг канал: https://t.me/GirlAgentAI/
+Тг сообщество: https://t.me/GirlAgentAI_chat/
 ---
 
 ## Содержание
@@ -35,20 +37,98 @@
 
 ## Быстрый старт
 
-**Через 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 (для серверов; нулевые зависимости на хосте)
+
+Интерактивная первичная настройка (ink-визард внутри контейнера):
+```sh
+docker run -it --rm -v girl-agent-data:/data ghcr.io/thesashadev/girl-agent:latest
+```
+
+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
+```
+
+Или совсем без файла, через 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
+```
+
+Готовые шаблоны:
+- `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) в корне репо
+
 **Из исходников:**
 
 ```powershell

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) {
@@ -377,8 +386,10 @@ var LLM_PRESETS = [
     proto: "openai",
     baseURL: "http://localhost:1234/v1",
     defaultModel: "",
+    defaultApiKey: "lm-studio",
+    apiKeyRequired: false,
     custom: true,
-    hint: "\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E, OpenAI-compatible endpoint"
+    hint: "\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E, OpenAI-compatible endpoint; \u043A\u043B\u044E\u0447 \u043D\u0435 \u043D\u0443\u0436\u0435\u043D"
   },
   {
     id: "ollama",
@@ -386,8 +397,10 @@ var LLM_PRESETS = [
     proto: "openai",
     baseURL: "http://localhost:11434/v1",
     defaultModel: "llama3.1",
+    defaultApiKey: "ollama",
+    apiKeyRequired: false,
     custom: true,
-    hint: "\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E \u0447\u0435\u0440\u0435\u0437 /v1"
+    hint: "\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E \u0447\u0435\u0440\u0435\u0437 /v1; \u043A\u043B\u044E\u0447 \u043D\u0435 \u043D\u0443\u0436\u0435\u043D"
   },
   {
     id: "anthropic",
@@ -796,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);
 }
@@ -1025,20 +1038,28 @@ var OpenAILike = class {
   constructor(cfg) {
     this.cfg = cfg;
     this.client = new OpenAI({
-      apiKey: cfg.apiKey,
+      apiKey: openAIApiKey(cfg),
       baseURL: normalizeBaseURL(cfg.baseURL),
       timeout: LLM_TIMEOUT_MS,
       maxRetries: LLM_MAX_RETRIES
     });
+    this.fetchClient = new OpenAI({
+      apiKey: openAIApiKey(cfg),
+      baseURL: normalizeBaseURL(cfg.baseURL),
+      timeout: LLM_TIMEOUT_MS,
+      maxRetries: LLM_MAX_RETRIES,
+      fetch: compatibleFetch
+    });
   }
   cfg;
   client;
+  fetchClient;
   async chat(messages, opts = {}) {
     const params = {
       model: this.cfg.model,
       messages: openAIMessages(messages),
       temperature: opts.temperature ?? 0.85,
-      response_format: opts.json ? { type: "json_object" } : void 0
+      response_format: openAIResponseFormat(opts)
     };
     if (usesMaxCompletionTokens(this.cfg.model)) {
       params.max_completion_tokens = opts.maxTokens ?? 600;
@@ -1049,19 +1070,86 @@ var OpenAILike = class {
     return res.choices[0]?.message?.content?.trim() ?? "";
   }
   async createWithCompatibilityFallback(params) {
-    try {
-      return await this.client.chat.completions.create(params);
-    } catch (error) {
-      const fallback = completionTokenFallback(params, error);
-      if (!fallback) throw enrichOpenAIError(error, this.cfg.baseURL);
+    const attempted = /* @__PURE__ */ new Set();
+    let current = params;
+    let lastError;
+    while (current) {
+      const key = completionParamsKey(current);
+      if (attempted.has(key)) break;
+      attempted.add(key);
+      try {
+        return await this.client.chat.completions.create(current);
+      } catch (error) {
+        lastError = error;
+        const next = completionFallback(current, error);
+        if (!next) break;
+        current = next;
+      }
+    }
+    if (this.cfg.baseURL) {
       try {
-        return await this.client.chat.completions.create(fallback);
-      } catch (fallbackError) {
-        throw enrichOpenAIError(fallbackError, this.cfg.baseURL);
+        return await this.fetchClient.chat.completions.create({ ...params, stream: false });
+      } catch (fetchError) {
+        lastError = fetchError;
       }
     }
+    throw enrichOpenAIError(lastError, this.cfg.baseURL);
   }
 };
+async function compatibleFetch(url, init) {
+  const res = await fetch(url, init);
+  const contentType = res.headers.get("content-type") ?? "";
+  if (!res.ok) return res;
+  const text = await res.clone().text();
+  if (contentType.includes("text/event-stream") || text.trimStart().startsWith("data:")) {
+    return completionStreamToJsonResponse(res, text);
+  }
+  return res;
+}
+function completionStreamToJsonResponse(res, text) {
+  const completion = parseOpenAIEventStream(text);
+  return new Response(JSON.stringify(completion), {
+    status: res.status,
+    statusText: res.statusText,
+    headers: { "content-type": "application/json" }
+  });
+}
+function parseOpenAIEventStream(raw) {
+  let id = "chatcmpl-stream";
+  let model = "";
+  let created = Math.floor(Date.now() / 1e3);
+  const content = [];
+  let finishReason = "stop";
+  for (const line of raw.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("data:")) continue;
+    const data = trimmed.slice(5).trim();
+    if (!data || data === "[DONE]") continue;
+    try {
+      const chunk = JSON.parse(data);
+      id = chunk.id || id;
+      model = chunk.model || model;
+      created = chunk.created || created;
+      const choice = chunk.choices[0];
+      finishReason = choice?.finish_reason ?? finishReason;
+      const delta = choice?.delta?.content ?? choice?.message?.content;
+      if (typeof delta === "string") content.push(delta);
+    } catch {
+    }
+  }
+  return {
+    id,
+    object: "chat.completion",
+    created,
+    model,
+    choices: [{
+      index: 0,
+      message: { role: "assistant", content: content.join(""), refusal: null },
+      finish_reason: finishReason,
+      logprobs: null
+    }]
+  };
+}
 var AnthropicLike = class {
   constructor(cfg) {
     this.cfg = cfg;
@@ -1155,8 +1243,36 @@ function normalizeBaseURL(value) {
 function usesMaxCompletionTokens(model) {
   return /^(?:o\d|o\d-|o\d\b|gpt-5|gpt-5\.|gpt-[5-9])|\/(?:o\d|gpt-5|gpt-[5-9])/.test(model.trim().toLowerCase());
 }
+function openAIApiKey(cfg) {
+  return cfg.apiKey.trim() || (cfg.presetId === "ollama" ? "ollama" : cfg.presetId === "lmstudio" ? "lm-studio" : "");
+}
+function openAIResponseFormat(opts) {
+  if (!opts.json) return void 0;
+  if (opts.jsonSchema) return { type: "json_schema", json_schema: opts.jsonSchema };
+  return {
+    type: "json_schema",
+    json_schema: {
+      name: "json_response",
+      strict: false,
+      schema: { type: "object", additionalProperties: true }
+    }
+  };
+}
+function completionFallback(params, error) {
+  return responseFormatFallback(params, error) ?? completionTokenFallback(params, error);
+}
+function responseFormatFallback(params, error) {
+  const message = openAIErrorText(error);
+  if (!params.response_format || !message.includes("response_format")) return null;
+  if (params.response_format.type === "json_schema" && message.includes("json_object")) {
+    return { ...params, response_format: { type: "text" } };
+  }
+  if (params.response_format.type === "json_schema") return { ...params, response_format: { type: "json_object" } };
+  if (params.response_format.type === "json_object") return { ...params, response_format: { type: "text" } };
+  return null;
+}
 function completionTokenFallback(params, error) {
-  const message = errorMessage(error).toLowerCase();
+  const message = openAIErrorText(error);
   if (params.max_tokens != null && message.includes("max_tokens") && message.includes("max_completion_tokens")) {
     const { max_tokens, ...rest } = params;
     return { ...rest, max_completion_tokens: max_tokens };
@@ -1167,6 +1283,16 @@ function completionTokenFallback(params, error) {
   }
   return null;
 }
+function completionParamsKey(params) {
+  const tokenKey = params.max_completion_tokens != null ? "max_completion_tokens" : "max_tokens";
+  return `${params.response_format?.type ?? "default"}:${tokenKey}`;
+}
+function openAIErrorText(error) {
+  if (error instanceof OpenAI.APIError) {
+    return `${error.status ?? ""} ${error.code ?? ""} ${error.type ?? ""} ${error.message}`.toLowerCase();
+  }
+  return errorMessage(error).toLowerCase();
+}
 function enrichOpenAIError(error, baseURL) {
   if (error instanceof OpenAI.APIConnectionError) {
     return new Error(connectionErrorMessage("OpenAI-compatible", baseURL, error));
@@ -1202,6 +1328,40 @@ function makeLLM(cfg) {
 init_esm_shims();
 var SYS = `\u0422\u044B \u2014 \u0440\u0435\u0436\u0438\u0441\u0441\u0451\u0440 \u043F\u0435\u0440\u0441\u043E\u043D\u0430\u0436\u0435\u0439. \u0422\u0432\u043E\u044F \u0437\u0430\u0434\u0430\u0447\u0430 \u2014 \u0441\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0434\u043E\u0441\u0442\u043E\u0432\u0435\u0440\u043D\u044B\u0439, \u043D\u0435-\u0433\u043E\u043B\u043B\u0438\u0432\u0443\u0434\u0441\u043A\u0438\u0439, \u043D\u0435-\u0441\u043B\u0430\u0434\u043A\u0438\u0439, \u043D\u0435-AI-\u043F\u043E\u043C\u043E\u0449\u043D\u0438\u043A\u043E\u0432\u044B\u0439 \u043F\u0440\u043E\u0444\u0438\u043B\u044C \u043E\u0431\u044B\u0447\u043D\u043E\u0439 \u0440\u0443\u0441\u0441\u043A\u043E\u044F\u0437\u044B\u0447\u043D\u043E\u0439 \u0434\u0435\u0432\u0443\u0448\u043A\u0438 \u0443\u043A\u0430\u0437\u0430\u043D\u043D\u043E\u0433\u043E \u0432\u043E\u0437\u0440\u0430\u0441\u0442\u0430. \u0411\u0435\u0437 \u043F\u0440\u0438\u0443\u043A\u0440\u0430\u0448\u0438\u0432\u0430\u043D\u0438\u0439, \u0431\u0435\u0437 \u043F\u043E\u0437\u0438\u0442\u0438\u0432\u043D\u043E\u0433\u043E \u043C\u043E\u0440\u0430\u043B\u044C\u043D\u043E\u0433\u043E \u0443\u043A\u043B\u043E\u043D\u0430, \u0431\u0435\u0437 \xAB\u0443\u0434\u043E\u0431\u043D\u043E\u0439\xBB \u043F\u0435\u0440\u0441\u043E\u043D\u044B. \u0414\u043E\u043F\u0443\u0441\u0442\u0438\u043C\u044B \u043D\u0435\u0434\u043E\u0441\u0442\u0430\u0442\u043A\u0438, \u0443\u0437\u043A\u0438\u0435 \u0438\u043D\u0442\u0435\u0440\u0435\u0441\u044B, \u0441\u043A\u0435\u043F\u0441\u0438\u0441, \u0442\u043E\u043A\u0441\u0438\u0447\u043D\u043E\u0441\u0442\u044C, \u043B\u0435\u043D\u044C, \u0442\u0440\u0435\u0432\u043E\u0436\u043D\u043E\u0441\u0442\u044C, \u043D\u0435\u0443\u0432\u0435\u0440\u0435\u043D\u043D\u043E\u0441\u0442\u044C \u2014 \u0447\u0442\u043E \u043F\u043E\u0434\u0445\u043E\u0434\u0438\u0442 \u0432\u043E\u0437\u0440\u0430\u0441\u0442\u0443. \u041D\u0438\u043A\u0430\u043A\u0438\u0445 \xAB\u043A\u043E\u0443\u0447\u0438\u043D\u0433\u043E\u0432\u044B\u0445\xBB \u0444\u043E\u0440\u043C\u0443\u043B\u0438\u0440\u043E\u0432\u043E\u043A. \u0422\u043E\u043B\u044C\u043A\u043E \u0436\u0438\u0432\u0430\u044F \u0440\u0435\u0447\u044C, \u043A\u0430\u043A \u0438\u0437 \u0434\u043D\u0435\u0432\u043D\u0438\u043A\u0430 \u0438\u043B\u0438 \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0435\u0433\u043E \u043C\u043E\u043D\u043E\u043B\u043E\u0433\u0430. \u0412\u043E\u0437\u0440\u0430\u0441\u0442: {{age}} \u043B\u0435\u0442, \u0438\u043C\u044F: {{name}}.`;
 var WEEKDAYS = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+var BUSY_SCHEDULE_SCHEMA = {
+  name: "busy_schedule",
+  strict: false,
+  schema: {
+    type: "object",
+    properties: {
+      busySchedule: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            label: { type: "string" },
+            days: {
+              type: "array",
+              items: { type: "string", enum: WEEKDAYS }
+            },
+            from: { type: "string" },
+            to: { type: "string" },
+            checkAfterMin: {
+              type: "array",
+              items: { type: "number" },
+              minItems: 2,
+              maxItems: 2
+            }
+          },
+          required: ["label", "from", "to"],
+          additionalProperties: false
+        }
+      }
+    },
+    required: ["busySchedule"],
+    additionalProperties: false
+  }
+};
 async function generatePersonaPack(llm, slug, name, age, nationality = "RU", personaNotes = "", onProgress) {
   const country = nationality === "UA" ? "\u0423\u043A\u0440\u0430\u0438\u043D\u0430" : "\u0420\u043E\u0441\u0441\u0438\u044F / \u0421\u041D\u0413";
   const langHint = nationality === "UA" ? "\u041F\u0438\u0448\u0435\u0442 \u043D\u0430 \u0420\u0423\u0421\u0421\u041A\u041E\u041C (\u043A\u0430\u043A \u0440\u0435\u0430\u043B\u044C\u043D\u043E \u043F\u0438\u0448\u0435\u0442 \u0431\u043E\u043B\u044C\u0448\u0438\u043D\u0441\u0442\u0432\u043E \u0434\u0435\u0432\u0443\u0448\u0435\u043A \u0432 \u0423\u043A\u0440\u0430\u0438\u043D\u0435 \u0432 \u0442\u0433). \u0414\u043E\u043F\u0443\u0441\u0442\u0438\u043C \u043B\u0451\u0433\u043A\u0438\u0439 \u0441\u0443\u0440\u0436\u0438\u043A: ~90% \u0440\u0443\u0441\u0441\u043A\u0438\u0439 + ~10% \u0443\u043A\u0440\u0430\u0438\u043D\u0441\u043A\u0438\u0445 \u0432\u0441\u0442\u0430\u0432\u043E\u043A (\u043E\u0442\u0434\u0435\u043B\u044C\u043D\u044B\u0435 \u0441\u043B\u043E\u0432\u0430: '\u0448\u043E', '\u043C\u0430\u0431\u0443\u0442\u044C', '\u0442\u0440\u043E\u0445\u0438', '\u044F\u043A', '\u043D\u0443 \u0448\u043E', '\u0442\u0430 \u0439\u0434\u0438', '\u0434\u044F\u043A\u0443\u044E'), \u043D\u043E \u0431\u0435\u0437 \u043F\u043E\u043B\u043D\u043E\u0433\u043E \u043F\u0435\u0440\u0435\u0445\u043E\u0434\u0430 \u043D\u0430 \u0443\u043A\u0440\u0430\u0438\u043D\u0441\u043A\u0438\u0439. \u0427\u0438\u0441\u0442\u043E-\u0443\u043A\u0440\u0430\u0438\u043D\u0441\u043A\u0438\u0439 \u0442\u0435\u043A\u0441\u0442 \u041D\u0415 \u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0439 \u2014 \u044D\u0442\u043E \u043D\u0435\u0440\u0435\u0430\u043B\u0438\u0441\u0442\u0438\u0447\u043D\u043E \u0434\u043B\u044F \u0442\u0433-\u043F\u0435\u0440\u0435\u043F\u0438\u0441\u043A\u0438." : "\u0420\u0443\u0441\u0441\u043A\u043E\u044F\u0437\u044B\u0447\u043D\u0430\u044F \u0431\u0435\u0437 \u0443\u043A\u0440\u0430\u0438\u043D\u0438\u0437\u043C\u043E\u0432.";
@@ -1312,7 +1472,7 @@ ${personaNotes.trim()}
   onProgress?.(65, "\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u043C communication.md\u2026");
   const boundaries = await llm.chat([{ role: "system", content: sys }, { role: "user", content: boundariesPrompt }], { temperature: 0.9, maxTokens: 3500 });
   onProgress?.(85, "\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u043C busy schedule\u2026");
-  const routineRaw = await llm.chat([{ role: "system", content: sys }, { role: "user", content: routinePrompt }], { temperature: 0.85, maxTokens: 3500, json: true });
+  const routineRaw = await llm.chat([{ role: "system", content: sys }, { role: "user", content: routinePrompt }], { temperature: 0.85, maxTokens: 3500, json: true, jsonSchema: BUSY_SCHEDULE_SCHEMA });
   const busySchedule = parseBusySchedule(routineRaw, name, age);
   await writeMd(slug, "persona.md", persona);
   await writeMd(slug, "speech.md", speech);
@@ -1383,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) {
@@ -1866,6 +2026,7 @@ function Wizard({ initial, onDone }) {
           setLlmProto(preset.proto);
           setLlmBaseURL(preset.baseURL ?? "");
           setLlmModel(preset.defaultModel);
+          setLlmKey(preset.defaultApiKey ?? "");
           if (preset.custom) setStep("api-base");
           else setStep("api-model");
         }
@@ -1893,7 +2054,9 @@ function Wizard({ initial, onDone }) {
     return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column", padding: 1 }, /* @__PURE__ */ React.createElement(Header, { sub: "\u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435 \u043C\u043E\u0434\u0435\u043B\u0438" }), /* @__PURE__ */ React.createElement(Bar, { step: 2, total: 9 }), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, null, "Model: "), /* @__PURE__ */ React.createElement(TextInput, { value: llmModel, onChange: setLlmModel, onSubmit: () => setStep("api-key") })));
   }
   if (step === "api-key") {
-    return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column", padding: 1 }, /* @__PURE__ */ React.createElement(Header, { sub: "API \u043A\u043B\u044E\u0447" }), /* @__PURE__ */ React.createElement(Bar, { step: 2, total: 11 }), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, null, "Key: "), /* @__PURE__ */ React.createElement(TextInput, { value: llmKey, onChange: setLlmKey, mask: "\u2022", onSubmit: () => llmKey && setStep("nationality") })));
+    const preset = findPreset(llmPresetId);
+    const apiKeyRequired = preset?.apiKeyRequired !== false;
+    return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column", padding: 1 }, /* @__PURE__ */ React.createElement(Header, { sub: apiKeyRequired ? "API \u043A\u043B\u044E\u0447" : "API \u043A\u043B\u044E\u0447 (\u043C\u043E\u0436\u043D\u043E \u043F\u0440\u043E\u043F\u0443\u0441\u0442\u0438\u0442\u044C)" }), /* @__PURE__ */ React.createElement(Bar, { step: 2, total: 11 }), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, null, "Key: "), /* @__PURE__ */ React.createElement(TextInput, { value: llmKey, onChange: setLlmKey, mask: "\u2022", onSubmit: () => (llmKey || !apiKeyRequired) && setStep("nationality") })), !apiKeyRequired && /* @__PURE__ */ React.createElement(Text, { dimColor: true }, "\u0414\u043B\u044F \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u0433\u043E API \u0431\u0443\u0434\u0435\u0442 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u043D \u0442\u0435\u0445\u043D\u0438\u0447\u0435\u0441\u043A\u0438\u0439 placeholder, \u0435\u0441\u043B\u0438 \u043E\u0441\u0442\u0430\u0432\u0438\u0442\u044C \u043F\u0443\u0441\u0442\u043E."));
   }
   if (step === "nationality") {
     return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column", padding: 1 }, /* @__PURE__ */ React.createElement(Header, { sub: "\u043D\u0430\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u043E\u0441\u0442\u044C (\u044F\u0437\u044B\u043A, \u0438\u043C\u044F, \u043A\u0443\u043B\u044C\u0442\u0443\u0440\u0430)" }), /* @__PURE__ */ React.createElement(Bar, { step: 3, total: 11 }), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(
@@ -2939,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);
@@ -2972,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)}-->
 `);
@@ -3202,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) {
@@ -5576,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
@@ -5587,7 +6280,15 @@ 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
 
-required flags \u0434\u043B\u044F headless setup (--name --age --stage --api-preset --api-key --mode):
+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
   --token=<bot_token>         \u0434\u043B\u044F bot
@@ -5596,7 +6297,7 @@ required flags \u0434\u043B\u044F headless setup (--name --age --stage --api-pre
   --base-url=<url>            \u0434\u043B\u044F custom
   --proto=openai|anthropic    \u0434\u043B\u044F custom
   --model=<model>
-  --api-key=<key>
+  --api-key=<key>             \u043D\u0435 \u043D\u0443\u0436\u0435\u043D \u0434\u043B\u044F \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0445 LM Studio/Ollama
   --name=<\u0438\u043C\u044F>                \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u0435 \u0438\u043C\u044F; \u0435\u0441\u043B\u0438 \u043F\u0440\u043E\u043F\u0443\u0441\u0442\u0438\u0442\u044C \u2014 \u0441\u043B\u0443\u0447\u0430\u0439\u043D\u043E\u0435 \u0438\u0437 \u043F\u0443\u043B\u0430 \u043F\u043E nationality (\u0442\u0443\u0440\u043D\u0438\u0440 \u0432\u044B\u0431\u043E\u0440\u0430 \u0438\u043C\u0451\u043D \u0434\u043E\u0441\u0442\u0443\u043F\u0435\u043D \u0422\u041E\u041B\u042C\u041A\u041E \u0432 TUI \u0432\u0438\u0437\u0430\u0440\u0434\u0435)
   --age=<n>
   --persona-notes=<text>      \u0434\u043E\u043F. \u043F\u043E\u0436\u0435\u043B\u0430\u043D\u0438\u044F \u043A persona/speech/communication \u043F\u0435\u0440\u0435\u0434 \u0433\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u0435\u0439
@@ -5642,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) {
@@ -5680,10 +6437,12 @@ ${profiles.join("\n")}
       cfg.stage = "tg-given-cold";
       await writeConfig(cfg);
     }
-    await runRuntime(cfg);
+    await runRuntime(cfg, { jsonEvents });
     return;
   }
-  const haveEnoughForFlags = argv.mode && argv["api-preset"] && argv["api-key"] && argv.age && argv.stage;
+  const presetForFlags = argv["api-preset"] ? findPreset(String(argv["api-preset"])) : void 0;
+  const apiKeyRequiredForFlags = presetForFlags?.apiKeyRequired !== false;
+  const haveEnoughForFlags = argv.mode && argv["api-preset"] && (!apiKeyRequiredForFlags || argv["api-key"]) && argv.age && argv.stage;
   if (haveEnoughForFlags) {
     const cfg = await buildConfigFromFlags(argv);
     await writeConfig(cfg);
@@ -5694,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) {
@@ -5704,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) {
@@ -5720,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 }
@@ -5755,7 +6514,7 @@ async function buildConfigFromFlags(argv) {
     tz,
     mode,
     stage: argv.stage,
-    llm: { presetId, proto, baseURL, apiKey: String(argv["api-key"]), model },
+    llm: { presetId, proto, baseURL, apiKey: String(argv["api-key"] ?? preset?.defaultApiKey ?? ""), model },
     telegram: mode === "bot" ? { botToken: String(argv.token ?? "") } : {
       apiId: Number(argv["api-id"] ?? 0),
       apiHash: String(argv["api-hash"] ?? ""),
@@ -5793,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();
@@ -5805,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.7",
+  "version": "0.1.9",
   "description": "Telegram AI persona engine with memory, schedule, relationship state and MTProto userbot mode.",
   "type": "module",
   "bin": {