Hermes Agent & Hedonist Orchestrator(Фірмова автономна архітектура Telegram-оркестрації)

1. Огляд концепції та системна проблема

Більшість ідей, посилань для дослідження та оперативних задач виникають у розробника або фаундера на ходу — у смартфоні. Проте робоча інфраструктура (сервери, кодові бази, локальні нотатки Obsidian, термінали) залишається прив'язаною до робочого ноутбука:

1. Високий поріг старту рутини: Щоб запустити парсинг новин чи перевірити статус бекапу на сервері, доводиться відкривати ноутбук, підключатися через SSH і запускати скрипти вручну.
2. Фрагментація вхідного потоку: Посилання губляться у «Збереженому» в месенджері без аналізу та категоризації.
3. Залежність від чужих SaaS-рішень: Використання комерційних сервісів не дає повного контролю над системними ключами та приватними даними.

Hermes Agent & Hedonist Orchestrator створюють суверенний цифровий міст: ви взаємодієте зі своєю персональною інфраструктурою та передовими моделями штучного інтелекту через звичний інтерфейс Telegram так само природно, як із колегою в чаті.

2. Архітектурна таксономія та ментальна модель

Архітектура побудована за модульним принципом із чотирма ізольованими шарами:

• 1. Шлюз автентифікації та роутингу (Hedonist Gateway): Точка входу для Webhook-подій Telegram. Здійснює жорстку перевірку білого списку ALLOWED_TELEGRAM_USER_IDS та криптографічних підписів. Працює як диспетчер: аналізує вхідний текст/аудіо через швидку модель (Gemini Flash або Claude Haiku) і визначає цільовий пайплайн.
• 2. Агентське ядро виконання (Hermes Core): Автономний воркер, що має доступ до інструментів: виклику curl/bash, веб-скрейпінгу, взаємодії з Git-репозиторіями та генерації коду.
• 3. Шар знань та довготривалого контексту (Knowledge Vault): Локальне сховище Markdown-файлів (синхронізоване з особистим сховищем Obsidian), реляційна база фактів SQLite та векторні індекси для семантичного пошуку.
• 4. Підсистема сповіщень та зворотного зв'язку (Feedback Loop): Форматування відповідей у чистий Telegram MarkdownV2 з інтерактивними Inline-кнопками для підтвердження критичних дій (Human-in-the-Loop).

3. Технічний пайплайн та внутрішня механіка

Життєвий цикл виконання команди розгортається наступним чином:

1. Ingress & Authentication (Прийом та перевірка): Telegram надсилає JSON-пейлоад на захищений HTTPS-ендпоінт. Hedonist перевіряє User ID. Якщо запит надійшов від неавторизованого користувача, він миттєво відкидається (Drop without response) для запобігання скануванню.
2. Intent Parsing & Context Fetching (Парсинг наміру): Оркестратор класифікує задачу (наприклад: cmd:server_health, digest:url_scrape, note:create). Якщо це дослідження, з Knowledge Vault підтягуються релевантні нотатки та контекст попередніх сесій.
3. Execution & Sandboxed Processing (Виконання завдання): Hermes запускає відповідний скрипт або формує запит до LLM у межах ізольованого Docker-контейнера. Довготривалі операції переводяться в асинхронний режим з відправкою статусу typing або проміжного повідомлення.
4. Delivery & State Commit (Відповідь та фіксація стану): Користувач отримує структуровану відповідь з ключовими тезами, а створений артефакт (нотатка, звіт чи diff коду) автоматично комітиться в локальний Git-репозиторій.

4. Практичні інженерні сценарії в продакшені

01. Мобільний DevOps-пульт сервера 24/7

Ви помічаєте сповіщення про сплеск навантаження на VPS. Відправивши коротке повідомлення боту, ви отримуєте вивід docker stats, статус сервісів у реальному часі та кнопку «Перезавантажити Nginx», не відкриваючи термінал.

02. Deep Research та автоматична підготовка дайджестів

Ви надсилаєте в Telegram-чат посилання на 50-сторінковий PDF або статтю. Hermes Agent завантажує сторінку в headless-режимі, вирізає контент без реклами, синтезує головні архітектурні інсайти і додає їх у чергу публікацій вашого каналу або блогу.

03. Двостороння синхронізація думок з Obsidian

Голосове повідомлення на ходу транскрибується, структурується моделлю на тези, категоризується тегами та записується новим файлом у папку Daily Notes персонального репозиторію з автоматичним git push.

5. Підводні камені, типові помилки та безпека

• Ризик неавторизованого доступу (Open Bot Risk): Якщо бот не має суворо захардкодженного списку дозволених ID на найпершому рядку обробника, сторонній користувач може віддати команду на видалення бази даних.
• Блокування Event Loop довгими LLM-запитами: Синхронне очікування відповіді моделі протягом 30 секунд блокує обробку повідомлень від інших тригерів або таймаутів. Усі взаємодії повинні бути суто асинхронними (async/await або черги задач).
• Telegram Markdown Parsing Errors: Символи на кшталт _, *, [, ] у виводі коду часто ламають рендеринг Telegram Bot API (помилка Bad Request: can't parse entities). Необхідно використовувати надійну функцію санітизації або надсилати сирий код у блоках pre.