config

type AgentConfig struct {
	ID        string           `json:"id"`
	Default   bool             `json:"default,omitempty"`
	Name      string           `json:"name,omitempty"`
	Workspace string           `json:"workspace,omitempty"`
	Model     string           `json:"model,omitempty"` // model selection: exact target "instance-id/model-id" or route name; empty uses the default
	Skills    []string         `json:"skills,omitempty"`
	Subagents *SubagentsConfig `json:"subagents,omitempty"`
}

type AgentDefaults struct {
	Workspace                 string             `json:"workspace"                        env:"COMPA_AGENTS_DEFAULTS_WORKSPACE"`
	RestrictToWorkspace       bool               `json:"restrict_to_workspace"            env:"COMPA_AGENTS_DEFAULTS_RESTRICT_TO_WORKSPACE"`
	AllowReadOutsideWorkspace bool               `json:"allow_read_outside_workspace"     env:"COMPA_AGENTS_DEFAULTS_ALLOW_READ_OUTSIDE_WORKSPACE"`
	ModelName                 string             `json:"model_name"                       env:"COMPA_AGENTS_DEFAULTS_MODEL_NAME"`  // default model selection: exact target "instance-id/model-id" or route name; empty means none
	ImageModel                string             `json:"image_model,omitempty"            env:"COMPA_AGENTS_DEFAULTS_IMAGE_MODEL"` // model selection turns carrying images are rerouted to; empty keeps the agent's model
	MaxTokens                 int                `json:"max_tokens"                       env:"COMPA_AGENTS_DEFAULTS_MAX_TOKENS"`
	ContextWindow             int                `json:"context_window,omitempty"         env:"COMPA_AGENTS_DEFAULTS_CONTEXT_WINDOW"`
	Temperature               *float64           `json:"temperature,omitempty"            env:"COMPA_AGENTS_DEFAULTS_TEMPERATURE"`
	MaxToolIterations         int                `json:"max_tool_iterations"              env:"COMPA_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS"`
	SummarizeMessageThreshold int                `json:"summarize_message_threshold"      env:"COMPA_AGENTS_DEFAULTS_SUMMARIZE_MESSAGE_THRESHOLD"`
	SummarizeTokenPercent     int                `json:"summarize_token_percent"          env:"COMPA_AGENTS_DEFAULTS_SUMMARIZE_TOKEN_PERCENT"`
	MaxMediaSize              int                `json:"max_media_size,omitempty"         env:"COMPA_AGENTS_DEFAULTS_MAX_MEDIA_SIZE"`
	Routing                   *RoutingConfig     `json:"routing,omitempty"`
	SteeringMode              string             `json:"steering_mode,omitempty"          env:"COMPA_AGENTS_DEFAULTS_STEERING_MODE"`      // "one-at-a-time" (default) or "all"
	MaxParallelTurns          int                `json:"max_parallel_turns,omitempty"     env:"COMPA_AGENTS_DEFAULTS_MAX_PARALLEL_TURNS"` // Max turns of different sessions at once (0 = default 4, 1 = sequential)
	SubTurn                   SubTurnConfig      `json:"subturn"`
	ToolFeedback              ToolFeedbackConfig `json:"tool_feedback,omitempty"`
	SplitOnMarker             bool               `json:"split_on_marker"                  env:"COMPA_AGENTS_DEFAULTS_SPLIT_ON_MARKER"` // split messages on <|[SPLIT]|> marker
	ContextManager            string             `json:"context_manager,omitempty"        env:"COMPA_AGENTS_DEFAULTS_CONTEXT_MANAGER"`
	ContextManagerConfig      json.RawMessage    `json:"context_manager_config,omitempty" env:"COMPA_AGENTS_DEFAULTS_CONTEXT_MANAGER_CONFIG"`
	TurnProfile               TurnProfileConfig  `json:"turn_profile,omitempty"`
	MaxLLMRetries             int                `json:"max_llm_retries,omitempty"        env:"COMPA_AGENTS_DEFAULTS_MAX_LLM_RETRIES"`
	LLMRetryBackoffSecs       int                `json:"llm_retry_backoff_secs,omitempty" env:"COMPA_AGENTS_DEFAULTS_LLM_RETRY_BACKOFF_SECS"`
}

type AgentsConfig struct {
	Defaults AgentDefaults   `json:"defaults"`
	List     []AgentConfig   `json:"list,omitempty"`
	Dispatch *DispatchConfig `json:"dispatch,omitempty"`
}

type BaiduSearchConfig struct {
	Enabled    bool         `json:"enabled"          yaml:"-"                 env:"COMPA_TOOLS_WEB_BAIDU_ENABLED"`
	APIKey     SecureString `json:"api_key,omitzero" yaml:"api_key,omitempty" env:"COMPA_TOOLS_WEB_BAIDU_API_KEY"`
	BaseURL    string       `json:"base_url"         yaml:"-"                 env:"COMPA_TOOLS_WEB_BAIDU_BASE_URL"`
	MaxResults int          `json:"max_results"      yaml:"-"                 env:"COMPA_TOOLS_WEB_BAIDU_MAX_RESULTS"`
}

type BraveConfig struct {
	Enabled    bool          `json:"enabled"           yaml:"-"                  env:"COMPA_TOOLS_WEB_BRAVE_ENABLED"`
	APIKeys    SecureStrings `json:"api_keys,omitzero" yaml:"api_keys,omitempty" env:"COMPA_TOOLS_WEB_BRAVE_API_KEYS"`
	MaxResults int           `json:"max_results"       yaml:"-"                  env:"COMPA_TOOLS_WEB_BRAVE_MAX_RESULTS"`
}

type BuildInfo struct {
	Version   string `json:"version"`
	GitCommit string `json:"git_commit"`
	BuildTime string `json:"build_time"`
	GoVersion string `json:"go_version"`
}

type BuiltinHookConfig struct {
	Enabled  bool            `json:"enabled"`
	Priority int             `json:"priority,omitempty"`
	Config   json.RawMessage `json:"config,omitempty"`
}

type Channel struct {
	Enabled   bool                `json:"enabled"                 yaml:"-"`
	Type      string              `json:"type"                    yaml:"-"`
	AllowFrom FlexibleStringSlice `json:"allow_from,omitempty"    yaml:"-"`
	// DMPolicy decides which direct messages are processed: "pairing",
	// "allowlist", "open" or "disabled". See EffectiveDMPolicy.
	DMPolicy string `json:"dm_policy,omitempty" yaml:"-"`
	// GroupPolicy decides which group messages are processed: "allowlist",
	// "open" or "disabled". See EffectiveGroupPolicy.
	GroupPolicy        string             `json:"group_policy,omitempty"  yaml:"-"`
	ReasoningChannelID string             `json:"reasoning_channel_id"    yaml:"-"`
	GroupTrigger       GroupTriggerConfig `json:"group_trigger,omitempty" yaml:"-"`
	Typing             TypingConfig       `json:"typing,omitempty"        yaml:"-"`
	Placeholder        PlaceholderConfig  `json:"placeholder,omitempty"   yaml:"-"`
	Settings           RawNode            `json:"settings,omitzero"       yaml:"settings,omitempty"`
	// contains filtered or unexported fields
}

type ChannelsConfig map[string]*Channel

type CommandsConfig struct {
	// OwnerOnly runs commands sent from chat apps only when the sender is the
	// owner: a sender matching an explicit allow_from entry. The web UI and
	// the terminal are always the owner.
	OwnerOnly bool `json:"owner_only" env:"COMPA_COMMANDS_OWNER_ONLY"`
}

type Config struct {
	Isolation IsolationConfig `json:"isolation,omitempty" yaml:"-"`
	Agents    AgentsConfig    `json:"agents"              yaml:"-"`
	Session   SessionConfig   `json:"session,omitempty"   yaml:"-"`
	Evolution EvolutionConfig `json:"evolution,omitempty" yaml:"-"`
	Channels  ChannelsConfig  `json:"channel_list"        yaml:"channel_list"`
	// ProviderInstances are the provider connections models run on; each
	// owns its endpoint, credential reference, runtime settings and model
	// catalog. ModelRoutes are named failover routes over their exact
	// targets, and every model selection in the config names a target or a
	// route. ActiveModels is the shortlist of targets offered for chat.
	ProviderInstances []*ProviderInstanceConfig `json:"provider_instances,omitempty" yaml:"-"`
	ModelRoutes       []*ModelRouteConfig       `json:"model_routes,omitempty"       yaml:"-"`
	ActiveModels      []string                  `json:"active_models,omitempty"      yaml:"-"`
	Gateway           GatewayConfig             `json:"gateway"             yaml:"-"`
	Events            EventsConfig              `json:"events,omitempty"    yaml:"-"`
	Hooks             HooksConfig               `json:"hooks,omitempty"     yaml:"-"`
	Tools             ToolsConfig               `json:"tools"               yaml:",inline"`
	Heartbeat         HeartbeatConfig           `json:"heartbeat"           yaml:"-"`
	Devices           DevicesConfig             `json:"devices"             yaml:"-"`
	Voice             VoiceConfig               `json:"voice"               yaml:"-"`
	// Commands configures who may run the chat commands.
	Commands CommandsConfig `json:"commands" yaml:"-"`
	// Logging configures Compa's log files.
	Logging LoggingConfig `json:"logging" yaml:"-"`
	// Modules configures the detached-module host, including the named
	// source roots a module may be granted read-only.
	Modules ModulesConfig `json:"modules,omitzero" yaml:"-"`
	// BuildInfo contains build-time version information
	BuildInfo BuildInfo `json:"build_info,omitempty" yaml:"-"`

	// Extension is the extension daemon Compa reaches providers through, if
	// any. Its shared secret lives in the auth store.
	Extension *ExtensionDaemonConfig `json:"extension,omitempty" yaml:"-"`
	// contains filtered or unexported fields
}

type CronToolsConfig struct {
	ToolConfig `envPrefix:"COMPA_TOOLS_CRON_"`
	// 0 means no timeout.
	ExecTimeoutMinutes    int      `json:"exec_timeout_minutes"    env:"COMPA_TOOLS_CRON_EXEC_TIMEOUT_MINUTES"`
	AllowCommand          bool     `json:"allow_command"           env:"COMPA_TOOLS_CRON_ALLOW_COMMAND"`
	CommandAllowedRemotes []string `json:"command_allowed_remotes" env:"COMPA_TOOLS_CRON_COMMAND_ALLOWED_REMOTES"`
}

type DeltaChatSettings struct {
	Email          string       `json:"email"                     yaml:"-"                  env:"COMPA_CHANNELS_DELTACHAT_EMAIL"`
	Password       SecureString `json:"password,omitzero"         yaml:"password,omitempty" env:"COMPA_CHANNELS_DELTACHAT_PASSWORD"`
	DisplayName    string       `json:"display_name,omitempty"    yaml:"-"                  env:"COMPA_CHANNELS_DELTACHAT_DISPLAY_NAME"`
	AvatarImage    string       `json:"avatar_image,omitempty"    yaml:"-"                  env:"COMPA_CHANNELS_DELTACHAT_AVATAR_IMAGE"`
	DataDir        string       `json:"data_dir,omitempty"        yaml:"-"                  env:"COMPA_CHANNELS_DELTACHAT_DATA_DIR"`
	RPCServerPath  string       `json:"rpc_server_path,omitempty" yaml:"-"                  env:"COMPA_CHANNELS_DELTACHAT_RPC_SERVER_PATH"`
	InviteLink     string       `json:"invite_link,omitempty"     yaml:"-"                  env:"COMPA_CHANNELS_DELTACHAT_INVITE_LINK"`
	AllowCrosspost bool         `json:"allow_crosspost,omitempty" yaml:"-"                  env:"COMPA_CHANNELS_DELTACHAT_ALLOW_CROSSPOST"`
	IMAPServer     string       `json:"imap_server,omitempty"     yaml:"-"`
	IMAPPort       int          `json:"imap_port,omitempty"       yaml:"-"`
	SMTPServer     string       `json:"smtp_server,omitempty"     yaml:"-"`
	SMTPPort       int          `json:"smtp_port,omitempty"       yaml:"-"`
}

type DevicesConfig struct {
	Enabled    bool `json:"enabled"     env:"COMPA_DEVICES_ENABLED"`
	MonitorUSB bool `json:"monitor_usb" env:"COMPA_DEVICES_MONITOR_USB"`
}

type DingTalkSettings struct {
	ClientID     string       `json:"client_id"              yaml:"-"                       env:"COMPA_CHANNELS_DINGTALK_CLIENT_ID"`
	ClientSecret SecureString `json:"client_secret,omitzero" yaml:"client_secret,omitempty" env:"COMPA_CHANNELS_DINGTALK_CLIENT_SECRET"`
}

type DiscordSettings struct {
	Token SecureString `json:"token,omitzero" yaml:"token,omitempty" env:"COMPA_CHANNELS_DISCORD_TOKEN"`
	Proxy string       `json:"proxy"          yaml:"-"               env:"COMPA_CHANNELS_DISCORD_PROXY"`
}

type DispatchConfig struct {
	Rules []DispatchRule `json:"rules,omitempty"`
}

type DispatchRule struct {
	Name              string           `json:"name,omitempty"`
	Agent             string           `json:"agent"`
	When              DispatchSelector `json:"when"`
	SessionDimensions []string         `json:"session_dimensions,omitempty"`
}

type DispatchSelector struct {
	Channel   string `json:"channel,omitempty"`
	Account   string `json:"account,omitempty"`
	Space     string `json:"space,omitempty"`
	Chat      string `json:"chat,omitempty"`
	Topic     string `json:"topic,omitempty"`
	Sender    string `json:"sender,omitempty"`
	Mentioned *bool  `json:"mentioned,omitempty"`
}

type DuckDuckGoConfig struct {
	Enabled    bool `json:"enabled"     env:"COMPA_TOOLS_WEB_DUCKDUCKGO_ENABLED"`
	MaxResults int  `json:"max_results" env:"COMPA_TOOLS_WEB_DUCKDUCKGO_MAX_RESULTS"`
}

type EffectiveTurnProfile struct {
	Enabled          bool
	HistoryMode      TurnProfileMode
	SystemPromptMode TurnProfileMode
	SkillsMode       TurnProfileMode
	ToolsMode        TurnProfileMode
	AllowedSkills    []string
	AllowedTools     []string
}

type EventLoggingConfig struct {
	// Enabled controls whether runtime events are printed by the built-in logger.
	Enabled bool `json:"enabled" env:"ENABLED"`
	// Include contains exact event kinds or glob patterns such as "agent.*" or "*".
	Include []string `json:"include,omitempty" env:"INCLUDE"`
	// Exclude contains exact event kinds or glob patterns to suppress after Include matches.
	Exclude []string `json:"exclude,omitempty" env:"EXCLUDE"`
	// MinSeverity filters out events below the configured severity: debug, info, warn, or error.
	MinSeverity string `json:"min_severity,omitempty" env:"MIN_SEVERITY"`
	// IncludePayload adds the raw payload to logs. Leave disabled unless detailed diagnostics are needed.
	IncludePayload bool `json:"include_payload,omitempty" env:"INCLUDE_PAYLOAD"`
}

type EventsConfig struct {
	Logging EventLoggingConfig `json:"logging,omitempty" envPrefix:"COMPA_EVENTS_LOGGING_"`
}

type EvolutionConfig struct {
	Enabled         bool     `json:"enabled,omitempty"`
	Mode            string   `json:"mode,omitempty"`
	StateDir        string   `json:"state_dir,omitempty"`
	MinTaskCount    int      `json:"min_task_count,omitempty"`
	MinSuccessRatio float64  `json:"min_success_ratio,omitempty"`
	ColdPathTrigger string   `json:"cold_path_trigger,omitempty"`
	ColdPathTimes   []string `json:"cold_path_times,omitempty"`
}

type ExactModelTarget struct {
	InstanceID string
	ModelID    string
}

type ExecConfig struct {
	ToolConfig          `         envPrefix:"COMPA_TOOLS_EXEC_"`
	EnableDenyPatterns  bool     `                                 json:"enable_deny_patterns"  env:"COMPA_TOOLS_EXEC_ENABLE_DENY_PATTERNS"`
	AllowRemote         bool     `                                 json:"allow_remote"          env:"COMPA_TOOLS_EXEC_ALLOW_REMOTE"`
	CustomDenyPatterns  []string `                                 json:"custom_deny_patterns"  env:"COMPA_TOOLS_EXEC_CUSTOM_DENY_PATTERNS"`
	CustomAllowPatterns []string `                                 json:"custom_allow_patterns" env:"COMPA_TOOLS_EXEC_CUSTOM_ALLOW_PATTERNS"`
	TimeoutSeconds      int      `                                 json:"timeout_seconds"       env:"COMPA_TOOLS_EXEC_TIMEOUT_SECONDS"` // 0 means use default (60s)
}

type ExposePath struct {
	Source string `json:"source"`
	Target string `json:"target,omitempty"`
	Mode   string `json:"mode"`
}

type ExtensionDaemonConfig struct {
	// URL is the daemon's origin, such as "http://127.0.0.1:18888".
	URL string `json:"url"`
}

type FeishuSettings struct {
	AppID               string              `json:"app_id"                      yaml:"-"                            env:"COMPA_CHANNELS_FEISHU_APP_ID"`
	AppSecret           SecureString        `json:"app_secret,omitzero"         yaml:"app_secret,omitempty"         env:"COMPA_CHANNELS_FEISHU_APP_SECRET"`
	EncryptKey          SecureString        `json:"encrypt_key,omitzero"        yaml:"encrypt_key,omitempty"        env:"COMPA_CHANNELS_FEISHU_ENCRYPT_KEY"`
	VerificationToken   SecureString        `json:"verification_token,omitzero" yaml:"verification_token,omitempty" env:"COMPA_CHANNELS_FEISHU_VERIFICATION_TOKEN"`
	RandomReactionEmoji FlexibleStringSlice `json:"random_reaction_emoji"       yaml:"-"                            env:"COMPA_CHANNELS_FEISHU_RANDOM_REACTION_EMOJI"`
	IsLark              bool                `json:"is_lark"                     yaml:"-"                            env:"COMPA_CHANNELS_FEISHU_IS_LARK"`
}

type FlexibleStringSlice []string

type GLMSearchConfig struct {
	Enabled bool         `json:"enabled"          yaml:"-"                 env:"COMPA_TOOLS_WEB_GLM_ENABLED"`
	APIKey  SecureString `json:"api_key,omitzero" yaml:"api_key,omitempty" env:"COMPA_TOOLS_WEB_GLM_API_KEY"`
	BaseURL string       `json:"base_url"         yaml:"-"                 env:"COMPA_TOOLS_WEB_GLM_BASE_URL"`
	// SearchEngine specifies the search backend: "search_std" (default),
	// "search_pro", "search_pro_sogou", or "search_pro_quark".
	SearchEngine string `json:"search_engine" yaml:"-" env:"COMPA_TOOLS_WEB_GLM_SEARCH_ENGINE"`
	MaxResults   int    `json:"max_results"   yaml:"-" env:"COMPA_TOOLS_WEB_GLM_MAX_RESULTS"`
}

type GatewayConfig struct {
	Host      string `json:"host"                env:"COMPA_GATEWAY_HOST"`
	Port      int    `json:"port"                env:"COMPA_GATEWAY_PORT"`
	HotReload bool   `json:"hot_reload"          env:"COMPA_GATEWAY_HOT_RELOAD"`
	LogLevel  string `json:"log_level,omitempty" env:"COMPA_LOG_LEVEL"`
}

type GeminiSearchConfig struct {
	Enabled    bool         `json:"enabled"          yaml:"-"                 env:"COMPA_TOOLS_WEB_GEMINI_ENABLED"`
	APIKey     SecureString `json:"api_key,omitzero" yaml:"api_key,omitempty" env:"COMPA_TOOLS_WEB_GEMINI_API_KEY"`
	Model      string       `json:"model"            yaml:"-"                 env:"COMPA_TOOLS_WEB_GEMINI_MODEL"`
	MaxResults int          `json:"max_results"      yaml:"-"                 env:"COMPA_TOOLS_WEB_GEMINI_MAX_RESULTS"`
}

type GroupTriggerConfig struct {
	// MentionOnly answers in groups only when the bot is mentioned. A channel
	// entry that leaves it out gets true (ChannelsConfig.UnmarshalJSON).
	MentionOnly bool     `json:"mention_only"`
	Prefixes    []string `json:"prefixes,omitempty"`
}

type HeartbeatConfig struct {
	Enabled  bool `json:"enabled"  env:"COMPA_HEARTBEAT_ENABLED"`
	Interval int  `json:"interval" env:"COMPA_HEARTBEAT_INTERVAL"` // minutes, min 5
}

type HookDefaultsConfig struct {
	ObserverTimeoutMS    int `json:"observer_timeout_ms,omitempty"`
	InterceptorTimeoutMS int `json:"interceptor_timeout_ms,omitempty"`
	ApprovalTimeoutMS    int `json:"approval_timeout_ms,omitempty"`
}

type HooksConfig struct {
	Enabled   bool                         `json:"enabled"`
	Defaults  HookDefaultsConfig           `json:"defaults,omitempty"`
	Builtins  map[string]BuiltinHookConfig `json:"builtins,omitempty"`
	Processes map[string]ProcessHookConfig `json:"processes,omitempty"`
}

type IRCSettings struct {
	Server           string              `json:"server"                     yaml:"-"                           env:"COMPA_CHANNELS_IRC_SERVER"`
	TLS              bool                `json:"tls"                        yaml:"-"                           env:"COMPA_CHANNELS_IRC_TLS"`
	Nick             string              `json:"nick"                       yaml:"-"                           env:"COMPA_CHANNELS_IRC_NICK"`
	User             string              `json:"user,omitempty"             yaml:"-"                           env:"COMPA_CHANNELS_IRC_USER"`
	RealName         string              `json:"real_name,omitempty"        yaml:"-"`
	Password         SecureString        `json:"password,omitzero"          yaml:"password,omitempty"          env:"COMPA_CHANNELS_IRC_PASSWORD"`
	NickServPassword SecureString        `json:"nickserv_password,omitzero" yaml:"nickserv_password,omitempty" env:"COMPA_CHANNELS_IRC_NICKSERV_PASSWORD"`
	SASLUser         string              `json:"sasl_user"                  yaml:"-"                           env:"COMPA_CHANNELS_IRC_SASL_USER"`
	SASLPassword     SecureString        `json:"sasl_password,omitzero"     yaml:"sasl_password,omitempty"     env:"COMPA_CHANNELS_IRC_SASL_PASSWORD"`
	Channels         FlexibleStringSlice `json:"channels"                   yaml:"-"                           env:"COMPA_CHANNELS_IRC_CHANNELS"`
	RequestCaps      FlexibleStringSlice `json:"request_caps,omitempty"     yaml:"-"`
}

type IsolationConfig struct {
	Enabled     bool         `json:"enabled,omitempty"`
	ExposePaths []ExposePath `json:"expose_paths,omitempty"`
}

type KagiConfig struct {
	Enabled    bool          `json:"enabled"           yaml:"-"                  env:"COMPA_TOOLS_WEB_KAGI_ENABLED"`
	APIKeys    SecureStrings `json:"api_keys,omitzero" yaml:"api_keys,omitempty" env:"COMPA_TOOLS_WEB_KAGI_API_KEYS"`
	BaseURL    string        `json:"base_url"          yaml:"-"                  env:"COMPA_TOOLS_WEB_KAGI_BASE_URL"`
	MaxResults int           `json:"max_results"       yaml:"-"                  env:"COMPA_TOOLS_WEB_KAGI_MAX_RESULTS"`
}

type LINESettings struct {
	ChannelSecret      SecureString `json:"channel_secret,omitzero"       yaml:"channel_secret,omitempty"       env:"COMPA_CHANNELS_LINE_CHANNEL_SECRET"`
	ChannelAccessToken SecureString `json:"channel_access_token,omitzero" yaml:"channel_access_token,omitempty" env:"COMPA_CHANNELS_LINE_CHANNEL_ACCESS_TOKEN"`
	WebhookPath        string       `json:"webhook_path"                  yaml:"-"                              env:"COMPA_CHANNELS_LINE_WEBHOOK_PATH"`
}

type LoggingConfig struct {
	// RedactSecrets replaces the secrets Compa stores, and tokens inside
	// URLs, with [FILTERED] in log entries.
	RedactSecrets bool `json:"redact_secrets" env:"COMPA_LOGGING_REDACT_SECRETS"`
	// MaxSizeMB rotates a log file when it reaches this size.
	MaxSizeMB int `json:"max_size_mb" env:"COMPA_LOGGING_MAX_SIZE_MB"`
	// MaxFiles is how many rotated files are kept beside the current one.
	MaxFiles int `json:"max_files" env:"COMPA_LOGGING_MAX_FILES"`
}

type MCPConfig struct {
	ToolConfig `                    envPrefix:"COMPA_TOOLS_MCP_"`
	Discovery  ToolDiscoveryConfig `                                json:"discovery"`
	// MaxInlineTextChars controls how much MCP text stays inline before it is saved as an artifact.
	MaxInlineTextChars int `json:"max_inline_text_chars,omitempty" env:"COMPA_TOOLS_MCP_MAX_INLINE_TEXT_CHARS"`
	// CallTimeoutSeconds bounds one tool call to a server without its own
	// call_timeout_seconds; 0 means 300 (mcp.DefaultCallTimeout).
	CallTimeoutSeconds int `json:"call_timeout_seconds,omitempty" env:"COMPA_TOOLS_MCP_CALL_TIMEOUT_SECONDS"`
	// Servers is a map of server name to server configuration
	Servers map[string]MCPServerConfig `json:"servers,omitempty"`
}

type MCPServerConfig struct {
	// Enabled indicates whether this MCP server is active
	Enabled bool `json:"enabled"`
	// Deferred controls whether this server's tools are registered as hidden (deferred/discovery mode).
	// When nil, the global Discovery.Enabled setting applies.
	// When explicitly set to true or false, it overrides the global setting for this server only.
	Deferred *bool `json:"deferred,omitempty"`
	// Command is the executable to run (e.g., "npx", "python", "/path/to/server")
	Command string `json:"command"`
	// Args are the arguments to pass to the command
	Args []string `json:"args,omitempty"`
	// Env are environment variables to set for the server process (stdio only)
	Env map[string]string `json:"env,omitempty"`
	// EnvFile is the path to a file containing environment variables (stdio only)
	EnvFile string `json:"env_file,omitempty"`
	// Type is "stdio", "sse", "http", or "streamable-http".
	// "http" and "streamable-http" both select streamable HTTP request-response
	// mode, while "sse" keeps the standalone SSE listener enabled for
	// server-initiated notifications. Defaults: stdio if command is set, sse if
	// url is set.
	Type string `json:"type,omitempty"`
	// URL is used for SSE/HTTP transport
	URL string `json:"url,omitempty"`
	// Headers are HTTP headers to send with requests (sse/http only)
	Headers map[string]string `json:"headers,omitempty"`
	// Trusted lets Compa act on what the server declares about its tools
	// (annotations such as readOnlyHint): approval rules may match them, and a
	// read-only or idempotent call is retried once after a lost session.
	// Annotations from servers that are not trusted are ignored.
	Trusted bool `json:"trusted,omitempty"`
	// Cwd is the working folder of a stdio server; empty means the agent
	// workspace.
	Cwd string `json:"cwd,omitempty"`
	// CallTimeoutSeconds bounds one tool call to this server; 0 means the
	// MCP default (MCPConfig.CallTimeoutSeconds).
	CallTimeoutSeconds int `json:"call_timeout_seconds,omitempty"`
}

type MQTTSettings struct {
	Broker      string       `json:"broker"                 yaml:"-"                  env:"COMPA_CHANNELS_MQTT_BROKER"`
	AgentID     string       `json:"agent_id"               yaml:"-"                  env:"COMPA_CHANNELS_MQTT_AGENT_ID"`
	TopicPrefix string       `json:"topic_prefix,omitempty" yaml:"-"                  env:"COMPA_CHANNELS_MQTT_TOPIC_PREFIX"`
	Username    SecureString `json:"username,omitzero"      yaml:"username,omitempty" env:"COMPA_CHANNELS_MQTT_USERNAME"`
	Password    SecureString `json:"password,omitzero"      yaml:"password,omitempty" env:"COMPA_CHANNELS_MQTT_PASSWORD"`
	ClientID    string       `json:"client_id,omitempty"    yaml:"-"                  env:"COMPA_CHANNELS_MQTT_CLIENT_ID"`
	KeepAlive   int          `json:"keep_alive,omitempty"   yaml:"-"                  env:"COMPA_CHANNELS_MQTT_KEEP_ALIVE"`
	QoS         int          `json:"qos,omitempty"          yaml:"-"                  env:"COMPA_CHANNELS_MQTT_QOS"`
	// TLSInsecureSkipVerify turns off verification of the broker's TLS
	// certificate.
	TLSInsecureSkipVerify bool `json:"tls_insecure_skip_verify" yaml:"-" env:"COMPA_CHANNELS_MQTT_TLS_INSECURE_SKIP_VERIFY"`
}

type MaixCamSettings struct {
	Host  string       `json:"host"           yaml:"-"               env:"COMPA_CHANNELS_MAIXCAM_HOST"`
	Port  int          `json:"port"           yaml:"-"               env:"COMPA_CHANNELS_MAIXCAM_PORT"`
	Token SecureString `json:"token,omitzero" yaml:"token,omitempty" env:"COMPA_CHANNELS_MAIXCAM_TOKEN"`
}

type MatrixSettings struct {
	Homeserver         string       `json:"homeserver"                     yaml:"-"                      env:"COMPA_CHANNELS_MATRIX_HOMESERVER"`
	UserID             string       `json:"user_id"                        yaml:"-"                      env:"COMPA_CHANNELS_MATRIX_USER_ID"`
	AccessToken        SecureString `json:"access_token,omitzero"          yaml:"access_token,omitempty" env:"COMPA_CHANNELS_MATRIX_ACCESS_TOKEN"`
	DeviceID           string       `json:"device_id,omitempty"            yaml:"-"`
	JoinOnInvite       bool         `json:"join_on_invite"                 yaml:"-"`
	MessageFormat      string       `json:"message_format,omitempty"       yaml:"-"`
	CryptoDatabasePath string       `json:"crypto_database_path,omitempty" yaml:"-"`
	// CryptoPassphrase protects the end-to-end encryption keys.
	CryptoPassphrase SecureString `json:"crypto_passphrase,omitzero" yaml:"crypto_passphrase,omitempty"`
}

type MediaCleanupConfig struct {
	ToolConfig `    envPrefix:"COMPA_MEDIA_CLEANUP_"`
	MaxAge     int `                                    json:"max_age_minutes"  env:"COMPA_MEDIA_CLEANUP_MAX_AGE"`
	Interval   int `                                    json:"interval_minutes" env:"COMPA_MEDIA_CLEANUP_INTERVAL"`
}

type MessageToolsConfig struct {
	ToolConfig `yaml:"-" envPrefix:"COMPA_TOOLS_MESSAGE_"`

	MediaEnabled bool `json:"media_enabled" yaml:"-" env:"COMPA_TOOLS_MESSAGE_MEDIA_ENABLED"`
	// Targets is where the message tool may send: "current_chat" or "any".
	Targets string `json:"targets" yaml:"-" env:"COMPA_TOOLS_MESSAGE_TARGETS"`
}

type ModelRouteConfig struct {
	Name    string   `json:"name"`
	Targets []string `json:"targets"`
}

type ModulesConfig struct {
	// SourceRoots are the named locations the host may lend a module to read:
	// root name -> absolute path of an existing directory or file.
	//
	// A module asks for a root by NAME in the filesystem_read list of its
	// descriptor, and the host grants it read-only only when that name is
	// configured here (or supplied for one invocation with
	// `module-invoke --source-root name=path`). Compa itself defines no names
	// and no default paths. Roots the host supplies on its own -- the
	// workspace, a module's bundle and its writable state -- are never taken
	// from here.
	//
	// Loading checks the SHAPE of each entry only. Whether a path exists is
	// checked each time a module is granted it, so a detached drive never
	// makes the whole config unloadable.
	SourceRoots map[string]string `json:"source_roots,omitempty"`
}

type OneBotSettings struct {
	WSUrl             string       `json:"ws_url"                yaml:"-"                      env:"COMPA_CHANNELS_ONEBOT_WS_URL"`
	AccessToken       SecureString `json:"access_token,omitzero" yaml:"access_token,omitempty" env:"COMPA_CHANNELS_ONEBOT_ACCESS_TOKEN"`
	ReconnectInterval int          `json:"reconnect_interval"    yaml:"-"                      env:"COMPA_CHANNELS_ONEBOT_RECONNECT_INTERVAL"`
}

type PerplexityConfig struct {
	Enabled    bool          `json:"enabled"           yaml:"-"                  env:"COMPA_TOOLS_WEB_PERPLEXITY_ENABLED"`
	APIKeys    SecureStrings `json:"api_keys,omitzero" yaml:"api_keys,omitempty" env:"COMPA_TOOLS_WEB_PERPLEXITY_API_KEYS"`
	MaxResults int           `json:"max_results"       yaml:"-"                  env:"COMPA_TOOLS_WEB_PERPLEXITY_MAX_RESULTS"`
}

type PlaceholderConfig struct {
	Enabled bool                `json:"enabled"`
	Text    FlexibleStringSlice `json:"text,omitempty"`
}

type ProcessHookConfig struct {
	Enabled   bool              `json:"enabled"`
	Priority  int               `json:"priority,omitempty"`
	Transport string            `json:"transport,omitempty"`
	Command   []string          `json:"command,omitempty"`
	Dir       string            `json:"dir,omitempty"`
	Env       map[string]string `json:"env,omitempty"`
	Observe   []string          `json:"observe,omitempty"`
	Intercept []string          `json:"intercept,omitempty"`
}

type ProviderInstanceConfig struct {
	ID                string            `json:"id"`
	ProviderKind      string            `json:"provider_kind"`
	Adapter           string            `json:"adapter"`
	Protocol          string            `json:"protocol"`
	Endpoint          string            `json:"endpoint,omitempty"`
	AuthConnectionRef string            `json:"auth_connection_ref,omitempty"`
	Headers           map[string]string `json:"headers,omitempty"`
	// Settings configure the adapter: display_name, project and location for
	// Vertex AI and, for an extension instance, the extension_* settings.
	Settings map[string]any `json:"settings,omitempty"`
	// Runtime holds the request settings every model of the instance runs
	// with; nil uses the provider defaults.
	Runtime *ProviderInstanceRuntime `json:"runtime,omitempty"`
	State   ProviderInstanceState    `json:"state"`
}

type ProviderInstanceRuntime struct {
	// Proxy is the http, https, socks5 or socks5h proxy URL requests go
	// through; empty uses none.
	Proxy string `json:"proxy,omitempty"`
	// RequestTimeout bounds a request, in seconds; 0 uses the provider
	// default.
	RequestTimeout int `json:"request_timeout,omitempty"`
	// RPM caps requests per minute; 0 is unlimited.
	RPM int `json:"rpm,omitempty"`
	// Streaming turns provider streaming on or off; nil leaves it on, so
	// answers show as they arrive.
	Streaming *bool `json:"streaming,omitempty"`
	// ThinkingLevel is the extended-thinking level: off, low, medium, high,
	// xhigh or adaptive; empty leaves it to the agent.
	ThinkingLevel string `json:"thinking_level,omitempty"`
	// MaxTokensField names the request's max-tokens field, such as
	// "max_completion_tokens"; empty uses the provider's choice.
	MaxTokensField string `json:"max_tokens_field,omitempty"`
	// ToolSchemaTransform adapts tool schemas for providers that reject
	// complex JSON Schema: "off" (or empty) or "simple".
	ToolSchemaTransform string `json:"tool_schema_transform,omitempty"`
	// ExtraBody holds fields merged into every request body.
	ExtraBody map[string]any `json:"extra_body,omitempty"`
}

type ProviderInstanceState string

type QQSettings struct {
	AppID                string       `json:"app_id"                   yaml:"-"                    env:"COMPA_CHANNELS_QQ_APP_ID"`
	AppSecret            SecureString `json:"app_secret,omitzero"      yaml:"app_secret,omitempty" env:"COMPA_CHANNELS_QQ_APP_SECRET"`
	MaxMessageLength     int          `json:"max_message_length"       yaml:"-"                    env:"COMPA_CHANNELS_QQ_MAX_MESSAGE_LENGTH"`
	MaxBase64FileSizeMiB int64        `json:"max_base64_file_size_mib" yaml:"-"                    env:"COMPA_CHANNELS_QQ_MAX_BASE64_FILE_SIZE_MIB"`
	SendMarkdown         bool         `json:"send_markdown"            yaml:"-"                    env:"COMPA_CHANNELS_QQ_SEND_MARKDOWN"`
}

type RawNode json.RawMessage

type ReadFileToolConfig struct {
	Enabled         bool   `json:"enabled"`
	Mode            string `json:"mode"`
	MaxReadFileSize int    `json:"max_read_file_size"`
}

type RoutingConfig struct {
	Enabled    bool    `json:"enabled"`
	LightModel string  `json:"light_model"` // model selection (exact target or model route name) for simple tasks
	Threshold  float64 `json:"threshold"`   // complexity score in [0,1]; score >= threshold → primary model
}

type SearXNGConfig struct {
	Enabled    bool   `json:"enabled"     env:"COMPA_TOOLS_WEB_SEARXNG_ENABLED"`
	BaseURL    string `json:"base_url"    env:"COMPA_TOOLS_WEB_SEARXNG_BASE_URL"`
	MaxResults int    `json:"max_results" env:"COMPA_TOOLS_WEB_SEARXNG_MAX_RESULTS"`
}

type SearchCacheConfig struct {
	MaxSize    int `json:"max_size"    env:"COMPA_SKILLS_SEARCH_CACHE_MAX_SIZE"`
	TTLSeconds int `json:"ttl_seconds" env:"COMPA_SKILLS_SEARCH_CACHE_TTL_SECONDS"`
}

type SecureString struct {
	// contains filtered or unexported fields
}

type SecureStrings []*SecureString

type SensitiveDataCache struct {
	// contains filtered or unexported fields
}

type SessionConfig struct {
	Dimensions    []string            `json:"dimensions,omitempty"`
	IdentityLinks map[string][]string `json:"identity_links,omitempty"`
	DmScope       string              `json:"dm_scope,omitempty"`
}

type SkillRegistryConfig struct {
	Name      string         `json:"name,omitempty"      yaml:"-"                    env:"-"`
	Enabled   bool           `json:"enabled"             yaml:"-"                    env:"-"`
	BaseURL   string         `json:"base_url"            yaml:"-"                    env:"-"`
	AuthToken SecureString   `json:"auth_token,omitzero" yaml:"auth_token,omitempty" env:"-"`
	Param     map[string]any `json:"-"                   yaml:"-"                    env:"-"`
}

type SkillsRegistriesConfig []*SkillRegistryConfig

type SkillsToolsConfig struct {
	ToolConfig            `                       yaml:"-"                    envPrefix:"COMPA_TOOLS_SKILLS_"`
	Registries            SkillsRegistriesConfig `yaml:"registries,omitempty"                                    json:"registries"`
	MaxConcurrentSearches int                    `yaml:"-"                    json:"max_concurrent_searches" env:"COMPA_TOOLS_SKILLS_MAX_CONCURRENT_SEARCHES"`
	SearchCache           SearchCacheConfig      `yaml:"-"                    json:"search_cache"`
}

type SlackSettings struct {
	BotToken SecureString `json:"bot_token,omitzero" yaml:"bot_token,omitempty" env:"COMPA_CHANNELS_SLACK_BOT_TOKEN"`
	AppToken SecureString `json:"app_token,omitzero" yaml:"app_token,omitempty" env:"COMPA_CHANNELS_SLACK_APP_TOKEN"`
}

type SlackWebhookSettings struct {
	Webhooks map[string]SlackWebhookTarget `json:"webhooks" yaml:"webhooks,omitempty"`
}

type SlackWebhookTarget struct {
	WebhookURL SecureString `json:"webhook_url,omitzero" yaml:"webhook_url,omitempty"`
	Username   string       `json:"username,omitempty"   yaml:"-"`
	IconEmoji  string       `json:"icon_emoji,omitempty" yaml:"-"`
}

type SogouConfig struct {
	Enabled    bool `json:"enabled"     env:"COMPA_TOOLS_WEB_SOGOU_ENABLED"`
	MaxResults int  `json:"max_results" env:"COMPA_TOOLS_WEB_SOGOU_MAX_RESULTS"`
}

type StreamingConfig struct {
	Enabled         bool `json:"enabled,omitempty"`
	ThrottleSeconds int  `json:"throttle_seconds,omitempty"`
	MinGrowthChars  int  `json:"min_growth_chars,omitempty"`
}

type SubTurnConfig struct {
	MaxDepth              int `json:"max_depth"               env:"COMPA_AGENTS_DEFAULTS_SUBTURN_MAX_DEPTH"`
	MaxConcurrent         int `json:"max_concurrent"          env:"COMPA_AGENTS_DEFAULTS_SUBTURN_MAX_CONCURRENT"`
	DefaultTimeoutMinutes int `json:"default_timeout_minutes" env:"COMPA_AGENTS_DEFAULTS_SUBTURN_DEFAULT_TIMEOUT_MINUTES"`
	ConcurrencyTimeoutSec int `json:"concurrency_timeout_sec" env:"COMPA_AGENTS_DEFAULTS_SUBTURN_CONCURRENCY_TIMEOUT_SEC"`
}

type SubagentsConfig struct {
	AllowAgents []string `json:"allow_agents,omitempty"`
}

type TavilyConfig struct {
	Enabled    bool          `json:"enabled"           yaml:"-"                  env:"COMPA_TOOLS_WEB_TAVILY_ENABLED"`
	APIKeys    SecureStrings `json:"api_keys,omitzero" yaml:"api_keys,omitempty" env:"COMPA_TOOLS_WEB_TAVILY_API_KEYS"`
	BaseURL    string        `json:"base_url"          yaml:"-"                  env:"COMPA_TOOLS_WEB_TAVILY_BASE_URL"`
	MaxResults int           `json:"max_results"       yaml:"-"                  env:"COMPA_TOOLS_WEB_TAVILY_MAX_RESULTS"`
}

type TeamsWebhookSettings struct {
	Webhooks map[string]TeamsWebhookTarget `json:"webhooks" yaml:"webhooks,omitempty"`
}

type TeamsWebhookTarget struct {
	WebhookURL SecureString `json:"webhook_url,omitzero" yaml:"webhook_url,omitempty"`
	Title      string       `json:"title,omitempty"      yaml:"-"`
}

type TelegramSettings struct {
	Token             SecureString    `json:"token,omitzero"       yaml:"token,omitempty" env:"COMPA_CHANNELS_TELEGRAM_TOKEN"`
	BaseURL           string          `json:"base_url"             yaml:"-"               env:"COMPA_CHANNELS_TELEGRAM_BASE_URL"`
	Proxy             string          `json:"proxy"                yaml:"-"               env:"COMPA_CHANNELS_TELEGRAM_PROXY"`
	Streaming         StreamingConfig `json:"streaming,omitzero"   yaml:"-"`
	UseMarkdownV2     bool            `json:"use_markdown_v2"      yaml:"-"               env:"COMPA_CHANNELS_TELEGRAM_USE_MARKDOWN_V2"`
	MediaGroupDelayMS int             `json:"media_group_delay_ms" yaml:"-"               env:"COMPA_CHANNELS_TELEGRAM_MEDIA_GROUP_DELAY_MS"`
}

type ToolConfig struct {
	Enabled bool `json:"enabled" yaml:"-" env:"ENABLED"`
}

type ToolDiscoveryConfig struct {
	Enabled          bool `json:"enabled"            env:"COMPA_TOOLS_DISCOVERY_ENABLED"`
	TTL              int  `json:"ttl"                env:"COMPA_TOOLS_DISCOVERY_TTL"`
	MaxSearchResults int  `json:"max_search_results" env:"COMPA_MAX_SEARCH_RESULTS"`
	UseBM25          bool `json:"use_bm25"           env:"COMPA_TOOLS_DISCOVERY_USE_BM25"`
	UseRegex         bool `json:"use_regex"          env:"COMPA_TOOLS_DISCOVERY_USE_REGEX"`
}

type ToolFeedbackConfig struct {
	Enabled          bool `json:"enabled"           env:"COMPA_AGENTS_DEFAULTS_TOOL_FEEDBACK_ENABLED"`
	MaxArgsLength    int  `json:"max_args_length"   env:"COMPA_AGENTS_DEFAULTS_TOOL_FEEDBACK_MAX_ARGS_LENGTH"`
	SeparateMessages bool `json:"separate_messages" env:"COMPA_AGENTS_DEFAULTS_TOOL_FEEDBACK_SEPARATE_MESSAGES"`
}

type ToolsConfig struct {
	AllowReadPaths  []string `json:"allow_read_paths"  yaml:"-" env:"COMPA_TOOLS_ALLOW_READ_PATHS"`
	AllowWritePaths []string `json:"allow_write_paths" yaml:"-" env:"COMPA_TOOLS_ALLOW_WRITE_PATHS"`
	// FilterSensitiveData controls whether to filter sensitive values (API keys,
	// tokens, secrets) from tool results before sending to the LLM.
	// Default: true (enabled)
	FilterSensitiveData bool `json:"filter_sensitive_data" yaml:"-" env:"COMPA_TOOLS_FILTER_SENSITIVE_DATA"`
	// FilterMinLength is the minimum content length required for filtering.
	// Content shorter than this will be returned unchanged for performance.
	// Default: 8
	FilterMinLength int                `json:"filter_min_length" yaml:"-"                env:"COMPA_TOOLS_FILTER_MIN_LENGTH"`
	Approval        approval.Policy    `json:"approval"          yaml:"-"`
	Web             WebToolsConfig     `json:"web"               yaml:"web,omitempty"`
	Cron            CronToolsConfig    `json:"cron"              yaml:"-"`
	Exec            ExecConfig         `json:"exec"              yaml:"-"`
	Skills          SkillsToolsConfig  `json:"skills"            yaml:"skills,omitempty"`
	MediaCleanup    MediaCleanupConfig `json:"media_cleanup"     yaml:"-"`
	MCP             MCPConfig          `json:"mcp"               yaml:"-"`
	AppendFile      ToolConfig         `json:"append_file"       yaml:"-"                                                       envPrefix:"COMPA_TOOLS_APPEND_FILE_"`
	EditFile        ToolConfig         `json:"edit_file"         yaml:"-"                                                       envPrefix:"COMPA_TOOLS_EDIT_FILE_"`
	FindSkills      ToolConfig         `json:"find_skills"       yaml:"-"                                                       envPrefix:"COMPA_TOOLS_FIND_SKILLS_"`
	I2C             ToolConfig         `json:"i2c"               yaml:"-"                                                       envPrefix:"COMPA_TOOLS_I2C_"`
	InstallSkill    ToolConfig         `` /* 126-byte string literal not displayed */
	ListDir         ToolConfig         `json:"list_dir"          yaml:"-"                                                       envPrefix:"COMPA_TOOLS_LIST_DIR_"`
	LoadImage       ToolConfig         `json:"load_image"        yaml:"-"                                                       envPrefix:"COMPA_TOOLS_LOAD_IMAGE_"`
	Message         MessageToolsConfig `json:"message"           yaml:"-"`
	ReadFile        ReadFileToolConfig `json:"read_file"         yaml:"-"                                                       envPrefix:"COMPA_TOOLS_READ_FILE_"`
	Serial          ToolConfig         `json:"serial"            yaml:"-"                                                       envPrefix:"COMPA_TOOLS_SERIAL_"`
	SendFile        ToolConfig         `json:"send_file"         yaml:"-"                                                       envPrefix:"COMPA_TOOLS_SEND_FILE_"`
	SendTTS         ToolConfig         `json:"send_tts"          yaml:"-"                                                       envPrefix:"COMPA_TOOLS_SEND_TTS_"`
	Spawn           ToolConfig         `json:"spawn"             yaml:"-"                                                       envPrefix:"COMPA_TOOLS_SPAWN_"`
	SpawnStatus     ToolConfig         `json:"spawn_status"      yaml:"-"                                                       envPrefix:"COMPA_TOOLS_SPAWN_STATUS_"`
	SPI             ToolConfig         `json:"spi"               yaml:"-"                                                       envPrefix:"COMPA_TOOLS_SPI_"`
	Subagent        ToolConfig         `json:"subagent"          yaml:"-"                                                       envPrefix:"COMPA_TOOLS_SUBAGENT_"`
	WebFetch        ToolConfig         `json:"web_fetch"         yaml:"-"                                                       envPrefix:"COMPA_TOOLS_WEB_FETCH_"`
	WriteFile       ToolConfig         `json:"write_file"        yaml:"-"                                                       envPrefix:"COMPA_TOOLS_WRITE_FILE_"`
}

type TurnProfileBlock struct {
	Mode  TurnProfileMode `json:"mode,omitempty"`
	Allow []string        `json:"allow,omitempty"`
}

type TurnProfileConfig struct {
	Enabled      bool             `json:"enabled"`
	History      TurnProfileBlock `json:"history,omitempty"`
	SystemPrompt TurnProfileBlock `json:"system_prompt,omitempty"`
	Skills       TurnProfileBlock `json:"skills,omitempty"`
	Tools        TurnProfileBlock `json:"tools,omitempty"`
}

type TurnProfileMode string

type TypingConfig struct {
	Enabled bool `json:"enabled,omitempty"`
}

type VKSettings struct {
	Token   SecureString `json:"token,omitzero" yaml:"token,omitempty" env:"COMPA_CHANNELS_VK_TOKEN"`
	GroupID int          `json:"group_id"       yaml:"-"               env:"COMPA_CHANNELS_VK_GROUP_ID"`
}

type VoiceConfig struct {
	Enabled bool `json:"enabled"`
	// Mode is "cascade" (push-to-talk) or "live" (hands-free).
	Mode string `json:"mode,omitempty"`
	// STTTarget is the exact target "instance-id/model-id" that transcribes
	// speech.
	STTTarget string `json:"stt_target,omitempty"`
	// STTViaChat opts STTTarget in as a chat model that transcribes the audio
	// it is sent (llmgw-core's chat transcription adapter) instead of a model
	// serving audio_transcriptions. It is never inferred, and holds only for
	// a model whose catalog declares audio input.
	STTViaChat bool `json:"stt_via_chat,omitempty"`
	// TTSTarget is the exact target "instance-id/model-id" that synthesizes
	// speech.
	TTSTarget string `json:"tts_target,omitempty"`
	// TTSVoice is the synthesis voice; empty uses the provider's default.
	TTSVoice          string `json:"tts_voice,omitempty"`
	EchoTranscription bool   `json:"echo_transcription" env:"COMPA_VOICE_ECHO_TRANSCRIPTION"`
}

type WeComGroupConfig struct {
	AllowFrom FlexibleStringSlice `json:"allow_from,omitempty"`
}

type WeComSettings struct {
	BotID               string          `json:"bot_id"                  yaml:"-"                env:"COMPA_CHANNELS_WECOM_BOT_ID"`
	Secret              SecureString    `json:"secret,omitzero"         yaml:"secret,omitempty" env:"COMPA_CHANNELS_WECOM_SECRET"`
	WebSocketURL        string          `json:"websocket_url,omitempty" yaml:"-"                env:"COMPA_CHANNELS_WECOM_WEBSOCKET_URL"`
	SendThinkingMessage bool            `json:"send_thinking_message"   yaml:"-"                env:"COMPA_CHANNELS_WECOM_SEND_THINKING_MESSAGE"`
	Streaming           StreamingConfig `json:"streaming,omitzero"      yaml:"-"`
}

type WebChatClientSettings struct {
	URL          string       `json:"url"                     yaml:"-"               env:"COMPA_CHANNELS_WEB_CLIENT_URL"`
	Token        SecureString `json:"token,omitzero"          yaml:"token,omitempty" env:"COMPA_CHANNELS_WEB_CLIENT_TOKEN"`
	SessionID    string       `json:"session_id,omitempty"    yaml:"-"`
	PingInterval int          `json:"ping_interval,omitempty" yaml:"-"`
	ReadTimeout  int          `json:"read_timeout,omitempty"  yaml:"-"`
}

type WebChatSettings struct {
	Token           SecureString    `json:"token,omitzero"              yaml:"token,omitempty" env:"COMPA_CHANNELS_WEB_TOKEN"`
	AllowTokenQuery bool            `json:"allow_token_query,omitempty" yaml:"-"`
	AllowOrigins    []string        `json:"allow_origins,omitempty"     yaml:"-"`
	Streaming       StreamingConfig `json:"streaming,omitzero"          yaml:"-"`
	PingInterval    int             `json:"ping_interval,omitempty"     yaml:"-"`
	ReadTimeout     int             `json:"read_timeout,omitempty"      yaml:"-"`
	WriteTimeout    int             `json:"write_timeout,omitempty"     yaml:"-"`
	MaxConnections  int             `json:"max_connections,omitempty"   yaml:"-"`
}

type WebToolsConfig struct {
	ToolConfig  `                   yaml:"-"                      envPrefix:"COMPA_TOOLS_WEB_"`
	Brave       BraveConfig        `yaml:"brave,omitempty"                                        json:"brave"`
	Tavily      TavilyConfig       `yaml:"tavily,omitempty"                                       json:"tavily"`
	Kagi        KagiConfig         `yaml:"kagi,omitempty"                                         json:"kagi"`
	Sogou       SogouConfig        `yaml:"-"                                                      json:"sogou"`
	DuckDuckGo  DuckDuckGoConfig   `yaml:"-"                                                      json:"duckduckgo"`
	Gemini      GeminiSearchConfig `yaml:"gemini,omitempty"                                       json:"gemini"`
	Perplexity  PerplexityConfig   `yaml:"perplexity,omitempty"                                   json:"perplexity"`
	SearXNG     SearXNGConfig      `yaml:"-"                                                      json:"searxng"`
	GLMSearch   GLMSearchConfig    `yaml:"glm_search,omitempty"                                   json:"glm_search"`
	BaiduSearch BaiduSearchConfig  `yaml:"baidu_search,omitempty"                                 json:"baidu_search"`
	Provider    string             `yaml:"-"                                                      json:"provider,omitempty" env:"COMPA_TOOLS_WEB_PROVIDER"`
	// PreferNative controls whether to use provider-native web search when
	// the active LLM supports it (e.g. OpenAI web_search_preview). When true,
	// the client-side web_search tool is hidden to avoid duplicate search surfaces,
	// and the provider's built-in search is used instead. Falls back to client-side
	// search when the provider does not support native search.
	PreferNative bool `yaml:"-" json:"prefer_native" env:"COMPA_TOOLS_WEB_PREFER_NATIVE"`
	// Proxy is an optional proxy URL for web tools (http/https/socks5/socks5h).
	// For authenticated proxies, prefer HTTP_PROXY/HTTPS_PROXY env vars instead of embedding credentials in config.
	Proxy                string              `yaml:"-" json:"proxy,omitempty"                  env:"COMPA_TOOLS_WEB_PROXY"`
	FetchLimitBytes      int64               `yaml:"-" json:"fetch_limit_bytes,omitempty"      env:"COMPA_TOOLS_WEB_FETCH_LIMIT_BYTES"`
	Format               string              `yaml:"-" json:"format,omitempty"                 env:"COMPA_TOOLS_WEB_FORMAT"`
	PrivateHostWhitelist FlexibleStringSlice `yaml:"-" json:"private_host_whitelist,omitempty" env:"COMPA_TOOLS_WEB_PRIVATE_HOST_WHITELIST"`
}

type WeixinSettings struct {
	Token      SecureString `json:"token,omitzero"       yaml:"token,omitempty" env:"COMPA_CHANNELS_WEIXIN_TOKEN"`
	AccountID  string       `json:"account_id,omitempty" yaml:"-"               env:"COMPA_CHANNELS_WEIXIN_ACCOUNT_ID"`
	BaseURL    string       `json:"base_url"             yaml:"-"               env:"COMPA_CHANNELS_WEIXIN_BASE_URL"`
	CDNBaseURL string       `json:"cdn_base_url"         yaml:"-"               env:"COMPA_CHANNELS_WEIXIN_CDN_BASE_URL"`
	Proxy      string       `json:"proxy"                yaml:"-"               env:"COMPA_CHANNELS_WEIXIN_PROXY"`
}

type WhatsAppSettings struct {
	BridgeURL        string `json:"bridge_url"         yaml:"-" env:"COMPA_CHANNELS_WHATSAPP_BRIDGE_URL"`
	UseNative        bool   `json:"use_native"         yaml:"-" env:"COMPA_CHANNELS_WHATSAPP_USE_NATIVE"`
	SessionStorePath string `json:"session_store_path" yaml:"-" env:"COMPA_CHANNELS_WHATSAPP_SESSION_STORE_PATH"`
	// Chats selects which chats the native client takes as input: "self",
	// "allowed" or "all" (see the WhatsAppChats* constants).
	Chats string `json:"chats,omitempty" yaml:"-" env:"COMPA_CHANNELS_WHATSAPP_CHATS"`
}