shell.go RawHistoryFolder

1package ports
2
3import (
4	"context"
5	"time"
6)
7
8// CommandSpec describes a bounded shell command execution request.
9type CommandSpec struct {
10	Command     string
11	Env         []string
12	Timeout     time.Duration
13	StdoutLimit int
14	StderrLimit int
15}
16
17// ShellCommandResult carries bounded output and the process exit status.
18// ExitCode is 0 when the command ran to completion successfully, the process
19// exit code when it ran and failed, and -1 when the command could not be
20// started or was terminated by a signal.
21type ShellCommandResult struct {
22	Stdout   []byte
23	Stderr   []byte
24	ExitCode int
25}
26
27// ShellCommandRunner runs shell commands and returns bounded output.
28type ShellCommandRunner interface {
29	Run(ctx context.Context, spec CommandSpec) (ShellCommandResult, error)
30}