log

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

type Options struct {
	// Verbose enables debug/info output to stderr (non-interactive only)
	Verbose bool
	// JSONFormat uses JSON output format for stderr
	JSONFormat bool
	// Interactive mode suppresses debug/info to stderr regardless of Verbose
	Interactive bool
	// DebugDir is the directory for debug log files. If empty, file logging is disabled.
	DebugDir string
	// RetentionDays is how many days to keep log files (0 = no cleanup)
	RetentionDays int
	// Stderr is the writer for stderr output (defaults to os.Stderr)
	Stderr io.Writer
}

type RunContext struct {
	RunID     string   // Unique run identifier
	RunName   string   // Human-readable name (e.g., "my-project")
	Agent     string   // Agent type (e.g., "claude", "codex")
	Workspace string   // Project directory basename
	Image     string   // Container image used
	Grants    []string // Active credential grants
}