config

type AppConfig struct {
	Name string `toml:"name"`
	Env  string `toml:"env"`
}

type Config struct {
	App        AppConfig        `toml:"app"`
	Log        LogConfig        `toml:"log"`
	Vault      VaultConfig      `toml:"vault"`
	OKF        OKFConfig        `toml:"okf"`
	Firecrawl  FirecrawlConfig  `toml:"firecrawl"`
	OpenRouter OpenRouterConfig `toml:"openrouter"`
	STT        STTConfig        `toml:"stt"`
	YouTube    YouTubeConfig    `toml:"youtube"`
	Instagram  InstagramConfig  `toml:"instagram"`
	Decisions  DecisionsConfig  `toml:"decisions"`
	Generation GenerationConfig `toml:"generation"`
}

type DecisionsConfig struct {
	// Model is the pinned decision model slug.
	Model string `toml:"model"`
	// Deadline is the total deadline of one attempt, body read included.
	Deadline string `toml:"deadline"`
	// Retries is the number of retries after the first attempt on transient
	// failures (408/429/5xx, network errors, timeouts). Zero disables retries.
	Retries int `toml:"retries"`
	// Concurrency is the number of decision requests in flight per run.
	Concurrency int `toml:"concurrency"`
	// MaxStateBytes caps the canonical JSON size of one decision state.
	MaxStateBytes int `toml:"max_state_bytes"`
	// BudgetUSD is the default per-run spend ceiling shared with generation.
	BudgetUSD float64 `toml:"budget_usd"`
	// Mode is the default decision mode: shadow or apply.
	Mode string `toml:"mode"`
	// Thresholds overrides named thresholds (see KnownThresholdNames).
	Thresholds map[string]float64 `toml:"thresholds"`
}

type FirecrawlConfig struct {
	APIKey string `toml:"api_key"`
	APIURL string `toml:"api_url"`
	// RefetchWaitMS is the `waitFor` sent on the fresh refetch that runs before
	// a quality gate judges a thin or broken capture (spec §7 stage 4).
	RefetchWaitMS int `toml:"refetch_wait_ms"`
	// RefetchOnlyMainContent is the `onlyMainContent` sent on that refetch;
	// false keeps tables and pricing grids the main-content filter drops.
	RefetchOnlyMainContent bool `toml:"refetch_only_main_content"`
}

type GenerationConfig struct {
	// Model is the primary chat-completions model.
	Model string `toml:"model"`
	// FallbackModel is tried once after the primary model fails; empty
	// disables the fallback.
	FallbackModel string `toml:"fallback_model"`
	// Deadline is the total deadline of one attempt.
	Deadline string `toml:"deadline"`
	// Retries is the number of retries per model after the first attempt.
	Retries int `toml:"retries"`
	// SummaryLanguage is the language generated summaries are written in.
	SummaryLanguage string `toml:"summary_language"`
}

type InstagramConfig struct {
	YTDLPPath     string `toml:"yt_dlp_path"`
	Proxy         string `toml:"proxy"`
	CookiesFile   string `toml:"cookies_file"`
	UserAgent     string `toml:"user_agent"`
	Transcription string `toml:"transcription"`
	RetryAttempts int    `toml:"retry_attempts"`
	RetryBackoff  string `toml:"retry_backoff"`
}

type LogConfig struct {
	Level string `toml:"level"`
}

type OKFConfig struct {
	Types []string `toml:"types"`
	// TypeDescriptions maps a type name to the description used as its option
	// text when the decision model suggests a type (`kb promote` without
	// --type, `kb okf check`). Types without a description use their name.
	TypeDescriptions map[string]string `toml:"type_descriptions"`
}

type OpenRouterConfig struct {
	APIKey   string `toml:"api_key"`
	APIURL   string `toml:"api_url"`
	STTModel string `toml:"stt_model"`
}

type STTConfig struct {
	Provider      string `toml:"provider"`
	APIKey        string `toml:"api_key"`
	APIURL        string `toml:"api_url"`
	Model         string `toml:"model"`
	Language      string `toml:"language"`
	Prompt        string `toml:"prompt"`
	AudioFormat   string `toml:"audio_format"`
	ChunkDuration string `toml:"chunk_duration"`
	MaxChunkBytes int64  `toml:"max_chunk_bytes"`
	Concurrency   int    `toml:"concurrency"`
	FFmpegPath    string `toml:"ffmpeg_path"`
}

type VaultConfig struct {
	Root       string   `toml:"root"`
	TopicGlobs []string `toml:"topic_globs"`
}

type YouTubeConfig struct {
	YTDLPPath     string `toml:"yt_dlp_path"`
	Proxy         string `toml:"proxy"`
	CookiesFile   string `toml:"cookies_file"`
	UserAgent     string `toml:"user_agent"`
	Transcription string `toml:"transcription"`
	RetryAttempts int    `toml:"retry_attempts"`
	RetryBackoff  string `toml:"retry_backoff"`
	// CaptionLanguages controls caption track selection. "orig" means the
	// video's original language as reported by yt-dlp metadata.
	CaptionLanguages        []string `toml:"caption_languages"`
	AllowTranslatedCaptions bool     `toml:"allow_translated_captions"`
	// Bulk* control the kb ingest channel worker pool, inter-request throttle,
	// and adaptive backoff used when ingesting an entire channel or playlist.
	BulkConcurrency int    `toml:"bulk_concurrency"`
	BulkThrottle    string `toml:"bulk_throttle"`
	BulkBackoffMax  string `toml:"bulk_backoff_max"`
	BulkRetries     int    `toml:"bulk_retries"`
}