@thesashadev/girl-agent 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,27 +1,44 @@
-# Changelog
-
-## 0.1.3 — Telegram formatting fix
-
-Дата: 2026-05-05
-
-- Исправлено: включён `parse_mode: "MarkdownV2"` для отправки сообщений в Telegram (bot и userbot).
-- Теперь поддерживается форматирование спойлеров `||текст||` и другие MarkdownV2-стили.
-
-## 0.1.2 — communication realism update
-
-Дата: 2026-05-05
-
-- Hotfix: профили из wizard теперь сохраняются раньше, а список профилей больше не показывает недосохранённые папки без `config.json`.
-- Добавлены жизненные стили общения: **Нормальная**, **Милая**, **Альтушка**, **Залипала**, **Болтушка**.
-- Добавлен `CommunicationProfile` с настройками уведомлений, стиля сообщений, инициативы и life sharing.
-- Presence, reply timing, bubbles, ignore chance и proactive agenda теперь учитывают профиль общения.
-- Wizard и CLI получили настройку communication profile.
-- Runtime `:status` и `:debug` показывают профиль общения.
-- Команда `:log` стала удобнее и поддерживает выбор дня/лимита вывода.
-- Старый `vibe` автоматически нормализуется в новый формат.
-
-## 0.1.1 — stability baseline
-
-- Базовый публичный релиз с Telegram bot/userbot режимами.
-- Persona, speech, relationship state, memory, conflict и agenda-модули.
-- Документация по установке, конфигурации, реализм-модулям и troubleshooting.
+# Changelog
+
+## 0.1.5 — owner TG credentials proxy
+
+Дата: 2026-05-06
+
+- Добавлен TG auth proxy для пользователей без доступа к my.telegram.org (виртуальные номера, новые аккаунты, VPN с IP датацентра).
+- Новый шаг визарда: выбор между своими api_id/api_hash или использованием от владельца.
+- Весь процесс авторизации через MTProto идёт через прокси-сервер — креды владельца не отображаются.
+- Добавлен модуль `src/telegram/remote-auth.ts` — HTTP-клиент для прокси.
+- Proxy URL настраивается через `GIRL_AGENT_AUTH_PROXY` env var (по умолчанию `https://tgproxy.girl-agent.com`).
+
+## 0.1.4 — npm publish automation
+
+Дата: 2026-05-06
+
+- Добавлен GitHub Actions workflow для публикации пакета в npm по тегу `v*`.
+- Добавлено правило релиза: каждая публичная обнова должна менять версию в `package.json`/`package-lock.json` и добавлять запись в changelog.
+
+## 0.1.3 — Telegram formatting fix
+
+Дата: 2026-05-05
+
+- Исправлено: включён `parse_mode: "MarkdownV2"` для отправки сообщений в Telegram (bot и userbot).
+- Теперь поддерживается форматирование спойлеров `||текст||` и другие MarkdownV2-стили.
+
+## 0.1.2 — communication realism update
+
+Дата: 2026-05-05
+
+- Hotfix: профили из wizard теперь сохраняются раньше, а список профилей больше не показывает недосохранённые папки без `config.json`.
+- Добавлены жизненные стили общения: **Нормальная**, **Милая**, **Альтушка**, **Залипала**, **Болтушка**.
+- Добавлен `CommunicationProfile` с настройками уведомлений, стиля сообщений, инициативы и life sharing.
+- Presence, reply timing, bubbles, ignore chance и proactive agenda теперь учитывают профиль общения.
+- Wizard и CLI получили настройку communication profile.
+- Runtime `:status` и `:debug` показывают профиль общения.
+- Команда `:log` стала удобнее и поддерживает выбор дня/лимита вывода.
+- Старый `vibe` автоматически нормализуется в новый формат.
+
+## 0.1.1 — stability baseline
+
+- Базовый публичный релиз с Telegram bot/userbot режимами.
+- Persona, speech, relationship state, memory, conflict и agenda-модули.
+- Документация по установке, конфигурации, реализм-модулям и troubleshooting.

package/LICENSE

@@ -1,31 +1,31 @@
-girl-agent Source-Available Non-Commercial License
-
-Copyright (c) 2026 girl-agent contributors.
-All rights reserved except as expressly stated below.
-
-Permission is granted to view, download, clone, and run this software
-for personal, educational, evaluation, and non-commercial testing purposes.
-
-Permission is also granted to create forks and submit issues, pull requests,
-bug reports, patches, and improvement suggestions to the original repository.
-
-You may modify the software only for the purpose of personal testing,
-evaluation, or contributing improvements back to the original project.
-
-You may not, without prior written permission from the copyright holder:
-
-1. use this software or substantial portions of it for commercial purposes;
-2. sell, rent, sublicense, host, or provide this software as a paid service;
-3. publish or distribute a competing product or public clone based on this software;
-4. use this software in a commercial product, service, or company project;
-5. remove or alter copyright notices, attribution, or license terms;
-6. relicense this software under another license;
-7. use the project name, branding, logo, documentation, or assets in a way that suggests endorsement or ownership.
-
-Any contribution submitted to the original repository, including pull requests,
-patches, issues, ideas, documentation changes, or code suggestions, may be used,
-modified, and distributed by the project maintainers as part of this project.
-
-This license does not grant any trademark rights.
-
+girl-agent Source-Available Non-Commercial License
+
+Copyright (c) 2026 girl-agent contributors.
+All rights reserved except as expressly stated below.
+
+Permission is granted to view, download, clone, and run this software
+for personal, educational, evaluation, and non-commercial testing purposes.
+
+Permission is also granted to create forks and submit issues, pull requests,
+bug reports, patches, and improvement suggestions to the original repository.
+
+You may modify the software only for the purpose of personal testing,
+evaluation, or contributing improvements back to the original project.
+
+You may not, without prior written permission from the copyright holder:
+
+1. use this software or substantial portions of it for commercial purposes;
+2. sell, rent, sublicense, host, or provide this software as a paid service;
+3. publish or distribute a competing product or public clone based on this software;
+4. use this software in a commercial product, service, or company project;
+5. remove or alter copyright notices, attribution, or license terms;
+6. relicense this software under another license;
+7. use the project name, branding, logo, documentation, or assets in a way that suggests endorsement or ownership.
+
+Any contribution submitted to the original repository, including pull requests,
+patches, issues, ideas, documentation changes, or code suggestions, may be used,
+modified, and distributed by the project maintainers as part of this project.
+
+This license does not grant any trademark rights.
+
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -1,184 +1,184 @@
-![girl-agent banner](https://girl-agent.com/og-image.png)
-
-[website]: https://girl-agent.com
-[docs]: https://docs.girl-agent.com
-
-**[website]**  ·  **[docs]**
-
-
-Это только бета-версия. Со временем будет дорабатыватся.
-Со всеми проблемами и багами пишите в Issues.
-ТГ создателя - @voided_net
-
----
-
-## Содержание
-
-- [Быстрый старт](#быстрый-старт)
-- [Что под капотом](#что-под-капотом)
-- [Почему не просто GPTs или промпт](#почему-не-просто-gpts-или-промпт)
-- [Changelog](./CHANGELOG.md)
-- [Безопасность](#безопасность)
-- [Лицензия](#лицензия)
-
----
-
-## О проекте
-
-Она не отвечает на каждое сообщение. Иногда читает и молчит. Иногда ставит реакцию. Иногда отвечает через час, потому что была занята или просто не хотела.
-
-Это не баг. Так задумано.
-
-`girl-agent` — ИИ-девушка, которая ведёт себя в переписке как человек. Со сном, настроением, расписанием, памятью и характером. Без "конечно, я понимаю" и ChatGPT-повадок.
-
----
-
-## Быстрый старт
-
-**Через NPX (рекомендуется):**
-
-```powershell
-npx @thesashadev/girl-agent
-```
-
-Wizard задаст пару вопросов — имя, возраст, Telegram-подключение, LLM-ключ. Всё.
-
-Если профиль уже есть:
-
-```powershell
-npx @thesashadev/girl-agent --profile=arina
-```
-
-**Из исходников:**
-
-```powershell
-git clone https://github.com/TheSashaDev/girl-agent.git
-cd girl-agent
-npm install
-npm run dev
-```
-
----
-
-## Что под капотом
-
-Поведение собирается из нескольких слоёв, а не из одного промпта.
-
-- 📱 **Она не всегда онлайн** — паттерн присутствия зависит от персонажа: кто-то в телефоне круглые сутки, кто-то заходит раз в час, кто-то только вечером.
-- 😴 **Ночью спит** — можно разбудить через `:wake`, но без команды шанс ответа низкий.
-- 📅 **Расписание дня** — у каждого дня есть расписание: пары, работа, дорога, свободное время. Если она на занятиях, телефон может быть недоступен.
-- ❤️ **Отношения** — пять счётчиков: интерес, доверие, привлекательность, раздражение, неловкость. Меняются от каждого диалога. Высокое раздражение — чаще игнор и холод.
-- 📈 **Стадии сближения** — отношения проходят стадии: от "дала тг, но холодная" до "давно вместе". Стадия влияет на тепло, флирт, длину ответов.
-- ⚠️ **Конфликты** — если давить, спамить или нарушать границы — включается конфликт. Она может замолчать на часы или дни.
-- 🧠 **Память** — важные события пишутся в `long-term.md` и всплывают в будущих диалогах.
-- 🚫 **Anti-AI** — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды, вопросы в конце сообщений и всё, что палит ChatGPT.
-- 👤 **Userbot mode** — настоящий Telegram-аккаунт через MTProto. Умеет читать сообщения, ставить реакции, печатать, удалять и редактировать. Выглядит как живой человек, а не как бот.
-
----
-
-## Почему не просто GPTs или промпт
-
-Вариантов сделать "девушку в Telegram" несколько — от костыльных до полноценных. Разберём, что есть и где дыры.
-
-### ChatGPT GPTs
-
-**Как это работает:** Кастомный бот внутри ChatGPT с system prompt. Логика поведения = промпт.
-
-**Что упущено:**
-- Нет памяти между сессиями — каждая начинается с нуля
-- Нет Telegram — только веб-интерфейс
-- Нет реакций, печати, редактирования
-- Бот всегда "онлайн" — нет расписания или сна
-- Память ограничена контекстным окном
-
-**Итог:** Чат-бот с кастомным промптом, без состояния и реалистичного поведения.
-
----
-
-### OpenClaw + prompt (markdown-файлы)
-
-**Как это работает:** Фреймворк для AI-ассистентов. Личность через markdown-файлы (SOUL.md, IDENTITY.md, USER.md). Telegram bridge через GramJS (MTProto).
-
-**Что упущено:**
-- Нет реализм-модулей: presence, sleep, conflict, daily-life, relationship stages
-- Нет agenda — бот не планирует действия
-- Память = история сообщений, нет long-term storage
-- Нет relationship score и conflict system
-
-**Итог:** Хороший bridge для Telegram, но не персонаж-движок. Поведение = промпт + история.
-
----
-
-### HeatherBot
-
-**Как это работает:** Локальный Telegram userbot (MTProto via Telethon), persona в YAML, 4-слойная память, 17 kink-specific overlays. ~10K строк Python.
-
-**Что упущено:**
-- Слишком специфично под NSFW — 17 kink overlays
-- Сложно настроить — нужно llama-server, Ollama, ComfyUI
-- Требует мощного GPU — 12B модель локально
-- Нет presence/sleep/conflict как отдельных модулей
-
-**Итог:** Мощное, но узкое решение под NSFW с тяжёлой инфраструктурой.
-
----
-
-### Character.AI
-
-**Как это работает:** Закрытый сервис для AI-переписки. Персоны через UI, поведение = prompt engineering + session-level memory.
-
-**Что упущено:**
-- Нет Telegram — только веб-интерфейс
-- Нет контроля — всё на их серверах
-- Память сбрасывается между сессиями
-- Memory ограничена — persona обрезается при росте истории
-
-**Итог:** Закрытый сервис с ограниченной памятью и без Telegram.
-
----
-
-### girl-agent
-
-**Как это работает:** Движок с несколькими слоями состояния: presence, sleep, daily-life, relationship stages, conflict, memory, anti-AI. Userbot mode через MTProto.
-
-**Технические детали:**
-- Presence — паттерны присутствия (частота, офлайн, вероятность ответа)
-- Sleep — время сна, night wake chance
-- Daily-life — расписание, занятость, приоритеты
-- Relationship stages — stranger → convinced → close → intimate → bonded
-- Relationship score — interest, trust, attraction, annoyance, cringe
-- Conflict — если давить/спамить, включается конфликт, может замолчать
-- Memory — важные события в long-term.md, всплывают в диалогах
-- Anti-AI — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды
-- Userbot mode — умеет читать, реагировать, печатать, удалять, редактировать
-- Agenda — бот планирует действия, живёт своей жизнью
-
-**Итог:** Движок с несколькими слоями решения. Поведение собирается из состояния, а не из текстовых инструкций.
-
----
-
-## Безопасность
-
-⚠️ **Не публикуй:** `data/`, `config.json`, `sessionString` и API-ключи.
-
-🔒 **Для userbot mode** используй отдельный тестовый аккаунт — Telegram может забанить основной аккаунт за подозрительную активность.
-
----
-
-## Лицензия
-
-📄 **Source-available** — исходный код открыт для личного тестирования, оценки и вкладов.
-
-**Разрешено:**
-- Клонировать и запускать локально
-- Создавать issues и отправлять pull requests
-- Изучать код и экспериментировать
-
-**Запрещено без письменного разрешения:**
-- Коммерческое использование
-- Платный хостинг
-- Перепродажа
-- Публичные конкурирующие клоны
-- Использование кода внутри коммерческих продуктов
-
-📜 Полный текст лицензии: [LICENSE](./LICENSE)
+![girl-agent banner](https://girl-agent.com/og-image.png)
+
+[website]: https://girl-agent.com
+[docs]: https://docs.girl-agent.com
+
+**[website]**  ·  **[docs]**
+
+
+Это только бета-версия. Со временем будет дорабатыватся.
+Со всеми проблемами и багами пишите в Issues.
+ТГ создателя - @voided_net
+
+---
+
+## Содержание
+
+- [Быстрый старт](#быстрый-старт)
+- [Что под капотом](#что-под-капотом)
+- [Почему не просто GPTs или промпт](#почему-не-просто-gpts-или-промпт)
+- [Changelog](./CHANGELOG.md)
+- [Безопасность](#безопасность)
+- [Лицензия](#лицензия)
+
+---
+
+## О проекте
+
+Она не отвечает на каждое сообщение. Иногда читает и молчит. Иногда ставит реакцию. Иногда отвечает через час, потому что была занята или просто не хотела.
+
+Это не баг. Так задумано.
+
+`girl-agent` — ИИ-девушка, которая ведёт себя в переписке как человек. Со сном, настроением, расписанием, памятью и характером. Без "конечно, я понимаю" и ChatGPT-повадок.
+
+---
+
+## Быстрый старт
+
+**Через NPX (рекомендуется):**
+
+```powershell
+npx @thesashadev/girl-agent
+```
+
+Wizard задаст пару вопросов — имя, возраст, Telegram-подключение, LLM-ключ. Всё.
+
+Если профиль уже есть:
+
+```powershell
+npx @thesashadev/girl-agent --profile=arina
+```
+
+**Из исходников:**
+
+```powershell
+git clone https://github.com/TheSashaDev/girl-agent.git
+cd girl-agent
+npm install
+npm run dev
+```
+
+---
+
+## Что под капотом
+
+Поведение собирается из нескольких слоёв, а не из одного промпта.
+
+- 📱 **Она не всегда онлайн** — паттерн присутствия зависит от персонажа: кто-то в телефоне круглые сутки, кто-то заходит раз в час, кто-то только вечером.
+- 😴 **Ночью спит** — можно разбудить через `:wake`, но без команды шанс ответа низкий.
+- 📅 **Расписание дня** — у каждого дня есть расписание: пары, работа, дорога, свободное время. Если она на занятиях, телефон может быть недоступен.
+- ❤️ **Отношения** — пять счётчиков: интерес, доверие, привлекательность, раздражение, неловкость. Меняются от каждого диалога. Высокое раздражение — чаще игнор и холод.
+- 📈 **Стадии сближения** — отношения проходят стадии: от "дала тг, но холодная" до "давно вместе". Стадия влияет на тепло, флирт, длину ответов.
+- ⚠️ **Конфликты** — если давить, спамить или нарушать границы — включается конфликт. Она может замолчать на часы или дни.
+- 🧠 **Память** — важные события пишутся в `long-term.md` и всплывают в будущих диалогах.
+- 🚫 **Anti-AI** — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды, вопросы в конце сообщений и всё, что палит ChatGPT.
+- 👤 **Userbot mode** — настоящий Telegram-аккаунт через MTProto. Умеет читать сообщения, ставить реакции, печатать, удалять и редактировать. Выглядит как живой человек, а не как бот.
+
+---
+
+## Почему не просто GPTs или промпт
+
+Вариантов сделать "девушку в Telegram" несколько — от костыльных до полноценных. Разберём, что есть и где дыры.
+
+### ChatGPT GPTs
+
+**Как это работает:** Кастомный бот внутри ChatGPT с system prompt. Логика поведения = промпт.
+
+**Что упущено:**
+- Нет памяти между сессиями — каждая начинается с нуля
+- Нет Telegram — только веб-интерфейс
+- Нет реакций, печати, редактирования
+- Бот всегда "онлайн" — нет расписания или сна
+- Память ограничена контекстным окном
+
+**Итог:** Чат-бот с кастомным промптом, без состояния и реалистичного поведения.
+
+---
+
+### OpenClaw + prompt (markdown-файлы)
+
+**Как это работает:** Фреймворк для AI-ассистентов. Личность через markdown-файлы (SOUL.md, IDENTITY.md, USER.md). Telegram bridge через GramJS (MTProto).
+
+**Что упущено:**
+- Нет реализм-модулей: presence, sleep, conflict, daily-life, relationship stages
+- Нет agenda — бот не планирует действия
+- Память = история сообщений, нет long-term storage
+- Нет relationship score и conflict system
+
+**Итог:** Хороший bridge для Telegram, но не персонаж-движок. Поведение = промпт + история.
+
+---
+
+### HeatherBot
+
+**Как это работает:** Локальный Telegram userbot (MTProto via Telethon), persona в YAML, 4-слойная память, 17 kink-specific overlays. ~10K строк Python.
+
+**Что упущено:**
+- Слишком специфично под NSFW — 17 kink overlays
+- Сложно настроить — нужно llama-server, Ollama, ComfyUI
+- Требует мощного GPU — 12B модель локально
+- Нет presence/sleep/conflict как отдельных модулей
+
+**Итог:** Мощное, но узкое решение под NSFW с тяжёлой инфраструктурой.
+
+---
+
+### Character.AI
+
+**Как это работает:** Закрытый сервис для AI-переписки. Персоны через UI, поведение = prompt engineering + session-level memory.
+
+**Что упущено:**
+- Нет Telegram — только веб-интерфейс
+- Нет контроля — всё на их серверах
+- Память сбрасывается между сессиями
+- Memory ограничена — persona обрезается при росте истории
+
+**Итог:** Закрытый сервис с ограниченной памятью и без Telegram.
+
+---
+
+### girl-agent
+
+**Как это работает:** Движок с несколькими слоями состояния: presence, sleep, daily-life, relationship stages, conflict, memory, anti-AI. Userbot mode через MTProto.
+
+**Технические детали:**
+- Presence — паттерны присутствия (частота, офлайн, вероятность ответа)
+- Sleep — время сна, night wake chance
+- Daily-life — расписание, занятость, приоритеты
+- Relationship stages — stranger → convinced → close → intimate → bonded
+- Relationship score — interest, trust, attraction, annoyance, cringe
+- Conflict — если давить/спамить, включается конфликт, может замолчать
+- Memory — важные события в long-term.md, всплывают в диалогах
+- Anti-AI — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды
+- Userbot mode — умеет читать, реагировать, печатать, удалять, редактировать
+- Agenda — бот планирует действия, живёт своей жизнью
+
+**Итог:** Движок с несколькими слоями решения. Поведение собирается из состояния, а не из текстовых инструкций.
+
+---
+
+## Безопасность
+
+⚠️ **Не публикуй:** `data/`, `config.json`, `sessionString` и API-ключи.
+
+🔒 **Для userbot mode** используй отдельный тестовый аккаунт — Telegram может забанить основной аккаунт за подозрительную активность.
+
+---
+
+## Лицензия
+
+📄 **Source-available** — исходный код открыт для личного тестирования, оценки и вкладов.
+
+**Разрешено:**
+- Клонировать и запускать локально
+- Создавать issues и отправлять pull requests
+- Изучать код и экспериментировать
+
+**Запрещено без письменного разрешения:**
+- Коммерческое использование
+- Платный хостинг
+- Перепродажа
+- Публичные конкурирующие клоны
+- Использование кода внутри коммерческих продуктов
+
+📜 Полный текст лицензии: [LICENSE](./LICENSE)