session-investigator

Investigate fast-agent session and history files to diagnose issues. Use when a session ended unexpectedly, when debugging tool loops, when correlating sub-agent traces with main sessions, or when analyzing conversation flow and timing. Covers session.json metadata, history JSON format, message structure, tool call/result correlation, and common failure patterns.

1. Zlokalizuj katalog sesji w .fast-agent/sessions/ — każda sesja ma unikalny identyfikator w formacie YYMMDDHHMM-random (np. 2601181023-Kob2h3), który koduje datę i godzinę utworzenia.

2. Otwórz plik session.json z katalogu sesji, aby sprawdzić metadane: nazwę agenta, czas utworzenia, ostatnią aktywność oraz listę powiązanych plików historii.

3. Przeanalizuj plik history_<agent>.json, aby zbadać strukturę wiadomości — każda wiadomość zawiera rolę (user/assistant), zawartość tekstową, wywołania narzędzi i ich wyniki.

4. Sprawdź kanały dodatkowe w historii: fast-agent-timing zawiera czasy wykonania, fast-agent-tool-timing pokazuje czas każdego narzędzia, a reasoning zawiera logikę agenta.

5. Szukaj anomalii: niezgodności między wywołaniami narzędzi a wynikami, błędy w polu isError, nieoczekiwane stop_reason lub długie czasy wykonania wskazujące na pętle.

6. W razie potrzeby porównaj z plikiem history_<agent>_previous.json — jest to kopia zapasowa z poprzedniego zapisu, która pomaga śledzić zmiany w sesji.