session-investigator

Session Investigator to umiejętność do debugowania sesji fast-agent. Pozwala badać pliki session.json i history, aby zdiagnozować nieoczekiwane zakończenia sesji, pętle narzędzi, ślady sub-agentów oraz przepływ i timing rozmów. Zawiera wiedzę o strukturze metadanych, formacie JSON historii, korelacji wywołań narzędzi z wynikami i typowych wzorcach błędów.

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.