hermes-vk-community 1.0.2__tar.gz

hermes_vk_community-1.0.2/.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+.coverage
+.pytest_cache/
+.ruff_cache/
+.venv/
+.pyright/
+__pycache__/
+*.py[cod]
+build/
+dist/
+htmlcov/
+release-corpus/result.json
+.env
+.env.*
+!.env.example

hermes_vk_community-1.0.2/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: hermes-vk-community
+Version: 1.0.2
+Summary: VK Community Long Poll platform plugin for Hermes Agent
+Author: Hermes VK Community contributors
+License: MIT
+Requires-Python: <3.14,>=3.11
+Requires-Dist: aiohttp>=3.14.1
+Requires-Dist: aiosqlite==0.22.1
+Requires-Dist: filetype==1.2.0
+Requires-Dist: hermes-agent>=0.18.2
+Requires-Dist: markdown-it-py<5,>=4.0.0
+Requires-Dist: packaging<27,>=24
+Requires-Dist: pillow==12.2.0
+Requires-Dist: pydantic-settings<3,>=2.7.0
+Requires-Dist: pydantic<3,>=2.10.0
+Requires-Dist: tenacity==9.1.4
+Description-Content-Type: text/markdown
+
+# Hermes VK Community
+
+Плагин платформы [Hermes Agent](https://github.com/NousResearch/hermes-agent),
+который подключает личного агента к сообщениям бота сообщества VK через
+Community Long Poll API.
+
+Проверяемый диапазон Hermes: `>=0.18.2,<0.19`.
+
+Hermes `0.18.2` сам фиксирует `cryptography==46.0.7` и `Pillow==12.2.0`, для
+которых опубликованы advisory с исправлениями в `48.0.1` и `12.3.0`.
+До совместимого upstream-релиза supply-chain gate содержит только точечные
+исключения конкретных advisory ID; расширять версии на стороне плагина нельзя,
+поскольку это сделает dependency graph с Hermes `0.18.2` неразрешимым.
+
+## Быстрая настройка
+
+После установки плагина включите его и запустите мастер:
+
+```bash
+hermes plugins enable vk-community
+hermes gateway setup
+```
+
+В списке платформ выберите **VK Community**. Тот же мастер можно запустить
+напрямую:
+
+```bash
+hermes vk setup
+```
+
+Мастер:
+
+1. расскажет, какие настройки включить в сообществе и какие права выдать ключу;
+2. примет ключ без отображения введённых символов;
+3. примет обычные ссылки на сообщество и профили пользователей;
+4. сам получит числовые VK ID;
+5. с подтверждением сделает сообщество приватным и включит сообщения;
+6. включит Community Long Poll `5.199` и событие входящего сообщения;
+7. проверит ключ, доступ к сообществу, пользователей и итоговые настройки;
+8. сохранит секрет и конфигурацию в активный профиль Hermes.
+
+Если проверка не пройдёт, мастер не сохраняет локальную конфигурацию. Уже
+подтверждённые изменения сообщества могут быть применены VK до последующей
+ошибки проверки; повторный запуск безопасен, потому что настройки идемпотентны.
+
+## Создание сообщества и ключа
+
+Подойдёт в том числе закрытое сообщество, в котором состоите только вы.
+
+1. [Создайте сообщество VK](https://vk.com/groups) или откройте его управление.
+2. Включите **Сообщения сообщества**.
+3. Настройки Long Poll можно оставить мастеру. При ручной настройке откройте
+   **Управление → Настройки → Работа с API → Long Poll API**, включите Long
+   Poll, выберите API `5.199` и отметьте только событие входящего сообщения
+   (`message_new`). Другие типы событий текущему адаптеру не нужны.
+4. Там же откройте **Ключи доступа** и создайте ключ сообщества.
+5. Выберите права:
+   - управление сообществом;
+   - сообщения сообщества;
+   - фотографии сообщества;
+   - документы сообщества.
+
+Права на истории, стену, товары и заказы плагину не нужны. Права на фотографии
+и документы используются реальными upload-flow: фото, обычные документы и
+голосовые сообщения/TTS отправляются как нативные вложения VK. Для голоса
+плагин преобразует исходное аудио в OGG/Opus через `ffmpeg`; если VK отклонит
+voice-flow, безопасный fallback отправляет ZIP-документ без потери исходных байт.
+
+Официальная отправная точка: [боты VK — начало работы](https://dev.vk.com/ru/api/bots/getting-started).
+
+## Где взять ID
+
+Вручную извлекать числовые ID не обязательно: мастер принимает ссылки.
+
+- `https://vk.com/club240186772` → ID сообщества `240186772`;
+- `https://vk.com/id7750207` → ID пользователя `7750207`;
+- `https://vk.com/shkarupa.alex` → мастер запросит числовой ID через VK API;
+- короткая ссылка сообщества с собственным именем тоже разрешается через API.
+
+Можно указать несколько разрешённых профилей через запятую. Пустой список
+запрещён: доступ к личному агенту закрыт по умолчанию.
+
+## Где хранится ключ
+
+Как и Telegram-токен в Hermes, ключ VK хранится под именем
+`VK_COMMUNITY_TOKEN` в `.env` **активного профиля Hermes**, а не в YAML:
+
+- профиль по умолчанию: обычно `~/.hermes/.env`;
+- именованный профиль: его собственный каталог профиля и собственный `.env`.
+
+Hermes устанавливает секретный scope конкретного профиля перед запуском
+адаптера. Плагин читает ключ только через этот scope, поэтому при нескольких
+профилях ключ одного профиля не подменит ключ другого.
+
+Несекретные значения мастер записывает в `config.yaml` активного профиля:
+
+```yaml
+platforms:
+  vk:
+    enabled: true
+    group_id: 240186772
+    allowed_user_ids:
+      - 7750207
+    typing_indicator: true
+```
+
+Ключ, помещённый в `.env` этого репозитория, предназначен только для локальных
+тестов разработчика. Он не переносится в профиль Hermes автоматически. При
+обычной установке вводите ключ в мастере — тот использует штатную атомарную
+запись секретов Hermes.
+
+## Разработка без установленного пользователем Hermes
+
+Глобально или в пользовательскую установку Hermes ничего ставить не требуется.
+`uv` создаёт изолированное окружение проекта и устанавливает совместимую версию
+Hermes как зависимость плагина:
+
+```bash
+uv sync --all-packages
+uv run pytest packages/hermes-vk-community/tests
+uv run ruff check packages/hermes-vk-community
+uv run pyright packages/hermes-vk-community
+```
+
+То есть тесты можно запускать до установки Hermes пользователем. Полностью без
+кода Hermes проверить платформенный плагин нельзя: его контракт содержит классы
+адаптеров, реестр платформ и профильное хранилище секретов. Изолированная `.venv`
+решает это без изменения рабочей установки пользователя.
+
+Для реальной end-to-end проверки всё равно нужны сеть, сообщество и тестовое
+сообщение. Мастер уже выполняет безопасную часть live-проверки: API, права,
+разрешение ID и получение Long Poll server.
+
+## Ручная настройка
+
+Если мастер использовать нельзя, добавьте `VK_COMMUNITY_TOKEN` в `.env`
+активного профиля и внесите показанный выше блок `platforms.vk` в его
+`config.yaml`. Не помещайте токен в YAML: валидатор плагина намеренно отклоняет
+такую конфигурацию.
+
+После изменения перезапустите gateway и напишите со своего разрешённого профиля
+в сообщения сообщества:
+
+```bash
+hermes gateway restart
+```
+
+Hermes передаёт адаптеру Markdown. Live-проверенный профиль API `5.199`
+использует Unicode codepoint offsets и компилирует
+`bold`/`italic`/`underline`/`url` в `format_data`; заголовки становятся жирными. Цитаты
+передаются как `▎` плюс курсив, списки — как Unicode-маркеры с отступами.
+Markdown-таблицы всегда рендерятся в JPEG и отправляются фотографиями. Поэтому
+смешанный ответ может стать упорядоченной серией сообщений: текст, таблица,
+следующий текст. Отдельная Markdown-картинка аналогично становится фото между
+текстовыми сообщениями. HTML и исходный Markdown в VK отправлять нельзя — клиент
+показывает их буквально.
+
+```bash
+hermes vk probe-formatting --peer-id <PRIVATE_TEST_PEER_ID> \
+  --output vk-formatting-format-data-probe.json
+```
+
+`auto` использует проверенный rich-профиль; явный `rich` доступен для API
+`5.199`, а `plain` оставлен как детерминированный fallback. Unknown profile/API
+по-прежнему переключает `auto` в plain и отклоняет явный rich. Probe проверяет
+send/edit, Unicode offsets и readback, после чего best-effort удаляет тестовые
+сообщения. Подробности и текущий проверенный профиль записаны в
+[`docs/vk-rich-text-compatibility.md`](docs/vk-rich-text-compatibility.md).
+
+Статус «печатает» отправляется через `messages.setActivity`, если
+`typing_indicator: true`; live-тест подтвердил и ответ API, и отображение в
+клиенте VK.
+
+Release live-матрица дополнительно проверяет DM reply на реальное входящее
+сообщение, pinned media download, `format_data`, inline keyboard, photo upload
+и восстановление подготовленного outbox после закрытия/повторного открытия
+SQLite. Для запуска нужны только `VK_COMMUNITY_TOKEN`, `VK_GROUP_ID` и
+`VK_TEST_PEER_ID`; тестовый пользователь должен предварительно прислать фото.
+
+## Интерактивность, длинные ответы и pairing
+
+Clarify-вопросы, подтверждения опасных команд и slash-confirm показываются как
+одноразовые VK-клавиатуры. Payload — случайный opaque nonce, связанный в памяти
+с разрешённым user ID, peer ID, сессией, допустимым действием и сроком жизни.
+Повторный, просроченный или скопированный payload отклоняется до Hermes.
+
+Длинные ответы и финализация streaming-preview поддерживают продолжения.
+Доставленные части не отправляются повторно после timeout/частичной ошибки;
+outbox сохраняет `random_id` и wire payload. После рестарта безопасные
+`prepared`-строки досылаются, а неоднозначные `sending` переводятся в
+`delivery_unknown` и доступны через `hermes vk doctor --delivery-unknown`.
+Ошибка VK `914` уменьшает рабочий лимит вплоть до 256 символов и кеширует его.
+
+Опциональный pairing включается в YAML:
+
+```yaml
+platforms:
+  vk:
+    pairing:
+      enabled: true
+      code_ttl_seconds: 600
+```
+
+Создайте одноразовый код командой `hermes vk pair` и отправьте его боту только
+текстом. В SQLite хранится SHA-256, а не сам код; вложения, forwards и payload
+от непривязанного пользователя не загружаются.
+
+## Диагностика
+
+`hermes vk doctor` проверяет discovery/enabled, secret scope, конфликты политики,
+identity сообщества, Community Long Poll, SQLite migration/schema, platform
+lock, formatting profile и media flow. Флаги `--inflight` и
+`--delivery-unknown` выводят только bounded идентификаторы и ошибки без текста
+сообщений и секретов.

hermes_vk_community-1.0.2/README.md

@@ -0,0 +1,214 @@
+# Hermes VK Community
+
+Плагин платформы [Hermes Agent](https://github.com/NousResearch/hermes-agent),
+который подключает личного агента к сообщениям бота сообщества VK через
+Community Long Poll API.
+
+Проверяемый диапазон Hermes: `>=0.18.2,<0.19`.
+
+Hermes `0.18.2` сам фиксирует `cryptography==46.0.7` и `Pillow==12.2.0`, для
+которых опубликованы advisory с исправлениями в `48.0.1` и `12.3.0`.
+До совместимого upstream-релиза supply-chain gate содержит только точечные
+исключения конкретных advisory ID; расширять версии на стороне плагина нельзя,
+поскольку это сделает dependency graph с Hermes `0.18.2` неразрешимым.
+
+## Быстрая настройка
+
+После установки плагина включите его и запустите мастер:
+
+```bash
+hermes plugins enable vk-community
+hermes gateway setup
+```
+
+В списке платформ выберите **VK Community**. Тот же мастер можно запустить
+напрямую:
+
+```bash
+hermes vk setup
+```
+
+Мастер:
+
+1. расскажет, какие настройки включить в сообществе и какие права выдать ключу;
+2. примет ключ без отображения введённых символов;
+3. примет обычные ссылки на сообщество и профили пользователей;
+4. сам получит числовые VK ID;
+5. с подтверждением сделает сообщество приватным и включит сообщения;
+6. включит Community Long Poll `5.199` и событие входящего сообщения;
+7. проверит ключ, доступ к сообществу, пользователей и итоговые настройки;
+8. сохранит секрет и конфигурацию в активный профиль Hermes.
+
+Если проверка не пройдёт, мастер не сохраняет локальную конфигурацию. Уже
+подтверждённые изменения сообщества могут быть применены VK до последующей
+ошибки проверки; повторный запуск безопасен, потому что настройки идемпотентны.
+
+## Создание сообщества и ключа
+
+Подойдёт в том числе закрытое сообщество, в котором состоите только вы.
+
+1. [Создайте сообщество VK](https://vk.com/groups) или откройте его управление.
+2. Включите **Сообщения сообщества**.
+3. Настройки Long Poll можно оставить мастеру. При ручной настройке откройте
+   **Управление → Настройки → Работа с API → Long Poll API**, включите Long
+   Poll, выберите API `5.199` и отметьте только событие входящего сообщения
+   (`message_new`). Другие типы событий текущему адаптеру не нужны.
+4. Там же откройте **Ключи доступа** и создайте ключ сообщества.
+5. Выберите права:
+   - управление сообществом;
+   - сообщения сообщества;
+   - фотографии сообщества;
+   - документы сообщества.
+
+Права на истории, стену, товары и заказы плагину не нужны. Права на фотографии
+и документы используются реальными upload-flow: фото, обычные документы и
+голосовые сообщения/TTS отправляются как нативные вложения VK. Для голоса
+плагин преобразует исходное аудио в OGG/Opus через `ffmpeg`; если VK отклонит
+voice-flow, безопасный fallback отправляет ZIP-документ без потери исходных байт.
+
+Официальная отправная точка: [боты VK — начало работы](https://dev.vk.com/ru/api/bots/getting-started).
+
+## Где взять ID
+
+Вручную извлекать числовые ID не обязательно: мастер принимает ссылки.
+
+- `https://vk.com/club240186772` → ID сообщества `240186772`;
+- `https://vk.com/id7750207` → ID пользователя `7750207`;
+- `https://vk.com/shkarupa.alex` → мастер запросит числовой ID через VK API;
+- короткая ссылка сообщества с собственным именем тоже разрешается через API.
+
+Можно указать несколько разрешённых профилей через запятую. Пустой список
+запрещён: доступ к личному агенту закрыт по умолчанию.
+
+## Где хранится ключ
+
+Как и Telegram-токен в Hermes, ключ VK хранится под именем
+`VK_COMMUNITY_TOKEN` в `.env` **активного профиля Hermes**, а не в YAML:
+
+- профиль по умолчанию: обычно `~/.hermes/.env`;
+- именованный профиль: его собственный каталог профиля и собственный `.env`.
+
+Hermes устанавливает секретный scope конкретного профиля перед запуском
+адаптера. Плагин читает ключ только через этот scope, поэтому при нескольких
+профилях ключ одного профиля не подменит ключ другого.
+
+Несекретные значения мастер записывает в `config.yaml` активного профиля:
+
+```yaml
+platforms:
+  vk:
+    enabled: true
+    group_id: 240186772
+    allowed_user_ids:
+      - 7750207
+    typing_indicator: true
+```
+
+Ключ, помещённый в `.env` этого репозитория, предназначен только для локальных
+тестов разработчика. Он не переносится в профиль Hermes автоматически. При
+обычной установке вводите ключ в мастере — тот использует штатную атомарную
+запись секретов Hermes.
+
+## Разработка без установленного пользователем Hermes
+
+Глобально или в пользовательскую установку Hermes ничего ставить не требуется.
+`uv` создаёт изолированное окружение проекта и устанавливает совместимую версию
+Hermes как зависимость плагина:
+
+```bash
+uv sync --all-packages
+uv run pytest packages/hermes-vk-community/tests
+uv run ruff check packages/hermes-vk-community
+uv run pyright packages/hermes-vk-community
+```
+
+То есть тесты можно запускать до установки Hermes пользователем. Полностью без
+кода Hermes проверить платформенный плагин нельзя: его контракт содержит классы
+адаптеров, реестр платформ и профильное хранилище секретов. Изолированная `.venv`
+решает это без изменения рабочей установки пользователя.
+
+Для реальной end-to-end проверки всё равно нужны сеть, сообщество и тестовое
+сообщение. Мастер уже выполняет безопасную часть live-проверки: API, права,
+разрешение ID и получение Long Poll server.
+
+## Ручная настройка
+
+Если мастер использовать нельзя, добавьте `VK_COMMUNITY_TOKEN` в `.env`
+активного профиля и внесите показанный выше блок `platforms.vk` в его
+`config.yaml`. Не помещайте токен в YAML: валидатор плагина намеренно отклоняет
+такую конфигурацию.
+
+После изменения перезапустите gateway и напишите со своего разрешённого профиля
+в сообщения сообщества:
+
+```bash
+hermes gateway restart
+```
+
+Hermes передаёт адаптеру Markdown. Live-проверенный профиль API `5.199`
+использует Unicode codepoint offsets и компилирует
+`bold`/`italic`/`underline`/`url` в `format_data`; заголовки становятся жирными. Цитаты
+передаются как `▎` плюс курсив, списки — как Unicode-маркеры с отступами.
+Markdown-таблицы всегда рендерятся в JPEG и отправляются фотографиями. Поэтому
+смешанный ответ может стать упорядоченной серией сообщений: текст, таблица,
+следующий текст. Отдельная Markdown-картинка аналогично становится фото между
+текстовыми сообщениями. HTML и исходный Markdown в VK отправлять нельзя — клиент
+показывает их буквально.
+
+```bash
+hermes vk probe-formatting --peer-id <PRIVATE_TEST_PEER_ID> \
+  --output vk-formatting-format-data-probe.json
+```
+
+`auto` использует проверенный rich-профиль; явный `rich` доступен для API
+`5.199`, а `plain` оставлен как детерминированный fallback. Unknown profile/API
+по-прежнему переключает `auto` в plain и отклоняет явный rich. Probe проверяет
+send/edit, Unicode offsets и readback, после чего best-effort удаляет тестовые
+сообщения. Подробности и текущий проверенный профиль записаны в
+[`docs/vk-rich-text-compatibility.md`](docs/vk-rich-text-compatibility.md).
+
+Статус «печатает» отправляется через `messages.setActivity`, если
+`typing_indicator: true`; live-тест подтвердил и ответ API, и отображение в
+клиенте VK.
+
+Release live-матрица дополнительно проверяет DM reply на реальное входящее
+сообщение, pinned media download, `format_data`, inline keyboard, photo upload
+и восстановление подготовленного outbox после закрытия/повторного открытия
+SQLite. Для запуска нужны только `VK_COMMUNITY_TOKEN`, `VK_GROUP_ID` и
+`VK_TEST_PEER_ID`; тестовый пользователь должен предварительно прислать фото.
+
+## Интерактивность, длинные ответы и pairing
+
+Clarify-вопросы, подтверждения опасных команд и slash-confirm показываются как
+одноразовые VK-клавиатуры. Payload — случайный opaque nonce, связанный в памяти
+с разрешённым user ID, peer ID, сессией, допустимым действием и сроком жизни.
+Повторный, просроченный или скопированный payload отклоняется до Hermes.
+
+Длинные ответы и финализация streaming-preview поддерживают продолжения.
+Доставленные части не отправляются повторно после timeout/частичной ошибки;
+outbox сохраняет `random_id` и wire payload. После рестарта безопасные
+`prepared`-строки досылаются, а неоднозначные `sending` переводятся в
+`delivery_unknown` и доступны через `hermes vk doctor --delivery-unknown`.
+Ошибка VK `914` уменьшает рабочий лимит вплоть до 256 символов и кеширует его.
+
+Опциональный pairing включается в YAML:
+
+```yaml
+platforms:
+  vk:
+    pairing:
+      enabled: true
+      code_ttl_seconds: 600
+```
+
+Создайте одноразовый код командой `hermes vk pair` и отправьте его боту только
+текстом. В SQLite хранится SHA-256, а не сам код; вложения, forwards и payload
+от непривязанного пользователя не загружаются.
+
+## Диагностика
+
+`hermes vk doctor` проверяет discovery/enabled, secret scope, конфликты политики,
+identity сообщества, Community Long Poll, SQLite migration/schema, platform
+lock, formatting profile и media flow. Флаги `--inflight` и
+`--delivery-unknown` выводят только bounded идентификаторы и ошибки без текста
+сообщений и секретов.

hermes_vk_community-1.0.2/docs/vk-rich-text-compatibility.md

@@ -0,0 +1,77 @@
+# VK rich-text compatibility
+
+Live capability profile for the `hermes-vk-community` release gate.
+
+## Tested profile
+
+- Date: 2026-07-15
+- VK API: `5.199`
+- Transport: community token, `messages.send` and `messages.edit`
+- Community: private group
+- Client observation: VK Web; the UI did not expose an exact build number
+- Machine artifact:
+  `tests/fixtures/vk/formatting/live-probe-format-data-2026-07-15.json`
+- Certified profile: `format-data-v1`, using Unicode codepoint offsets
+
+## Live results
+
+| Candidate | API/readback | VK Web |
+| --- | --- | --- |
+| `format_data` bold, italic, underline, URL | accepted and returned | styled correctly |
+| nested ranges | accepted and returned | styled correctly |
+| partially overlapping ranges | accepted and returned | styled correctly |
+| `messages.edit` plus `format_data` | accepted and returned | styled correctly |
+| raw HTML | accepted as text | tags displayed literally |
+| raw Markdown | accepted as text | markers displayed literally |
+| 4096 Cyrillic characters | exact length/hash readback | accepted |
+| bare HTTPS URL | exact readback | clickable |
+| `messages.setActivity(type="typing")` | response `1` | visibly displayed |
+| Unicode-codepoint emoji-adjacent ranges | accepted and returned | intended bold/underline ranges |
+| UTF-16 emoji-adjacent ranges | accepted and returned | same intended ranges in VK Web |
+
+The live Unicode probe established that the renderer's Unicode-codepoint
+payload styles the intended emoji-adjacent ranges in VK Web. The competing
+UTF-16 payload was also normalized/displayed as intended by the tested client;
+this does not change the wire contract emitted by the plugin. Python string
+indices are therefore certified for API `5.199`, while both probe cases remain
+in the regression artifact for future client/API reverification.
+
+## Rendering profile
+
+- Compile Markdown locally; never send raw HTML or Markdown markup.
+- Map bold, italic and links to `format_data` version 1. Underline is supported
+  by the wire profile even though standard Markdown has no underline node.
+- Render headings as bold text.
+- Render quotes as `▎ ` followed by italic text.
+- Render unordered and ordered lists with Unicode bullets/numbers and preserve
+  nesting with spaces.
+- Render every Markdown table locally as one or more RGB JPEG images. JPEG is
+  the only table wire representation, independent of formatting mode.
+- Lower a standalone Markdown image to a VK photo attachment. Keep an inline
+  image embedded in a text line as an alt-text fallback rather than guessing a
+  disruptive message split.
+- Preserve mixed-content order by sending a sequence such as text → photo →
+  text. One logical Hermes reply is not required to fit one VK message.
+- Rebase and clip formatting ranges after each 4096-character split.
+- Persist each text chunk's exact `format_data` in the durable outbox so replay
+  does not silently lose styling.
+
+`formatting.mode: auto` uses this rich profile. Explicit `rich` is accepted for
+API `5.199`; `plain` remains a deterministic fallback that strips native text
+ranges but retains JPEG tables. Unknown API/profile combinations continue to
+fail closed to plain mode, and explicit `rich` is rejected for them.
+
+## Reverification
+
+Run the private-peer probe after changing the VK API version or supported
+clients:
+
+```bash
+hermes vk probe-formatting --peer-id <PRIVATE_TEST_PEER_ID> \
+  --output vk-formatting-format-data-probe.json
+```
+
+The command tests send/edit, nesting, partial overlap and competing Unicode
+offset hypotheses, then removes its visible probe messages best-effort. Update
+both the redacted artifact and the capability profile only after manual client
+observation. Never commit a community token or private peer identifier.

hermes_vk_community-1.0.2/plugin.yaml

@@ -0,0 +1,13 @@
+name: vk-community
+label: VK Community
+kind: platform
+version: 0.1.0
+description: VK Community Long Poll gateway adapter for Hermes Agent.
+author: Hermes VK Community contributors
+requires_env:
+  - name: VK_COMMUNITY_TOKEN
+    description: VK community access token with messages, management, photos, and documents permissions
+    prompt: VK Community token
+    url: https://dev.vk.com/ru/api/bots/getting-started
+    password: true
+    category: credential

hermes_vk_community-1.0.2/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hermes-vk-community"
+version = "1.0.2"
+description = "VK Community Long Poll platform plugin for Hermes Agent"
+readme = "README.md"
+requires-python = ">=3.11,<3.14"
+license = { text = "MIT" }
+authors = [{ name = "Hermes VK Community contributors" }]
+dependencies = [
+    "aiohttp>=3.14.1",
+    "aiosqlite==0.22.1",
+    "filetype==1.2.0",
+    "hermes-agent>=0.18.2",
+    "markdown-it-py>=4.0.0,<5",
+    "packaging>=24,<27",
+    "pillow==12.2.0",
+    "pydantic>=2.10.0,<3",
+    "pydantic-settings>=2.7.0,<3",
+    "tenacity==9.1.4",
+]
+
+[project.entry-points."hermes_agent.plugins"]
+"vk-community" = "hermes_vk_community"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hermes_vk_community"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"plugin.yaml" = "hermes_vk_community/plugin.yaml"

hermes_vk_community-1.0.2/src/hermes_vk_community/__init__.py

@@ -0,0 +1,3 @@
+from hermes_vk_community.plugin import register
+
+__all__ = ["register"]