startup

type AutoRestartConfig struct {
	Enabled       bool          // Whether auto-restart is enabled
	MaxRestarts   int           // Max restarts within window (0 = unlimited)
	RestartWindow time.Duration // Time window for restart limit (default 1 minute)
	RestartDelay  time.Duration // Delay before restart (default 1 second)
	OnlyOnError   bool          // Only restart if exit code != 0
}

type AutoRestarterView interface {
	Register(processID string, config AutoRestartConfig, command string, args []string, env []string, expectedPorts []int, projectPath, workingDir string)
}

type Deps interface {
	ProcessManager() ProcessManagerView
	ScriptRegistry() ScriptRegistryView
	URLTracker() URLTrackerView
	AutoRestarter() AutoRestarterView
	StartupLog() *startuplog.StartupLogStore
}

type ProcessManagerView interface {
	StartOrReuse(ctx context.Context, cfg process.ProcessConfig) (*process.StartOrReuseResult, error)
	StopProcess(ctx context.Context, proc *process.ManagedProcess) error
	RemoveByPath(id string, projectPath string) bool
	KillProcessByPort(ctx context.Context, port int) ([]int, error)
}

type ScriptRegistryView interface {
	Register(name, projectPath string, cfg *script.Config) (*script.Entry, error)
	Get(name, projectPath string) (*script.Entry, bool)
	GetByProcessID(processID string) (*script.Entry, bool)
}

type StartScriptConfig struct {
	// ProcessID is the unique identifier for the process
	ProcessID string
	// ProjectPath is the root project directory (where .agnt.kdl is located).
	// Used for session association and proxy event handling.
	// If empty, defaults to WorkingDir.
	ProjectPath string
	// WorkingDir is the working directory for the process (may differ from ProjectPath
	// when script has cwd configured)
	WorkingDir string
	// Command is the executable to run
	Command string
	// Args are the command arguments
	Args []string
	// Env are environment variables (KEY=VALUE format)
	Env []string
	// ExpectedPorts are the ports the process is expected to use (for pre-flight cleanup and EADDRINUSE recovery)
	ExpectedPorts []int
	// URLMatchers are patterns for URL detection in output
	URLMatchers []string
	// AutoRestart enables automatic restart on process exit
	AutoRestart bool
	// AutoRestartConfig is optional custom restart configuration.
	// If nil, default config is used.
	AutoRestartConfig *AutoRestartConfig
	// StripProcessPrefix extracts the script name from a process ID.
	// If nil, the process ID is used as-is.
	StripProcessPrefix func(processID string) string
}

type StartScriptResult struct {
	Process *process.ManagedProcess
	Reused  bool // True if an existing process was reused
}

type StartupError struct {
	ProcessID string
	Port      int
	ErrorType string // "EADDRINUSE", "start_failed", "cleanup_failed", "retry_failed", "startup_failed"
	Message   string
	Output    string // Last lines of process output (for user-facing diagnostics)
	Retried   bool
}

type URLTrackerView interface {
	SetURLMatchers(processID string, matchers []string)
	ClearProcess(processID string)
}