# Задание A42: подключение провайдеров — OpenRouter, NVIDIA, Ollama, квота Codex

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

## База

`origin/main` (`ff303b5`) — туда уже слиты правки ревьюера по вебу и A41 (чистая первая установка).

```
git fetch origin --prune
git checkout -b antigravity/a42-provider-connect origin/main
```

В `main` напрямую не пушить.

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

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

Это задание **по коду**. Вёрстка и холст — отдельное задание A43, туда не залезать.

---

## Задача

Владелец сообщает: «опенроутер не подключается, нвидиа не подключаются, кодекс выдаёт ошибку по квоте, хотя квоты полные, оллама не выдаёт облачные модели».

Причины найдены ревьюером и проверены по коду. Заново их выяснять не нужно — нужно чинить.

## Что проверено ревьюером

### OpenRouter и NVIDIA реализованы наполовину

```
adapters/__init__.py      OpenRouterAdapter и NvidiaAdapter в реестре есть
web/static/index.html:163 пункты в списке провайдеров есть
app.js:2482               шаг мастера с полем API-ключа и Base URL есть

action_handler.py:574     add_account сохраняет ТОЛЬКО для
                          (local, local-llm, llama.cpp, ollama, vllm)
                          и только при непустом base_url
action_handler.py:588     для всех остальных возвращается ok=True с текстом
                          «Навигация» — и не сохраняется ничего
```

То есть мастер докладывает об успехе и **не сохраняет ничего**. Аккаунт не появляется, потому что его никто не создал.

Дальше по цепочке пусто тоже:

```
auto_assigner.py:129  слоты объявлены для ollama; openrouter и nvidia отсутствуют
auto_assigner.py:219  роли по умолчанию — то же самое
router_config.py      в конфигурации по умолчанию нет ни одного из трёх
model_discovery_service.py:216  _probe_provider не имеет ветки ни для
                                openrouter, ни для nvidia, и возвращает None
```

### Ollama обнаруживает не то

`model_discovery_service.py:325` заводит `ollama` в одну ветку с `local`, `llama.cpp`, `vllm`. Эта ветка:

1. перебирает **зашитые** идентификаторы `local-1` и `local-2` — профиль `ollama-1` не смотрит вообще;
2. читает учётные данные провайдера `local`, а не `ollama`;
3. по умолчанию идёт на `http://127.0.0.1:8081/v1` — это порт llama.cpp, а не Ollama (11434);
4. дёргает `/v1/models` и ничего не знает про облачные модели Ollama.

Скриншот владельца: «Список моделей ещё не получен от провайдера ollama» при подключённом `ollama-1`.

Та же болезнь рядом: ветка Codex перебирает зашитые `codex-orch`, `codex-worker-1`, `codex-worker-2`. После A26 идентификаторы выдаются автоматически (`codex-4`, `codex-5`), и такой профиль обнаружение пропустит.

### «Квота исчерпана» при полной квоте

На скриншоте у Codex значок «Квота исчерпана», а Session и Weekly показывают `Н/Д`. То есть **вердикт об исчерпании выносится там, где квота не измерена вовсе**.

```
unified_health.py:467   ветка: max_cd > 0 либо overall_state == QUOTA_EXHAUSTED
                        → health_state = STATUS_QUOTA_EXHAUSTED
unified_health.py:470   ветка RATE_LIMITED идёт НИЖЕ
```

`max_cd` берётся из `frec.reset_at > now` — это **окно отката после ошибки**, а не остаток квоты. Отсюда два разных дефекта:

1. Любой откат показывается как исчерпание квоты, хотя квота может быть полной.
2. Ветка `RATE_LIMITED` практически мертва: при активном лимите запросов `reset_at` всегда в будущем, поэтому строка 467 срабатывает раньше и лимит запросов выдаёт себя за исчерпанную квоту.

И третье, в `health_tracker.py:483`: при пустом имени модели или значении `default` исчерпанным помечается **весь аккаунт** (`record.overall_state`). Hermes имя модели передаёт не всегда.

Классификатор в `codex_adapter.py:132` ловит подстроку `quota` в любом месте текста ошибки — проверить, не попадают ли туда сообщения, к квоте не относящиеся.

---

## P0-1. OpenRouter и NVIDIA подключаются по-настоящему

1. **`add_account` сохраняет профиль** для `openrouter`, `nvidia`, `nvidia-nim`: создаёт определение профиля, пишет учётные данные (ключ и адрес), назначает роль — по образцу существующей локальной ветки.
2. **Слоты и роли по умолчанию** для обоих провайдеров в `AutoAssigner`, как сделано для `ollama`.
3. **Адреса по умолчанию**: `https://openrouter.ai/api/v1` и `https://integrate.api.nvidia.com/v1`; владелец может переопределить в мастере.
4. **Ветка с мнимым успехом не должна остаться ловушкой.** Провайдер, для которого сохранение не реализовано, обязан получать честный отказ с причиной, а не `ok: True`. Это главное требование пункта: молчаливый успех стоил владельцу нескольких попыток подключения.

## P0-2. Обнаружение моделей для трёх провайдеров

1. **OpenRouter**: запрос списка моделей по адресу профиля с его ключом.
2. **NVIDIA**: то же самое.
3. **Ollama — отдельная ветка**, не общая с llama.cpp:
   - адрес берётся из **самого профиля**, а не из зашитых `local-1`/`local-2`;
   - учётные данные читаются для провайдера `ollama`;
   - по умолчанию `http://127.0.0.1:11434`;
   - локальные модели — через нативный `/api/tags`;
   - **облачные модели Ollama** — отдельный источник, требующий ключа. Выяснить по действующей документации Ollama способ и адрес; **не выдумывать эндпоинт**. Если способ не подтверждён — так и написать в отчёте, а в интерфейсе показать `Н/Д` с причиной.
4. **Зашитые идентификаторы профилей убрать везде**, включая ветку Codex: перебирать профили провайдера из конфигурации. После A26 идентификаторы выдаются автоматически, и любой зашитый список рано или поздно промахнётся.
5. **Ошибка обнаружения показывается с текстом ответа сервера.** Сейчас `_probe_provider` возвращает `None` и когда ветки нет, и когда сервер отказал — владелец не может отличить одно от другого.

## P0-3. Квота говорит только то, что измерено

1. **Откат после ошибки — это не исчерпание квоты.** Разделить состояния: исчерпание объявлять по измеренному остатку, откат показывать как откат с причиной и временем окончания.
2. **Порядок веток исправить**: лимит запросов не должен выдавать себя за исчерпанную квоту.
3. **Ошибка без имени модели не помечает весь аккаунт.** Помечать конкретное семейство; общий вердикт — только при подтверждении.
4. **Ярлык называет источник.** «Квота исчерпана» — когда есть измерение. Иначе «Откат до HH:MM после ошибки: текст».
5. **Классификатор Codex** проверить на ложные срабатывания подстроки `quota`.

## P0-4. Проверка исполнением

Заглушек недостаточно, но и ключей владельца у исполнителя нет. Поэтому:

1. **Сохранение профиля** проверить с заведомо неверным ключом: профиль обязан создаться, а проверка подключения — вернуть внятную ошибку авторизации, а не тишину.
2. **Ollama** проверить на живом сервере: локальные модели через `/api/tags` обязаны появиться в списке.
3. **Квота**: смоделировать откат после ошибки и убедиться, что интерфейс не пишет «квота исчерпана» при неизмеренной квоте.
4. **Отказ вместо мнимого успеха** проверить отдельно.

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

1. **Искать оставшиеся зашитые идентификаторы профилей** по всему коду — это повторяющийся класс дефекта.
2. **Проверить, что мнимых успехов не осталось**: действие, ничего не сохранившее, не возвращает `ok: True`.
3. **Эндпоинт облачных моделей Ollama** сверить с документацией. Выдуманный адрес — дефект того же рода, что выдуманные метрики в A38.
4. **Побочные изменения** объяснить.
5. **Пропущенный пункт назвать пропущенным.**

---

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

- Ключи владельца не запрашивать и в репозиторий не класть.
- Каталог `~/.hermes/agy_profiles/` не трогать.
- Вёрстку и холст не менять — это A43.
- Версию `0.1.1` не поднимать.
- Правило честности без исключений: неизмеренное показывать как `Н/Д` с причиной.

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

1. Ветка в `origin`, `git status` чист.
2. OpenRouter и NVIDIA подключаются: профиль создаётся, учётные данные сохраняются, аккаунт виден в списке; проверено.
3. Действие, ничего не сохранившее, возвращает отказ с причиной; проверено.
4. Обнаружение моделей работает для openrouter, nvidia и ollama; для Ollama проверено на живом сервере.
5. Зашитых идентификаторов профилей в обнаружении не осталось.
6. Ошибка обнаружения доходит до интерфейса с текстом.
7. Откат после ошибки не показывается как исчерпание квоты; лимит запросов показывается как лимит запросов.
8. Ошибка без имени модели не помечает весь аккаунт.
9. `ruff check .` чисто; релизный гейт не ухудшен.
10. Отчёт: `START_HEAD`, `FINAL_HEAD`, `origin/main`, `git status`, `X passed / Y skipped / Z failed`. На `origin/main` сейчас **491 passed**.

## Главное

Два провайдера нельзя подключить вовсе, и мастер при этом рапортует об успехе — владелец несколько раз повторял заведомо безрезультатное действие. Третий подключается, но опрашивается по чужому адресу и чужому имени профиля. А Codex объявляется исчерпанным по квоте в тот момент, когда квота не измерена ни разу. Общее у всех четырёх — интерфейс утверждает то, чего не проверял.

## Порядок сдачи
Передать точный `FINAL_COMMIT_SHA`.