sandbox-agent/docs
Nathan Flurry ac0a22cd07 feat: add PTY/terminal session support to Process Manager API
Add Docker-style terminal support with -t (TTY) and -i (interactive) flags:

Backend (Rust):
- Add portable-pty dependency for PTY allocation on Unix
- Extend StartProcessRequest with tty, interactive, and terminalSize options
- Add PTY process spawning with TERM=xterm-256color
- Add WebSocket endpoint for bidirectional terminal I/O
- Add terminal resize endpoint (POST /process/:id/resize)
- Add terminal input endpoint (POST /process/:id/input)
- Support base64-encoded binary input
- Process info now includes tty, interactive, and terminalSize fields
- Terminal output is logged to combined.log for persistence

Frontend (Inspector UI):
- Add @xterm/xterm and addons for terminal rendering
- Create Terminal component with xterm.js integration
- Add tabbed view (Terminal/Logs) for PTY processes
- Terminal auto-connects via WebSocket when process is expanded
- Support terminal resize with ResizeObserver
- Show PTY badge on processes with TTY enabled
- Graceful handling of process exit and disconnection

API:
- GET /v1/process/:id/terminal - WebSocket for terminal I/O
- POST /v1/process/:id/resize - Resize terminal (cols, rows)
- POST /v1/process/:id/input - Write data to terminal

WebSocket protocol:
- type: 'data' - Terminal output (server -> client)
- type: 'input' - Terminal input (client -> server)
- type: 'resize' - Resize request (client -> server)
- type: 'exit' - Process exited (server -> client)
- type: 'error' - Error message (server -> client)
2026-01-30 13:13:16 -08:00
..
ai chore: update skill install command to use rivet-dev/skills (#20) 2026-01-29 06:04:07 -08:00
deploy docs: install agents before starting server in E2B example 2026-01-28 05:22:58 -08:00
images docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
logo chore(site): links and image updates 2026-01-28 02:16:37 -08:00
sdks docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
building-chat-ui.mdx docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
cli.mdx docs: update CORS documentation for inspector defaults 2026-01-28 05:15:21 -08:00
conversion.mdx feat: add Claude adapter improvements for HITL support (#30) 2026-01-29 07:19:10 -08:00
cors.mdx docs: update CORS documentation for inspector defaults 2026-01-28 05:15:21 -08:00
docs.json docs: merge universal schema and coverage matrix into session-transcript-schema 2026-01-29 09:08:35 -08:00
favicon.svg docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
inspector.mdx docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
manage-sessions.mdx docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
openapi.json fix: use sandbox-agent CLI for credential extraction in tests and add delay for permission approval 2026-01-29 07:39:07 -08:00
process-terminal.md feat: add PTY/terminal session support to Process Manager API 2026-01-30 13:13:16 -08:00
quickstart.mdx docs: simplify quickstart examples with --no-token default (#39) 2026-01-30 00:03:23 -08:00
session-transcript-schema.mdx docs: merge universal schema and coverage matrix into session-transcript-schema 2026-01-29 09:08:35 -08:00
telemetry.mdx docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
theme.css docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
troubleshooting.mdx fix: detect musl/glibc at runtime for correct Claude binary download 2026-01-28 04:19:35 -08:00