harivansh-afk/sandbox-agent
1
0
Fork 0
mirror of https://github.com/harivansh-afk/sandbox-agent.git synced 2026-04-21 23:04:46 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

chore: specs for unimplemented work

Browse source
This commit is contained in:
Nathan Flurry 2026-02-04 13:42:09 -08:00
parent ef3e811c94
commit f0912c333c
No known key found for this signature in database
GPG key ID: 6A5F43A4F3241BCA
14 changed files with 367 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

28
research/specs/pty-management.md Normal file
View file

@ -0,0 +1,28 @@
# Spec: PTY Management
**Proposed API Changes**
- Add a PTY manager to the core session manager to spawn, track, and stream terminal processes.
- Define a PTY IO channel for OpenCode connect operations (SSE or websocket).
**Summary**
OpenCode expects a PTY lifecycle API with live IO. We need real PTY creation and streaming output/input handling.
**OpenCode Endpoints (Reference)**
- `GET /opencode/pty`
- `POST /opencode/pty`
- `GET /opencode/pty/{ptyID}`
- `PUT /opencode/pty/{ptyID}`
- `DELETE /opencode/pty/{ptyID}`
- `GET /opencode/pty/{ptyID}/connect`
**Core Functionality Required**
- Spawn PTY processes with configurable cwd/args/title/env.
- Track PTY state (running/exited), pid, exit code.
- Streaming output channel with backpressure handling.
- Input write support with safe buffering.
- Cleanup on session termination.
**OpenCode Compat Wiring + Tests**
- Replace stubs for `/pty` and `/pty/{ptyID}` endpoints.
- Implement `/pty/{ptyID}/connect` streaming with real PTY IO.
- Add E2E tests for PTY spawn, output capture, and input echo.