config

type AgentConfig struct {
	BotToken          string `toml:"-"                jsonschema:"-"`
	BotTokenEnv       string `toml:"bot_token_env"    jsonschema:"-"`
	Port              int    `toml:"port"             jsonschema:"-"`
	Runtime           string `toml:"runtime"          jsonschema:"-"`
	Model             string `toml:"model"            jsonschema:"-"`
	HeartbeatInterval string `toml:"heartbeat_interval" jsonschema:"-"`
}

type AskConfig struct {
	// Local path for cloned OSS reference repos (default: ~/.ttal/references/)
	ReferencesPath string `toml:"references_path"`
	// Model for the ask subagent (default: claude-sonnet-4-6)
	Model string `toml:"model"`
	// Maximum agent steps (default: 100)
	MaxSteps int `toml:"max_steps"`
	// Maximum output tokens per step (default: 131072)
	MaxTokens int `toml:"max_tokens"`
	// Output verbosity for human CLI use: "verbose" (default) or "quiet"
	Output string `toml:"output" jsonschema:"enum=verbose,enum=quiet"`
	// Output verbosity for agent sessions (TTAL_AGENT_NAME set).
	// Default is quiet. Set to "verbose" to see streaming in agent sessions.
	AgentOutput string `toml:"agent_output" jsonschema:"enum=verbose,enum=quiet"`
}

type Config struct {
	// Resolved fields — populated from active team after Load(). Not directly settable in TOML.
	ChatID            string      `toml:"-" json:"-"`
	LifecycleAgent    string      `toml:"-" json:"-"` // Deprecated: use NotificationToken instead
	NotificationToken string      `toml:"-" json:"-"`
	VoiceResolved     VoiceConfig `toml:"-" json:"-"`

	// Shell for spawning workers
	Shell string `toml:"shell" jsonschema:"enum=zsh,enum=fish"`
	// Paths for subagent and skill deployment
	Sync SyncConfig `toml:"sync"`
	// Prompt templates for task routing (loaded from prompts.toml, not config.toml)
	Prompts PromptsConfig `toml:"-"`
	// Ask subcommand settings
	Ask AskConfig `toml:"ask"`
	// Flicknote integration settings
	Flicknote FlicknoteConfig `toml:"flicknote"`
	// Global voice settings (vocabulary, language)
	Voice VoiceConfig `toml:"voice"`

	// Active team — falls back to "default" if unset
	DefaultTeam string `toml:"default_team"` //nolint:lll
	// Per-team configuration sections
	Teams map[string]TeamConfig `toml:"teams"`
	// Human user identity (used by GUI ChatService and message queries)
	User UserConfig `toml:"user"`
	// contains filtered or unexported fields
}

type DaemonConfig struct {
	Global *Config                  // Raw config (Sync, Shell, Prompts, etc.)
	Teams  map[string]*ResolvedTeam // team name -> resolved team config
}

type FlicknoteConfig struct {
	// Project substrings to inline (default: plan)
	InlineProjects []string `toml:"inline_projects" jsonschema:"description=Project substrings to inline (default: plan)"`
}

type MatrixAgentConfig struct {
	// Env var name for this agent's Matrix access token
	AccessTokenEnv string `toml:"access_token_env"`
	// Matrix room ID for this agent's chat (e.g. "!abc:example.com")
	RoomID string `toml:"room_id"`
}

type MatrixTeamConfig struct {
	// Matrix homeserver URL (e.g. "https://matrix.example.com")
	Homeserver string `toml:"homeserver"`
	// Room ID for system notifications
	NotifyRoom string `toml:"notification_room"`
	// Env var name for notification bot access token
	NotifyTokenEnv string `toml:"notification_token_env"`
	// Matrix user ID of the human owner, invited to all provisioned rooms (e.g. "@neil:ttal.dev")
	HumanUserID string `toml:"human_user_id"`
	// Per-agent Matrix credentials
	Agents map[string]MatrixAgentConfig `toml:"agents"`
}

type PromptsConfig struct {
	Execute string `toml:"execute" jsonschema:"description=Prompt prefix for worker spawn"`
	Triage  string `toml:"triage" jsonschema:"description=Prompt sent to coder after PR review. Supports {{review-file}}"` //nolint:lll
	Review  string ``                                                                                                      //nolint:lll
	/* 129-byte string literal not displayed */
	ReReview     string `toml:"re_review" jsonschema:"description=Re-review prompt sent to reviewer. Supports {{review-scope}} {{coder-comment}}"` //nolint:lll
	PlanReview   string `toml:"plan_review" jsonschema:"description=Plan reviewer prompt. Supports {{task-id}} {{skill:plan-review}}"`             //nolint:lll
	PlanReReview string `toml:"plan_re_review" jsonschema:"description=Plan re-review prompt. Supports {{task-id}}"`                               //nolint:lll
	PlanTriage   string `toml:"plan_triage" jsonschema:"description=Prompt sent to designer after plan review. Supports {{review-file}}"`          //nolint:lll
}

type ResolvedTeam struct {
	Name              string
	Frontend          string // "telegram" or "matrix" (default: "telegram")
	TeamPath          string
	DataDir           string
	TaskRC            string
	ChatID            string
	LifecycleAgent    string // Deprecated: use NotificationToken instead
	NotificationToken string
	AgentRuntime      string
	WorkerRuntime     string
	ReviewerRuntime   string
	AgentModel        string
	WorkerModel       string
	ReviewerModel     string
	MergeMode         string
	CommentSync       string
	Voice             VoiceConfig
	EmojiReactions    bool
	UserName          string            // human identity for this team
	Matrix            *MatrixTeamConfig // nil for telegram teams
}

type RolesConfig struct {
	Roles              map[string]string `toml:"-"`
	HeartbeatPrompts   map[string]string `toml:"-"`
	HeartbeatIntervals map[string]string `toml:"-"` // per-role heartbeat interval (e.g. "1h")
}

type SyncConfig struct {
	// Directories for subagent definitions
	SubagentsPaths []string `toml:"subagents_paths"`
	// Directories for RULE.md files
	RulesPaths []string `toml:"rules_paths"`
	// Path to global CLAUDE.md prompt
	GlobalPromptPath string `toml:"global_prompt_path"`
}

type TeamAgent struct {
	TeamName  string
	AgentName string
	ChatID    string // team chat ID (all agents in a team share one chat)
	TeamPath  string
}

type TeamConfig struct {
	// Messaging frontend for this team ("telegram" or "matrix"; default: "telegram")
	Frontend string `toml:"frontend" jsonschema:"enum=telegram,enum=matrix"`
	// Root path for agent workspaces. Agent path = team_path/agent_name
	TeamPath string `toml:"team_path"` //nolint:lll
	// ttal data directory (default: ~/.ttal/<team>)
	DataDir string `toml:"data_dir"` //nolint:lll
	// Taskwarrior config file path (default: <data_dir>/taskrc)
	TaskRC string `toml:"taskrc"` //nolint:lll
	// Telegram chat ID for this team
	ChatID string `toml:"chat_id"`
	// Deprecated: use notification_token_env instead
	LifecycleAgent string `toml:"lifecycle_agent"` //nolint:lll
	// Override env var for notification bot token (default: {UPPER_TEAM}_NOTIFICATION_BOT_TOKEN)
	NotificationTokenEnv string `toml:"notification_token_env"` //nolint:lll
	// Runtime for agent sessions
	AgentRuntime string `toml:"agent_runtime" jsonschema:"enum=claude-code"` //nolint:lll
	// Runtime for spawned workers
	WorkerRuntime string `toml:"worker_runtime" jsonschema:"enum=claude-code,enum=codex"` //nolint:lll
	// Model for agent sessions (default: sonnet)
	AgentModel string `toml:"agent_model" jsonschema:"enum=haiku,enum=sonnet,enum=opus"` //nolint:lll
	// Model for spawned workers (default: sonnet; +hard tag overrides to opus)
	WorkerModel string `toml:"worker_model" jsonschema:"enum=haiku,enum=sonnet,enum=opus"` //nolint:lll
	// Runtime for spawned reviewers (falls back to worker_runtime)
	ReviewerRuntime string `toml:"reviewer_runtime" jsonschema:"enum=claude-code,enum=codex"` //nolint:lll
	// Model for spawned reviewers (falls back to worker_model)
	ReviewerModel string `toml:"reviewer_model" jsonschema:"enum=haiku,enum=sonnet,enum=opus"` //nolint:lll
	// PR merge mode override for this team
	MergeMode string `toml:"merge_mode" jsonschema:"enum=auto,enum=manual"` //nolint:lll
	// Comment sync mode: "none" (DB only) or "pr" (mirror to PR). Default: "pr".
	CommentSync string `toml:"comment_sync" jsonschema:"enum=none,enum=pr,default=pr"` //nolint:lll
	// ISO 639-1 language code for Whisper (default: en; auto for auto-detect)
	VoiceLanguage string `toml:"voice_language"` //nolint:lll
	// Per-agent credentials for this team
	Agents map[string]AgentConfig `toml:"agents"` //nolint:lll
	// Custom vocabulary words for Whisper transcription accuracy
	VoiceVocabulary []string `toml:"voice_vocabulary"` //nolint:lll
	// Enable emoji reactions on Telegram tool messages
	EmojiReactions *bool `toml:"emoji_reactions" jsonschema:"default=false"`
	// TaskChampion sync server URL for ttal doctor --fix
	TaskSyncURL string `toml:"task_sync_url"` //nolint:lll
	// Optional per-team human identity override (falls back to global [user])
	User UserConfig `toml:"user"` //nolint:lll
	// Matrix-specific configuration (only used when frontend = "matrix")
	Matrix *MatrixTeamConfig `toml:"matrix"`
	// Context usage threshold (%) below which auto-breathe is skipped (default: 40).
	// Use a pointer so that an explicit 0 (always breathe) is not silently promoted to 40.
	BreatheThreshold *float64 `toml:"breathe_threshold"` //nolint:lll
}

type UserConfig struct {
	// Human's display name (e.g. "neil"). Falls back to $USER env var if empty.
	Name string `toml:"name"`
}

type VoiceConfig struct {
	// Custom vocabulary words for Whisper
	Vocabulary []string `toml:"vocabulary"`
	// ISO 639-1 language code (default: en)
	Language string `toml:"language"`
}