imp

type ExecutionSession interface {
	Session
	InitiateNamedPipeForUser(ctx context.Context, connectionId connection.Id, purpose net.Purpose, user, group string) (net.NamedPipe, error)

	// GetExecutionExitCode returns the exit code for one execution, or
	// [connection.ErrNotFound] if its result is not available yet.
	GetExecutionExitCode(ctx context.Context, connectionId connection.Id, executionId execution.Id) (int, error)

	// KillExecution will try to kill the process with the given signal.
	// If pid is 0, the process will be resolved from the provided execution ID.
	KillExecution(ctx context.Context, connectionId connection.Id, executionId execution.Id, pid int, signal sys.Signal) error
}

type Imp interface {
	io.Closer
	Open(context.Context, Ref) (Session, error)
	GetMasterPublicKey() (crypto.PublicKey, error)
}

type Ref interface {
	SessionId() session.Id
	PublicKey() crypto.PublicKey
	Dial(context.Context) (gonet.Conn, error)
}

type Service struct {
	Version                    sys.Version
	ExitCodeByConnectionIdPath string
	Addr                       string
	MasterPublicKey            crypto.PublicKey
	SessionId                  session.Id
	ReverseTCPUser             string
	ReverseTCPUserConfigured   bool

	Logger log.Logger
}

type Session interface {
	io.Closer
	Ping(ctx context.Context, connectionId connection.Id) error
	InitiateTcpForward(ctx context.Context, connectionId connection.Id, target net.HostPort) (gonet.Conn, error)
	InitiateNamedPipe(ctx context.Context, connectionId connection.Id, purpose net.Purpose) (net.NamedPipe, error)
	ListenReverseTCP(ctx context.Context, connectionId connection.Id, host string, port uint16) (gonet.Listener, error)

	// GetConnectionExitCode returns the legacy connection-scoped exit code, or
	// [connection.ErrNotFound] if its result is not available yet.
	GetConnectionExitCode(ctx context.Context, connectionId connection.Id) (int, error)

	GetEnvironment(ctx context.Context, connectionId connection.Id) (sys.EnvVars, error)

	// Kill will try to kill the process with the given signal.
	// If pid is 0, the process will be resolved from the provided connection ID.
	Kill(ctx context.Context, connectionId connection.Id, pid int, signal sys.Signal) error
}