approved/004-settings-agents: одобренный экран настроек агентов (без панели и фона), обновлены доки

approved/README.md

@@ -7,6 +7,7 @@
 | Файл | Что это | Одобрено |
 |---|---|---|
 | `001-sidebar-utility.html` | **Основа дизайна**: привычный мессенджер | 2026-09-18 |
+| `004-settings-agents.html` | Настройки агентов: список, форма, проверка связи | 2026-09-19 |
 | `005-new-chat-picker.html` | Модалка «Новый диалог»: выбор ассистента | 2026-09-19 |
 
 `sketches/` — предложения: `002-rail-voice-first`, `003-three-pane-command`,
@@ -66,6 +67,39 @@
 
 ---
 
+## 004-settings-agents.html — Настройки агентов
+
+**Два окна друг над другом.** Первое — настройки (620 px): список агентов и форма
+нового. Второе, поверх — проверка связи (480 px).
+
+**Окно 1, список агентов.** У каждого: знак (цвет или картинка), имя, адрес,
+состояние — «на связи» зелёным, «не отвечает» красным, «не проверялся» серым.
+Кнопки в строке: **проверить связь (⇄)**, **изменить (✎)**, **удалить (🗑)**.
+Внизу пунктирная «＋ Добавить агента».
+
+**Окно 1, форма нового** — три поля:
+- **Название.** Пояснение: имя придумывает пользователь, сервер своего имени
+  не сообщает (это из исходников, не догадка).
+- **Адрес сервера** — целиком, вместе с путём `/agentik`. Прямо в строке адреса
+  кнопка «Проверить связь».
+- **Как отличать в списке** — вкладки **Цвет / Картинка**, выбирается что-то одно.
+  Цвет — из пяти. Картинка — файл с диска, круглый превью, «Выбрать файл…» и «Убрать».
+  ⚠️ Картинка **копируется внутрь клиента**, не берётся по исходному адресу.
+
+**Окно 2, проверка связи — отдельное окно поверх настроек**, три состояния
+в одном окне: идёт (крутится кольцо) → отвечает (зелёная галочка, подробности:
+ответ, адрес, число диалогов, отклик) → не отвечает (красный крестик, подсказка
+что проверить). Внизу всегда «Проверить снова». Кнопка «Добавить агента»
+доступна только при успехе. Работает и для добавленных агентов — кнопкой «⇄».
+
+**Почему проверка отдельным окном:** места больше, основную форму не дёргает,
+одно окно годится и для новой формы, и для уже добавленного агента.
+
+**Честно о непроверенном:** живого агента на момент макета не поднято — на порту
+8080 отвечал чужой сервер. Адреса запросов взяты из исходников (`GET /agentik/health`
+и список диалогов, оба ничего не меняют), но замеры времени и число диалогов
+в макете условные. На настоящем агенте проверка ещё не гонялась.
+
 ## Про цвета в макетах
 
 Цвета в макетах стоят числами — так и надо, иначе макет не будет выглядеть
@@ -77,4 +111,6 @@
 Открыть файл в браузере — самодостаточный, без сборки и без зависимостей.
 
 - в `001` переключается узкий/широкий вид и видны состояния сообщений;
+- в `004` переключаются список/форма, вкладки Цвет/Картинка; кнопкой «⇄» или
+  «Проверить связь» открывается окно проверки (оба состояния — успех и отказ);
 - в `005` кликом по карточке меняется выбор и появляется предупреждение.