config

type Cache struct {
	Enabled bool
	// TTL is the maximum age of a reusable cached answer. Must be positive to be
	// useful (a non-positive TTL means every entry reads as expired).
	TTL time.Duration
}

type Chunk struct {
	Strategy string
	Size     int
	Overlap  int
	// ContextPrefix prepends a chunk's heading path to the text that is embedded
	// (not stored), so the embedding captures the chunk's place in the document.
	// Default on; applies to the structure strategy's markdown chunker.
	ContextPrefix bool
}

type Config struct {
	Provider  Provider
	Rerank    Rerank
	Storage   Storage
	Ingest    Ingest
	Chunk     Chunk
	Cache     Cache
	Retrieval Retrieval
	Log       Log
}

type Connection struct {
	BaseURL string
	APIKey  string
	Auth    string // "bearer" or "api-key"
	Timeout time.Duration
}

type FlagOverrides struct {
	LogLevel  string // "" = unset; e.g. "debug", "info", "warn", "error"
	LogFormat string // "" = unset; "text" or "json"
	Verbose   bool   // true forces debug level unless LogLevel is set
}

type Ingest struct {
	// Concurrency bounds parallel embedding during ingest. 0 means use the
	// built-in default; lower it for providers with tight rate limits.
	Concurrency int
}

type Log struct {
	Level  slog.Level
	Format string // "text" or "json"
}

type Provider struct {
	BaseURL    string
	APIKey     string
	EmbedModel string
	Dimensions int
	ChatModel  string
	// Auth selects how the API key is sent: "bearer" (OpenAI default) or
	// "api-key" (Azure OpenAI's header).
	Auth string
	// Timeout bounds each HTTP request to the provider (per attempt, so retries
	// each get the full budget). Zero disables it. Guards against a hung
	// provider blocking forever in non-interactive use (CI, scripts), where
	// there is no SIGINT to cancel the request context.
	Timeout time.Duration
	// EmbedBaseURL/EmbedAPIKey/EmbedAuth/EmbedTimeout override the shared
	// connection for the embedding role only; an empty (zero) field inherits the
	// shared value. EmbedTimeout of 0 inherits the shared Timeout — to disable a
	// timeout set the shared Timeout to 0 (both roles then inherit it).
	EmbedBaseURL string
	EmbedAPIKey  string
	EmbedAuth    string
	EmbedTimeout time.Duration
	// ChatBaseURL/ChatAPIKey/ChatAuth/ChatTimeout override the shared connection
	// for the chat role only, with the same empty-inherits-shared semantics.
	ChatBaseURL string
	ChatAPIKey  string
	ChatAuth    string
	ChatTimeout time.Duration
	// StructuredOutput declares that the provider supports JSON-schema
	// (response_format) output. Off by default so lore works against any
	// OpenAI-compatible endpoint; enable it for providers that support it.
	// A chat-role property.
	StructuredOutput bool
	// ImageInput / DocumentInput declare that the provider accepts image /
	// document attachments. Off by default; `ask --attach`
	// errors for an attachment whose capability is off. Chat-role properties.
	ImageInput    bool
	DocumentInput bool
}

type Rerank struct {
	BaseURL string
	APIKey  string
	Auth    string // "bearer" (default) or "api-key"
	Model   string
	Timeout time.Duration
}

type Retrieval struct {
	Hybrid bool
}

type Storage struct {
	Backend string
	Path    string
}