config

type ActiveHoursConfig struct {
	Start    string `json:"start"`    // HH:MM (24h), inclusive (e.g. "09:00")
	End      string `json:"end"`      // HH:MM (24h), exclusive (e.g. "22:00"); "24:00" allowed
	Timezone string `json:"timezone"` // IANA timezone or "local" (default: agents.defaults.userTimezone)
}

type AgentDef struct {
	ID              string       `json:"id"`
	Default         bool         `json:"default"`
	Identity        Identity     `json:"identity"`
	Capabilities    []Capability `json:"capabilities,omitempty"` // agent skills for capability-based routing
	CLICommand      string       `json:"cliCommand"`             // if set, this agent delegates to a CLI subprocess
	CLIArgs         []string     `json:"cliArgs"`                // args prepended before the message, e.g. ["-p"] for claude -p
	MaxConcurrent   int          `json:"maxConcurrent"`          // orchestrator: max parallel subtasks (default 5)
	ProgressUpdates bool         `json:"progressUpdates"`        // orchestrator: send per-task completion updates
	Async           bool         `json:"async"`                  // if true, runs via TaskManager (non-blocking)
}

type AgentDefaults struct {
	Engine            string                     `json:"engine"`    // "router" (default) or "claude-cli"
	CLIEngine         CLIEngineConfig            `json:"cliEngine"` // config when engine="claude-cli"
	Model             ModelConfig                `json:"model"`
	Models            map[string]ModelAliasEntry `json:"models"` // model-id → {alias}; used for reverse alias lookup
	Subagents         SubagentsConfig            `json:"subagents"`
	Workspace         string                     `json:"workspace"`
	UserTimezone      string                     `json:"userTimezone"`
	TimeoutSeconds    int                        `json:"timeoutSeconds"`
	MaxConcurrent     int                        `json:"maxConcurrent"`
	ContextPruning    ContextPruning             `json:"contextPruning"`
	LoopDetectionN    int                        `json:"loopDetectionN"`    // consecutive identical tool calls to trigger break (default 3)
	ToolLoopDetection ToolLoopDetectionConfig    `json:"toolLoopDetection"` // multi-detector loop detection (REQ-410)
	MaxIterations     int                        `json:"maxIterations"`     // max tool-call rounds per turn (default 200)
	SoftTrimRatio     float64                    `json:"softTrimRatio"`     // fraction of model max tokens to trigger soft trim (default 0.0 = disabled)
	Compaction        CompactionConfig           `json:"compaction"`        // compaction model/timeout overrides
	Thinking          ThinkingConfig             `json:"thinking"`          // extended thinking (Anthropic models)
	Memory            MemoryConfig               `json:"memory"`            // persistent memory files
	Sandbox           SandboxConfig              `json:"sandbox"`           // Docker exec sandbox
	Heartbeat         HeartbeatConfig            `json:"heartbeat"`         // parsed for config compat; not implemented
}

type Agents struct {
	Defaults AgentDefaults `json:"defaults"`
	List     []AgentDef    `json:"list"`
}

type BrowserConfig struct {
	Enabled    bool   `json:"enabled"`
	Headless   *bool  `json:"headless"`   // nil = default true when Enabled
	ChromePath string `json:"chromePath"` // empty = auto-detect
	NoSandbox  bool   `json:"noSandbox"`  // launch Chrome with --no-sandbox (required in some containers)
	Width      int    `json:"width"`      // viewport width (default 1280)
	Height     int    `json:"height"`     // viewport height (default 900)
}

type CLIEngineConfig struct {
	Command      string   `json:"command"`      // path/name of claude binary (default "claude")
	Model        string   `json:"model"`        // model to request (e.g. "sonnet", "opus")
	MCPConfig    string   `json:"mcpConfig"`    // path to MCP config JSON for Roger tools
	SystemPrompt string   `json:"systemPrompt"` // custom system prompt override
	ExtraArgs    []string `json:"extraArgs"`    // additional CLI flags
	IdleTTLSec   int      `json:"idleTTLSec"`   // idle subprocess reap timeout in seconds (default 1800)
}

type Capability struct {
	Name        string   `json:"name"`                  // e.g. "code-review", "research"
	Description string   `json:"description,omitempty"` // human-readable description
	Tags        []string `json:"tags"`                  // searchable labels
	Strength    float64  `json:"strength"`              // 0.0-1.0, default 1.0
}

type Channels struct {
	Telegram TelegramConfig `json:"telegram"`
	Discord  DiscordConfig  `json:"discord"`
	Slack    SlackConfig    `json:"slack"`
}

type CompactionConfig struct {
	Model          string `json:"model"`          // provider/model override for compaction (empty = use primary)
	TimeoutSeconds int    `json:"timeoutSeconds"` // per-compaction timeout (0 = no separate timeout)
}

type ContextPruning struct {
	Mode               string  `json:"mode"`
	TTL                string  `json:"ttl"`
	KeepLastAssistants int     `json:"keepLastAssistants"`
	HardClearRatio     float64 `json:"hardClearRatio"`
	SoftTrimRatio      float64 `json:"softTrimRatio"`   // OpenClaw nests this here
	ModelMaxTokens     int     `json:"modelMaxTokens"`  // max context tokens for the model (default 128000)
	SurgicalPruning    *bool   `json:"surgicalPruning"` // prefer trimming tool results over hard clear (default true)
	CacheTTLSeconds    int     `json:"cacheTtlSeconds"` // seconds to defer pruning after last API call (default 0 = immediate)
}

type ControlUI struct {
	Enabled  bool   `json:"enabled"`
	BasePath string `json:"basePath"`
}

type DigestConfig struct {
	Enabled    bool   `json:"enabled"`
	Schedule   string `json:"schedule"`      // "daily" or "weekly" (default "daily")
	Hour       int    `json:"hour"`          // hour of day to run (0-23), default 8
	Timezone   string `json:"timezone"`      // IANA timezone, default "America/New_York"
	Target     string `json:"target"`        // delivery target: "last" (all paired), "none"
	LookbackH  int    `json:"lookbackHours"` // hours to look back, default 24 for daily
	MaxEntries int    `json:"maxEntries"`    // max entries to summarize, default 50
}

type Dirs struct {
	Config string // user-authored config (no secrets)
	State  string // runtime state, credentials, retry queues
	Data   string // workspace, agents, cron, sessions
}

type DiscordConfig struct {
	Enabled        bool     `json:"enabled"`
	BotToken       string   `json:"botToken"`
	DMPolicy       string   `json:"dmPolicy"`       // "pairing" or "allowlist"
	AllowUsers     []string `json:"allowUsers"`     // Discord user IDs (snowflakes, for allowlist mode)
	StreamMode     string   `json:"streamMode"`     // "partial" or ""
	ReplyToMode    string   `json:"replyToMode"`    // "first" or ""
	TimeoutSeconds int      `json:"timeoutSeconds"` // agent call timeout (default 300)
	AckEmoji       string   `json:"ackEmoji"`       // default "eyes"
}

type EideticConfig struct {
	Enabled         bool    `json:"enabled"`
	BaseURL         string  `json:"baseURL"`              // default "http://localhost:7700"
	APIKey          string  `json:"apiKey"`               // Bearer token
	AgentID         string  `json:"agentID"`              // override agent_id; defaults to agent def ID
	RecentLimit     int     `json:"recentLimit"`          // entries injected into system prompt (default 20)
	SearchLimit     int     `json:"searchLimit"`          // max results for eidetic_search tool (default 10)
	SearchThreshold float64 `json:"searchThreshold"`      // cosine similarity threshold (default 0.5)
	TimeoutSeconds  int     `json:"timeoutSeconds"`       // per-request timeout (default 5)
	RecallEnabled   *bool   `json:"recallEnabled"`        // semantic recall per turn (default true when eidetic enabled)
	RecallLimit     int     `json:"recallLimit"`          // max recalled entries per turn (default 5)
	RecallThreshold float64 `json:"recallThreshold"`      // min relevance for recalled entries (default 0.4)
	RecallTimeoutS  int     `json:"recallTimeoutSeconds"` // per-recall timeout; 0 = use timeoutSeconds (default 5)

	// Embeddings enables client-side vector embedding generation.
	// When configured, Roger generates embeddings before storing memories
	// and uses hybrid (keyword + vector) search for retrieval.
	Embeddings EmbeddingsConfig `json:"embeddings"`
}

type EmbeddingsConfig struct {
	Enabled    bool   `json:"enabled"`              // generate embeddings on store, use hybrid search
	Provider   string `json:"provider"`             // provider name for base URL lookup (e.g. "ollama", "openai")
	Model      string `json:"model"`                // embedding model ID (e.g. "nomic-embed-text", "text-embedding-3-small")
	BaseURL    string `json:"baseURL"`              // override provider default endpoint
	APIKey     string `json:"apiKey"`               // API key (empty = "no-key" for local providers)
	Dimensions int    `json:"dimensions,omitempty"` // optional truncated dimensions (0 = model default)
}

type ExecConfig struct {
	TimeoutSec          int      `json:"timeoutSec"`
	BackgroundMs        int      `json:"backgroundMs"`
	BackgroundHardTimeM int      `json:"backgroundHardTimeM"` // hard kill for bg processes in minutes (default 30)
	MaxOutputChars      int      `json:"maxOutputChars"`      // output truncation limit (default 100000)
	DenyCommands        []string `json:"denyCommands"`        // empty = no restriction (backward-compatible)
	DangerousPatterns   []string `json:"dangerousPatterns"`   // extra patterns that trigger confirmation (merged with builtins)
	ConfirmTimeoutSec   int      `json:"confirmTimeoutSec"`   // timeout for destructive command confirmation (default 60)
}

type FilesConfig struct {
	AllowPaths []string `json:"allowPaths"` // empty = no restriction (backward-compatible)
}

type Gateway struct {
	Port            int             `json:"port"`
	Bind            string          `json:"bind"`
	ControlUI       ControlUI       `json:"controlUi"`
	Auth            GatewayAuth     `json:"auth"`
	Reload          GatewayReload   `json:"reload"`
	RateLimit       RateLimitConfig `json:"rateLimit"`
	WebhookSecret   string          `json:"webhookSecret"`   // HMAC-SHA256 secret for webhook signature validation
	ReadTimeoutSec  int             `json:"readTimeoutSec"`  // HTTP read timeout in seconds (default 300)
	WriteTimeoutSec int             `json:"writeTimeoutSec"` // HTTP write timeout in seconds (default 600)
}

type GatewayAuth struct {
	Mode  string `json:"mode"`
	Token string `json:"token"`
}

type GatewayReload struct {
	Mode       string `json:"mode"`       // "hybrid", "poll", ""
	DebounceMs int    `json:"debounceMs"` // e.g. 300
}

type GatewayState struct {
	GeneratedToken string `json:"generatedToken,omitempty"`
}

type GroupConfig struct {
	RequireMention bool `json:"requireMention"`
}

type HealthConfig struct {
	Enabled          bool `json:"enabled"`          // enable health tracking with circuit breakers (default false)
	FailureThreshold int  `json:"failureThreshold"` // consecutive failures to trip circuit (default 5)
	ResetTimeoutS    int  `json:"resetTimeoutS"`    // seconds before circuit resets to half-open (default 60)
}

type HeartbeatConfig struct {
	Every        string             `json:"every"`        // interval duration string, e.g. "30m", "1h" (default "30m"; empty or "0" = disabled)
	ActiveHours  *ActiveHoursConfig `json:"activeHours"`  // optional time-of-day window
	Target       string             `json:"target"`       // delivery target: "last", "none", channel name (default "none")
	Model        string             `json:"model"`        // optional model override for heartbeat turns
	Prompt       string             `json:"prompt"`       // custom prompt (default: read HEARTBEAT.md)
	AckMaxChars  int                `json:"ackMaxChars"`  // max trailing chars after HEARTBEAT_OK before forcing delivery (default 300)
	LightContext bool               `json:"lightContext"` // minimal bootstrap context (identity + HEARTBEAT.md only)
	DirectPolicy string             `json:"directPolicy"` // "allow" (default) or "block"
}

type Identity struct {
	Name  string `json:"name"`
	Theme string `json:"theme"`
	Emoji string `json:"emoji"`
}

type Logging struct {
	Level           string `json:"level"`
	File            string `json:"file"`
	ConsoleLevel    string `json:"consoleLevel"`
	RedactSensitive string `json:"redactSensitive"`
}

type MemoryConfig struct {
	Enabled bool `json:"enabled"` // load MEMORY.md into system prompt, enable memory tools
}

type MessageQueue struct {
	Mode       string `json:"mode"`       // "collect" or ""
	DebounceMs int    `json:"debounceMs"` // e.g. 300
	Cap        int    `json:"cap"`
}

type Messages struct {
	Queue            MessageQueue `json:"queue"`
	AckReactionScope string       `json:"ackReactionScope"` // "group-mentions", "all", ""
	Usage            string       `json:"usage"`            // "off" (default), "tokens"
	StreamEditMs     int          `json:"streamEditMs"`     // streaming message edit interval in ms (default 400)
}

type Meta struct {
	LastTouchedVersion string `json:"lastTouchedVersion"`
}

type ModelAliasEntry struct {
	Alias string `json:"alias"`
}

type ModelConfig struct {
	Primary   string   `json:"primary"`
	Fallbacks []string `json:"fallbacks"`
}

type PostgresConfig struct {
	DSN string `json:"dsn"` // e.g. "postgres://eidetic:eidetic@localhost:5432/eidetic"
}

type ProviderConfig struct {
	APIKey  string `json:"apiKey"`
	BaseURL string `json:"baseURL"` // empty = use provider default
}

type RateLimitConfig struct {
	RPS   float64 `json:"rps"`   // max requests per second per IP (0 = disabled)
	Burst int     `json:"burst"` // burst capacity (default max(1, rps))
}

type ReasoningConfig struct {
	Enabled   bool   `json:"enabled"`  // run reasoning cycles (default true when surfaces enabled)
	IntervalS string `json:"interval"` // duration string, e.g. "3m" (default "3m")
	Model     string `json:"model"`    // optional model override for reasoning turns
}

type Root struct {
	Env       map[string]string          `json:"env"`
	Providers map[string]*ProviderConfig `json:"providers"`
	Logging   Logging                    `json:"logging"`
	Agents    Agents                     `json:"agents"`
	Tools     Tools                      `json:"tools"`
	Session   Session                    `json:"session"`
	Channels  Channels                   `json:"channels"`
	Gateway   Gateway                    `json:"gateway"`
	Messages  Messages                   `json:"messages"`
	TaskQueue TaskQueueConfig            `json:"taskQueue"`
	Update    UpdateConfig               `json:"update"`
	Eidetic   EideticConfig              `json:"eidetic"`
	Surfaces  SurfacesConfig             `json:"surfaces"`
	Digest    DigestConfig               `json:"digest"`
	Health    HealthConfig               `json:"health"`

	// Path is the filesystem path this config was loaded from (not serialized).
	Path string `json:"-"`
	// Dirs holds the resolved XDG directory layout (not serialized).
	Dirs Dirs `json:"-"`
}

type SandboxConfig struct {
	Enabled      bool     `json:"enabled"`
	Image        string   `json:"image"`        // Docker image, e.g. "ubuntu:22.04"
	Mounts       []string `json:"mounts"`       // "host:container:mode" bind mounts
	SetupCommand string   `json:"setupCommand"` // run once after container creation
}

type Session struct {
	Scope         string       `json:"scope"`
	ResetTriggers []string     `json:"resetTriggers"`
	Reset         SessionReset `json:"reset"`
	IdleMinutes   int          `json:"idleMinutes"`   // top-level shorthand (default 120)
	MaxConcurrent int          `json:"maxConcurrent"` // max concurrent requests per agent (default 2)
}

type SessionReset struct {
	Mode        string `json:"mode"`
	AtHour      *int   `json:"atHour"` // nil = default 4 for daily mode
	IdleMinutes int    `json:"idleMinutes"`
}

type SlackConfig struct {
	Enabled        bool     `json:"enabled"`
	BotToken       string   `json:"botToken"`       // xoxb-...
	AppToken       string   `json:"appToken"`       // xapp-... (Socket Mode)
	AllowUsers     []string `json:"allowUsers"`     // Slack user IDs; empty = all workspace members
	StreamMode     string   `json:"streamMode"`     // "partial" or ""
	TimeoutSeconds int      `json:"timeoutSeconds"` // agent call timeout (default 300)
	AckEmoji       string   `json:"ackEmoji"`       // default "eyes"
}

type State struct {
	Meta    StateMeta    `json:"meta"`
	Wizard  StateWizard  `json:"wizard"`
	Gateway GatewayState `json:"gateway"`
}

type StateMeta struct {
	LastTouchedAt      string `json:"lastTouchedAt"`
	LastTouchedVersion string `json:"lastTouchedVersion"`
}

type StateWizard struct {
	LastRunAt      string `json:"lastRunAt,omitempty"`
	LastRunCommand string `json:"lastRunCommand,omitempty"`
	LastRunMode    string `json:"lastRunMode,omitempty"`
	LastRunVersion string `json:"lastRunVersion,omitempty"`
}

type SubagentsConfig struct {
	Model         string `json:"model"`         // default model for subagent calls (empty = inherit primary)
	MaxConcurrent int    `json:"maxConcurrent"` // max concurrent subagent tasks (default 4)
}

type SurfacesConfig struct {
	Enabled   bool            `json:"enabled"`
	Postgres  PostgresConfig  `json:"postgres"`
	Reasoning ReasoningConfig `json:"reasoning"`
}

type TaskQueueConfig struct {
	MaxConcurrent     int `json:"maxConcurrent"`     // max parallel tasks (default 5)
	ResultRetentionM  int `json:"resultRetentionM"`  // minutes to keep completed task results (default 60)
	ProgressThrottleS int `json:"progressThrottleS"` // seconds between progress updates (default 5)
}

type TelegramConfig struct {
	Enabled        bool                   `json:"enabled"`
	BotToken       string                 `json:"botToken"`
	DMPolicy       string                 `json:"dmPolicy"`
	StreamMode     string                 `json:"streamMode"`
	HistoryLimit   int                    `json:"historyLimit"`
	Groups         map[string]GroupConfig `json:"groups"`
	GroupPolicy    string                 `json:"groupPolicy"`
	ReplyToMode    string                 `json:"replyToMode"`    // "first" or ""
	TimeoutSeconds int                    `json:"timeoutSeconds"` // agent call timeout (default 300)
	AckEmoji       string                 `json:"ackEmoji"`       // default "👀"
}

type ThinkingConfig struct {
	Enabled      bool   `json:"enabled"`
	BudgetTokens int    `json:"budgetTokens"` // tokens reserved for thinking (default 8192)
	Level        string `json:"level"`        // "off", "enabled", "adaptive"; empty = use Enabled field; Claude 4.6 defaults to "adaptive"
}

type ToolLoopDetectionConfig struct {
	Enabled                       bool `json:"enabled"`                       // enable multi-detector loop detection (default true)
	HistorySize                   int  `json:"historySize"`                   // sliding window size (default 30)
	WarningThreshold              int  `json:"warningThreshold"`              // repetitions to trigger warning (default 10)
	CriticalThreshold             int  `json:"criticalThreshold"`             // repetitions to trigger hard break (default 20)
	GlobalCircuitBreakerThreshold int  `json:"globalCircuitBreakerThreshold"` // any single hash repeated this many times = stop (default 30)
}

type Tools struct {
	Web     Web           `json:"web"`
	Exec    ExecConfig    `json:"exec"`
	Files   FilesConfig   `json:"files"`
	Browser BrowserConfig `json:"browser"`
}

type UpdateConfig struct {
	AutoUpdate bool `json:"autoUpdate"` // if true, binary self-updates on startup when new version available (default: false)
}

type Web struct {
	Search WebSearch `json:"search"`
	Fetch  WebFetch  `json:"fetch"`
}

type WebFetch struct {
	Enabled        bool `json:"enabled"`
	MaxChars       int  `json:"maxChars"`
	TimeoutSeconds int  `json:"timeoutSeconds"`
}

type WebSearch struct {
	Enabled        bool `json:"enabled"`
	MaxResults     int  `json:"maxResults"`
	TimeoutSeconds int  `json:"timeoutSeconds"`
}