hermes/dsh-vk-group
1
0 Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity

WP-3 · Инструменты чтения (10 шт.) #3

New Issue
Open
opened 2026-10-21 11:00:43 +00:00 by hermes · 0 comments
hermes commented 2026-10-21 11:00:43 +00:00
Owner
Copy link
Copy source

Цель

Агент может прочитать всё состояние сообщества.

Список

vk_members_list, vk_ban_list, vk_requests_list, vk_managers_list, vk_wall_list, vk_comments_list, vk_messages_list, vk_stats_get, vk_shortlink, vk_member_status.

Требования к каждому

  • defineTool с типизированными parameters и output.schema.
  • Любой список возвращает { items, total, offset, count, hasMore }.
  • count клампится к максимуму метода (1000 для members, 200 для banned/requests/conversations, 100 для wall/comments).
  • Токен: U где нужен юзер-токен. Без него — VK_SCOPE_MISSING с явным именем scope, а не сырая ошибка 15.
  • presentCall/presentResult — чистые (без I/O, без часов), возвращают generic-карточку.

Acceptance

  • Contract-тесты зелёные для всех 10 (схема, валидация аргументов, канонический выход, totality render).
  • vk_stats_get и vk_members_list без юзер-токена возвращают VK_SCOPE_MISSING с именем scope stats / groups.

Ссылки

wiki: Tools-Reference · Platform-VK-API · Testing-Strategy

## Цель Агент может прочитать всё состояние сообщества. ## Список `vk_members_list`, `vk_ban_list`, `vk_requests_list`, `vk_managers_list`, `vk_wall_list`, `vk_comments_list`, `vk_messages_list`, `vk_stats_get`, `vk_shortlink`, `vk_member_status`. ## Требования к каждому - `defineTool` с типизированными `parameters` и `output.schema`. - Любой список возвращает `{ items, total, offset, count, hasMore }`. - `count` клампится к максимуму метода (1000 для members, 200 для banned/requests/conversations, 100 для wall/comments). - Токен: `U` где нужен юзер-токен. Без него — `VK_SCOPE_MISSING` с явным именем scope, а не сырая ошибка 15. - `presentCall`/`presentResult` — чистые (без I/O, без часов), возвращают `generic`-карточку. ## Acceptance - Contract-тесты зелёные для всех 10 (схема, валидация аргументов, канонический выход, totality `render`). - `vk_stats_get` и `vk_members_list` без юзер-токена возвращают `VK_SCOPE_MISSING` с именем scope `stats` / `groups`. ## Ссылки wiki: [[Tools-Reference]] · [[Platform-VK-API]] · [[Testing-Strategy]]
hermes added this to the M1 · Core (loadable plugin + read tools) milestone 2026-10-21 11:00:43 +00:00
hermes added the work-packagetoolspriority:high labels 2026-10-21 11:00:43 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
client
docs
events
moderation
policy
priority:high
priority:low
priority:medium
tests
tools
ui
work-package
No labels priority:high tools work-package
Milestone
No items
No Milestone M1 · Core (loadable plugin + read tools)
Projects
Clear projects
No projects
Assignees
Clear assignees
hermes (Hermes Agent)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: hermes/dsh-vk-group#3