process

type Adapter struct {
	// contains filtered or unexported fields
}

type Command struct {
	// Binary is the executable path or name (resolved via PATH).
	Binary string
	// Args are the command-line arguments.
	Args []string
	// Dir is the working directory. If empty, uses the current directory.
	Dir string
	// Env is additional environment variables (key=value).
	// By default these are merged with the parent environment.
	Env []string
	// ScrubEnv starts from an empty environment instead of inheriting the parent.
	ScrubEnv bool
	// Stdin provides input to the process. May be nil. When set it takes precedence
	// over Input and is fed to the child, then closed.
	Stdin io.Reader
	// Input selects the stdin policy when Stdin is nil: closed (default) or inherited
	// from the parent process.
	Input InputPolicy
	// IO selects how stdout and stderr are wired. The zero value, IOCaptured, pipes both
	// into bounded buffers on Result. IOInherited forwards them to the parent's terminal
	// without capture. Stream always observes output live regardless of this field.
	IO IOMode
	// MaxOutputBytes bounds captured stdout and stderr independently. Zero
	// or negative means unlimited capture.
	MaxOutputBytes int
	// GracePeriod is how long to wait after SIGTERM before SIGKILL. Defaults to 5 seconds if zero.
	// When Lifecycle is set its GracePeriod takes precedence.
	GracePeriod time.Duration
	// Lifecycle configures process-group isolation and shutdown escalation. When nil,
	// Run and Stream apply DefaultLifecyclePolicy with GracePeriod honored as an override.
	Lifecycle *LifecyclePolicy
}

type Config struct {
	// Name identifies this adapter instance (used by provider.Provider interface).
	Name string `yaml:"name,omitempty" mapstructure:"name"`
	// GracePeriod is the default grace period for SIGTERM→SIGKILL.
	GracePeriod time.Duration `yaml:"grace_period,omitempty" mapstructure:"grace_period"`
	// Timeout is the default execution timeout. Zero means no timeout.
	Timeout time.Duration `yaml:"timeout,omitempty" mapstructure:"timeout"`
}

type IOMode int

type InputPolicy int

type LifecyclePolicy struct {
	// GracePeriod is how long to wait after graceful termination before kill escalation.
	GracePeriod time.Duration
	// IsolateProcessGroup places the child in a new process group where supported.
	IsolateProcessGroup bool
	// TerminateDescendants targets the whole process group rather than only the immediate child.
	TerminateDescendants bool
	// KillAfterGrace escalates to a force kill after GracePeriod expires. When false, no
	// escalation occurs: Run/Stream leave WaitDelay unset, so a child that ignores graceful
	// termination can block the call until it exits on its own or the context is canceled.
	KillAfterGrace bool
}

type PersistentConfig struct {
	// Readiness selects the readiness strategy. Defaults to ReadyImmediate.
	Readiness PersistentReadiness
	// OutputMarker is the substring awaited when Readiness is ReadyOnOutput.
	OutputMarker string
	// ReadyDelay is the wait applied when Readiness is ReadyAfterDelay.
	ReadyDelay time.Duration
	// ReadinessTimeout bounds how long StartPersistent waits for readiness. Defaults to 30s.
	ReadinessTimeout time.Duration
	// ShutdownGracePeriod is the wait after graceful termination before a force kill. Defaults to 5s.
	ShutdownGracePeriod time.Duration
	// MaxCaptureBytes bounds retained startup output per stream. Zero or negative means unbounded.
	MaxCaptureBytes int
	// Lifecycle configures process-group isolation and shutdown escalation.
	Lifecycle LifecyclePolicy
}

type PersistentProcess struct {
	// contains filtered or unexported fields
}

type PersistentReadiness int

type PersistentRun struct {
	// Startup is the output captured up to the moment readiness completed.
	Startup PersistentStartup
	// Process is the running persistent process handle.
	Process *PersistentProcess
}

type PersistentStartErrorKind string

type PersistentStartup struct {
	// Stdout is the stdout captured at the moment readiness completed.
	Stdout []byte
	// StdoutTruncated reports whether startup stdout exceeded MaxCaptureBytes.
	StdoutTruncated bool
	// Stderr is the stderr captured at the moment readiness completed.
	Stderr []byte
	// StderrTruncated reports whether startup stderr exceeded MaxCaptureBytes.
	StderrTruncated bool
	// Duration is the time from spawn until readiness completed.
	Duration time.Duration
}

type Result struct {
	// Stdout is the captured standard output.
	Stdout []byte
	// StdoutTruncated reports whether stdout exceeded MaxOutputBytes.
	StdoutTruncated bool
	// Stderr is the captured standard error.
	Stderr []byte
	// StderrTruncated reports whether stderr exceeded MaxOutputBytes.
	StderrTruncated bool
	// ExitCode is the process exit code. -1 if the process was killed.
	ExitCode int
	// Duration is how long the process ran.
	Duration time.Duration
	// TimedOut reports whether the process was killed because the context deadline was exceeded.
	TimedOut bool
	// Canceled reports whether the process was killed because the context was canceled by the caller.
	Canceled bool
}

type Runner struct {
	// contains filtered or unexported fields
}

type ShutdownOutcome struct {
	// AlreadyExited reports whether the process had already exited before shutdown was requested.
	AlreadyExited bool
	// Result is the completed process result.
	Result *Result
}

type StreamChunk struct {
	Stream StreamName
	Data   []byte
}

type StreamName string

type SubprocessProvider[I, O any] struct {
	// contains filtered or unexported fields
}

type Supervisor struct {
	// contains filtered or unexported fields
}

type TrackHandle int