@deadragdoll/tellymcp 0.0.12 → 0.0.14

package/.env.example.client

@@ -29,7 +29,7 @@ GATEWAY_WS_URL=wss://your-domain.example/api/gateway/ws
 GATEWAY_WS_PATH=/api/gateway/ws
 GATEWAY_TOKEN=change_me_gateway_token
 GATEWAY_USER_UUID=
-# GATEWAY_AUTH_TOKEN=
+GATEWAY_AUTH_TOKEN=
 
 TERMINAL_SHELL=bash
 TERMINAL_COLS=120
@@ -71,6 +71,10 @@ BROWSER_WAIT_UNTIL=load
 # BROWSER_EXECUTABLE_PATH=
 # BROWSER_CHANNEL=chrome
 BROWSER_SLOW_MO_MS=0
+# BROWSER_ATTACH_ENABLED=true
+# BROWSER_ATTACH_WS_HOST=127.0.0.1
+# BROWSER_ATTACH_WS_PORT=9999
+# BROWSER_ATTACH_WS_PATH=/browser-attach/ws
 
 NAMESPACE=mcp
 NODE_ID=agent

package/.env.example.gateway

@@ -29,12 +29,27 @@ MCP_HTTP_PATH=/mcp
 MCP_HTTP_ENABLE_DEBUG_ROUTES=false
 MCP_HTTP_ENABLE_PRUNE_ROUTE=false
 
+# ChatGPT / Claude OAuth connector. Setting any OAuth value enables the facade.
+# TELLYMCP_PUBLIC_URL=https://your-domain.example/api
+# TELLYMCP_OAUTH_ISSUER=https://your-domain.example/api
+# TELLYMCP_OAUTH_AUDIENCE=https://your-domain.example/api
+# TELLYMCP_MAGIC_TOKEN=change_me_private_connector_token
+# TELLYMCP_MAGIC_TOKEN_HASH=sha256:<hex>
+# TELLYMCP_OAUTH_CLIENT_ID=tellymcp
+# TELLYMCP_OAUTH_CLIENT_SECRET=
+# TELLYMCP_ALLOWED_REDIRECT_URIS=https://chatgpt.com/connector/oauth/...,https://claude.ai/api/mcp/auth_callback
+# TELLYMCP_OAUTH_PRIVATE_KEY_PEM="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+# TELLYMCP_AUTH_CODE_TTL_SECONDS=300
+# TELLYMCP_OAUTH_SCOPES=tellymcp:read tellymcp:write
+# TELLYMCP_OAUTH_KEY_ID=tellymcp-oauth
+
 DISTRIBUTED_MODE=gateway
+# Also used to derive short-lived file URLs under /api/files/.
 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
 GATEWAY_TOKEN=change_me_gateway_token
-# GATEWAY_AUTH_TOKEN=
+GATEWAY_AUTH_TOKEN=
 
 ROOT_PREFIX=/api
 PORT=8080

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 ## Unreleased
 
 ### Added
+
+- Добавлены связанные MCP tools `get_file_list` и `get_file` для получения
+  файлов из workspace выбранной live-консоли через gateway. Первый возвращает
+  список managed files и точные пути, второй принимает `file_path` либо
+  `selector=latest_screenshot`. По умолчанию `get_file(type="url")` возвращает
+  короткоживущую download-ссылку в `data`; временная gateway-копия хранится в
+  `.tellymcp/tmp/file-links`, а `type="base64"` остаётся fallback.
+- Добавлен явный режим `get_file(type="image")`: download URL остаётся в
+  `structuredContent.data`, сам structured type равен `image`, а изображение
+  возвращается отдельным нативным MCP-блоком, чтобы Claude и другие совместимые
+  клиенты могли рендерить его inline.
+- Для Claude.ai сохранён совместимый `type="base64"`: полный JSON вместе с raw
+  base64 в `data` возвращается обычным MCP text-блоком без native image, поскольку
+  некоторые MCP-host адаптеры заменяют изображение на `[image]` и скрывают
+  structured output от модели.
+- Добавлен `get_file(type="text")` для прямого чтения UTF-8 Markdown и исходников
+  через native MCP text-блок. Для `.ts`, `.tsx` и других source-расширений добавлены
+  текстовые MIME overrides.
+- Доступ к live `.env`, credential stores, private-key расширениям и чувствительным
+  директориям теперь блокируется на клиенте до чтения или отправки файла; выход
+  за workspace и через symlink по-прежнему запрещён.
 - Перенос `telegram_mcp` на сервисную архитектуру `Moleculer`:
   - `telegramMcp.runtime`
   - `telegramMcp.http`
@@ -74,6 +95,14 @@
   - безопасные packaged templates для `.env`
 
 ### Changed
+
+- Общее чтение workspace-файлов теперь проверяет реальный путь после разрешения
+  symlink и не позволяет выйти за пределы workspace.
+- Telegram Mini App Live Console переведена на WS-only rendering:
+  - HTTP polling и `/api/view` удалены
+  - после разрыва WebSocket автоматически восстанавливается с exponential backoff
+  - размеры xterm рассчитываются официальным `@xterm/addon-fit`
+  - resize колонок и строк передаётся локальным и relay PTY
 - Полностью убран legacy standalone MCP transport. `telegram_mcp` работает только через REST/MCP over HTTP.
 - Локальный standalone HTTP listener убран; `telegram_mcp` больше не поднимает отдельный сервер вне Moleculer gateway.
 - UI Telegram переосмыслен по двум режимам:
@@ -113,6 +142,7 @@
 - старый `go/node terminal-proxy` path полностью удалён, поддерживается только прямой локальный terminal runtime
 
 ### Fixed
+
 - Исправлен `Headers have already sent` при работе MCP/WebApp через общий HTTP runtime.
 - Исправлены route/alias проблемы после перехода под `${ROOT_PREFIX}`.
 - Исправлены зависания Mini App bootstrap и проблемы с relative WebApp routes.

package/README-ru.md

@@ -27,8 +27,12 @@
 
 - даёт MCP tools для human-in-the-loop через Telegram
 - позволяет одной консоли агента ставить задачу другой консоли
+- позволяет MCP chat-клиенту получать проектный текст, изображения и артефакты выбранной консоли
 - хранит structured xchange records в `.mcp-xchange`
 - поддерживает browser automation через Playwright
+- умеет attach к уже открытому Firefox или Chrome через bundled local extensions
+- умеет писать structured browser bundles в `.mcp-xchange/web/...` с HTML, network и console артефактами
+- умеет инжектить helper scripts в attached tabs или Playwright pages через `browser_inject_script`
 - отдаёт Telegram Mini App / Live View с gateway
 - поддерживает polling и webhook на gateway
 - поставляет встроенный Codex plugin со skills под типовые workflow
@@ -63,6 +67,7 @@ Gateway
 - `telegram_message`
 - `notify_telegram`
 - `browser_screenshot(send_to_telegram=true)`
+- `get_file` для возврата скриншотов и артефактов в MCP chat-клиент
 
 Для agent-to-agent:
 
@@ -76,9 +81,22 @@ Gateway
 - `browser_open`
 - `browser_click`
 - `browser_fill`
+- `browser_inject_script`
 - `browser_press`
 - `browser_wait_for`
 - `browser_screenshot`
+- `browser_recording_start`
+- `browser_recording_stop`
+- `browser_recording_status`
+
+Файлы:
+
+- `get_file_list(source=..., limit=...)`
+- `get_file(file_path=..., type="url")`
+- `get_file(file_path=..., type="image")`
+- `get_file(file_path=..., type="text")`
+- `get_file(file_path=..., type="base64")`
+- `get_file(selector="latest_screenshot")`
 
 Синхронизация инструкций:
 
@@ -105,6 +123,18 @@ npm install -g @deadragdoll/tellymcp
 tellymcp browser install
 ```
 
+Если нужны attach extensions для существующего Firefox/Chrome:
+
+```bash
+tellymcp extension firefox
+tellymcp extension chrome
+```
+
+Команда выгружает готовые unpacked bundles в текущий каталог:
+
+- `./tellymcp-firefox-attach`
+- `./tellymcp-chrome-attach`
+
 Если используешь Codex:
 
 ```bash
@@ -138,6 +168,7 @@ tellymcp init gateway
 - `GATEWAY_PUBLIC_URL`
 - `GATEWAY_WS_URL`
 - `GATEWAY_TOKEN`
+- `GATEWAY_AUTH_TOKEN`
 
 Запуск:
 
@@ -164,6 +195,7 @@ tellymcp init client
 - `GATEWAY_PUBLIC_URL`
 - `GATEWAY_WS_URL`
 - `GATEWAY_TOKEN`
+- `GATEWAY_AUTH_TOKEN` (тот же transport-токен, который задан на gateway)
 - `GATEWAY_USER_UUID`, если консоль должна быть видна конкретному владельцу в gateway-боте
 
 Рекомендуется:
@@ -356,6 +388,7 @@ tellymcp system-prune --env .env --yes
 - [README.md](./README.md)
 - [STANDALONE.md](./docs/STANDALONE.md)
 - [STANDALONE-ru.md](./docs/STANDALONE-ru.md)
+- [CHAT_CONNECTOR.md](./docs/CHAT_CONNECTOR.md) — OAuth-коннектор ChatGPT/Claude
 - [TOOLS.md](./TOOLS.md)
 - [screenshots/README.md](./screenshots/README.md)
 

package/README.md

@@ -27,8 +27,12 @@ The current model is gateway-first:
 
 - exposes MCP tools for human Telegram interaction
 - lets one agent ask another agent to do work and return files or notes
+- lets MCP chat clients retrieve project text, images, and artifacts from a selected console
 - stores structured xchange records in `.mcp-xchange`
 - supports browser automation with Playwright
+- can attach to an already running Firefox or Chrome tab through bundled local extensions
+- records browser sessions into structured `.mcp-xchange/web/...` bundles with HTML, network and console artifacts
+- can inject helper scripts into attached tabs or Playwright pages through `browser_inject_script`
 - serves the Telegram Mini App / Live View from the gateway
 - supports Telegram polling or webhook mode on the gateway
 - ships a bundled Codex workflow plugin for better agent behavior
@@ -63,6 +67,7 @@ Human-facing:
 - `telegram_message` records
 - `notify_telegram`
 - `browser_screenshot(send_to_telegram=true)`
+- `get_file` for returning screenshots and artifacts to MCP chat clients
 
 Agent-to-agent:
 
@@ -76,9 +81,22 @@ Browser:
 - `browser_open`
 - `browser_click`
 - `browser_fill`
+- `browser_inject_script`
 - `browser_press`
 - `browser_wait_for`
 - `browser_screenshot`
+- `browser_recording_start`
+- `browser_recording_stop`
+- `browser_recording_status`
+
+Files:
+
+- `get_file_list(source=..., limit=...)`
+- `get_file(file_path=..., type="url")`
+- `get_file(file_path=..., type="image")`
+- `get_file(file_path=..., type="text")`
+- `get_file(file_path=..., type="base64")`
+- `get_file(selector="latest_screenshot")`
 
 Tools sync:
 
@@ -105,6 +123,18 @@ Optional browser runtime:
 tellymcp browser install
 ```
 
+Optional attached-browser extensions:
+
+```bash
+tellymcp extension firefox
+tellymcp extension chrome
+```
+
+This exports unpacked extension bundles into the current directory:
+
+- `./tellymcp-firefox-attach`
+- `./tellymcp-chrome-attach`
+
 Optional Codex workflow plugin:
 
 ```bash
@@ -138,6 +168,7 @@ Required gateway values:
 - `GATEWAY_PUBLIC_URL`
 - `GATEWAY_WS_URL`
 - `GATEWAY_TOKEN`
+- `GATEWAY_AUTH_TOKEN`
 
 Then run:
 
@@ -164,6 +195,7 @@ Required client values:
 - `GATEWAY_PUBLIC_URL`
 - `GATEWAY_WS_URL`
 - `GATEWAY_TOKEN`
+- `GATEWAY_AUTH_TOKEN` (the same transport token configured on the gateway)
 - `GATEWAY_USER_UUID` if this console should be scoped to a specific Telegram owner
 
 Recommended:
@@ -355,6 +387,7 @@ tellymcp system-prune --env .env --yes
 - [README-ru.md](./README-ru.md)
 - [STANDALONE.md](./docs/STANDALONE.md)
 - [STANDALONE-ru.md](./docs/STANDALONE-ru.md)
+- [CHAT_CONNECTOR.md](./docs/CHAT_CONNECTOR.md) — ChatGPT/Claude OAuth connector
 - [TOOLS.md](./TOOLS.md)
 - [screenshots/README.md](./screenshots/README.md)