config

type AgentConfig struct {
	Includes        []string          `yaml:"includes,omitempty"` // TODO: these are added to the build context and image hash but never COPY'd into the image. Project root is already mounted at runtime. Do we still need this?
	EnvFile         []string          `yaml:"env_file,omitempty"`
	FromEnv         []string          `yaml:"from_env,omitempty"`
	Env             map[string]string `yaml:"env,omitempty"`
	Memory          string            `yaml:"memory,omitempty"`
	Editor          string            `yaml:"editor,omitempty"`
	Visual          string            `yaml:"visual,omitempty"`
	Shell           string            `yaml:"shell,omitempty"`
	ClaudeCode      *ClaudeCodeConfig `yaml:"claude_code,omitempty"`
	EnableSharedDir *bool             `yaml:"enable_shared_dir,omitempty"`
	PostInit        string            `yaml:"post_init,omitempty"`
}

type ArgDefinition struct {
	Name    string `yaml:"name"`
	Default string `yaml:"default,omitempty"`
}

type BuildConfig struct {
	Image        string              `yaml:"image"`
	Dockerfile   string              `yaml:"dockerfile,omitempty"`
	Packages     []string            `yaml:"packages,omitempty"`
	Context      string              `yaml:"context,omitempty"`
	BuildArgs    map[string]string   `yaml:"build_args,omitempty"`
	Instructions *DockerInstructions `yaml:"instructions,omitempty"`
	Inject       *InjectConfig       `yaml:"inject,omitempty"`
}

type ClaudeCodeConfig struct {
	Config      ClaudeCodeConfigOptions `yaml:"config"`
	UseHostAuth *bool                   `yaml:"use_host_auth,omitempty"`
}

type ClaudeCodeConfigOptions struct {
	Strategy string `yaml:"strategy"` // "copy" or "fresh"
}

type Config interface {
	ClawkerIgnoreName() string
	Project() *Project
	Settings() *Settings

	// ProjectStore returns the underlying project config store.
	// Prefer this over SetProject/WriteProject for direct store access.
	ProjectStore() *storage.Store[Project]

	// SettingsStore returns the underlying settings store.
	// Prefer this over SetSettings/WriteSettings for direct store access.
	SettingsStore() *storage.Store[Settings]

	// Deprecated: Use SettingsStore().Read().Logging instead.
	LoggingConfig() LoggingConfig

	// Deprecated: Use SettingsStore().Read().Monitoring instead.
	MonitoringConfig() MonitoringConfig

	// Deprecated: Use SettingsStore().Read().HostProxy instead.
	HostProxyConfig() HostProxyConfig

	Domain() string
	LabelDomain() string
	ConfigDirEnvVar() string
	StateDirEnvVar() string
	DataDirEnvVar() string
	TestRepoDirEnvVar() string
	MonitorSubdir() (string, error)
	BuildSubdir() (string, error)
	DockerfilesSubdir() (string, error)
	ClawkerNetwork() string
	LogsSubdir() (string, error)
	BridgesSubdir() (string, error)
	PidsSubdir() (string, error)
	BridgePIDFilePath(containerID string) (string, error)
	HostProxyLogFilePath() (string, error)
	HostProxyPIDFilePath() (string, error)
	ShareSubdir() (string, error)
	WorktreesSubdir() (string, error)
	LabelPrefix() string
	LabelManaged() string
	LabelMonitoringStack() string
	LabelProject() string
	LabelAgent() string
	LabelVersion() string
	LabelImage() string
	LabelCreated() string
	LabelWorkdir() string
	LabelPurpose() string
	LabelTestName() string
	LabelBaseImage() string
	LabelFlavor() string
	LabelTest() string
	LabelE2ETest() string
	ManagedLabelValue() string
	EngineLabelPrefix() string
	EngineManagedLabel() string
	ContainerUID() int
	ContainerGID() int
	GrafanaURL(host string, https bool) string
	JaegerURL(host string, https bool) string
	PrometheusURL(host string, https bool) string
	RequiredFirewallDomains() []string
	ProjectConfigFileName() string
	SettingsFileName() string
	ProjectRegistryFileName() string
	GetProjectRoot() (string, error)
	GetProjectIgnoreFile() (string, error)
}

type CopyInstruction struct {
	Src   string `yaml:"src"`
	Dest  string `yaml:"dest"`
	Chown string `yaml:"chown,omitempty"`
	Chmod string `yaml:"chmod,omitempty"`
}

type DockerInstructions struct {
	Copy        []CopyInstruction  `yaml:"copy,omitempty"`
	Env         map[string]string  `yaml:"env,omitempty"`
	Labels      map[string]string  `yaml:"labels,omitempty"`
	Expose      []ExposePort       `yaml:"expose,omitempty"`
	Args        []ArgDefinition    `yaml:"args,omitempty"`
	Volumes     []string           `yaml:"volumes,omitempty"`
	Workdir     string             `yaml:"workdir,omitempty"`
	Healthcheck *HealthcheckConfig `yaml:"healthcheck,omitempty"`
	Shell       []string           `yaml:"shell,omitempty"`
	UserRun     []RunInstruction   `yaml:"user_run,omitempty"`
	RootRun     []RunInstruction   `yaml:"root_run,omitempty"`
}

type ExposePort struct {
	Port     int    `yaml:"port"`
	Protocol string `yaml:"protocol,omitempty"` // "tcp" or "udp", defaults to tcp
}

type FirewallConfig struct {
	Enable         bool            `yaml:"enable"`
	AddDomains     []string        `yaml:"add_domains,omitempty"`
	IPRangeSources []IPRangeSource `yaml:"ip_range_sources,omitempty"`
}

type GitCredentialsConfig struct {
	ForwardHTTPS  *bool `yaml:"forward_https,omitempty"`   // Enable HTTPS credential forwarding (default: follows host_proxy)
	ForwardSSH    *bool `yaml:"forward_ssh,omitempty"`     // Enable SSH agent forwarding (default: true)
	ForwardGPG    *bool `yaml:"forward_gpg,omitempty"`     // Enable GPG agent forwarding (default: true)
	CopyGitConfig *bool `yaml:"copy_git_config,omitempty"` // Copy host .gitconfig (default: true)
}

type HealthcheckConfig struct {
	Cmd         []string `yaml:"cmd"`
	Interval    string   `yaml:"interval,omitempty"`
	Timeout     string   `yaml:"timeout,omitempty"`
	StartPeriod string   `yaml:"start_period,omitempty"`
	Retries     int      `yaml:"retries,omitempty"`
}

type HostProxyConfig struct {
	Manager HostProxyManagerConfig `yaml:"manager,omitempty"`
	Daemon  HostProxyDaemonConfig  `yaml:"daemon,omitempty"`
}

type HostProxyDaemonConfig struct {
	Port               int           `yaml:"port"`
	PollInterval       time.Duration `yaml:"poll_interval,omitempty"`
	GracePeriod        time.Duration `yaml:"grace_period,omitempty"`
	MaxConsecutiveErrs int           `yaml:"max_consecutive_errs,omitempty"`
}

type HostProxyManagerConfig struct {
	Port int `yaml:"port"`
}

type IPRangeSource struct {
	// Name is the identifier (e.g., "github", "google-cloud", "cloudflare")
	Name string `yaml:"name" json:"name"`
	// URL is an optional custom URL (uses built-in URL if empty for known sources)
	URL string `yaml:"url,omitempty" json:"url,omitempty"`
	// JQFilter extracts CIDR arrays from JSON response (optional, uses built-in if empty)
	JQFilter string `yaml:"jq_filter,omitempty" json:"jq_filter,omitempty"`
	// Required determines if failure to fetch is fatal (default: false)
	Required *bool `yaml:"required,omitempty" json:"required,omitempty"`
}

type InjectConfig struct {
	AfterFrom          []string `yaml:"after_from,omitempty"`
	AfterPackages      []string `yaml:"after_packages,omitempty"`
	AfterUserSetup     []string `yaml:"after_user_setup,omitempty"`
	AfterUserSwitch    []string `yaml:"after_user_switch,omitempty"`
	AfterClaudeInstall []string `yaml:"after_claude_install,omitempty"`
	BeforeEntrypoint   []string `yaml:"before_entrypoint,omitempty"`
}

type KeyNotFoundError struct {
	Key string
}

type LoggingConfig struct {
	FileEnabled *bool      `yaml:"file_enabled,omitempty"`
	MaxSizeMB   int        `yaml:"max_size_mb,omitempty"`
	MaxAgeDays  int        `yaml:"max_age_days,omitempty"`
	MaxBackups  int        `yaml:"max_backups,omitempty"`
	Compress    *bool      `yaml:"compress,omitempty"`
	Otel        OtelConfig `yaml:"otel,omitempty"`
}

type LoopConfig struct {
	MaxLoops                  int    `yaml:"max_loops,omitempty"`
	StagnationThreshold       int    `yaml:"stagnation_threshold,omitempty"`
	TimeoutMinutes            int    `yaml:"timeout_minutes,omitempty"`
	CallsPerHour              int    `yaml:"calls_per_hour,omitempty"`
	CompletionThreshold       int    `yaml:"completion_threshold,omitempty"`
	SessionExpirationHours    int    `yaml:"session_expiration_hours,omitempty"`
	SameErrorThreshold        int    `yaml:"same_error_threshold,omitempty"`
	OutputDeclineThreshold    int    `yaml:"output_decline_threshold,omitempty"`
	MaxConsecutiveTestLoops   int    `yaml:"max_consecutive_test_loops,omitempty"`
	LoopDelaySeconds          int    `yaml:"loop_delay_seconds,omitempty"`
	SafetyCompletionThreshold int    `yaml:"safety_completion_threshold,omitempty"`
	SkipPermissions           bool   `yaml:"skip_permissions,omitempty"`
	HooksFile                 string `yaml:"hooks_file,omitempty"`
	AppendSystemPrompt        string `yaml:"append_system_prompt,omitempty"`
}

type Mode string

type MonitoringConfig struct {
	OtelCollectorEndpoint string          `yaml:"otel_collector_endpoint,omitempty"`
	OtelCollectorPort     int             `yaml:"otel_collector_port,omitempty"`
	OtelCollectorHost     string          `yaml:"otel_collector_host,omitempty"`
	OtelCollectorInternal string          `yaml:"otel_collector_internal,omitempty"`
	OtelGRPCPort          int             `yaml:"otel_grpc_port,omitempty"`
	LokiPort              int             `yaml:"loki_port,omitempty"`
	PrometheusPort        int             `yaml:"prometheus_port,omitempty"`
	JaegerPort            int             `yaml:"jaeger_port,omitempty"`
	GrafanaPort           int             `yaml:"grafana_port,omitempty"`
	PrometheusMetricsPort int             `yaml:"prometheus_metrics_port,omitempty"`
	Telemetry             TelemetryConfig `yaml:"telemetry,omitempty"`
}

type OtelConfig struct {
	Enabled               *bool `yaml:"enabled,omitempty"`
	TimeoutSeconds        int   `yaml:"timeout_seconds,omitempty"`
	MaxQueueSize          int   `yaml:"max_queue_size,omitempty"`
	ExportIntervalSeconds int   `yaml:"export_interval_seconds,omitempty"`
}

type Project struct {
	Build     BuildConfig     `yaml:"build"`
	Agent     AgentConfig     `yaml:"agent"`
	Workspace WorkspaceConfig `yaml:"workspace"`
	Security  SecurityConfig  `yaml:"security"`
	Loop      *LoopConfig     `yaml:"loop,omitempty"`
}

type ProjectEntry struct {
	Name      string                   `yaml:"name"`
	Root      string                   `yaml:"root"`
	Worktrees map[string]WorktreeEntry `yaml:"worktrees,omitempty"`
}

type ProjectRegistry struct {
	Projects []ProjectEntry `yaml:"projects"`
}

type RunInstruction struct {
	Cmd    string `yaml:"cmd,omitempty"`    // Generic command for both OS
	Alpine string `yaml:"alpine,omitempty"` // Alpine-specific command
	Debian string `yaml:"debian,omitempty"` // Debian-specific command
}

type SecurityConfig struct {
	Firewall        *FirewallConfig       `yaml:"firewall,omitempty"`
	DockerSocket    bool                  `yaml:"docker_socket"`
	CapAdd          []string              `yaml:"cap_add,omitempty"`
	EnableHostProxy *bool                 `yaml:"enable_host_proxy,omitempty"` // defaults to true
	GitCredentials  *GitCredentialsConfig `yaml:"git_credentials,omitempty"`
}

type Settings struct {
	Logging    LoggingConfig    `yaml:"logging,omitempty"`
	Monitoring MonitoringConfig `yaml:"monitoring,omitempty"`
	HostProxy  HostProxyConfig  `yaml:"host_proxy,omitempty"`
}

type TelemetryConfig struct {
	MetricsPath            string `yaml:"metrics_path,omitempty"`
	LogsPath               string `yaml:"logs_path,omitempty"`
	MetricExportIntervalMs int    `yaml:"metric_export_interval_ms,omitempty"`
	LogsExportIntervalMs   int    `yaml:"logs_export_interval_ms,omitempty"`
	LogToolDetails         *bool  `yaml:"log_tool_details,omitempty"`
	LogUserPrompts         *bool  `yaml:"log_user_prompts,omitempty"`
	IncludeAccountUUID     *bool  `yaml:"include_account_uuid,omitempty"`
	IncludeSessionID       *bool  `yaml:"include_session_id,omitempty"`
}

type WorkspaceConfig struct {
	DefaultMode string `yaml:"default_mode"`
}

type WorktreeEntry struct {
	Path   string `yaml:"path"`
	Branch string `yaml:"branch,omitempty"`
}