v2026.02.27 — FastMCP (Phase 19)

FastMCP — 7 MCP субмодулей

Полная миграция на FastMCP фреймворк.

Новые модули (184 tools)

• tg-chat (52) — сообщения, чаты, callbacks
• tg-media (16) — фото, видео, аудио, документы
• tg-calendar (23) — календарь, записи, цепочки
• tg-polls (13) — опросы, реакции, обновления
• tg-commerce (28) — боты, звёзды, подарки, предсказания
• tg-app (18) — веб-приложение, роли, страницы
• tg-utils (34) — шаблоны, команды, баланс, статистика

Docker

Один Docker image tg-fastmcp:latest, модуль выбирается через MODULE env var.

Подход

FastMCP.from_openapi() с фильтрацией роутов + clean_operation_ids() для чистых имён tools.

v2026.02.23 — Chat Hubs + Pinned Messages

Что нового

Chat Hubs

• Главный хаб упрощён: только баннеры + список чатов с краткой сводкой активности
• Каждый чат получил полноценный хаб /c/{chat_id}: temporal events с orbital-визуализацией, Democracy/governance, Integrat плагины, привязанные страницы
• Обратная совместимость: /chat/{id} → 301 redirect на /c/{id}

Живые закрепы (Pinned Messages)

• PNG-баннеры генерируются через Playwright (HTML→PNG, 800×400, BeeWeb стиль)
• Отправка фото + inline keyboard + бесшумное закрепление
• Типы: default (статистика чата), democracy (governance), chart (заглушка для графиков)
• Cron автообновление (настраиваемый интервал)
• API: POST /init, POST /update, GET, PUT config
• Deep link кнопки открывают Mini App (t.me/Bot/App?startapp=c_CHATID)

Прочее

• Integrat перенесён из хаба в профиль
• twa.js: обработка start_param с префиксом c_ для deep link чат-хабов
• K8s: MINIAPP_URL, DEMOCRACY_URL env vars, memory limit 1Gi для Playwright
• Исправлено: EditMessageCaptionIn — добавлены direct_messages_topic_id, suggested_post_parameters

v2026.02.22

v2026.02.22

Крупное обновление: система хендлеров, Bee Design System, Page Manager, маркетплейс и интеграция с модулями Democracy/Datesale.

Handler System — автодискавери типов страниц

• Архитектура auto-discovery из каталога handlers/
• 16 типов страниц: prediction, calendar, governance, llm, infra, k8s, metrics, arena, planner, bcs, channel, marketplace, developer, datesale, profile, chat
• Каждый хендлер: шаблон, load_data(), proxy routes, config schema
• Cross-namespace proxy к бэкенд-модулям (llmcore, arenacore, plannercore и др.)

Bee Design System — UI toolkit + визуальные эффекты

• bee-kit.js — poll() с skeleton crossfade, sheet(), stale(), accordions, haptic feedback
• bee-fx.js — countUp, revealText, fadeIn, spotlight, clickSpark, ripple (порт react-bits → vanilla JS)
• CSS-эффекты — shiny, gradient-text, star-border, glare, glitch, fade-in
• Skeleton loading — shimmer-плейсхолдеры вместо "Loading...", smooth crossfade
• Apache ECharts 6.0.0 — SVG renderer, графики для LLM costs, stock indices
• test-fx.html — 33 теста + 6 бенчмарков, Puppeteer-совместимый

Новые веб-страницы (Mini App)

• Marketplace — каталог плагинов, поиск, категории, профили авторов
• Developer Cabinet — управление API-ключами, аналитика, эндпоинты, монетизация
• Governance — голосования, предложения, казна, конституция (proxy к Democracy)
• Дашборды модулей — Metrics, Arena, Planner, BCS, Channel, K8s (owner-only)
• Profile, Chat, Datesale — пользовательские страницы

Page Manager — мониторинг страниц (порт 8088)

• Standalone дашборд для разработки и отладки
• Phone preview — iframe в мобильной рамке с реальным initData
• Генерация HMAC-SHA256 подписанного initData для proxy-превью
• JS interceptor для перехвата fetch/XHR из iframe
• Preview As — переключение пользователя для просмотра
• Access simulation — проверка доступа по user_id/ролям
• Health monitoring — проверка хендлеров, шаблонов, конфигов
• OLED dark дизайн с Bee-UI компонентами

Access Control System

• Трёхуровневый контроль: chat-based, role-based, user-based
• check_page_access(), get_access_reasons() — отладка доступа
• Интеграция с Page Manager для симуляции

Тесты

• test_handlers.py, test_access.py, test_integration.py, test_smoke.py
• 198+ unit-тестов на access control
• GitHub Actions: web-tests job

Документация

• UI-GUIDE.md — полный гайд по Bee Design System (865 строк)
• WEBDEV.md — туториал по созданию новых страниц с хендлерами
• access-control.md — дизайн системы доступа

v2026.02.21 — Bee Design System + Owner Dashboards

Bee Design System

Полная система переиспользуемых компонентов для Telegram Mini App.

UI Toolkit (bee-kit.js)

• BeeKit.poll() — data polling с skeleton crossfade, stale detection, auto-retry
• BeeKit.sheet — bottom sheet с toolbar (фильтры, сортировка)
• BeeKit.stale — stale data indicator banner
• BeeKit.initAccordions() — auto-init аккордеонов
• [data-haptic] — автоматический haptic feedback

Визуальные эффекты (bee-fx.js)

Портировано из react-bits в vanilla JS:

• BeeFX.countUp() — анимация чисел
• BeeFX.revealText() — посимвольное раскрытие
• BeeFX.initFadeIn() — каскадное появление при скролле
• BeeFX.initSpotlight() — подсветка за пальцем
• BeeFX.clickSpark() — Canvas искры при тапе
• BeeFX.initRipple() — Material Design ripple

CSS-эффекты

.bee-shiny · .bee-gradient-text · .bee-star-border · .bee-glare · .bee-glitch · .bee-fade-in · .bee-ripple

Skeleton Loading

Анимированные shimmer-плейсхолдеры + crossfade к контенту (double rAF).

Apache ECharts 6.0.0

SVG renderer, lazy-load через {% block head_libs %}.

---

Owner-only дашборды (Mini App)

6 новых страниц мониторинга модулей:

• Metrics — FX & Crypto, market data, stock indices ECharts
• Arena — matches, leaderboard, species, predictions
• Planner — budget, tasks, triggers, schedules, task log
• BCS — портфели, позиции, P&L
• Channel — каналы, статистика
• K8s — кластер, namespace'ы, поды

Cross-namespace proxy (module_proxy.py) с owner-only access через initData.

---

Тесты

test-fx.html — самодостаточный browser test runner:

• 33 функциональных теста (countUp, revealText, fadeIn, ripple, spotlight, sheet, stale)
• 6 перформанс-бенчмарков с порогами

---

Документация

• web-ui/docs/UI-GUIDE.md — полное руководство разработчика Bee UI
• web-ui/docs/CHANGELOG.md — лог изменений web-ui
• Обновлены: README.md, docs/web-ui.md, CHANGELOG.md

29 файлов, +5228 строк

v2026.02.20 — Hub v2, контроль доступа, стандартизация layout

Hub v2 — Орбитальная система эмодзи

• Орбитальные визуальные панели — анимированные эмодзи вокруг карточек (звезда + до 5 орбит)
• Hover/touch раскрытие — орбиты скрыты по умолчанию, раскрываются при наведении (desktop) или long-press (mobile)
• LLM-генерация эмодзи — тематический подбор через llama3:8b / llmcore
• Две секции — «Активные» (временные) и «Постоянные»
• Аватарки чатов — фото чата-источника вместо иконки-пина
• Поиск и фильтры — по типу, источнику, сортировка (дедлайн, популярность, новизна)
• Промо-баннеры — баннеры в Hub с админкой (CRUD)

Контроль доступа

• Вебхук-события — обработка chat_member/my_chat_member (вступление/выход из чата)
• Live getChatMember — проверка членства через Telegram Bot API в реальном времени с кэшированием в БД
• RBAC — глобальные роли (project_owner, tester, moderator, backend_dev) с API управления

Стандартизация 3-тирного layout

Все 12 шаблонов теперь следуют единой структуре:

• Tier 1: Sticky bee-bar (рендерится всегда, аватар условно)
• Tier 2: Контекстная зона (bee-hex-bg заголовок)
• Tier 3: Контент страницы

Исправлено: error.html (добавлен бар + контекст), profile.html (аватар перенесён в Tier 2)

Инфраструктура

• Документация сетевой архитектуры (VDS socat-прокси, Tailscale mesh)
• vds_proxy.sh — автоматика деплоя systemd units на VDS
• Реестр нод (nodes.json) с API-эндпоинтом
• K8s: tgweb SSL hostPath, обновление configmap

---

45 файлов, 5671 добавлений(+), 174 удалений(-)

v2026.02.19 — LLM Infrastructure Dashboard

LLM Infrastructure Dashboard (Mini App)

Новая страница мониторинга LLM-инфраструктуры для Telegram Mini App.

Добавлено

• Шаблон infra.html — полный дашборд:
  • Cluster Overview, Fleet, Performance gauges (CPU/Capacity)
  • Job Queue, Running Jobs, Costs (USD)
  • Auto-refresh 10s без мерцания
• All Models sheet — каталог моделей кластера:
  • Агрегация по устройствам с device tags
  • Сортировка: Popular, A-Z, Size, Devices
  • Фильтр по устройству
• Иконки производителей через Simple Icons:
  • Alibaba Cloud (Qwen), Meta (Llama), Google (Gemma), Microsoft (Phi), HuggingFace, Mistral AI
• Прокси GET /p/{slug}/infra/data с access control
• Design doc docs/access-control.md — будущая система доступов

v2026.02.18 — K8s Support, Webhook Proxy

Что нового

K8s / K3s deployment

• hostPort: 8443 для tgweb (SSL Mini App) — совместимо с kube-proxy
• Kustomize labels (project, module)
• secret.yaml → .gitignore + secret.yaml.example

Webhook proxy

• POST /telegram/webhook и POST /telegram/webhook/{bot_id} — проксирование через tgweb → tgapi

Исправления

• SQL: ON CONFLICT ... WHERE telegram_message_id IS NOT NULL — корректная обработка NULL

Деплой

kubectl apply -k telegram-mcp/k8s/   # автономный
# или как часть NeuronSwarm full-stack

v2026.02.17 — Bot API 9.4 | 128 MCP | 173 Endpoints

Bot API 9.1–9.4 — полная поддержка

Масштабная реализация всех методов Bot API 9.1–9.4 по 5 слоям архитектуры: Telegram Client, Pydantic Models, FastAPI Routers, MCP Tools, Python SDK.

Ключевые цифры

Метрика	Было	Стало
MCP-инструменты	78	128
API-эндпоинты	~92	173
SDK-методы	~77	~95
Роутеры	14	20
MCP-модули	12	17

Bot API 9.4

• setMyProfilePhoto / removeMyProfilePhoto — фото профиля бота
• getUserProfileAudios — аудио профиля пользователя
• editUserStarSubscription — управление Star-подписками
• Стилизованные кнопки: button_style (primary, danger, success) + icon_custom_emoji_id

Bot API 9.3

• sendMessageDraft — черновики для стриминга LLM
• getUserGifts / getChatGifts — подарки
• postStory / editStory / deleteStory / repostStory — истории
• Форум-топики: создание, редактирование, закрытие, удаление

Bot API 9.2

• approveSuggestedPost / declineSuggestedPost — предложенные посты
• direct_messages_topic_id — маршрутизация в топики (~22 модели)
• suggested_post_parameters — параметры предложенных постов (~22 модели)

Bot API 9.1

• sendChecklist / editMessageChecklist — интерактивные чек-листы
• getMyStarBalance — баланс звёзд бота
• giftPremiumSubscription — подарки премиум-подписок
• Расширенные опросы — до 12 вариантов ответа

Мультибот

• Полная мультибот-архитектура: реестр, маршрутизация, авто-регистрация
• bot_id во всех send/webhook/commands/stars эндпоинтах

Расширенные медиа

• sendAnimation, sendAudio, sendVoice, sendSticker, sendVideoNote
• sendVenue, sendContact, sendDice, sendLocation, sendPaidMedia
• sendMediaGroup, forwardMessages, copyMessages
• message_effect_id, show_caption_above_media

Исправления

• SDK: is_personal → is_public в set_my_profile_photo()

36 файлов изменено, +5001/-423 строк

Полный changelog

v2026.02.16: Calendar v3 + Simple Icons

📅 Calendar v3 — триггеры, бюджет, 3300+ SVG-иконок

Новое

Calendar v3 (DB + API):

• Триггеры и действия: trigger_at, action (Telegram-уведомления, webhook, бюджет)
• Мониторы: крипто/погода/API с автосозданием записей (tick_interval, tick_count)
• entry_type: event, task, reminder, note, trigger, monitor
• Бюджет: budget_limit, budget_spent, прогресс-бар в UI
• Поле icon TEXT — привязка Simple Icons к записям

Simple Icons (3300+ SVG):

• Локальная раздача SVG-иконок брендов (Bitcoin, Telegram, GitHub…)
• Python-резолвер с алиасами (btc → bitcoin) и ключевыми словами
• API: GET /api/icons/resolve?name=..., /static/icons/{slug}.svg
• Entry-level иконки: SVG с фирменным цветом вместо emoji в заголовке
• Кастомные виджеты через metadata.widgets: [{label, value, icon}]
• Скрипт генерации: web-ui/scripts/extract-icons.js (из npm simple-icons)

MCP (+7 инструментов → 78 всего):

• icons.resolve — проверка доступности SVG-иконки по имени/алиасу
• calendar.create_trigger, calendar.create_monitor — специализированные инструменты
• Поле icon в calendar.create_entry, calendar.update_entry, calendar.bulk_create
• metadata описания обновлены: widgets: [{label, value, icon}]

Web-UI (Mini App):

• Entry-level иконки: SVG с brand-цветом фоном (22px rounded square)
• Кастомные виджеты из metadata.widgets с иконками
• Бюджет: прогресс-бар расходов/лимита
• Тик-информация для мониторов

SDK (Python):

• 5 методов календаря: create_calendar_entry, update_calendar_entry, list_calendar_entries, get_calendar_entry, delete_calendar_entry
• Хелпер _put для PUT-запросов

Инфраструктура

• tgmcp → tgweb: HTTPS + NODE_TLS_REJECT_UNAUTHORIZED=0 (внутренний Docker TLS)
• .gitignore: исключены генерируемые SVG (~15MB, 3393 файла)
• mcp/src/config.ts: webBase для обращений к tgweb

---

Файлов изменено: 30 | +2913 строк | 78 MCP-инструментов

Полный CHANGELOG · Документация иконок

v2026.02.15: Calendar v2

📅 Calendar v2 — полнофункциональный календарь в Mini App

Новое

Web-UI (Telegram Mini App):

• Месячная сетка с цветными точками событий + переключение на список
• Полноэкранная детализация: эмодзи, бейджи (приоритет, статус, AI), время, описание, теги, создатель
• Поиск и фильтры: текст, статус, приоритет, теги, создатель
• Эмодзи-пикер: 64 эмодзи в 8 категориях
• Аватарки создателей: Claude 🤖, GPT 🧠, Gemini ✨, Llama 🦙 + пользователи 👤
• Аватарка чата через Telegram Bot API getFile (кэш 1 час)
• Профиль пользователя из Telegram.WebApp.initDataUnsafe
• Админ-панель: FAB, форма создания/редактирования, Выполнено / Удалить

API & DB:

• Таблицы: calendars, calendar_entries (emoji, priority, tags, ai_actionable), calendar_history
• CRUD API с историей изменений, bulk-операции, preview
• Pydantic-модели с emoji, приоритетами, тегами, AI-флагом

MCP (+14 инструментов, теперь 71 всего):

• calendar.create, calendar.list, calendar.create_entry, calendar.list_entries
• calendar.get_entry, calendar.get_chain, calendar.update_entry, calendar.move_entry
• calendar.set_status, calendar.delete_entry, calendar.entry_history
• calendar.bulk_create, calendar.bulk_delete, calendar.upcoming

Безопасность

• XSS-защита: escapeHtml() для пользовательских данных
• HMAC-SHA256 валидация initData на proxy-эндпоинтах
• created_by атрибуция (admin:{user_id} / ai:{model})

Изменено

• Порт tgweb по умолчанию: 8090 → 8443 (TLS обязателен)

---

Файлов изменено: 24 | +4557 строк

Полный CHANGELOG