Add multi-turn Assistent session diagnostics to the Debug API.

POST /assistent/session + /chat with rich per-turn traces (patch, Exact merge, compact_context); chat-eval wraps one session turn. Docs playbook and unit/HTTP tests included.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/cli.md

@@ -133,31 +133,59 @@ Exit 0 → можно `up`. Exit 1 → причина в таблице / кра
 | Путь | Зачем |
 | --- | --- |
 | `/assistent` | Сводка: extension + overlay + roles + memory + live API + hints + playbook |
+| `/assistent/diagnose` | То же + journal по умолчанию + session store meta |
 | `/assistent/extension` | DLL, Sqlite deps, Tab/Assets, git HEAD |
 | `/assistent/overlay` | personas на VM vs локальный `assistent-personas/` |
 | `/assistent/roles` | `ollama-roles.json` ↔ `/api/tags` (`default_chat`) |
 | `/assistent/memory` | `assistent.sqlite` + counts |
 | `/assistent/api` | `AssistentListPersonas/Models/Memory/Chats` через туннель (или SSH) |
 | `/assistent/api?chat_smoke=1` | + 1-token Ollama `/api/chat` (кратко грузит модель) |
-| `/assistent/chat-eval` | **Opt-in** `GetNewSession` → `AssistentChat` (полный ответ ассистента) |
 | `/assistent/logs` | journalctl swarmui: build/load/Sqlite |
 | `/assistent?logs=1` | Сводка + journal |
+| `/assistent/session` | **POST** — multi-turn debug chat (in-memory, TTL ~45m) |
+| `/assistent/session/{id}/chat` | **POST** — ход + объект `trace` |
+| `/assistent/session/{id}` | **GET** / **DELETE** — состояние / сброс |
+| `/assistent/chat-eval` | One-shot: session + один chat + delete |
 
 Симптомы → куда смотреть: поле `playbook` в `/assistent`.
 
-**`/assistent/chat-eval`** — не входит в `/snapshot`. Может загрузить chat-модель в VRAM и записать чат в Sqlite (если DLL на месте). Предпочтительно `POST` с JSON; для агентов удобен и `GET` с query.
+**Session / chat-eval** не входят в `/snapshot`. Могут грузить VRAM, писать sqlite chat, тратить биллинг GPU. `compactContext` / Exact merge в Assistent HTTP API **нет** — sidecar реконструирует best-effort (`trace.gaps`).
+
+#### Agent playbook (curl)
 
 ```bash
-# POST (предпочтительно)
-curl -sS -X POST http://127.0.0.1:17821/assistent/chat-eval \
-  -H "Content-Type: application/json" \
-  -d "{\"message\":\"какой checkpoint и какие steps/cfg должны быть\",\"persona\":\"leonid\",\"timeout\":120}"
+BASE=http://127.0.0.1:17821
 
-# GET (агенты / быстрый smoke)
-curl -sS "http://127.0.0.1:17821/assistent/chat-eval?message=ping&timeout=90"
+# Static+live health (no chat)
+curl -sS "$BASE/assistent/diagnose" | jq '{ok,hints,playbook,session_store}'
+
+# Multi-turn conversational diagnostics
+SID=$(curl -sS -X POST "$BASE/assistent/session" \
+  -H 'Content-Type: application/json' \
+  -d '{"persona":"neutral","pack":"ordinary","context":{"krea_profile":"turbo","checkpoint":"krea-turbo"}}' \
+  | jq -r .debug_session_id)
+
+curl -sS -X POST "$BASE/assistent/session/$SID/chat" \
+  -H 'Content-Type: application/json' \
+  -d '{"message":"какой checkpoint и какие steps/cfg должны быть"}' \
+  | jq '{ok,reply,trace:{timings_ms,patch,exact_merge,compact_context,system_layers,gaps}}'
+
+curl -sS -X POST "$BASE/assistent/session/$SID/chat" \
+  -H 'Content-Type: application/json' \
+  -d '{"message":"сделай generate с этими params"}' \
+  | jq '{ok, trace:{patch,exact_merge}}'
+
+curl -sS "$BASE/assistent/session/$SID" | jq .session
+curl -sS -X DELETE "$BASE/assistent/session/$SID"
+
+# One-shot convenience (session + one chat + delete)
+curl -sS -X POST "$BASE/assistent/chat-eval" \
+  -H 'Content-Type: application/json' \
+  -d '{"message":"какие steps/cfg для turbo?","persona":"leonid","timeout":120}' \
+  | jq '{ok,reply,patch,trace}'
 ```
 
-Ответ: `ok`, `ms` / `chat_ms`, `model` / `preferred`, `reply` / `reply_prose`, `patch` (prompt/steps/cfg/aspect/actions…), `errors`, `hints`. Туннель `:swarmui_local_port` (обычно 17801), иначе SSH на VM `:7801`.
+Ответ chat: `ok`, `reply`, `trace` (`timings_ms`, `patch`, `exact_merge`, `compact_context`, `system_chars` / `system_layers`, `skills`, `hops`, `gaps`, `errors`/`warnings`/`hints`). Sqlite SaveChat fail — soft error, если текст ответа есть.
 
 После `up --no-tunnel` процесс завершается и sidecar гаснет — держи отдельно:
 
@@ -165,7 +193,7 @@ curl -sS "http://127.0.0.1:17821/assistent/chat-eval?message=ping&timeout=90"
 gpu-rent debug
 ```
 
-Мутаций конфига/GPU нет (restart/hold/stop — как раньше через CLI). `chat_smoke` только пингует Ollama; `chat-eval` — полноценный AssistentChat (opt-in).
+Мутаций конфига/GPU нет (restart/hold/stop — как раньше через CLI). `chat_smoke` только пингует Ollama; session/chat-eval — полноценный AssistentChat (opt-in).
 
 ---