subochev
ddd9d076c1
ci / JVM build + tests (push) Failing after 1m25s
Закрывает разрыв между :proto и UI-композицией: TuiBackend маршрутизирует
onUserMessage → Conversation.send и Event → AppState.
Изменения:
- agentik-tui/.../TuiBackend.kt — новый commonMain-файл (138 строк):
инкапсулирует Agent-общение, авто-создание первого диалога,
подписку на Conversation.events, диспетчеризацию Event в AppState.
- agentik-tui/.../Main.kt — обязательный health-check GET {baseUrl}/health
ДО старта UI: понятная ошибка и exit 1 при недоступном сервере,
понятное сообщение при не-200/не-'ok'. JVM-only API (java.net.*,
ktor.*Timeout) обёрнуты в catch (Exception) — commonMain собирается
под все desktop-native.
- agentik-tui/.../AppState.kt — добавлены attachBackend/setConversation/
newConversation/postSystem; submitInput теперь не пишет AssistantStreaming
сам (его рисует TuiBackend по Event.AppendText).
- agentik-tui/.../TuiApp.kt — TuiBackend монтируется в LaunchedEffect,
делит scope с recomposer'ом.
- agentik-tui/.../Platform.jvm.kt — expect/actual platformEnv + platformCreateAgent.
- agentik-tui/.../Platform.native.kt — stub actual.
- agentik-tui/build.gradle.kts — kotlinx-coroutines-test в commonTest.
- agentik-cli/build.gradle.kts — binaries.executable entryPoint для native
(тот же фикс, что прошёл для agentik-tui в предыдущем коммите).
- TuiBackend.dispatch: Event.End теперь зовёт finishAssistant()
(конвертирует streaming-чанк в финальный Assistant), Interrupted —
finishAssistant + 'прервано' system message. Раньше оба только
выключали streaming, и последний чанк висел как AssistantStreaming
с курсором.
Тесты: agentik-tui/src/commonTest/.../TuiBackendTest.kt — 10 кейсов
против FakeAgent/FakeConversation: auto-create, переиспользование,
AppendText-coalesce, End finalize, Interrupted system, ToolCall/ToolResult
visibility, Error handling, exception path, StartReasoning, connect
message. Используется runTest.backgroundScope + runCurrent — backgroundScope
не двигается через advanceUntilIdle (документированное поведение).
Сборка: jvm + linuxX64 + linuxArm64 + macosX64 + macosArm64 + mingwX64,
10/10 jvmTest green, full project jvmTest не задет.
:agentik-tui — Compose-for-Mosaic TUI-клиент к /agentik
Что это
Compose-style TUI-клиент в терминале на базе
Mosaic (Jetpack Compose
runtime, рендерится в ANSI-коды). Без :-команд (без vim-style
prompt): клавиатурная навигация Tab/Enter/Esc/Ctrl-D/F1/стрелки +
жирный focus indicator.
- Layout: header (id/conv/focus) + history + input + footer.
- Focus: Tab/Shift-Tab цикл по фокусам (input → history → sidebar).
- Input: стандартное текстовое поле с курсором
|посередине. - Stream: подписка на SSE в фон-корутинах,
StateFlow+collectAsState()для UI-реактивности (см. Snake sample).
Решает: полноценный TUI-клиент для тех, кто предпочитает мышкой
кликать в терминале больше, чем печатать. В отличие от :agentik-cli,
показывает историю диалога и текущий стрим в одном окне.
Как запустить
Требования
- JVM 21+.
- Запущенный
:standalone(по умолчаниюhttp://localhost:8080/agentik). - Реальный TTY (через
ssh -tt,tmux, либо нативный terminal).
Запуск из готового fatjar
java --enable-native-access=ALL-UNNAMED \
-jar agentik-tui-0.1.0-all.jar \
--server http://192.168.76.166:8080/agentik
--enable-native-access=ALL-UNNAMED обязателен — Mosaic использует
native syscalls для терминала.
Запуск через Gradle (dev)
./gradlew :agentik-tui:run --args="--server http://localhost:8080/agentik"
Параметры CLI
| Флаг | ENV | Что делает |
|---|---|---|
--server URL |
AGENTIK_SERVER |
URL /agentik (default http://localhost:8080/agentik) |
--id ID |
USER/USERNAME |
Имя агента (default — текущий пользователь) |
--no-history |
— | Не восстанавливать последнюю диалог после запуска |
--help |
— | Показывает help и выходит |
Keybindings
| Клавиша | Когда | Что делает |
|---|---|---|
Tab / Shift-Tab |
глобально | Цикл фокусов: input → history → sidebar → ... |
F1 |
глобально | Toggle help overlay |
Esc |
в input | Очистить input |
Enter |
в input | Submit message |
Backspace / Del |
в input | Удалить символ |
← → Home End |
в input | Курсор |
↑ ↓ |
в history | Scrollback |
Ctrl-D / Ctrl-C |
— | Exit (TODO — пока работает только вне стрима) |
Переменные среды (сервера)
См. ../standalone/README.md. TUI
получает URL сервера через --server, остальное настройка
агента, а не клиента.
Известное ограничение
- SSE в не-TTY ssh закрывается на default Ktor timeout — то
же, что для
:agentik-cli. - Mouse events не подключены в v2 (Mosaic 0.18 не имеет built-in mouse-runtime). Планируется в v3 через termios SGR-mouse.
- Нативные target'ы (macOS / Linux x64+ARM64 / Windows x64)
собраны, но без
:client(он JVM-only). Для нативной работы нужен альтернативный HTTP-клиент.
Тесты
./gradlew :agentik-tui:jvmTest
Тесты composable'ов и event-рендеринга. Включает smoke-test для key-event → AppState mutation → ре-рендер.
Версии
gradle/libs.versions.toml → [versions] agentik-agentik-tui.
Архитектурная заметка
UI-стейт держится в StateFlow, а не в Compose mutableStateOf.
Причина: Mosaic 0.18 не триггерит recomposition от mutableStateOf
-writes внутри onPreviewKeyEvent-handler'ов (см. Snake sample в
репо Mosaic — они тоже используют StateFlow + collectAsState()).