Summary

• Add an optional timeout setting to PythonShell options
• Reject timed-out runs with a timeout error and preserve collected logs
• Honor killSignal, flush buffered splitter output, handle parser errors during timeout flush, and use a SIGKILL fallback when the timeout signal is ignored
• Clear timeout timers on spawn failures

Context

Fixes #96.

Verification

• npm test -- --grep 'timeout|bad path|fails to spawn'
• npm test (run outside the sandbox because Python's py_compile test writes bytecode under ~/Library/Caches)
• npx prettier --check README.md index.ts test/test-python-shell.ts
• git diff --check
• review-fix-loop: no actionable regressions found