executor

type ClaudeExecutor struct {
	Command        string            // command to execute, defaults to "claude"
	Args           string            // additional arguments (space-separated), defaults to standard args
	ArgsSet        bool              // true when Args was explicitly set, including an empty value
	Model          string            // model override (e.g., "opus", "sonnet", "haiku"); empty = CLI default
	Effort         string            // reasoning effort override (e.g., "low", "medium", "high", "xhigh", "max"); empty = CLI default
	OutputHandler  func(text string) // called for each text chunk, can be nil
	Debug          bool              // enable debug output
	ErrorPatterns  []string          // patterns to detect in output (e.g., rate limit messages)
	LimitPatterns  []string          // patterns to detect rate limits (checked before error patterns)
	IdleTimeout    time.Duration     // kill session after this duration of no output, zero = disabled
	PreserveAPIKey bool              // when true, ANTHROPIC_API_KEY is passed through to the child; default false strips it
	// contains filtered or unexported fields
}

type CodexExecutor struct {
	Command         string            // command to execute, defaults to "codex"
	Model           string            // model override; empty means inherit from ~/.codex/config.toml (no -c model= flag emitted)
	ReasoningEffort string            // reasoning effort override; empty means inherit from ~/.codex/config.toml
	TimeoutMs       int               // stream idle timeout in ms, defaults to 3600000
	Sandbox         string            // sandbox mode, defaults to "read-only"
	ProjectDoc      string            // path to project documentation file
	OutputHandler   func(text string) // called for each filtered output line in real-time
	Debug           bool              // enable debug output
	ErrorPatterns   []string          // patterns to detect in output (e.g., rate limit messages)
	LimitPatterns   []string          // patterns to detect rate limits (checked before error patterns)
	MultiAgent      bool              // enable codex multi_agent feature + reviewer agent registration; set to true on the review-phase codex instance built by processor.New() for first-class --codex mode
	PassClaudeMd    bool              // pass project-level CLAUDE.md to codex via project_doc_fallback_filenames (set by processor.New() only when cfg.AppConfig.Executor == ExecutorCodex)
	IdleTimeout     time.Duration     // kill session after this duration of no output, zero = disabled
	// contains filtered or unexported fields
}

type CodexRunner interface {
	Run(ctx context.Context, name string, args ...string) (streams CodexStreams, wait func() error, err error)
}

type CodexStreams struct {
	Stderr io.Reader
	Stdout io.Reader
}

type CommandRunner interface {
	Run(ctx context.Context, name string, args ...string) (output io.Reader, wait func() error, err error)
}

type CustomExecutor struct {
	Script        string            // path to the custom review script
	OutputHandler func(text string) // called for each output line, can be nil
	ErrorPatterns []string          // patterns to detect in output (e.g., rate limit messages)
	LimitPatterns []string          // patterns to detect rate limits (checked before error patterns)
	// contains filtered or unexported fields
}

type CustomRunner interface {
	Run(ctx context.Context, script, promptFile string) (stdout io.Reader, wait func() error, err error)
}

type LimitPatternError struct {
	Pattern string // the pattern that matched
	HelpCmd string // command to run for more information
}

type PatternMatchError struct {
	Pattern string // the pattern that matched
	HelpCmd string // command to run for more information (e.g., "claude /usage")
}

type Result struct {
	Output       string // accumulated text output
	RecentText   string // last 10 text blocks joined, used for pattern matching to avoid false positives
	Signal       string // detected signal (COMPLETED, FAILED, etc.) or empty
	Error        error  // execution error if any
	IdleTimedOut bool   // true when idle timeout fired (derived context canceled, parent alive)
}