| 1 | // Package persistentshell runs foreground bash commands in a session-scoped |
| 2 | // interpreter so cwd, exported variables, and shell functions survive across calls. |
| 3 | // POSIX hosts use a PTY; Windows Git Bash uses raw pipes to avoid ConPTY screen |
| 4 | // rendering corrupting Unicode output and completion fences. |
| 5 | // Command wrappers use ASCII-only byte escapes: interactive line editors must |
| 6 | // not reinterpret non-ASCII command bytes when the host has no UTF-8 locale. |
| 7 | // |
| 8 | // It is invisible to models: the bash tool schema and description stay |
| 9 | // byte-identical. Background jobs, commands that background a child, per-call |
| 10 | // write-root escalations, host terminals, and PowerShell hosts keep using |
| 11 | // one-shot processes; see Supports. |
| 12 | package persistentshell |
| 13 |