Module session 

ТЗ 0.16.0: Session Recorder — журнал действий агента в .light/agent-sessions/. ТЗ 0.16.0: Session Recorder — журнал действий агента.

Когда активна сессия, любая команда light devtools <cmd> (кроме session start/stop) записывается в .light/agent-sessions/<session-id>/actions.jsonl. Каждая запись — одна строка JSON:

{"ts":"...Z","cmd":"find","args":{...},"result":{...},"screenshot":"screenshots/001.png"}

Команда shot в активной сессии сохраняет PNG в screenshots/<n>_<cmd>.png и автоматически дописывает ссылку на него в actions.jsonl.

Enums

SessionError

Ошибка работы с session recorder.

Functions

active_session_id

ID активной сессии (содержимое файла current), если сессия запущена.

read_actions

Читает actions.jsonl активной сессии в вектор объектов (для тестов/отчётов).

read_session_meta

Метаданные сессии (state/session.json): время начала/окончания.

record_action

Записывает одно действие в actions.jsonl активной сессии (если она есть).

save_screenshot

Сохраняет base64-PNG ("base64:<data>") в screenshots/<counter>_<cmd>.png активной сессии и возвращает относительный путь (для записи в actions.jsonl).

start_session

Создаёт новую сессию, возвращает её id (имя каталога).

stop_session

Закрывает активную сессию: снимает маркер current, генерирует summary.md (хронологию) и возвращает путь к нему.

Type Aliases

Result

Результат операций session recorder.