config

type ByteSize uint64

type Config struct {
	LLM        LLM        `toml:"llm"        doc:"LLM provider, model, and connection settings."`
	Documents  Documents  `toml:"documents"  doc:"Document attachment limits and caching."`
	Extraction Extraction `` /* 133-byte string literal not displayed */
	Locale     Locale     `toml:"locale"     doc:"Locale and currency settings."`

	// Warnings collects non-fatal messages (e.g. deprecations) during load.
	// Not serialized; the caller decides how to display them.
	Warnings []string `toml:"-"`
}

type Documents struct {
	// MaxFileSize is the largest file that can be imported as a document
	// attachment. Accepts unitized strings ("50 MiB") or bare integers
	// (bytes). Default: 50 MiB.
	MaxFileSize ByteSize `toml:"max_file_size" env:"MICASA_MAX_DOCUMENT_SIZE"`

	// CacheTTL is the preferred cache lifetime setting. Accepts unitized
	// strings ("30d", "720h") or bare integers (seconds). Default: 30d.
	CacheTTL *Duration `toml:"cache_ttl,omitempty" env:"MICASA_CACHE_TTL"`

	// CacheTTLDays is deprecated; use CacheTTL instead. Kept for backward
	// compatibility. Bare integer interpreted as days.
	CacheTTLDays *int `toml:"cache_ttl_days,omitempty" env:"MICASA_CACHE_TTL_DAYS"`
}

type Duration struct{ time.Duration }

type Extraction struct {
	// Model overrides llm.model for extraction. Extraction wants a small,
	// fast model optimized for structured JSON output. Defaults to the
	// chat model if empty.
	Model string `toml:"model" env:"MICASA_EXTRACTION_MODEL"`

	// MaxExtractPages is the maximum number of pages for async extraction of scanned
	// documents. 0 means no limit (all pages). Default: 0.
	MaxExtractPages int `toml:"max_extract_pages" env:"MICASA_MAX_EXTRACT_PAGES"`

	// Enabled controls whether LLM-powered extraction runs when a document
	// is uploaded. When disabled, no structured data is extracted -- OCR and
	// pdftotext are internal pipeline steps, not standalone features. Default: true.
	Enabled *bool `toml:"enabled,omitempty" env:"MICASA_EXTRACTION_ENABLED"`

	// TextTimeout is the maximum time to wait for pdftotext. Go duration
	// string, e.g. "30s", "1m". Default: "30s".
	TextTimeout string `toml:"text_timeout" env:"MICASA_TEXT_TIMEOUT"`

	// LLMTimeout is the maximum time to wait for the LLM extraction
	// inference step. Go duration string, e.g. "5m", "90s". Default: "5m".
	LLMTimeout string `toml:"llm_timeout" env:"MICASA_EXTRACTION_LLM_TIMEOUT"`

	// Thinking controls the model's reasoning effort level for extraction.
	// Supported values: none, low, medium, high, auto.
	// Empty string = don't send (server default). Default: empty.
	Thinking string `toml:"thinking,omitempty" env:"MICASA_EXTRACTION_THINKING"`
}

type LLM struct {
	// Provider selects which LLM provider to use. Supported values:
	// ollama, anthropic, openai, openrouter, deepseek, gemini, groq,
	// mistral, llamacpp, llamafile. Auto-detected when empty.
	Provider string `toml:"provider" env:"MICASA_LLM_PROVIDER"`

	// BaseURL is the base URL for the provider's API.
	// Default varies by provider (e.g. http://localhost:11434 for Ollama).
	// No /v1 suffix needed -- the provider handles path construction.
	BaseURL string `toml:"base_url" env:"MICASA_LLM_BASE_URL"`

	// Model is the model identifier passed in chat requests.
	// Default: qwen3
	Model string `toml:"model" env:"MICASA_LLM_MODEL"`

	// APIKey is the authentication credential. Required for cloud
	// providers (Anthropic, OpenAI, OpenRouter, etc.). Leave empty for local
	// servers like Ollama that don't require authentication.
	APIKey string `toml:"api_key" env:"MICASA_LLM_API_KEY"` //nolint:gosec // config field, not a hardcoded credential

	// ExtraContext is custom text appended to all system prompts.
	// Useful for domain-specific details: house style, location, etc.
	// Currency is handled by [locale] section. Optional; defaults to empty.
	ExtraContext string `toml:"extra_context" env:"MICASA_LLM_EXTRA_CONTEXT"`

	// Timeout is the maximum time for a single LLM response (including
	// streaming). Go duration string, e.g. "5m", "10m". Default: "5m".
	// Quick operations (ping, model listing) use a shorter fixed deadline.
	Timeout string `toml:"timeout" env:"MICASA_LLM_TIMEOUT"`

	// Thinking controls the model's reasoning effort level. Supported values:
	// none, low, medium, high, auto. Empty string = don't send (server default).
	Thinking string `toml:"thinking,omitempty" env:"MICASA_LLM_THINKING"`

	// Chat holds per-pipeline overrides for the chat (NL-to-SQL) pipeline.
	// Non-empty fields take precedence over the base values above.
	Chat LLMChatOverride `toml:"chat" doc:"Per-pipeline LLM overrides for chat. Inherits from [llm]."`

	// Extraction holds per-pipeline overrides for the document extraction
	// pipeline. Non-empty fields take precedence over the base values above.
	Extraction LLMExtractionOverride `toml:"extraction" doc:"Per-pipeline LLM overrides for extraction. Inherits from [llm]."`
}

type LLMChatOverride struct {
	Provider string `toml:"provider"           env:"MICASA_LLM_CHAT_PROVIDER"`
	BaseURL  string `toml:"base_url"           env:"MICASA_LLM_CHAT_BASE_URL"`
	Model    string `toml:"model"              env:"MICASA_LLM_CHAT_MODEL"`
	APIKey   string `toml:"api_key"            env:"MICASA_LLM_CHAT_API_KEY"` //nolint:gosec // config field, not a hardcoded credential
	Timeout  string `toml:"timeout"            env:"MICASA_LLM_CHAT_TIMEOUT"`
	Thinking string `toml:"thinking,omitempty" env:"MICASA_LLM_CHAT_THINKING"`
}

type LLMExtractionOverride struct {
	Provider string `toml:"provider"           env:"MICASA_LLM_EXTRACTION_PROVIDER"`
	BaseURL  string `toml:"base_url"           env:"MICASA_LLM_EXTRACTION_BASE_URL"`
	Model    string `toml:"model"              env:"MICASA_LLM_EXTRACTION_MODEL"`
	APIKey   string `toml:"api_key"            env:"MICASA_LLM_EXTRACTION_API_KEY"` //nolint:gosec // config field, not a hardcoded credential
	Timeout  string `toml:"timeout"            env:"MICASA_LLM_EXTRACTION_TIMEOUT"`
	Thinking string `toml:"thinking,omitempty" env:"MICASA_LLM_EXTRACTION_THINKING"`
}

type Locale struct {
	// Currency is the ISO 4217 code (e.g. "USD", "EUR", "GBP").
	// Used as the default when the database has no currency set yet.
	Currency string `toml:"currency" env:"MICASA_CURRENCY"`
}

type ResolvedLLM struct {
	Provider     string
	BaseURL      string
	Model        string
	APIKey       string //nolint:gosec // resolved config field, not a hardcoded credential
	ExtraContext string
	Timeout      time.Duration
	Thinking     string
}