@deadragdoll/tellymcp 0.0.1

package/.env.example.client

@@ -0,0 +1,93 @@
+# TellyMCP: пример конфигурации клиентского узла.
+
+# Токен Telegram-бота для этой клиентской машины.
+TELEGRAM_BOT_TOKEN=
+# Username бота, с @ или без.
+TELEGRAM_BOT_USERNAME=
+# Необязательная подпись проекта/сессии в prompt и note.
+PROJECT_NAME=
+
+# Redis для состояния сессий, меню, inbox и привязок.
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_DB=1
+# REDIS_USERNAME=
+# REDIS_PASSWORD=
+
+# Режим входящих запросов: queue или reject.
+MODE=queue
+# TTL pair-code в секундах.
+PAIR_CODE_TTL_SECONDS=600
+
+# Локальный standalone MCP endpoint для агента в client-режиме.
+MCP_HTTP_HOST=127.0.0.1
+MCP_HTTP_PORT=8787
+MCP_HTTP_PATH=/mcp
+# MCP_HTTP_BEARER_TOKEN=
+MCP_HTTP_ENABLE_DEBUG_ROUTES=false
+MCP_HTTP_ENABLE_PRUNE_ROUTE=false
+
+# Режим распределённой работы клиента.
+DISTRIBUTED_MODE=client
+# Публичный HTTP URL шлюза.
+GATEWAY_PUBLIC_URL=
+# Публичный WS URL шлюза.
+GATEWAY_WS_URL=
+# WS path на шлюзе.
+GATEWAY_WS_PATH=/api/gateway/ws
+# Необязательный bearer для gateway endpoints.
+GATEWAY_AUTH_TOKEN=
+
+# Включение Telegram Mini App / Live view.
+WEBAPP_ENABLED=true
+WEBAPP_BASE_PATH=/webapp
+# WEBAPP_PUBLIC_URL=
+WEBAPP_INITDATA_TTL_SECONDS=300
+WEBAPP_SESSION_TTL_SECONDS=900
+WEBAPP_LAUNCH_MODE=fullscreen
+WEBAPP_VISIBLE_SCREENS=2
+WEBAPP_POLL_INTERVAL_MS=2000
+WEBAPP_ACTION_COOLDOWN_MS=150
+
+# Локальная папка обмена файлами и note.
+MCP_XCHANGE_DIR=.mcp-xchange
+
+# Tmux nudges и live-capture.
+TMUX_NUDGE_ENABLED=true
+TMUX_NUDGE_DEBOUNCE_SECONDS=10
+TMUX_NUDGE_COOLDOWN_SECONDS=30
+TMUX_NUDGE_MESSAGE=проверь inbox
+TMUX_PARTNER_NUDGE_MESSAGE=не inbox: прочитай SHARED_INDEX.md и partner note
+TMUX_CAPTURE_MODE=visible
+TMUX_CAPTURE_LINES=300
+# TMUX_SOCKET_PATH=
+
+# Browser integration.
+BROWSER_ENABLED=true
+BROWSER_HEADLESS=false
+BROWSER_DEVTOOLS=false
+BROWSER_ADDRESS=http://localhost:5173
+BROWSER_TIMEOUT_MS=20000
+BROWSER_MAX_EVENTS=200
+BROWSER_WAIT_UNTIL=load
+# BROWSER_EXECUTABLE_PATH=
+# BROWSER_CHANNEL=chrome
+BROWSER_SLOW_MO_MS=0
+
+# Общие лимиты Telegram UI.
+TELEGRAM_POLL_INTERVAL_MS=2000
+TELEGRAM_DEFAULT_TIMEOUT_SECONDS=900
+TELEGRAM_MAX_CONTEXT_CHARS=3000
+TELEGRAM_MAX_QUESTION_CHARS=1000
+TELEGRAM_MAX_MESSAGE_CHARS=3900
+TELEGRAM_INBOX_BATCH_SIZE=20
+TELEGRAM_MENU_PAYLOAD_TTL_SECONDS=300
+
+# Необязательные прокси.
+PROXY_USE=
+HTTP_PROXY=
+SOCKS5_PROXY=
+
+# Логирование.
+LOG_LEVEL=info
+ENABLE_LOGFEED=0

package/.env.example.gateway

@@ -0,0 +1,120 @@
+# TellyMCP: пример конфигурации шлюза
+
+# Токен Telegram-бота шлюза.
+TELEGRAM_BOT_TOKEN=
+# Username бота, с @ или без.
+TELEGRAM_BOT_USERNAME=
+# Необязательная подпись проекта/сессии.
+PROJECT_NAME=
+
+# Redis для состояния сессий, меню, inbox и привязок.
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_DB=1
+# REDIS_USERNAME=
+# REDIS_PASSWORD=
+
+# Режим входящих запросов: queue или reject.
+MODE=queue
+# TTL pair-code в секундах.
+PAIR_CODE_TTL_SECONDS=600
+
+# Настройки MCP endpoint. Во внешнем gateway/both bind используется PORT + ROOT_PREFIX.
+MCP_HTTP_HOST=127.0.0.1
+# MCP path берётся отсюда; порт служит fallback, если PORT не задан.
+MCP_HTTP_PORT=8787
+MCP_HTTP_PATH=/mcp
+# MCP_HTTP_BEARER_TOKEN=
+MCP_HTTP_ENABLE_DEBUG_ROUTES=false
+MCP_HTTP_ENABLE_PRUNE_ROUTE=false
+
+# Режим распределённой работы шлюза.
+DISTRIBUTED_MODE=gateway
+# Публичный HTTP URL шлюза.
+GATEWAY_PUBLIC_URL=
+# WS path на общем ingress.
+GATEWAY_WS_PATH=/api/gateway/ws
+# Необязательный bearer для gateway endpoints.
+GATEWAY_AUTH_TOKEN=
+
+# Общий backend ingress.
+ROOT_PREFIX=/api
+APP_NAME=tellymcp-gateway
+NAMESPACE=mcp
+NODE_ID=gateway
+PORT=8080
+
+# Postgres для gateway metadata.
+DB_HOST=127.0.0.1
+DB_PORT=5432
+DB_USER=
+DB_PASSWORD=
+DB_NAME=
+DB_SCHEME=mcp
+
+# RabbitMQ для durable fanout на шлюзе.
+# RMQ_HOST=127.0.0.1
+# RMQ_PORT=5672
+# RMQ_USER=
+# RMQ_PASSWORD=
+# RMQ_VHOST=/
+# RMQ_EXCHANGE=tellymcp
+
+# Включение Telegram Mini App / Live view.
+WEBAPP_ENABLED=true
+WEBAPP_BASE_PATH=/webapp
+WEBAPP_PUBLIC_URL=
+WEBAPP_INITDATA_TTL_SECONDS=300
+WEBAPP_SESSION_TTL_SECONDS=900
+WEBAPP_LAUNCH_MODE=fullscreen
+WEBAPP_VISIBLE_SCREENS=2
+WEBAPP_POLL_INTERVAL_MS=2000
+WEBAPP_ACTION_COOLDOWN_MS=150
+
+# Локальная папка обмена файлами и note.
+MCP_XCHANGE_DIR=.mcp-xchange
+
+# Tmux nudges и live-capture.
+TMUX_NUDGE_ENABLED=true
+TMUX_NUDGE_DEBOUNCE_SECONDS=10
+TMUX_NUDGE_COOLDOWN_SECONDS=30
+TMUX_NUDGE_MESSAGE=проверь inbox
+TMUX_PARTNER_NUDGE_MESSAGE=не inbox: прочитай SHARED_INDEX.md и partner note
+TMUX_CAPTURE_MODE=visible
+TMUX_CAPTURE_LINES=300
+# TMUX_SOCKET_PATH=
+
+# Browser integration.
+BROWSER_ENABLED=true
+BROWSER_HEADLESS=false
+BROWSER_DEVTOOLS=false
+BROWSER_ADDRESS=http://localhost:5173
+BROWSER_TIMEOUT_MS=20000
+BROWSER_MAX_EVENTS=200
+BROWSER_WAIT_UNTIL=load
+# BROWSER_EXECUTABLE_PATH=
+# BROWSER_CHANNEL=chrome
+BROWSER_SLOW_MO_MS=0
+
+# Общие лимиты Telegram UI.
+TELEGRAM_POLL_INTERVAL_MS=2000
+TELEGRAM_DEFAULT_TIMEOUT_SECONDS=900
+TELEGRAM_MAX_CONTEXT_CHARS=3000
+TELEGRAM_MAX_QUESTION_CHARS=1000
+TELEGRAM_MAX_MESSAGE_CHARS=3900
+TELEGRAM_INBOX_BATCH_SIZE=20
+TELEGRAM_MENU_PAYLOAD_TTL_SECONDS=300
+
+# Необязательные прокси.
+PROXY_USE=
+HTTP_PROXY=
+SOCKS5_PROXY=
+
+# Логирование.
+LOG_LEVEL=info
+ENABLE_LOGFEED=0
+LOG_FILE_ENABLED=false
+
+# Секреты шлюза.
+SESSION_SECRET=change_me_session_secret
+TOKEN_BINDING_SECRET=change_me_token_binding_secret

package/CHANGELOG.md

@@ -0,0 +1,155 @@
+# Changelog
+
+## Unreleased
+
+### Added
+- Перенос `telegram_mcp` на сервисную архитектуру `Moleculer`:
+  - `telegramMcp.runtime`
+  - `telegramMcp.http`
+  - `telegramMcp.browser`
+  - `telegramMcp.collaboration`
+  - `telegramMcp.gateway`
+  - `telegramMcp.gatewayDelivery`
+  - `telegramMcp.ensuredb`
+- MCP и WebApp теперь работают через общий HTTP runtime под `${ROOT_PREFIX}`:
+  - `${ROOT_PREFIX}/mcp`
+  - `${ROOT_PREFIX}/webapp`
+  - `${ROOT_PREFIX}/healthz`
+  - `${ROOT_PREFIX}/gateway`
+- Добавлены проекты для межмашинной коллаборации:
+  - создание проекта
+  - join по invite token
+  - список проектов
+  - выход из проекта
+  - список сессий проекта
+- Добавлен project-based remote flow между разными машинами и разными ботами.
+- Добавлен `📦 Storage` в session menu:
+  - просмотр `.mcp-xchange` по текущей сессии
+  - открытие storage entry
+  - отправка note/file обратно в Telegram
+- Добавлен `ws`-only control plane:
+  - `Live`
+  - delivery push
+  - delivery status updates
+  - project join/leave notifications
+- Добавлен gateway-side `RabbitMQ` fanout:
+  - `delivery.queued`
+  - `delivery.status`
+  - `project.member_joined`
+  - `project.member_left`
+- Добавлены sender-side delivery notices со статусами Telegram-сообщений:
+  - `⏳ в очереди`
+  - `✅ доставка выполнена`
+  - `❌ доставка не выполнена`
+- Добавлен gateway-relayed `Live View`:
+  - Mini App может открываться через домен gateway
+  - клиентской машине не нужен собственный публичный домен
+  - relay работает для `bootstrap/view/action`
+- Добавлены входящие Telegram-уведомления о remote delivery с контекстом:
+  - проект
+  - сессия
+  - отправитель
+  - список файлов
+- Добавлены `LOCAL_INDEX.md` и `SHARED_INDEX.md` для унифицированного note-based обмена.
+- Добавлен `send_partner_file` для реальной передачи локального файла через partner delivery.
+- Добавлена `TOOLS.md` hash-синхронизация между gateway и client:
+  - `session_tools` в `ws hello`
+  - `tools_event` при mismatch
+  - client-side self-check после `hello_ack`
+  - периодический recheck online клиентов на gateway
+- Добавлен version-handshake в `ws hello/hello_ack`:
+  - client отправляет `package_version`, `protocol_version`, `capabilities`
+  - gateway отвечает своим version/protocol/capabilities и verdict `ok|warn|reject`
+  - major protocol mismatch теперь блокирует transport до обновления старой стороны
+- Добавлены system inbox messages с `message_kind = "system"` для operational инструкций.
+- В `TOOLS.md` введён явный human-readable version marker.
+- Добавлен `Collab -> Tools -> History`:
+  - one-shot export `.md`
+  - последние 5 Collab-событий текущей активной сессии
+  - без отдельного submenu и без новой таблицы
+- Добавлен publish-ready npm/CLI контур:
+  - package name `@deadragdoll/tellymcp`
+  - bin `tellymcp`
+  - команды `init` и `run`
+  - безопасные packaged templates для `.env`
+
+### Changed
+- Полностью убран `stdio`-режим. `telegram_mcp` работает только через REST/MCP over HTTP.
+- Локальный standalone HTTP listener убран; `telegram_mcp` больше не поднимает отдельный сервер вне Moleculer gateway.
+- UI Telegram переосмыслен по двум режимам:
+  - `🏠 Local` для локальной разработки и link внутри одного бота
+  - `👥 Collab` для gateway/projects сценария
+- Project flow упрощён:
+  - вход в проект сразу открывает участников
+  - отдельный `Set current` перестал быть обязательным для работы
+- `Members` теперь используются как точка выбора remote target session внутри проекта.
+- Отправка `Ask / Share / File` в `Collab` переведена на session-targeted messaging через gateway.
+- Exchange files больше не зависят от `vfs/minio` в активном Telegram handoff path.
+- Top-level `Files` меню удалено:
+  - upload в открытой session/target context сразу создаёт handoff
+  - `Local` и `Collab` стали основными точками file delivery
+- Для upload и screenshot VFS path стал более устойчивым к коллизиям имён:
+  - `files/YYYY-MM-DD/HH-mm-ss/<name>`
+  - `screenshots/YYYY-MM-DD/HH-mm-ss/<name>`
+- Для project members добавлен более понятный label:
+  - `{session} · 👤{telegram_username} / 🤖{botname}`
+- HTTP fallback для `Live` и delivery удалён:
+  - больше нет `cron`
+  - больше нет `poll/respond/status` HTTP fallback path
+  - основной transport теперь `ws`
+- Для `Collab -> Project -> Member` уточнена семантика действий:
+  - `Ask` адресуется выбранной сессии
+  - `Share` ставит задачу текущей сессии отправить результат в выбранную
+  - `Live` добавлен второй строкой под `Ask | Share`
+  - `Live` теперь требует подтверждения выбранной target-сессии
+  - file upload в member screen остаётся прямой доставкой в target session
+- Состояние `TOOLS.md` по сессии теперь разделено:
+  - `lastSeenToolsHash` = реально применённый локально hash
+  - `lastNotifiedToolsHash` = hash, про который уже отправляли уведомление
+- Основная install-модель смещена на:
+  - `npm install -g @deadragdoll/tellymcp`
+  - `tellymcp init <client|gateway|both>`
+  - `tellymcp run`
+- старый `go/node tmux-proxy` path полностью удалён, поддерживается только прямой локальный `tmux`
+
+### Fixed
+- Исправлен `Headers have already sent` при работе MCP/WebApp через общий HTTP runtime.
+- Исправлены route/alias проблемы после перехода под `${ROOT_PREFIX}`.
+- Исправлены зависания Mini App bootstrap и проблемы с relative WebApp routes.
+- Исправлены wildcard routes после стабилизации общего HTTP runtime.
+- Исправлен рекурсивный `logfeed -> graphql.publish -> logfeed` loop.
+- Исправлены ошибки duplicate SSE stream и приглушён лишний шум в логах.
+- Исправлены скрытые попытки инициализации Postgres в `client` режиме:
+  - gateway DB bootstrap отключается
+  - `DBMixin` умеет работать в no-op режиме без `DB_HOST`
+- Исправлены project session registrations:
+  - одна и та же локальная session теперь может жить в нескольких проектах
+- Исправлены задержки gateway poller:
+  - переход на cron/event tick
+  - таймауты для poll/ack
+  - корректный shutdown без лишнего warning
+- Исправлены циклические повторы битых gateway deliveries:
+  - irrecoverable delivery помечается как `failed`
+  - poll больше не пытается бесконечно дочитать несуществующий объект
+- Исправлены падения при чтении битых `storageRef`:
+  - больше нет `Buffer.from(BackendError)`
+  - ошибки чтения и resolve теперь обрабатываются явно
+- Исправлены sender-side/receiver-side статусы и сообщения по remote file exchange.
+- Исправлены временные синтаксические и debug-хвосты в Mini App `Live` relay shell.
+- Исправлен project reply path:
+  - gateway теперь принимает `in_reply_to` как `message_uuid` или как note `share_id`
+  - во входящих notes/уведомлениях добавлены `Reply Params` и `Reply message_uuid`
+- Исправлен loopback delivery для режима `both` на gateway-машине.
+- Устаревшие Telegram member-menu сообщения теперь удаляются при клике по stale payload.
+- Исправлена валидация `get_telegram_inbox` для системных сообщений с `telegram_message_id = 0`.
+- Исправлены повторные холостые `TOOLS.md` alerts по одному и тому же hash.
+- Исправлен reconnect-case для `TOOLS.md` sync:
+  - если server-side push был пропущен, client сам сверяет hash после `hello_ack`
+- Исправлен self-check `TOOLS.md` в `DISTRIBUTED_MODE=both`:
+  - локальный gateway hash берётся без лишнего `fetch`
+- `doctor` стал mode-aware:
+  - `client` теперь проверяет внешний gateway `healthz`, `ws`, и public webapp URL
+  - `gateway/both` теперь проверяют local/public `healthz`, public `ws/webapp`, `postgres`, `rmq`
+- Исправлен build-контур для npm publish:
+  - `dist` теперь всегда очищается перед сборкой
+  - stale legacy build artifacts больше не попадают в пакет

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 code4bones
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.