pty.go RawHistoryFolder

1package ports
2
3import (
4	"context"
5	"io"
6
7	"github.com/bnema/vev/internal/domain"
8)
9
10// PTY is a running pseudo-terminal-backed child process.
11type PTY interface {
12	io.ReadWriteCloser // Read = child output, Write = child input
13	Resize(geometry domain.Geometry) error
14	Pid() int
15	ForegroundPgid() (int, error)
16}
17
18// PTYFactory creates PTYs by spawning a command attached to a new pseudo-terminal.
19type PTYFactory interface {
20	// Open creates a PTY while honoring ctx cancellation. Implementations must
21	// return promptly once ctx is cancelled and must not leave a child running.
22	// geometry is applied before the child starts, including optional pixel
23	// dimensions when they are known.
24	Open(ctx context.Context, cmd string, args []string, env []string, dir string, geometry domain.Geometry) (PTY, error)
25}