protocol

type Connection interface {
	fmt.Stringer
	// Protocol returns the protocol family, such as "SSH", "WinRM", or "Local".
	// Both the native SSH and OpenSSH implementations return "SSH".
	// Custom or test implementations may return other values.
	Protocol() string
	// ProtocolName returns the specific implementation name, such as "SSH",
	// "OpenSSH", "WinRM", or "Local". Use this for logging or diagnostics
	// where the distinction between native SSH and OpenSSH matters. Custom
	// or test implementations may return other values.
	ProtocolName() string
	// IsConnected returns true if the connection is currently active.
	// Built-in implementations attempt an active liveness probe where
	// possible (e.g. SSH keepalive, ssh -O check for OpenSSH multiplexing,
	// or a no-op command for WinRM), but some implementations may skip the
	// probe or always return true (e.g. Localhost). Callers should be aware
	// this may block up to a timeout (typically 10s) and may cause
	// side-effects on the remote.
	IsConnected() bool
	IPAddress() string
	ProcessStarter
	WindowsChecker
}

type Connector interface {
	Connect(ctx context.Context) error
}

type Disconnector interface {
	Disconnect()
}

type InteractiveExecer interface {
	ExecInteractive(ctx context.Context, cmd string, stdin io.Reader, stdout io.Writer, stderr io.Writer) error
}

type ProcessStarter interface {
	StartProcess(ctx context.Context, cmd string, stdin io.Reader, stdout io.Writer, stderr io.Writer) (Waiter, error)
}

type Waiter interface {
	Wait() error
}

type WindowsChecker interface {
	IsWindows() bool
}