version: "1.0.1" name: v8-session-manager description: "Use for работы с менеджером сессий 1С: запуск, конфигурация, подключение клиентов, чтение session_list, вызов проксированных MCP-tools расширений 1С. Helps при ошибках «no active sessions» / «session_id required» и подключении клиента через mcpMode=ws." provides_capabilities: # Встроенные tools менеджера — доступны всегда, пока поднят.

• session_list
• tools_cache_reset

# Tools, которые менеджер проксирует от подключённых 1С-клиентов. # ВНИМАНИЕ: их имена в tools/list читаются из persistent tools-cache # (ADR-0035) — наличие имени НЕ гарантирует доступность вызова. # Без live-сессии нужного kind вызов вернёт MCP tool error # isError:true, _meta.error_code="no_live_session". # client_mcp / system:

• infobase_info
• system_spawn_1c_client
• system_kill_pid
• timer

# test_client (UI-управление):

• test_client_start
• test_client_stop
• ui_find
• ui_open_form
• ui_activate
• ui_click
• ui_close
• ui_input
• ui_select
• ui_select_row
• ui_get_value
• ui_get_cell_value
• ui_get_table_rows
• ui_wait_for

v8-session-manager

Тонкий MCP-агрегатор: принимает WS-подключения от 1С-клиентов и публикует их MCP-tools на едином HTTP-эндпоинте для AI-агента.

Что даёт сам менеджер

Всё остальное (доменные tools — описание форм, запуск тестов, навигация и т.п.) добавляется расширениями 1С, не менеджером. Под каждое расширение — отдельный skill.

Кеш проксированных tools (ADR-0035) — ключевой момент

tools/list менеджера читается из persistent кеша на диске, а не только из живых WS-сессий. Следствия для агента:

• Имя tool в `tools/list` ≠ доступность вызова. Кеш переживает disconnect клиента и рестарт менеджера — имя остаётся на витрине, но вызов без live-сессии вернёт MCP tool error isError:true, _meta.error_code="no_live_session". Это не баг, это контракт.
• Зачем так: часть MCP-харнесов (в частности Claude Code) нестабильно реагирует на notifications/tools/list_changed. Persistent-кеш снимает зависимость от стабильной обработки нотификации.
• Когда нужен `tools_cache_reset`: когда tool осознанно удалён из расширения и больше не вернётся (или конфигурация снята полностью). Иначе он будет висеть до истечения TTL (по дефолту 5 суток с момента последнего session.register). Полный сброс — без аргументов; точечный — {"config_id": "<id>"} (берётся из session_list[*].config_id).
• Что НЕ делает кеш: не запускает 1С, не воспроизводит ответ tool, не подменяет live-сессию. Только хранит имена и inputSchema.

Подробности — references/sessions-and-tools.md § «Persistent кеш и tools_cache_reset».

Границы

Менеджер не:

• запускает 1С-клиентов (это работа внешнего оркестратора, типично — v8-runner);
• хранит состояние между перезапусками (реестр in-memory);
• содержит бизнес-логику (только транспорт + маршрутизация);
• управляет ИБ.

Routing задач

Guardrails (hard)

1. Не править исходники менеджера (src/, Cargo.toml, systemd/, etc/, spec/, ADR в docs/decisions/) — это upstream-репозиторий. Все изменения уровня менеджера согласуются отдельной задачей.
2. Не создавать и не менять MCP-tools без прямого разрешения пользователя. Tools живут в расширениях 1С (exts/<extension>/); правка/добавление = изменение публичного контракта.
3. Не тащить бизнес-логику в менеджер. Если задача требует «менеджер должен делать X» — это сигнал, что X относится либо к расширению, либо к оркестратору запуска.
4. Не пытаться запустить 1С-клиента через менеджер. Менеджер только принимает входящее WS-подключение. Запуск 1С — задача v8-runner.
5. Перед сборкой/перезапуском клиента — спросить пользователя. Любая операция, меняющая состояние проекта (билд, рестарт), требует подтверждения.