@deadragdoll/tellymcp 0.0.10 → 0.0.12

package/scripts/build-package-artifact.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+DOCKER_IMAGE="${DOCKER_IMAGE:-node:24-bookworm-slim}"
+
+echo "Building TellyMCP package artifact inside ${DOCKER_IMAGE}"
+
+rm -f deadragdoll-tellymcp-*.tgz
+
+docker run --rm \
+  -u "$(id -u):$(id -g)" \
+  -e HOME=/tmp/tellymcp-build-home \
+  -e npm_config_cache=/tmp/tellymcp-npm-cache \
+  -v "${PWD}:/work" \
+  -w /work \
+  "${DOCKER_IMAGE}" \
+  bash -lc '
+    set -euo pipefail
+    mkdir -p "$HOME" "$npm_config_cache"
+    npx -y yarn@1.22.22 install --frozen-lockfile
+    npx -y yarn@1.22.22 lint
+    npx -y yarn@1.22.22 test
+    npm pack
+  '
+
+echo "Built package artifacts:"
+ls -1 deadragdoll-tellymcp-*.tgz

package/scripts/deploy-gateway.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+GATEWAY_ENV_FILE="${GATEWAY_ENV_FILE:-}"
+DEPLOY_TAG="${CI_COMMIT_TAG:-}"
+LOG_HOST_DIR="${LOG_HOST_DIR:-}"
+
+if [[ -z "${GATEWAY_ENV_FILE}" ]]; then
+  echo "GATEWAY_ENV_FILE is required." >&2
+  exit 1
+fi
+
+if [[ ! -f "${GATEWAY_ENV_FILE}" ]]; then
+  echo "Missing gateway env file: ${GATEWAY_ENV_FILE}" >&2
+  exit 1
+fi
+
+ARCHIVE="$(find . -maxdepth 1 -type f -name 'deadragdoll-tellymcp-*.tgz' | sort | tail -n 1)"
+if [[ -z "${ARCHIVE}" ]]; then
+  echo "No deadragdoll-tellymcp-*.tgz artifact found in current workspace." >&2
+  exit 1
+fi
+
+extract_package_version() {
+  local package_json
+  package_json="$(<package.json)"
+  sed -n 's/^[[:space:]]*"version":[[:space:]]*"\([^"]*\)".*$/\1/p' \
+    <<<"${package_json}" \
+    | head -n 1
+}
+
+PACKAGE_VERSION="$(extract_package_version)"
+if [[ -z "${PACKAGE_VERSION}" ]]; then
+  echo "Failed to extract version from package.json" >&2
+  exit 1
+fi
+if [[ -n "${DEPLOY_TAG}" ]]; then
+  if [[ "${DEPLOY_TAG}" != "${PACKAGE_VERSION}" && "${DEPLOY_TAG}" != "v${PACKAGE_VERSION}" ]]; then
+    echo "Tag ${DEPLOY_TAG} does not match package.json version ${PACKAGE_VERSION}" >&2
+    exit 1
+  fi
+fi
+
+if [[ -z "${LOG_HOST_DIR}" ]]; then
+  LOG_HOST_DIR="$(dirname "${GATEWAY_ENV_FILE}")/.tellymcp"
+fi
+
+mkdir -p "${LOG_HOST_DIR}"
+
+export TELLYMCP_VERSION="${PACKAGE_VERSION}"
+export GATEWAY_ENV_FILE
+export LOG_HOST_DIR
+
+echo "Deploying TellyMCP gateway ${TELLYMCP_VERSION}"
+echo "Artifact: ${ARCHIVE}"
+echo "Gateway env: ${GATEWAY_ENV_FILE}"
+echo "Log host dir: ${LOG_HOST_DIR}"
+
+echo "Rebuilding gateway container stack"
+docker compose build --pull tellymcp-gateway
+docker compose up -d --force-recreate
+
+echo "Gateway deployment completed"
+docker compose ps

package/scripts/deploy-onebot-branch.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT_DIR="${CI_PROJECT_DIR:-$(pwd)}"
+
+if [[ ! -d "${PROJECT_DIR}" ]]; then
+  echo "Missing project directory: ${PROJECT_DIR}" >&2
+  exit 1
+fi
+
+cd "${PROJECT_DIR}"
+
+PACKAGE_ARCHIVE="$(find . -maxdepth 1 -type f -name 'deadragdoll-tellymcp-*.tgz' | sort | tail -n 1)"
+
+if [[ -z "${PACKAGE_ARCHIVE}" ]]; then
+  echo "Missing package archive in ${PROJECT_DIR}. Expected deadragdoll-tellymcp-*.tgz artifact." >&2
+  exit 1
+fi
+
+echo "Installing TellyMCP from archive: ${PACKAGE_ARCHIVE}"
+npm install -g "${PACKAGE_ARCHIVE}"
+
+echo "Installed version:"
+tellymcp help | sed -n '1,2p'
+
+echo "Restarting existing PM2 instance 0"
+pm2 restart 0

package/scripts/postinstall.js

@@ -3,61 +3,36 @@
 const { spawnSync } = require("node:child_process");
 const pc = require("picocolors");
 
-function getTmuxStatus() {
-  const result = spawnSync("tmux", ["-V"], {
+function hasCodex() {
+  const result = spawnSync("codex", ["--version"], {
     encoding: "utf8",
     stdio: ["ignore", "pipe", "ignore"],
   });
-
-  if (result.status === 0) {
-    return {
-      found: true,
-      version: (result.stdout || "tmux").trim(),
-    };
-  }
-
-  return { found: false };
-}
-
-function getInstallHints() {
-  if (process.platform === "darwin") {
-    return ["brew install tmux"];
-  }
-
-  return [
-    "Ubuntu/Debian: sudo apt install tmux",
-    "Fedora/RHEL:   sudo dnf install tmux",
-    "Arch:          sudo pacman -S tmux",
-  ];
+  return result.status === 0;
 }
 
 function line(value = "") {
   process.stdout.write(`${value}\n`);
 }
 
-const tmux = getTmuxStatus();
-
 line();
 line(`${pc.bold(pc.cyan("TellyMCP"))} ${pc.dim("installed")}`);
 line();
 
-if (tmux.found) {
-  line(`${pc.green("OK")} tmux detected: ${tmux.version}`);
-  line("Live view and session nudges should work on this machine.");
-} else {
-  line(`${pc.yellow("WARN")} tmux was not found on this system.`);
-  line("TellyMCP can still run, but Live view and nudges will be limited.");
-  line("Install tmux, for example:");
-  for (const hint of getInstallHints()) {
-    line(`  ${hint}`);
-  }
-}
+line(`${pc.green("OK")} Built-in PTY terminal runtime is enabled.`);
 
 line();
 line(`${pc.yellow("INFO")} Browser tools need Playwright browser binaries.`);
 line("If you plan to use browser_* tools, run:");
 line(`  ${pc.bold("tellymcp browser install")}`);
 
+if (hasCodex()) {
+  line();
+  line(`${pc.yellow("INFO")} Codex CLI detected on this machine.`);
+  line("To sync or update the bundled Codex workflow plugin, run:");
+  line(`  ${pc.bold("tellymcp codex-plugin install")}`);
+}
+
 line();
 line(`Check your local setup: ${pc.bold("tellymcp doctor")}`);
 line(`General help: ${pc.bold("tellymcp help")}`);

package/STANDALONE-ru.md

@@ -1,274 +0,0 @@
-# TellyMCP Standalone Guide
-
-[English](STANDALONE.md) | [Русский](STANDALONE-ru.md)
-
-Это пошаговая инструкция для самого простого сценария TellyMCP:
-
-- одна машина
-- один Telegram-бот
-- без shared gateway
-- без Postgres
-- без RabbitMQ
-
-Именно с этого режима лучше начинать.
-
-## Что понадобится
-
-Перед установкой нужны:
-
-1. Node.js 24+
-2. `tmux`
-3. Redis
-4. Telegram bot token из BotFather
-5. опционально для `browser_*` tools: Playwright Chromium browser binaries
-
-Зачем это нужно:
-
-- Node.js запускает сервис
-- `tmux` нужен для Live View, `nudge` и полноценной интерактивной работы
-- Redis хранит состояние сессий, inbox, pairing и меню
-- Telegram bot token связывает сервис с Telegram
-
-## Шаг 1. Установить зависимости
-
-Пример для Ubuntu / Debian:
-
-```bash
-sudo apt-get update
-sudo apt-get install -y tmux redis-server
-node -v
-tmux -V
-redis-cli ping
-```
-
-Ожидаемый результат:
-
-- Node версии `24.x` или новее
-- `tmux -V` показывает версию
-- `redis-cli ping` возвращает `PONG`
-
-Если планируешь использовать browser automation tools, один раз выполни ещё:
-
-```bash
-tellymcp browser install
-```
-
-## Шаг 2. Создать Telegram-бота
-
-В Telegram:
-
-1. Открой BotFather
-2. Выполни `/newbot`
-3. Выбери имя бота
-4. Выбери username бота
-5. Сохрани токен
-
-Тебе понадобятся:
-
-- `TELEGRAM_BOT_TOKEN`
-- `TELEGRAM_BOT_USERNAME`
-
-## Шаг 3. Установить TellyMCP
-
-```bash
-npm install -g @deadragdoll/tellymcp
-```
-
-Проверка CLI:
-
-```bash
-tellymcp help
-```
-
-## Шаг 4. Запустить агента в tmux
-
-Это важный момент.
-
-Для полноценной работы агент лучше запускать внутри `tmux`, а не в обычной shell-сессии.
-
-Создать tmux-сессию:
-
-```bash
-tmux new -s backend
-```
-
-Хорошие имена:
-
-- `backend`
-- `frontend`
-- `review`
-- `ops`
-
-Почему имя tmux-сессии важно:
-
-- по нему проще различать агентов
-- оно улучшает диагностику
-- в Telegram и Live View проще понимать, какая сессия открыта
-
-Если нужно выйти:
-
-```bash
-tmux detach
-```
-
-И вернуться:
-
-```bash
-tmux attach -t backend
-```
-
-## Шаг 5. Создать standalone-конфиг
-
-В рабочей директории:
-
-```bash
-tellymcp init client
-```
-
-Команда создаст локальный `.env`.
-
-## Шаг 6. Заполнить `.env`
-
-Минимум:
-
-```env
-TELEGRAM_BOT_TOKEN=...
-TELEGRAM_BOT_USERNAME=@your_bot
-REDIS_HOST=127.0.0.1
-REDIS_PORT=6379
-REDIS_DB=1
-MCP_HTTP_HOST=127.0.0.1
-MCP_HTTP_PORT=8787
-MCP_HTTP_PATH=/mcp
-MCP_HTTP_BEARER_TOKEN=choose-a-secret-token
-DISTRIBUTED_MODE=client
-WEBAPP_ENABLED=true
-```
-
-Если tmux использует нестандартный socket:
-
-```env
-TMUX_SOCKET_PATH=/tmp/tmux-1000/default
-```
-
-## Шаг 7. Проверить конфиг
-
-```bash
-tellymcp doctor --env .env
-```
-
-В standalone `client` режиме он должен проверить:
-
-- `tmux`
-- `.env`
-- Redis
-- локальный MCP bind
-- Playwright Chromium, если browser tools включены
-
-## Шаг 8. Запустить сервис
-
-```bash
-tellymcp run --env .env
-```
-
-Обычный standalone MCP endpoint:
-
-- `http://127.0.0.1:8787/mcp`
-
-## Шаг 9. Подключить MCP к агенту
-
-Чтобы получить готовый snippet:
-
-```bash
-tellymcp mcp --help
-```
-
-Типичный локальный endpoint:
-
-- `http://127.0.0.1:8787/mcp`
-
-Если используешь bearer auth, агент должен подключаться с тем же токеном, что и в `.env`.
-
-## Шаг 10. Привязать агента к Telegram
-
-После подключения MCP можно просто написать агенту:
-
-- `привяжись к Telegram`
-- `подключись к Telegram`
-- `свяжи эту сессию с Telegram`
-- `создай код привязки к Telegram`
-
-Ожидаемый flow:
-
-1. агент вызывает `create_session_pair_code`
-2. отдаёт короткий код
-3. ты отправляешь боту `/start <code>` или `/link <code>`
-4. после успеха открываешь `/menu`
-
-Если агент работает внутри `tmux`, ему желательно передать:
-
-- `cwd`
-- имя tmux-сессии
-- tmux window/pane атрибуты
-
-Тогда `Live` и `nudge` заработают сразу.
-
-## Шаг 11. Что будет после pairing
-
-После привязки Telegram можно использовать для:
-
-- inbox
-- вопросов к человеку
-- local partner collaboration
-- переключения сессий
-- просмотра storage
-- Live View
-
-Агент сможет:
-
-- вызывать `ask_user_telegram`
-- читать несвязанные входящие сообщения
-- отправлять note и файлы
-- получать tmux `nudge`, когда появляется новая работа
-
-## Что работает без tmux
-
-TellyMCP можно запустить и без `tmux`, но это урезанный режим.
-
-Не будет:
-
-- Live View
-- tmux `nudge`
-- прямого управления из Telegram Mini App
-
-Такой режим стоит использовать только если тебя устраивает пассивная работа.
-
-## Troubleshooting
-
-Если `doctor` ругается:
-
-- проверь, что Redis запущен
-- проверь, что установлен `tmux`
-- проверь правильность bot token
-- проверь, что bearer token совпадает с MCP-конфигом агента
-
-Если pairing работает, а Live View нет:
-
-- убедись, что агент действительно запущен внутри `tmux`
-- убедись, что у tmux-сессии есть стабильное имя
-- при необходимости задай `TMUX_SOCKET_PATH`
-
-Если агент не может подключиться к MCP:
-
-- проверь, что `tellymcp run --env .env` действительно запущен
-- проверь endpoint `http://127.0.0.1:8787/mcp`
-- проверь bearer token
-
-## Следующий шаг
-
-Когда standalone уже работает, дальше можно переходить к:
-
-- `gateway`
-- или `both`
-
-Это нужно только если нужен `Collab` между машинами.