João Salavisa
c5c591b60b
Co-authored-by: Kandev Agent <agent@kandev.dev> Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
33 lines
1.5 KiB
Go
33 lines
1.5 KiB
Go
// Package ptyexec starts commands under a pseudo-terminal.
|
|
//
|
|
// It is the single home for PTY plumbing needed by more than one tier:
|
|
// the backend's login-PTY sessions (internal/agent/loginpty) and the agentctl
|
|
// sidecar's interactive terminals (internal/agentctl/server/process). Both
|
|
// previously carried byte-identical copies of the ConPTY wrapper and the Win32
|
|
// command-line quoting; the copies had already begun to drift, and only one of
|
|
// them was reachable by CI, so a bug fixed in one would not be fixed in the
|
|
// other.
|
|
//
|
|
// This package lives under internal/common because neither tier may own it:
|
|
// agentctl is uploaded into containers as a standalone binary, so it must not
|
|
// import backend packages, and the backend must not depend on the sidecar's
|
|
// internals. internal/common is the established neutral tier for exactly this
|
|
// (see internal/common/subproc, gitref, securityutil), and cmd/agentctl already
|
|
// depends on 15 packages from it.
|
|
//
|
|
// The Windows command-line helpers deliberately carry no build tag: they are
|
|
// pure string transformations, and the Win32 argument escaping they implement is
|
|
// security-sensitive enough that its tests should run on every CI runner rather
|
|
// than only the single Windows job.
|
|
package ptyexec
|
|
|
|
import "io"
|
|
|
|
// PtyHandle abstracts PTY operations across Unix and Windows.
|
|
// On Unix it wraps creack/pty (*os.File); on Windows it wraps ConPTY.
|
|
type PtyHandle interface {
|
|
io.ReadWriteCloser
|
|
// Resize changes the PTY window size.
|
|
Resize(cols, rows uint16) error
|
|
}
|