config

type ActivationWeights struct {
	Similarity       float64
	Recency          float64
	Frequency        float64
	Graph            float64
	TypeBoost        float64
	RecencyHalfLifeS float64
}

type AttentionConfig struct {
	DedupWindowS float64
	NoiseWords   []string
}

type AuthConfig struct {
	Enabled bool
}

type CodeIndexConfig struct {
	MaxBodyLinesPerSymbol int
	RespectGitignore      bool
	ExtraIgnoreGlobs      []string
	Languages             []string // nil = all supported
}

type Config struct {
	DBPath          string
	Workspace       string
	PreferSQLiteVec bool
	EnableWAL       bool

	// store backend (flat — source of truth for storage.OpenStore)
	StoreBackend string // "sqlite" (default) or "postgres"
	StoreDSN     string // postgres DSN; may be written directly (not a secret literal)
	StoreDSNEnv  string // env var name to read the DSN from (secrets-off-disk pattern)
	Store        StoreConfig

	// HTTP server auth (flat — source of truth for api.NewHandler)
	AuthEnabled bool // [auth] enabled: users-table Basic auth; default false = allow all
	Auth        AuthConfig

	// embedding (flat — source of truth for make_provider)
	EmbeddingProvider         string
	EmbeddingModel            string
	EmbeddingDim              int
	EmbeddingBaseURL          string
	EmbeddingAPIKeyEnv        string
	EmbeddingFallback         string
	EmbeddingQueryCacheSize   int
	EmbeddingTimeoutS         float64
	EmbeddingAllowDimChange   bool
	EmbeddingHTTPRequest      string
	EmbeddingHTTPResponsePath string
	Embedding                 EmbeddingConfig

	// CJK tokenizer dictionary (flat — source of truth for storage's dict
	// directory). "" = default ~/.ladyM/dict. Set to a shared volume mount
	// (LADYM_DICT_DIR / dict_dir) in microservice deployments so every
	// instance reads the dictionary one download provisioned.
	CJKDictDir string

	// llm (flat — source of truth for make_agent)
	LLMProvider           string // "none" = heuristic / offline mode
	LLMBaseURL            string
	LLMModel              string
	LLMAPIKeyEnv          string
	LLMMaxTokens          int
	LLMTemperature        float64
	LLMStructuredMethod   string
	LLMReasoningEffort    string // "low" | "medium" | "high" for OpenAI reasoning models; "" = provider default
	LLMTimeoutS           float64
	LLMAPIKey             string // plaintext LLM key (only when allow_plaintext_secrets)
	AllowPlaintextSecrets bool   // DEV/testing escape hatch; default stays secure
	LLM                   LLMConfig

	AgentsOverrides map[string]map[string]any
	Activation      ActivationWeights
	Recall          RecallConfig
	Consolidate     ConsolidateConfig
	CodeIndex       CodeIndexConfig
	System2         System2Config
	Attention       AttentionConfig
	Resource        ResourceConfig
	Maintain        MaintainConfig
}

type ConfigError struct {
	Msg string
}

type ConsolidateConfig struct {
	MinEpisodesToTrigger     int
	DedupSimilarityThreshold float64
}

type EmbeddingConfig struct {
	Provider         string
	BaseURL          string
	Model            string
	APIKeyEnv        string
	Fallback         string
	QueryCacheSize   int
	TimeoutS         float64
	AllowDimChange   bool
	HTTPRequest      string
	HTTPResponsePath string
}

type LLMConfig struct {
	Provider         string
	BaseURL          string
	Model            string
	APIKeyEnv        string
	MaxTokens        int
	Temperature      float64
	StructuredMethod string
	ReasoningEffort  string
	TimeoutS         float64
}

type MaintainConfig struct {
	Enabled              bool    // whether the maintenance sub-steps run in a cycle (GC always runs)
	BackfillBatch        int     // max episodes backfilled per cycle
	LinkingEnabled       bool    // gate for the LLM semantic-linking sub-step
	LinkingBudget        int     // max candidate pairs sent to the LLM per cycle
	LinkingSimilarity    float64 // cosine pre-filter for linking candidates
	AliasMergeSimilarity float64 // cosine threshold for resource alias-merge candidates
}

type RecallConfig struct {
	TopKTier1             int
	TopKTier2             int
	GraphHops             int
	ReflectionMinHits     int
	ReflectionMinCoverage float64
	EnableTier2           bool
}

type ResourceConfig struct {
	ResolveThreshold float64           // write side: vector match vs create-new
	ReadThreshold    float64           // read side: pivot resolution
	Actions          []string          // extra canonical action words, appended to builtins
	ActionAliases    map[string]string // extra alias→canonical mappings, appended to builtins
}

type StoreConfig struct {
	Backend string
	DSN     string
}

type System2Config struct {
	Enabled              bool
	IntervalS            int
	MinEpisodesToRun     int
	MaxConsecutiveErrors int
	L5ClusterSimilarity  float64
	L5MinClusterSize     int
	L5MergeSimilarity    float64
	L5MergeEveryNCycles  int
	L6MaxEpisodes        int
	L6HorizonS           float64
}