hermes-hub/agents/inbox/2026-08-30-A34-restore-wizard-providers-desktop.md

# Задание A34: восстановить подключение аккаунтов, добавить OpenRouter и NVIDIA, удалить десктоп

## Дата поступления
2026-08-30

## База

Работать **поверх ветки ревьюера** `review/a28-a31-fixes` (`529192b`), а не поверх `main` и не поверх своей прошлой ветки. В ней уже лежат A28–A31, слитые с `main`, плюс исправления ревьюера.

```
git fetch origin --prune
git checkout -b antigravity/a34-restore-and-providers origin/review/a28-a31-fixes
```

В `main` напрямую не пушить. В конце — push, `git log --oneline -1`, `git status` чистый.

## Порядок исполнения

Два прохода: **Flash** реализует, **Pro** проводит аудит. Пункт **P0-6** написан для аудитора.

Пункты выполняются **по порядку**. P0-1 блокирует всё остальное: пока нельзя подключить аккаунт, ни новых провайдеров, ни автопоиска проверить не на чем.

---

## Что уже сделано ревьюером — не переделывать

Снято исполнением на кандидате A28–A31 и исправлено в `529192b`:

1. **Дублирование ролей.** `RoleRegistry.migrate_legacy_roles` существовала, но не вызывалась ниоткуда; интерфейс показывал 19 агентов вместо 13, шесть пар неотличимы по названию. Миграция подключена, порядок обработки исправлен, цепочки владельца сохраняются. Проверено на его живой конфигурации: 19 → 13, цепочки совпадают.
2. **Сохранённый workflow** мигрируется вместе с ролями, иначе рёбра ссылались на исчезнувших агентов.
3. **Поиск локальных серверов** — новый модуль `router/local_discovery.py` и действие `discover_local_models`. Серверная часть готова и проверена; **не хватает только интерфейса** (P0-3).
4. **Глобальный мьютекс Antigravity** снят ранее (`7e83c38`): три параллельных вызова занимали 3.01 с, стали 1.00 с. Возвращать нельзя, есть тест.
5. **CORS** закрыт по умолчанию (`c35bc48`). Список источников — настройка `web_api_allowed_origins`.

---

## P0-1. Восстановить подключение аккаунтов — блокирующее

При переписывании клиента в A29 **функции удалили, а вызовы оставили**. Проверено в браузере на живом кандидате, консоль:

```
openAddAccountWizard is not defined     ← «+ Добавить аккаунт» ничего не делает
checkUpdates is not defined             ← падает при каждой загрузке страницы
```

Полный список повисших обработчиков — определений 0, вызовы есть:

```
openAddAccountWizard          нельзя подключить аккаунт
handleNodeAccountChange       нельзя сменить аккаунт у агента в «Обзоре»
handleNodeModelChange         нельзя сменить модель
handleRefreshProviderModels   нельзя обновить список моделей
checkUpdates                  проверка обновлений падает на загрузке
```

При этом `startDeviceAuth` и `startRedirectAuth` **в коде остались и работают**, но не вызываются ниоткуда — стали мёртвыми. Их надо не писать заново, а связать с восстановленным мастером.

Требуется вернуть работоспособность каждому пункту списка. Действия на сервере существуют и менять их не нужно:

```
add_account, start_device_auth, poll_device_auth,
start_redirect_auth, submit_redirect_callback, poll_redirect_auth,
assign_role, set_model, refresh_models, check_updates
```

Что мастер обязан уметь, по провайдерам:

- **Grok, OpenAI Codex** — код устройства. Адрес и код приходят **от провайдера**, подставлять свои нельзя.
- **Antigravity, Claude** — вход по ссылке с возвратом. Ссылку можно открыть **на любой машине**. Принимается и полный адрес возврата, и один только код. При работе с другой машины показывается готовая команда проброса порта возврата.
- **Локальный сервер** — адрес и необязательный ключ, плюс автопоиск из P0-3.
- **Выбор слота обязателен и делается владельцем.** Автоподбор ошибается: `find_free_slot` определяет занятость по файлу учётных данных, а `agy` на Windows держит их в keyring, поэтому все слоты выглядят свободными и всегда возвращается первый. Вход затирал бы работающий аккаунт. В списке слотов видно, какие заняты и кем, и участвует ли слот в маршрутизации.

**Проверять исполнением, а не глазами.** Откройте страницу, нажмите каждую кнопку, посмотрите консоль. Ни одного `ReferenceError` при загрузке и при работе.

## P0-2. OpenRouter и NVIDIA, аккаунтов по несколько

Владелец подключил их в Hermes напрямую, мимо хаба: «главный кодекс стоит, подключил себе нвидеа и опенроутер и грок». Хаб их не видит — адаптеров нет, упоминаний в коде нет вовсе.

Оба **OpenAI-совместимы**, поэтому образец есть: `adapters/local_adapter.py` и `adapters/deepseek_adapter.py` работают ровно так же — `POST {base_url}/chat/completions`, `GET {base_url}/models`.

1. **Адаптеры** `openrouter` и `nvidia`. Базовый адрес — **настройка, не константа**. Для OpenRouter это `https://openrouter.ai/api/v1`, у NVIDIA свой; но зашивать нельзя, владелец может использовать прокси.
2. **Несколько аккаунтов на провайдера**, без потолка. Потолок в A26 уже снят: `find_free_slot` выдаёт идентификаторы сама, когда предопределённые кончились (`codex-4`, `codex-5`). Сделать так же.
3. **Ключ вводится в мастере** и хранится там же, где ключи прочих провайдеров. В снапшот, в журнал и в `/api/settings` он попадать не должен — тест на это уже есть.
4. **Обнаружение моделей** через `GET /models`. У OpenRouter список большой; показывать надо тот, что вернул провайдер, а не подмножество из головы.
5. **Квоты.** OpenRouter отдаёт остаток кредитов, у NVIDIA свои лимиты. Отдаёт — показывать; не отдаёт — **«Н/Д» с причиной**, а не ноль и не пустая полоса, которую можно принять за исчерпание.
6. **Логотипы** провайдеров у владельца есть в каталоге с макетами. Файла нет — нейтральная заглушка, а не чужой знак.

## P0-3. Автопоиск локальных моделей в интерфейсе

Серверная часть готова ревьюером, писать её заново не нужно.

```
router/local_discovery.py     discover_local_servers()
action_handler                действие discover_local_models
```

Опрашивает Ollama 11434, LM Studio 1234, llama.cpp 8080–8082, vLLM 8000, Jan, GPT4All, Text Generation WebUI — параллельно, девять портов за 1.5 с. Возвращает только ответившие, со списком моделей от самого сервера.

Требуется кнопка **«Найти на этом компьютере»** в шаге подключения локального провайдера:

1. Нажатие — опрос, показ найденного: имя сервера, адрес, список моделей.
2. Выбор найденного заполняет адрес; вводить руками по-прежнему можно.
3. **Ничего не найдено — так и сказать**, с подсказкой запустить Ollama, LM Studio или llama.cpp либо ввести адрес вручную. Пустой список это результат, а не ошибка.
4. Порт, занятый чужим сервисом, показывается **с причиной** — иначе владелец будет гадать, почему заведомо работающий сервер не виден.
5. Опрос идёт в фоне, интерфейс не блокируется.

Учесть: хаб может работать на сервере, а браузер у владельца на другой машине. Поиск идёт **там, где работает хаб**, и это надо сказать в интерфейсе прямо, иначе результат будет непонятен.

## P0-4. Удаление десктопа (задание A32 целиком)

Выполняется **после** P0-1: пока веб не подключает аккаунты, удалять десктоп нельзя.

Полный текст — `agents/inbox/2026-08-25-A32-remove-desktop.md`, здесь коротко:

```
router/ui/**                        20 файлов, ~6 910 строк
hermes_hub_app.py                   ~1 345 строк, CustomTkinter
cli_commands.py:481                 команда запуска десктопа
HermesHubSetup.cs:575               ярлык «Hermes Hub (Desktop).lnk»
HermesHubSetup.cs:140               проверка зависимостей ТРЕБУЕТ customtkinter
pyproject.toml:40                   customtkinter>=6.0.0
```

Сначала **таблица паритета** «умение десктопа → где в вебе → проверено», и только потом удаление. Непокрытое умение не удалять, а назвать в отчёте.

Отдельно: в `b4ae08e` появился обход «GUI helpers importable without customtkinter». После удаления десктопа эта прослойка не нужна — снять её, а не оставлять.

Обновление пойдёт **поверх установок с десктопом** на трёх машинах владельца: старый ярлык обязан убираться, учётные данные, настройки и цепочки ролей — уцелеть.

## P0-5. Проверка на живой установке

1. Собрать оба установщика, поставить на Windows и на Linux.
2. Подключить хотя бы по одному аккаунту каждого потока: код устройства, вход по ссылке, локальный сервер.
3. Разложить аккаунты по ролям и убедиться, что порядок переживает перезапуск.
4. Проверить обновление поверх старой установки.

## P0-6. Аудит вторым проходом

1. **Повисшие вызовы.** Собрать все `onclick`/`onchange` и убедиться, что каждая функция определена. Именно этот класс дефекта и пропустили в A29: разметка звала пять функций, которых нет.
2. **Консоль браузера чистая** при загрузке и при работе.
3. **Выдуманные значения.** Особый риск в P0-2: квоты и списки моделей новых провайдеров. Ни одного числа, которого не дал провайдер.
4. **Ключи не утекают** в снапшот, журнал и `/api/settings`.
5. **Мьютекс Antigravity не вернулся** — есть тест, он должен проходить.
6. **Побочные изменения** объяснить.
7. **Пропущенный пункт назвать пропущенным.**

---

## Ограничения

- Не переделывать то, что перечислено в разделе «сделано ревьюером».
- Без сборки, без npm, без фреймворка — решение обосновано в контракте.
- Действия только через `action_handler`; новые — с правкой `docs/web-api/CONTRACT.md`.
- Правило честности без исключений: нет данных — «Н/Д» и причина.
- Тег `v0.1.1` не создавать.

## Критерии приёмки

1. Ветка в `origin` от `review/a28-a31-fixes`, `git status` чист.
2. В консоли браузера нет `ReferenceError` ни при загрузке, ни при работе; все обработчики определены — проверено списком.
3. Аккаунт подключается всеми тремя потоками; слот выбирает владелец, занятые видны.
4. Аккаунт назначается агенту и меняется модель — из «Обзора» и из «Маршрутизации»; переживает перезапуск.
5. OpenRouter и NVIDIA подключаются, аккаунтов больше трёх на провайдера; ключи не утекают; модели берутся у провайдера.
6. Квоты новых провайдеров показаны настоящие либо «Н/Д» с причиной.
7. Кнопка автопоиска находит запущенные локальные серверы; пустой результат объяснён; чужой сервис на порту назван с причиной.
8. `router/ui/**` и `hermes_hub_app.py` удалены, `customtkinter` из зависимостей убран, ярлык один; обновление поверх старой установки сохраняет данные.
9. Таблица паритета приложена.
10. `ruff check .` чисто; релизный гейт не ухудшен.
11. **Скриншоты:** мастер на каждом из трёх потоков, автопоиск локальных, «Обзор» с назначением аккаунта, «Маршрутизация».
12. Отчёт: `START_HEAD`, `FINAL_HEAD`, `origin/main`, `git status`, `X passed / Y skipped / Z failed`. На ветке ревьюера сейчас **475 passed, 2 skipped**.

## Главное

Сейчас в новой сборке нельзя подключить ни одного аккаунта и нельзя назначить его агенту — разметка зовёт пять функций, которых в коде нет. Всё остальное в задании бессмысленно, пока это не восстановлено.

## Порядок сдачи
Передать точный `FINAL_COMMIT_SHA`. Сдано только после появления коммита в `origin`.