@deadragdoll/tellymcp 0.0.9 → 0.0.11

package/.env.example.client

@@ -1,25 +1,21 @@
-# TellyMCP: пример конфигурации клиентского узла.
+# TellyMCP client example
 
-# Токен Telegram-бота для этой клиентской машины.
-TELEGRAM_BOT_TOKEN=
-# Username бота, с @ или без.
-TELEGRAM_BOT_USERNAME=
-# Необязательная подпись проекта/сессии в prompt и note.
-PROJECT_NAME=
+# Optional project label shown in prompts.
+# PROJECT_NAME=
+
+# Optional explicit session identity for the first run.
+# TELLYMCP_SESSION_ID=NEW
+# TELLYMCP_SESSION_LABEL=NEW
 
-# 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
+MODE=reject
+PAIR_CODE_TTL_SECONDS=300
 
-# Локальный standalone MCP endpoint для агента в client-режиме.
 MCP_HTTP_HOST=127.0.0.1
 MCP_HTTP_PORT=8787
 MCP_HTTP_PATH=/mcp
@@ -27,46 +23,48 @@ MCP_HTTP_PATH=/mcp
 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_PUBLIC_URL=https://your-domain.example/api/gateway
+GATEWAY_WS_URL=wss://your-domain.example/api/gateway/ws
 GATEWAY_WS_PATH=/api/gateway/ws
-# Необязательный bearer для gateway endpoints.
-GATEWAY_AUTH_TOKEN=
+GATEWAY_TOKEN=change_me_gateway_token
+GATEWAY_USER_UUID=
+# GATEWAY_AUTH_TOKEN=
+
+TERMINAL_SHELL=bash
+TERMINAL_COLS=120
+TERMINAL_ROWS=40
+TERMINAL_SCROLLBACK_LINES=4000
 
-# Включение Telegram Mini App / Live view.
+TERMINAL_NUDGE_ENABLED=true
+TERMINAL_NUDGE_DEBOUNCE_SECONDS=10
+TERMINAL_NUDGE_COOLDOWN_SECONDS=30
+TERMINAL_NUDGE_MESSAGE=получи newest telegram_message через list_xchange_records/get_xchange_record, выполни запрос и ответь человеку через notify_telegram; не останавливайся на анализе
+TERMINAL_PARTNER_NUDGE_MESSAGE=получи newest partner_note через list_xchange_records/get_xchange_record, выполни задачу в текущей консоли и обязательно отправь результат через send_partner_note или send_partner_file; только потом mark_xchange_record_read
+TERMINAL_PARTNER_REPLY_NUDGE_MESSAGE=получи newest partner_note через list_xchange_records/get_xchange_record; если newest note имеет kind=reply или не требует ответа, не отправляй новый send_partner_note/send_partner_file без явного нового запроса. Если этот reply завершает задачу от человека, сразу отправь финальный результат в Telegram через notify_telegram или send_file_to_telegram; только потом mark_xchange_record_read
+TERMINAL_CAPTURE_MODE=visible
+TERMINAL_CAPTURE_LINES=300
+TERMINAL_PROMPT_SCAN_ENABLED=true
+TERMINAL_PROMPT_SCAN_INTERVAL_SECONDS=15
+TERMINAL_PROMPT_SCAN_COOLDOWN_SECONDS=120
+TERMINAL_PROMPT_SCAN_STRATEGY=strict
+TERMINAL_PROMPT_SCAN_MIN_SCORE=5
 WEBAPP_ENABLED=true
 WEBAPP_BASE_PATH=/webapp
-# WEBAPP_PUBLIC_URL=
+WEBAPP_PUBLIC_URL=https://your-domain.example/api/webapp
 WEBAPP_INITDATA_TTL_SECONDS=300
 WEBAPP_SESSION_TTL_SECONDS=900
 WEBAPP_LAUNCH_MODE=fullscreen
-WEBAPP_VISIBLE_SCREENS=2
+WEBAPP_VISIBLE_SCREENS=10
 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_ADDRESS=http://localhost:5173
 BROWSER_TIMEOUT_MS=20000
 BROWSER_MAX_EVENTS=200
 BROWSER_WAIT_UNTIL=load
@@ -74,22 +72,16 @@ BROWSER_WAIT_UNTIL=load
 # 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
+NAMESPACE=mcp
+NODE_ID=agent
 
-# Необязательные прокси.
-PROXY_USE=
-HTTP_PROXY=
-SOCKS5_PROXY=
+# Optional outbound proxy.
+# PROXY_USE=http
+# HTTP_PROXY=http://user:pass@proxy.example:3128
+# SOCKS5_PROXY=socks5h://user:pass@proxy.example:1080
 
-# Логирование.
 LOG_LEVEL=info
 LOG_FILE_ENABLED=false
 LOG_FILE_PATH=.tellymcp/log.jsonl
+# LOG_STDERR_LEVEL=error
 ENABLE_LOGFEED=0

package/.env.example.gateway

@@ -1,50 +1,46 @@
-# TellyMCP: пример конфигурации шлюза
+# TellyMCP gateway example
 
-# Токен Telegram-бота шлюза.
 TELEGRAM_BOT_TOKEN=
-# Username бота, с @ или без.
 TELEGRAM_BOT_USERNAME=
-# Необязательная подпись проекта/сессии.
-PROJECT_NAME=
+# ADMIN_TOKEN=
+# DEBUG_LANGUAGE=ru
+
+# Enable webhook instead of polling.
+# TELEGRAM_WEBHOOK_ENABLED=true
+# TELEGRAM_WEBHOOK_PATH=/telegram/webhook
+# TELEGRAM_WEBHOOK_PUBLIC_URL=https://your-domain.example/api/telegram/webhook
+# TELEGRAM_WEBHOOK_SECRET=change_me_webhook_secret
+# TELEGRAM_WEBHOOK_TRACE=false
+# TELEGRAM_WEBHOOK_DROP_PENDING_UPDATES=false
 
-# 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
+MODE=reject
+PAIR_CODE_TTL_SECONDS=300
 
-# Настройки 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_PUBLIC_URL=https://your-domain.example/api/gateway
+GATEWAY_WS_URL=wss://your-domain.example/api/gateway/ws
 GATEWAY_WS_PATH=/api/gateway/ws
-# Необязательный bearer для gateway endpoints.
-GATEWAY_AUTH_TOKEN=
+GATEWAY_TOKEN=change_me_gateway_token
+# GATEWAY_AUTH_TOKEN=
 
-# Общий backend ingress.
 ROOT_PREFIX=/api
-APP_NAME=tellymcp-gateway
-NAMESPACE=mcp
-NODE_ID=gateway
 PORT=8080
+NAMESPACE=mcp
+NODE_ID=GWAY
 
-# Postgres для gateway metadata.
 DB_HOST=127.0.0.1
 DB_PORT=5432
 DB_USER=
@@ -52,43 +48,48 @@ DB_PASSWORD=
 DB_NAME=
 DB_SCHEME=mcp
 
-# RabbitMQ для durable fanout на шлюзе.
+# Optional RabbitMQ fanout.
 # RMQ_HOST=127.0.0.1
 # RMQ_PORT=5672
 # RMQ_USER=
 # RMQ_PASSWORD=
 # RMQ_VHOST=/
-# RMQ_EXCHANGE=tellymcp
+# RMQ_EXCHANGE=telegram_mcp.gateway
 
-# Включение Telegram Mini App / Live view.
 WEBAPP_ENABLED=true
 WEBAPP_BASE_PATH=/webapp
-WEBAPP_PUBLIC_URL=
+WEBAPP_PUBLIC_URL=https://your-domain.example/api/webapp
 WEBAPP_INITDATA_TTL_SECONDS=300
 WEBAPP_SESSION_TTL_SECONDS=900
 WEBAPP_LAUNCH_MODE=fullscreen
-WEBAPP_VISIBLE_SCREENS=2
+WEBAPP_VISIBLE_SCREENS=10
 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
+TERMINAL_SHELL=bash
+TERMINAL_COLS=120
+TERMINAL_ROWS=40
+TERMINAL_SCROLLBACK_LINES=4000
+
+TERMINAL_NUDGE_ENABLED=true
+TERMINAL_NUDGE_DEBOUNCE_SECONDS=10
+TERMINAL_NUDGE_COOLDOWN_SECONDS=30
+TERMINAL_NUDGE_MESSAGE=получи newest telegram_message через list_xchange_records/get_xchange_record, выполни запрос и ответь человеку через notify_telegram; не останавливайся на анализе
+TERMINAL_PARTNER_NUDGE_MESSAGE=получи newest partner_note через list_xchange_records/get_xchange_record, выполни задачу в текущей консоли и обязательно отправь результат через send_partner_note или send_partner_file; только потом mark_xchange_record_read
+TERMINAL_PARTNER_REPLY_NUDGE_MESSAGE=получи newest partner_note через list_xchange_records/get_xchange_record; если newest note имеет kind=reply или не требует ответа, не отправляй новый send_partner_note/send_partner_file без явного нового запроса. Если этот reply завершает задачу от человека, сразу отправь финальный результат в Telegram через notify_telegram или send_file_to_telegram; только потом mark_xchange_record_read
+TERMINAL_CAPTURE_MODE=visible
+TERMINAL_CAPTURE_LINES=300
+TERMINAL_PROMPT_SCAN_ENABLED=false
+TERMINAL_PROMPT_SCAN_INTERVAL_SECONDS=15
+TERMINAL_PROMPT_SCAN_COOLDOWN_SECONDS=120
+TERMINAL_PROMPT_SCAN_STRATEGY=strict
+TERMINAL_PROMPT_SCAN_MIN_SCORE=5
+BROWSER_ENABLED=false
 BROWSER_HEADLESS=false
 BROWSER_DEVTOOLS=false
-BROWSER_ADDRESS=http://localhost:5173
+# BROWSER_ADDRESS=http://localhost:5173
 BROWSER_TIMEOUT_MS=20000
 BROWSER_MAX_EVENTS=200
 BROWSER_WAIT_UNTIL=load
@@ -96,26 +97,13 @@ BROWSER_WAIT_UNTIL=load
 # 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=
+# Optional outbound proxy.
+# PROXY_USE=http
+# HTTP_PROXY=http://user:pass@proxy.example:3128
+# SOCKS5_PROXY=socks5h://user:pass@proxy.example:1080
 
-# Логирование.
 LOG_LEVEL=info
-LOG_FILE_ENABLED=false
+LOG_FILE_ENABLED=true
 LOG_FILE_PATH=.tellymcp/log.jsonl
+# LOG_STDERR_LEVEL=error
 ENABLE_LOGFEED=0
-
-# Секреты шлюза.
-SESSION_SECRET=change_me_session_secret
-TOKEN_BINDING_SECRET=change_me_token_binding_secret

package/CHANGELOG.md

@@ -50,7 +50,7 @@
   - сессия
   - отправитель
   - список файлов
-- Добавлены `LOCAL_INDEX.md` и `SHARED_INDEX.md` для унифицированного note-based обмена.
+- Добавлен унифицированный note-based обмен; позже он переведён на structured xchange records на sqlite.
 - Добавлен `send_partner_file` для реальной передачи локального файла через partner delivery.
 - Добавлена `TOOLS.md` hash-синхронизация между gateway и client:
   - `session_tools` в `ws hello`
@@ -74,7 +74,7 @@
   - безопасные packaged templates для `.env`
 
 ### Changed
-- Полностью убран `stdio`-режим. `telegram_mcp` работает только через REST/MCP over HTTP.
+- Полностью убран legacy standalone MCP transport. `telegram_mcp` работает только через REST/MCP over HTTP.
 - Локальный standalone HTTP listener убран; `telegram_mcp` больше не поднимает отдельный сервер вне Moleculer gateway.
 - UI Telegram переосмыслен по двум режимам:
   - `🏠 Local` для локальной разработки и link внутри одного бота
@@ -110,7 +110,7 @@
   - `npm install -g @deadragdoll/tellymcp`
   - `tellymcp init <client|gateway|both>`
   - `tellymcp run`
-- старый `go/node tmux-proxy` path полностью удалён, поддерживается только прямой локальный `tmux`
+- старый `go/node terminal-proxy` path полностью удалён, поддерживается только прямой локальный terminal runtime
 
 ### Fixed
 - Исправлен `Headers have already sent` при работе MCP/WebApp через общий HTTP runtime.