session-execution

Session Execution to umiejętność dla deweloperów pracujących z architekturą wykonywania poleceń w Cloudflare Sandbox SDK. Pomaga w zrozumieniu i debugowaniu dwóch trybów wykonania: trybu foreground (exec) z trwałym stanem oraz trybu background (execStream/startProcess) ze strumieniowaniem przez FIFO. Zawiera wiedzę o separacji stdout/stderr za pomocą prefiksów binarnych, obsłudze kodów wyjścia oraz detekcji zakończenia poleceń. Niezbędna przy pracy nad session.ts, obsługą poleceń, oraz zarządzaniem procesami shell.

1. Zainstaluj umiejętność session-execution z repozytorium Cloudflare sandbox-sdk, dodając ją do swojego projektu jako skill w konfiguracji MCP.
2. Przeczytaj dokumentację docs/SESSION_EXECUTION.md aby zrozumieć architekturę niezawodnego wykonywania poleceń i separacji strumieni wyjścia.
3. Podczas debugowania poleceń shell zwróć uwagę na wybrany tryb wykonania: jeśli pracujesz z exec, pamiętaj że stan persystuje w głównym shellu i używane są pliki tymczasowe do przechwycenia wyjścia; jeśli z execStream lub startProcess, wiesz że polecenia działają w podshelu przez FIFO z prefiksami etykiet.
4. Weryfikuj obsługę kodów wyjścia poprzez sprawdzenie atomowych operacji zapisu do pliku .exit (najpierw do .tmp, potem mv) oraz upewnij się że FIFO są czyszczone w ścieżkach błędów.
5. Testuj polecenia niemające wyjścia (cd, przypisanie zmiennej) oraz duże wyjścia aby wykryć potencjalne zawieszenia lub problemy z buforowaniem logów.
6. Analizując wyścigi danych pamiętaj że mutex serializuje wykonanie poleceń w sesji — sprawdź czy operacje zachodzą w tej samej sesji (chronione mutexem) czy między sesjami (tam wyścigi są możliwe).